Condições de ativação de pedidos provisórios, passo a passo

Copiar página

Dez gatilhos do Shopify Flow para pedidos provisórios: estado, itens, tags, notas, atributos, e-mail e morada.

Os pedidos provisórios são onde se encontram as cotações B2B, as encomendas por grosso e as encomendas por telefone, e o Shopify Flow praticamente não oferece funcionalidades para elas. Estes dez gatilhos abrangem todo o ciclo de vida de um pedido provisório: edições, estado, tags, notas e, mediante opção, os dados de contacto.

Nesta página: Atualização do pedido preliminar, Alteração do estado do pedido preliminar, Alteração dos itens do pedido preliminar, Adição de etiquetas ao pedido preliminar, Remoção de etiquetas do pedido preliminar, Alteração da nota do pedido preliminar, Alteração dos atributos do pedido preliminar, Alteração do e-mail do pedido preliminar, Alteração da morada de envio do pedido preliminar, Alteração da morada de faturação do pedido preliminar

Atualização do projeto de decreto

Aciona-se sempre que se guarda um pedido provisório.


Incêndios provocados por	Shopify webhook
Autorização	Acesso aos dados do projeto de decisão
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O respetivo botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Importar as cotações para um CRM.
Uma solução provisória enquanto determina qual o gatilho mais específico que se adequa.

O que a atualização do «Pedido provisório» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`draftOrder`	Objeto	O pedido provisório que foi atualizado
`draftOrder.id`	ID
`draftOrder.name`	Texto
`draftOrder.status`	Texto
`draftOrder.totalPrice`	Texto
`draftOrder.currencyCode`	Texto
`draftOrder.tags`	Texto
`draftOrder.note`	Texto
`draftOrder.invoiceUrl`	Texto
`draftOrder.updatedAt`	Texto
`payload`	Texto	Objeto JSON que contém o GID do pedido provisório que foi atualizado (por exemplo, {"id":"gid://shopify/PedidoProvisório/123"})
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Refletir todas as alterações nas cotações no CRM

Selecione «Atualização da ordem do pedido provisório» como gatilho.
Adicione «Enviar pedido HTTP» com {{draftOrder.id}}, {{draftOrder.name}}, {{draftOrder.status}} e {{draftOrder.totalPrice}} {{draftOrder.currencyCode}}.
Ative o fluxo de trabalho.

Alteração do estado do pedido provisório

É acionado quando um pedido provisório é transferido entre open, invoice_sent e completed.


Incêndios provocados por	Shopify webhook e deteção de alterações
Autorização	Pedidos provisórios de acesso aos dados do projeto de decisão
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Inicie uma sequência de lembretes quando for enviada uma fatura.
Informe o gestor de contas quando uma cotação se transformar em um pedido.

O que a ação «Alteração do estado do pedido provisório» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`draftOrder`	Objeto	O pedido provisório cujo estado se alterou
`draftOrder.id`	ID
`draftOrder.name`	Texto
`draftOrder.status`	Texto
`oldStatus`	Texto	O estado anterior do pedido provisório (em aberto / fatura enviada / concluída)
`newStatus`	Texto	O novo estado do pedido provisório (em aberto / fatura enviada / concluída)
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Enviar um lembrete ao cliente três dias após a emissão da fatura

Selecione «Alteração do estado do pedido provisório» como gatilho.
Adicione uma condição: newStatus é igual a invoice_sent.
Adicione: «Aguarde 3 dias e, em seguida, envie um pedido HTTP para a sua ferramenta de e-mail com {{draftOrder.name}}.»
Ative o fluxo de trabalho.

Alterações nos itens de linha da linha de pedido provisório

É acionado quando os itens de um pedido provisório sofrem alterações: adição, remoção, quantidade, preço ou variante. Apresenta a mesma estrutura changes.items que o gatilho de pedido.


Incêndios provocados por	Shopify webhook e deteção de alterações
Autorização	Acesso aos dados do projeto de decisão
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Exigir aprovação sempre que um representante comercial reduzir o preço de um orçamento.
Mantenha um sistema de reservas em sintonia com os orçamentos.

O que a função «Itens de linha alterados (rascunho)» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`draftOrder`	Objeto	O pedido provisório cujos itens de linha foram alterados
`draftOrder.id`	ID
`draftOrder.name`	Texto
`draftOrder.status`	Texto
`changes`	Objeto	Alterações nos itens de linha: adições, eliminações, alterações na quantidade, no preço e nas variantes, com os respetivos valores antigos e novos
`changes.items`	Lista de objetos	Lista de alterações detetadas
`changes.items (each).changeType`	Texto	Tipo de alteração: adicionado, removido, quantidade_alterada, preço_alterado, variante_alterada
`changes.items (each).lineItemId`	ID	ID do item de linha (se disponível)
`changes.items (each).productTitle`	Texto	Título do produto
`changes.items (each).variantTitle`	Texto	Variante del título
`changes.items (each).oldVariantId`	ID	Variante antiga GID (para «removido» ou «variante alterada»)
`changes.items (each).newVariantId`	ID	Nova variante GID (para «adicionado» ou «variante_alterada»)
`changes.items (each).oldProductId`	ID	GID do produto antigo (para produtos removidos ou cuja variante foi alterada)
`changes.items (each).newProductId`	ID	GID do novo produto (para «adicionado» ou «variante alterada»)
`changes.items (each).oldQuantity`	Número	Quantidade anterior (para «quantity_changed»)
`changes.items (each).newQuantity`	Número	Nova quantidade (para quantity_changed)
`changes.items (each).oldPrice`	Texto	Preço anterior (para price_changed)
`changes.items (each).newPrice`	Texto	Novo preço (para price_changed)
`changes.items (each).lineItemData`	Texto	Dados completos dos itens de linha em formato JSON
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Solicitar aprovação sempre que o preço de um orçamento for alterado

Selecione «Alterações nos itens de linha do pedido provisório» como gatilho.
Adicionar uma condição: Pelo menos um dos seguintes **elementos - changes.items - ** tem changeType igual a price_changed.
Adicione as etiquetas de pedido provisório needs-approval e envie um e-mail interno ao responsável de vendas com os valores oldPrice e newPrice das entradas alteradas (um ciclo Liquid for sobre changes.items).
Ative o fluxo de trabalho.

Foram adicionadas etiquetas de pedido provisório

É acionado quando é adicionada pelo menos uma tag a um pedido provisório.


Incêndios provocados por	Shopify webhook e deteção de alterações
Autorização	Acesso aos dados do projeto de despacho
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O respetivo botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Deixem que a equipa de vendas inicie um processo ao atribuir uma etiqueta a um orçamento: approved, rush.

O que a função «Adicionar tags ao pedido provisório» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`draftOrder`	Objeto	O pedido provisório cujas etiquetas foram alteradas
`draftOrder.id`	ID
`draftOrder.name`	Texto
`draftOrder.status`	Texto
`draftOrder.tags`	Texto
`addedTags`	Texto	Lista separada por vírgulas das tags que foram adicionadas ao pedido provisório
`removedTags`	Texto	Lista separada por vírgulas das tags que foram removidas dos pedidos provisórios na mesma atualização (pode estar vazia)
`currentTags`	Texto	Lista separada por vírgulas de todas as etiquetas atuais no pedido provisório
`previousTags`	Texto	Lista separada por vírgulas de todas as etiquetas anteriores presentes nos pedidos provisórios antes desta atualização
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Notificar o departamento financeiro quando uma cotação for aprovada

Foram adicionadas as etiquetas «Pedido provisório» como gatilho.
Adicionar uma condição: addedTags inclui approved.
Adicione a opção «Enviar e-mail interno ao departamento financeiro» com {{draftOrder.name}}.
Ative o fluxo de trabalho.

Tags de pedido provisório removidas

É executada quando pelo menos uma etiqueta é removida de um pedido provisório.


Incêndios provocados por	Shopify webhook e deteção de alterações
Autorização	Acesso aos dados do projeto de decisão
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O respetivo botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Anule o que foi feito pelo fluxo de trabalho de adição de tags correspondentes.

O que a função «Remoção de etiquetas de pedidos provisórios» transmite ao seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`draftOrder`	Objeto	O pedido provisório cujas etiquetas foram alteradas
`draftOrder.id`	ID
`draftOrder.name`	Texto
`draftOrder.status`	Texto
`draftOrder.tags`	Texto
`addedTags`	Texto	Lista separada por vírgulas de tags que foram adicionadas ao pedido provisório na mesma atualização (pode estar vazia)
`removedTags`	Texto	Lista separada por vírgulas das etiquetas que foram removidas do pedido provisório
`currentTags`	Texto	Lista separada por vírgulas de todas as etiquetas atuais no pedido provisório
`previousTags`	Texto	Lista separada por vírgulas de todas as tags anteriores presentes no pedido provisório antes desta atualização
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Informar o departamento de vendas quando a aprovação for retirada

As etiquetas «Pick Draft Order» foram removidas como gatilho.
Adicionar uma condição: removedTags inclui approved.
Adicione a opção «Enviar e-mail interno ao representante de vendas».
Ative o fluxo de trabalho.

Nota relativa ao projeto de portaria alterada

É acionado quando a nota de um pedido provisório é adicionada, alterada ou anulada.


Incêndios provocados por	Shopify Webhook e deteção de alterações
Autorização	Acesso aos dados do projeto de decisão
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Transmita as observações internas relativas a um orçamento à equipa seguinte.

O que a nota «Alterações ao pedido provisório» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`draftOrder`	Objeto	O pedido provisório cuja nota foi alterada
`draftOrder.id`	ID
`draftOrder.name`	Texto
`draftOrder.status`	Texto
`draftOrder.note`	Texto
`oldNote`	Texto	A nota anterior relativa ao pedido provisório (vazia caso a nota não tenha sido definida anteriormente)
`newNote`	Texto	A nova nota relativa ao pedido provisório (vazia se a nota tiver sido apagada)
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Encaminhar notas de cotação para o canal da conta

A «Nota sobre a alteração da ordem do pedido provisório» foi definida como o gatilho.
Adicione a funcionalidade «Enviar pedido HTTP para o Slack» com o {{draftOrder.name}}: {{newNote}}.
Ative o fluxo de trabalho.

Atributos do pedido provisório alterados

É acionado quando são adicionados, removidos ou alterados atributos personalizados num pedido provisório.


Incêndios provocados por	Shopify Webhook e deteção de alterações
Autorização	Pedido provisório de acesso aos dados do projeto de decisão
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O respetivo botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Reaja a um número de ordem de compra ou a uma semana de entrega solicitada, armazenados como um atributo.

O que a função «Atributos dos pedidos provisórios alterados» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`draftOrder`	Objeto	O pedido provisório cujos atributos personalizados foram alterados
`draftOrder.id`	ID
`draftOrder.name`	Texto
`draftOrder.status`	Texto
`changes`	Objeto	Foram detetadas alterações nos atributos. Cada item possui um «changeType» (adicionado, removido ou alterado), a chave e os valores antigo e novo.
`changes.items`	Lista de objetos	Lista das alterações de atributos detetadas
`changes.items (each).changeType`	Texto	Tipo de alteração: adicionado, removido, alterado
`changes.items (each).key`	Texto	A chave do atributo
`changes.items (each).oldValue`	Texto	O valor anterior (cadeia de caracteres vazia quando changeType é 'added')
`changes.items (each).newValue`	Texto	O novo valor (cadeia de caracteres vazia quando changeType for «removed»)
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Obter o número de um pedido de compra

Selecione «Atributos do pedido provisório alterados» como gatilho.
Adicionar uma condição: Pelo menos um dos seguintes **elementos - changes.items - ** tem key igual a po_number.
Adicione «Enviar pedido HTTP» ao ERP com o novo valor.
Ative o fluxo de trabalho.

Alteração do endereço de e-mail para pedidos provisórios

É acionado quando o endereço de e-mail de um pedido provisório é alterado. Contém o endereço atual.


Incêndios provocados por	Shopify Webhook e deteção de alterações
Autorização	Pedido provisório de acesso aos dados do projeto de decisão
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que este fique ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Certifique-se de que as faturas são enviadas para a morada correta.

O que a função «Alteração do pedido provisório do e-mail de encomenda» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`draftOrder`	Objeto	O pedido provisório cujo endereço de e-mail foi alterado
`draftOrder.id`	ID
`draftOrder.name`	Texto
`draftOrder.status`	Texto
`draftOrder.note`	Texto
`email`	Texto	O endereço de e-mail atual do pedido provisório
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Reenviar a fatura após uma correção por e-mail

O e-mail relativo ao pedido provisório foi alterado no Shopify Flow.
Adicione uma condição: draftOrder.status é igual a invoice_sent.
Adicione: Envie um e-mail interno a solicitar ao representante que reenvie a fatura.
Ative o fluxo de trabalho.

Alteração do endereço de entrega de um pedido provisório

É acionado quando a morada de entrega de um pedido provisório é alterada.


Incêndios provocados por	Shopify webhook e deteção de alterações
Autorização	Acesso aos dados do projeto de decisão
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize ativa-o. O respetivo botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Recalcular os portes de envio ou os impostos de uma cotação quando o destino for alterado.

O que a notificação «Alteração da morada de envio (pedido provisório)» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`draftOrder`	Objeto	Um pedido provisório cuja morada de entrega foi alterada
`draftOrder.id`	ID
`draftOrder.name`	Texto
`draftOrder.status`	Texto
`draftOrder.note`	Texto
`shippingAddress`	Texto	O endereço de envio (entrega) atual do pedido provisório, apresentado numa única linha formatada (pode estar vazio)
`shippingAddressDetails`	Objeto	O pedido provisório possui a morada de envio (entrega) atual, sob a forma de campos estruturados (pode estar em branco)
`shippingAddressDetails.firstName`	Texto	Nome próprio que consta na morada
`shippingAddressDetails.lastName`	Texto	Apelido que consta na morada
`shippingAddressDetails.name`	Texto	Nome completo, derivado de «firstName» e «lastName»
`shippingAddressDetails.company`	Texto	Nome da empresa ou organização
`shippingAddressDetails.address1`	Texto	Primeira linha - morada ou número de caixa postal
`shippingAddressDetails.address2`	Texto	Segunda linha - apartamento, suite ou unidade
`shippingAddressDetails.city`	Texto	Cidade, distrito, aldeia ou vila
`shippingAddressDetails.province`	Texto	Região - província, estado ou distrito
`shippingAddressDetails.provinceCode`	Texto	Código da região (por exemplo, ON)
`shippingAddressDetails.zip`	Texto	Código postal ou ZIP
`shippingAddressDetails.country`	Texto	Nome do país
`shippingAddressDetails.countryCode`	Texto	Código de país de duas letras (por exemplo, US)
`shippingAddressDetails.phone`	Texto	Número de telefone indicado na morada
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Assinalar as cotações cujo país de destino se alterou

Os pedidos provisórios e a morada de envio foram alterados no Shopify Flow.
Adicione as etiquetas recheck-shipping ao seu pedido provisório e mencione {{shippingAddressDetails.countryCode}} num e-mail interno.
Ative o fluxo de trabalho.

Alteração do endereço de faturação do pedido provisório

É acionado quando a morada de faturação de um pedido provisório é alterada.


Incêndios provocados por	Shopify Webhook e deteção de alterações
Autorização	Acesso aos dados do projeto de decisão
Ligado	Ao ativar um fluxo de trabalho do Shopify Flow que o utilize, este fica ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Mantenha atualizado o registo do devedor no sistema ERP antes da emissão da fatura.

O que a notificação «Alteração do endereço de faturação do pedido provisório» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`draftOrder`	Objeto	Um pedido provisório cujo endereço de faturação sofreu uma alteração
`draftOrder.id`	ID
`draftOrder.name`	Texto
`draftOrder.status`	Texto
`draftOrder.note`	Texto
`billingAddress`	Texto	O endereço de faturação atual do pedido provisório, apresentado numa única linha formatada (pode estar em branco)
`billingAddressDetails`	Objeto	O endereço de faturação atual do pedido provisório, sob a forma de campos estruturados (pode estar vazio)
`billingAddressDetails.firstName`	Texto	Nome próprio que consta na morada
`billingAddressDetails.lastName`	Texto	Apelido que consta na morada
`billingAddressDetails.name`	Texto	Nome completo, derivado de «firstName» e «lastName»
`billingAddressDetails.company`	Texto	Nome da empresa ou organização
`billingAddressDetails.address1`	Texto	Primeira linha - endereço ou número de caixa postal
`billingAddressDetails.address2`	Texto	Segunda linha - apartamento, suite ou unidade
`billingAddressDetails.city`	Texto	Cidade, distrito, aldeia ou vila
`billingAddressDetails.province`	Texto	Região - província, estado ou distrito
`billingAddressDetails.provinceCode`	Texto	Código da região (por exemplo, ON)
`billingAddressDetails.zip`	Texto	Código postal
`billingAddressDetails.country`	Texto	Nome do país
`billingAddressDetails.countryCode`	Texto	Código de país de duas letras (por exemplo, US)
`billingAddressDetails.phone`	Texto	Número de telefone indicado na morada
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Atualizar o ERP antes da emissão da fatura

Ordem de seleção no pedido provisório: endereço de faturação alterado no Shopify Flow.
Adicione a opção «Enviar pedido HTTP» com {{draftOrder.id}} e os campos de billingAddressDetails.
Ative o fluxo de trabalho.

Próximos passos

Um pedido provisório não é um tipo de referência do Shopify Flow; por isso, estes gatilhos devolvem um objeto draftOrder com o id, o nome e o estado. Para qualquer outra situação, adicione um passo «Enviar pedido à API de administração» ou «Executar código» com a opção draftOrder.id.

Referência completa sobre os gatilhos - todos os gatilhos numa única página.
Escolher o gatilho certo - qual é a opção mais adequada ao seu caso.
Gatilhos personalizados - quando nenhum gatilho integrado for adequado, crie o seu próprio.
Histórico de eventos e resolução de problemas - ver o que disparou e o que transportava.
Acionar gatilhos na página de administração de um registo - os eventos mais recentes de um registo, na sua própria página no painel de administração do Shopify.