Como acionar os gatilhos de pedido provisório, passo a passo

Copiar página

Aprenda a configurar 10 gatilhos de pedido provisório no Shopify Flow: status, itens, tags, notas, atributos, e-mail e endereços.

Os pedidos provisórios são onde ficam as cotações B2B, os pedidos no atacado e os pedidos por telefone, e o Shopify Flow praticamente não oferece nada para eles. Esses dez gatilhos abrangem todo o ciclo de vida de um pedido provisório: edições, status, tags, notas e, mediante opção, os dados de contato.

Nesta página: Atualização do rascunho do pedido, Alteração do status do rascunho do pedido, Alteração dos itens do rascunho do pedido, Adição de tags ao rascunho do pedido, Remoção de tags do rascunho do pedido, Alteração da nota do rascunho do pedido, Alteração dos atributos do rascunho do pedido, Alteração do e-mail do rascunho do pedido, Alteração do endereço de entrega do rascunho do pedido, Alteração do endereço de cobrança do rascunho do pedido

Atualização do projeto de portaria

Aciona a cada salvamento de um pedido provisório.


Incêndios causados por	Shopify webhook
Permissão	Acesso aos dados do pedido provisório
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

Importar cotações para um CRM.
Uma opção genérica enquanto o senhor decide qual gatilho mais específico é o mais adequado.

O que a atualização “Pedido provisório” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`draftOrder`	Objeto	O projeto de portaria 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 contendo o GID do pedido provisório que foi atualizado (por exemplo, {"id":"gid://shopify/Pedido provisório/123"})
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

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

Selecione “Atualização do pedido provisório” como gatilho.
Adicione a opção “Enviar solicitação HTTP” com {{draftOrder.id}}, {{draftOrder.name}}, {{draftOrder.status}} e {{draftOrder.totalPrice}} {{draftOrder.currencyCode}}.
Ative o fluxo de trabalho.

Alteração no status do pedido provisório

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


Incêndios causados por	Shopify Webhook e detecção de alterações
Permissão	Acesso aos dados do pedido provisório
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

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

O que o evento “Alteração do status do pedido provisório” transmite ao seu fluxo de trabalho

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

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

Selecione “Alteração do status do pedido provisório” como gatilho.
Adicione uma condição: newStatus seja igual a invoice_sent.
Adicione: Aguarde 3 dias e, em seguida, envie uma solicitação HTTP para sua ferramenta de e-mail usando {{draftOrder.name}}.
Ative o fluxo de trabalho.

Itens de linha do pedido provisório foram alterados

É 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 causados por	Shopify webhook e detecção de alterações
Permissão	Acesso aos dados do pedido provisório
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

Exigir aprovação quando um representante de vendas reduzir o preço de uma cotação.
Mantenha um sistema de reservas em sincronia com as cotações.

O que o relatório “Itens de linha do pedido provisório alterados” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`draftOrder`	Objeto	O rascunho do 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, exclusões, alterações na quantidade, no preço e nas variantes, com seus valores antigos e novos
`changes.items`	Lista de objetos	Lista das alterações detectadas
`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	Título de variante
`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 com alteração de variante)
`changes.items (each).newProductId`	ID	GID do novo produto (para adição ou alteração de variante)
`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 no formato JSON
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Solicite aprovação quando o preço de uma cotação 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 - ** tenha changeType igual a price_changed.
Adicione as tags de pedido provisório needs-approval e envie um e-mail interno ao responsável pelas vendas com os campos oldPrice e newPrice das entradas alteradas (um loop Liquid for sobre changes.items).
Ative o fluxo de trabalho.

Adicionadas tags de pedido provisório

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


Incêndios causados por	Shopify webhook e detecção de alterações
Permissão	Acesso aos dados do pedido provisório
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

Que a equipe de vendas inicie um processo marcando uma cotação: approved, rush.

O que a função “Adicionar tags de pedidos provisórios” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`draftOrder`	Objeto	O rascunho do pedido provisório cujas tags 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 do pedido provisório na mesma atualização (pode estar vazia)
`currentTags`	Texto	Lista separada por vírgulas de todas as etiquetas atuais nos pedidos provisórios
`previousTags`	Texto	Lista separada por vírgulas de todas as tags anteriores nos pedidos provisórios antes desta atualização
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para ver exatamente o que foi enviado.

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

As tags “Pedido provisório” foram adicionadas 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 pedidos provisórios removidas

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


Incêndios causados por	Shopify Webhook e detecção de alterações
Permissão	Acesso aos dados de pedidos provisórios
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

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

O que a função “Remoção de tags de pedidos provisórios” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`draftOrder`	Objeto	O rascunho do pedido provisório cujas tags 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 na mesma atualização (pode estar vazia)
`removedTags`	Texto	Lista separada por vírgulas das tags que foram removidas do pedido provisório
`currentTags`	Texto	Lista separada por vírgulas de todas as tags atuais no pedido provisório
`previousTags`	Texto	Lista separada por vírgulas de todas as tags anteriores no pedido provisório antes desta atualização
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

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

As tags “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 sobre o pedido provisório alterado

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


Incêndios causados por	Shopify Webhook e detecção de alterações
Permissão	Acesso aos dados do pedido provisório
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

Encaminhe as observações internas sobre uma cotação à equipe seguinte.

O que a nota “Alterações no 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 sobre o pedido provisório (vazia caso a nota não tenha sido definida anteriormente)
`newNote`	Texto	A nova observação no pedido provisório (em branco caso a observação tenha sido apagada)
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

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

A opção “Nota sobre a ordem do pedido provisório” foi alterada como gatilho.
Adicione a função “Enviar solicitação HTTP para o Slack” com o {{draftOrder.name}}: {{newNote}}.
Ative o fluxo de trabalho.

Alterações nos atributos do pedido provisório

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


Incêndios causados por	Shopify Webhook e detecção de alterações
Permissão	Acesso aos dados do pedido provisório
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

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 rascunho do pedido provisório cujos atributos personalizados foram alterados
`draftOrder.id`	ID
`draftOrder.name`	Texto
`draftOrder.status`	Texto
`changes`	Objeto	Alterações de atributos detectadas. 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 detectadas
`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 vazia quando changeType é 'added')
`changes.items (each).newValue`	Texto	O novo valor (cadeia vazia quando changeType for 'removed')
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Identificar um número de pedido de compra

Selecione “Atributos dos pedidos provisórios alterados” como o gatilho.
Adicionar uma condição: Pelo menos um dos seguintes **elementos - changes.items - ** possui key igual a po_number.
Adicione a opção “Enviar solicitação HTTP ao ERP com o novo valor”.
Ative o fluxo de trabalho.

Alteração no e-mail de confirmação do pedido provisório

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


Incêndios causados por	Shopify Webhook e detecção de alterações
Permissão	Acesso aos dados do pedido provisório
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

Certifique-se de que as faturas sejam enviadas para o endereço correto.

O que o e-mail “Alteração no 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 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 do aplicativo para verificar exatamente o que foi enviado.

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

O e-mail do pedido provisório foi alterado no Shopify Flow.
Adicione uma condição: draftOrder.status seja igual a invoice_sent.
Adicione: Envie um e-mail interno solicitando 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 o endereço de entrega de um pedido provisório é alterado.


Incêndios causados por	Shopify Webhook e detecção de alterações
Permissão	Acesso aos dados do pedido provisório
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

Recalcular o frete ou os impostos de um orçamento quando o destino for alterado.

O que o pedido provisório “Endereço de entrega alterado” 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 entrega foi alterado
`draftOrder.id`	ID
`draftOrder.name`	Texto
`draftOrder.status`	Texto
`draftOrder.note`	Texto
`shippingAddress`	Texto	O endereço de entrega atual do pedido provisório, em uma única linha formatada (pode estar em branco)
`shippingAddressDetails`	Objeto	O endereço de envio (entrega) atual do pedido provisório, na forma de campos estruturados (pode estar em branco)
`shippingAddressDetails.firstName`	Texto	Nome no endereço
`shippingAddressDetails.lastName`	Texto	Sobrenome que consta no endereço
`shippingAddressDetails.name`	Texto	Nome completo, derivado de firstName e lastName
`shippingAddressDetails.company`	Texto	Nome da empresa ou organização
`shippingAddressDetails.address1`	Texto	Primeira linha - endereço ou número de caixa postal
`shippingAddressDetails.address2`	Texto	Segunda linha - apartamento, suíte ou unidade
`shippingAddressDetails.city`	Texto	Cidade, distrito, vila ou município
`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 que consta no endereço
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Identificar cotações cujo país de destino tenha mudado

Pedido provisório e endereço de entrega alterados no Shopify Flow.
Adicione as tags recheck-shipping ao pedido provisório e mencione {{shippingAddressDetails.countryCode}} em um e-mail interno.
Ative o fluxo de trabalho.

Alteração do endereço de cobrança do pedido provisório

É acionado quando o endereço de cobrança de um pedido provisório é alterado.


Incêndios causados por	Shopify Webhook e detecção de alterações
Permissão	Acesso aos dados do pedido provisório
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize significa ativá-lo. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

Mantenha atualizado o registro do devedor no sistema ERP antes da emissão da nota fiscal.

O que o pedido provisório “Endereço de cobrança alterado” 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 cobrança foi alterado
`draftOrder.id`	ID
`draftOrder.name`	Texto
`draftOrder.status`	Texto
`draftOrder.note`	Texto
`billingAddress`	Texto	O endereço de cobrança atual do pedido provisório, apresentado em uma única linha formatada (pode estar em branco)
`billingAddressDetails`	Objeto	O endereço de cobrança atual do pedido provisório, na forma de campos estruturados (pode estar em branco)
`billingAddressDetails.firstName`	Texto	Nome próprio que consta no endereço
`billingAddressDetails.lastName`	Texto	Sobrenome que consta no endereço
`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, suíte ou unidade
`billingAddressDetails.city`	Texto	Cidade, distrito, vila ou município
`billingAddressDetails.province`	Texto	Região - província, estado ou distrito
`billingAddressDetails.provinceCode`	Texto	Código de região (por exemplo, ON)
`billingAddressDetails.zip`	Texto	Código postal ou CEP
`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 no endereço
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Atualize o ERP antes de emitir a nota fiscal

Pedido provisório no Shopify Flow; endereço de cobrança alterado no Shopify Flow.
Adicione a opção “Enviar solicitação 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; portanto, esses gatilhos retornam um objeto draftOrder com os campos id, name e status. Para qualquer outra situação, adicione uma etapa “Enviar solicitação da API de administração” ou “Executar código” com draftOrder.id.

Referência completa sobre gatilhos - todos os gatilhos em uma única página.
Escolhendo o gatilho certo - qual deles se aplica ao seu caso.
Gatilhos personalizados - quando nenhum gatilho integrado for adequado, crie o seu próprio.
Histórico de eventos e solução de problemas - verificar o que foi disparado e o que estava carregado.
Acionar gatilhos na página de administração de um registro - os eventos mais recentes de um registro, em sua própria página no painel de administração do Shopify.