Gatilhos de pedidos, passo a passo

Gatilhos de pedidos, passo a passo

Copiar página

Dez gatilhos para tags, notas, atributos, itens de linha e status de pedidos no Shopify Flow, com tutoriais passo a passo.

Shopify Flow possui bons gatilhos para os principais momentos de um pedido: criado, pago, processado, cancelado. O que falta são todos os eventos intermediários. Esses dez gatilhos são acionados pelas alterações que ocorrem em um pedido após sua criação, cada um com detalhes sobre o que foi alterado.

Nesta página: Atualização do pedido, Adicionadas tags ao pedido, Tags removidas do pedido, Nota do pedido alterada, Atributos do pedido alterados, Itens da linha do pedido alterados, Atendimento do pedido alterado, Status de exibição do pedido alterado, Status financeiro do pedido alterado, Endereço de entrega do pedido alterado

Shopify Flow
Onde encontrá-los: em Shopify Flow, selecione “Selecionar um gatilho”, acesse Workflow Trigger Extensions e pesquise por “Pedido”.

Atualização do pedido

É acionado a cada atualização de um pedido. Ele contém um changes: os campos rastreados que foram alterados (status financeiro, status de processamento, tags, notas, itens de linha, atributos personalizados) com o valor anterior e o valor posterior.

Incêndios causados por Shopify webhook e detecção de alterações
Permissão Acesso aos dados do pedido
Ligado Ativar um fluxo de trabalho do Flow que o utilize aciona esse recurso. O botão de ativação específico para ele está na página “Gatilhos” do aplicativo

Utilize-o para

  • Um fluxo de trabalho que responde a diversos tipos de alterações em pedidos.
  • Um registro de alterações dos pedidos para o atendimento ao cliente.

O que a função “Atualização de Pedido” envia ao seu fluxo de trabalho

Variável em Shopify Flow Tipo O que contém
order Pedido (Shopify) O pedido que foi atualizado. Trata-se de um pedido completo do Shopify, portanto, todos os seus campos e as ações específicas do Shopify Flow relacionadas a pedidos estão disponíveis.
payload Texto Objeto JSON contendo o GID do pedido que foi atualizado (por exemplo, {"id":"gid://shopify/Order/123"})
changes Objeto Quais campos monitorados foram alterados (situação financeira, status de processamento, tags, nota, itens de linha, atributos personalizados), com o valor antigo e o novo de cada um
changes.fields Lista de textos Nomes dos campos monitorados que sofreram alterações
changes.items Lista de objetos Valor antigo e novo por campo alterado
changes.items (each).field Texto O campo que foi alterado: financialStatus, fulfillmentStatus, tags, note, lineItems ou customAttributes.
changes.items (each).oldValue Texto O valor antes da atualização. Os valores longos são encurtados
changes.items (each).newValue Texto O valor após a atualização. Os valores longos são encurtados
eventId Texto O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para ver exatamente o que foi enviado.

Exemplo: Registre as alterações rastreadas no pedido na linha do tempo do pedido por meio do seu serviço de atendimento ao cliente

  1. Selecione “Atualização do pedido de separação” como gatilho.
  2. Adicionar uma condição: changes.fields Não estiver vazio e existir.
  3. Adicione a opção “Enviar solicitação HTTP” ao seu helpdesk com {{order.name}} no corpo da mensagem. Os campos de texto do Shopify Flow aceitam Liquid; portanto, um loop for sobre changes.items adiciona uma linha por alteração com seus field, oldValue e newValue.
  4. Ative o fluxo de trabalho.

Tags de pedido adicionadas

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

Incêndios causados por Shopify webhook e detecção de alterações
Permissão Acesso aos dados do pedido
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

  • Permita que os funcionários iniciem um processo utilizando as seguintes tags: gift-wrap, hold, priority.
  • Reaja às tags provenientes de aplicativos de combate à fraude, assinaturas ou processamento de pedidos.

O que o recurso “Tags de Pedido Adicionadas” envia para o seu fluxo de trabalho

Variável em Shopify Flow Tipo O que contém
order Pedido (Shopify) O pedido cujas tags foram alteradas. Trata-se de um pedido completo do tipo Shopify, portanto, todos os seus campos e as ações de pedido próprias do Shopify Flow estão disponíveis.
addedTags Texto Lista separada por vírgulas das tags que foram adicionadas ao pedido
removedTags Texto Lista separada por vírgulas das tags que foram removidas do pedido na mesma atualização (pode estar vazia)
currentTags Texto Lista separada por vírgulas de todas as tags atuais dos pedidos
previousTags Texto Lista separada por vírgulas de todas as tags anteriores no pedido anterior a esta 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: Suspenda o processamento de um pedido quando ele for marcado como “suspenso”

  1. “Tags de pedido de separação adicionadas” foi definido como o gatilho.
  2. Adicionar uma condição: addedTags Inclui hold.
  3. Adicione um ciclo “Para cada” sobre order.fulfillmentOrders com a ação “Suspender o processo de processamento do pedido”.
  4. Ative o fluxo de trabalho. Crie a imagem espelhada com a opção “Remoção de etiquetas de pedido” e “Liberar a retenção do pedido de processamento”.

Etiquetas de pedidos removidas

É acionado quando pelo menos uma tag é removida de um pedido.

Incêndios causados por Shopify webhook e detecção de alterações
Autorização Acesso aos dados do pedido
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

  • Liberte o que uma tag estava impedindo.
  • Encerre uma tarefa quando a tag needs-review for removida.

O que o recurso “Remover etiquetas de pedidos” envia para o seu fluxo de trabalho

Variável em Shopify Flow Tipo O que contém
order Pedido (Shopify) O pedido cujas tags foram alteradas. Trata-se de um pedido completo do Shopify, portanto, todos os seus campos e as ações próprias do Shopify Flow relacionadas a pedidos estão disponíveis.
removedTags Texto Lista separada por vírgulas das tags que foram removidas do pedido
addedTags Texto Lista separada por vírgulas das tags que foram adicionadas ao pedido na mesma atualização (pode estar vazia)
currentTags Texto Lista separada por vírgulas de todas as tags atuais do pedido
previousTags Texto Lista separada por vírgulas de todas as tags anteriores no pedido anterior a esta 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: Liberar o bloqueio quando o tag for removido

  1. As etiquetas de pedido de separação foram removidas como gatilho.
  2. Adicionar uma condição: removedTags inclui hold.
  3. Adicione um ciclo “Para cada” sobre order.fulfillmentOrders com a opção “Liberar retenção do pedido de processamento”.
  4. Ative o fluxo de trabalho.

Nota do pedido alterada

É acionado quando uma nota de pedido é adicionada, alterada ou cancelada, seja pela equipe ou pelo cliente durante as edições no momento do checkout.

Incêndios causados por Shopify Webhook e detecção de alterações
Permissão Acesso aos dados do pedido
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

  • Notifique o almoxarifado sobre as observações adicionadas após a realização do pedido.
  • Analise as instruções de entrega.

O que a nota “Alteração no pedido” envia para o seu fluxo de trabalho

Variável em Shopify Flow Tipo O que contém
order Pedido (Shopify) O pedido cuja nota foi alterada. Trata-se de um pedido completo do Shopify, portanto, todos os seus campos e as ações próprias do Shopify Flow relacionadas a pedidos estão disponíveis.
oldNote Texto A nota anterior do pedido (vazia caso a nota não tenha sido definida anteriormente)
newNote Texto A nova observação no pedido (vazia 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: Notificar o almoxarifado sobre um atraso

  1. “Alteração na nota de pedido de separação” foi definida como o gatilho.
  2. Adicionar uma condição: order.displayFulfillmentStatus não é igual a FULFILLED.
  3. Adicione “Enviar e-mail interno”: {{order.name}} note changed from "{{oldNote}}" to "{{newNote}}".
  4. Ative o fluxo de trabalho.

Atributos dos pedidos alterados

É disparado quando os atributos personalizados de um pedido (atributos do carrinho, atributos de notas) são adicionados, removidos ou alterados. Cada item em changes.items possui um changeType, o key e ambos os valores.

Incêndios causados por Shopify webhook e detecção de alterações
Autorização Acesso aos dados do pedido
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

  • Reaja aos atributos inseridos por um seletor de data de entrega, uma opção de presente ou um formulário B2B.
  • Detectar quando um funcionário corrige um atributo após o pedido.

O que o recurso “Atributos do pedido alterados” envia para o seu fluxo de trabalho

Variável em Shopify Flow Tipo O que contém
order Pedido (Shopify) O pedido cujos atributos personalizados foram alterados. Trata-se de um pedido completo do tipo Shopify, portanto, todos os seus campos e as ações próprias do Shopify Flow relacionadas a pedidos estão disponíveis.
changes Objeto Alterações detectadas 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 detectadas
changes.items (each).changeType Texto Tipo de alteração: adicionado, removido, alterado
changes.items (each).key Texto A chave do atributo (também conhecida como nome do atributo da nota)
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: Reagir a uma alteração na data de entrega

  1. “Atributos do pedido de separação alterados” como gatilho.
  2. Adicionar uma condição: Pelo menos um dos seguintes valores - changes.items - tenha key igual a delivery_date.
  3. Adicione “Enviar e-mail interno”. Os campos de texto do Shopify Flow aceitam Liquid; portanto, um loop for sobre changes.items exibe o endereço key de cada entrada, juntamente com oldValue e newValue.
  4. Ative o fluxo de trabalho.

Itens de linha alterados

É acionado quando um pedido é editado: um item é adicionado ou removido, ou quando há alteração na quantidade, no preço ou na variante. Cada registro em changes.items indica o tipo de alteração (added, removed, quantity_changed, price_changed, variant_changed), juntamente com os valores antigos e novos.

Incêndios causados por Shopify Webhook e detecção de alterações
Permissão Acesso aos dados do pedido
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

  • Informe ao depósito que um pedido já separado sofreu alteração.
  • Reexecute as verificações de fraude ou de margem após uma edição.
  • Sincronizar as edições de pedidos com um ERP, o que se torna complicado devido aos webhooks de pedidos do próprio Shopify.

O que o recurso “Itens de linha de pedido alterados” envia para o seu fluxo de trabalho

Variável em Shopify Flow Tipo O que contém
order Pedido (Shopify) O pedido que foi atualizado. Trata-se de um pedido completo do Shopify, portanto, todos os seus campos e as ações específicas do Shopify Flow relacionadas ao pedido estão disponíveis.
changes Objeto Foram detectadas alterações em itens de linha com 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 “removida” 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 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: Interromper a operação do depósito quando um item for retirado

  1. Selecione “Itens de linha alterados” como gatilho.
  2. Adicione uma condição: pelo menos um dos seguintes **elementos - changes.items - ** tenha changeType igual a removed.
  3. Adicione as tags de pedido edited-recheck e envie um e-mail interno que liste os endereços productTitle e variantTitle de cada entrada em changes.items (um loop Liquid for no corpo do e-mail).
  4. Ative o fluxo de trabalho.

Alteração no processamento do pedido

É acionado quando o status de processamento de um pedido é alterado (null, partial, fulfilled, restocked) e em eventos de processamento que ocorram nesse intervalo: uma linha processada, um processamento cancelado, rastreamento adicionado ou alterado.

Incêndios causados por Shopify Webhook e detecção de alterações
Permissão Acesso aos dados do pedido
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

  • Envie sua própria notificação de envio com número de rastreamento.
  • Detectar processamentos cancelados.
  • Atualize o ERP por remessa, em vez de por pedido.

O que o “Alterações no processamento de pedidos” envia para o seu fluxo de trabalho

Variável em Shopify Flow Tipo O que contém
order Pedido (Shopify) O pedido cujo status de processamento foi alterado. Trata-se de um pedido completo do tipo Shopify, portanto, todos os seus campos e as ações próprias do Shopify Flow relacionadas ao pedido estão disponíveis.
oldFulfillmentStatus Texto O status anterior do processamento REST (nulo, parcial, atendido, reabastecido)
newFulfillmentStatus Texto O novo status de processamento REST (nulo, parcial, atendido, reabastecido)
changes Objeto Alterações detectadas no processamento de pedidos, com detalhes
changes.items Lista de objetos Lista das alterações detectadas
changes.items (each).changeType Texto Tipo de alteração: status_alterado, item_de_pedido_atendido, item_de_pedido_não_atendido, rastreamento_atualizado
changes.items (each).lineItemId ID ID do item de linha (para line_item_fulfilled/unfulfilled)
changes.items (each).productTitle Texto Título do produto
changes.items (each).variantTitle Texto Variante del título
changes.items (each).oldFulfillmentStatus Texto Status anterior de processamento (por exemplo: nulo, parcial, atendido, reabastecido)
changes.items (each).newFulfillmentStatus Texto Novo status de processamento (por exemplo: nulo, parcial, atendido, reabastecido)
changes.items (each).fulfillmentId ID ID de processamento (para tracking_updated)
changes.items (each).trackingNumber Texto Número de rastreamento
changes.items (each).trackingUrl Texto URL de rastreamento
changes.items (each).trackingCompany Texto Empresa de rastreamento
eventId Texto O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Encaminhar novos números de rastreamento

  1. “Alteração no processamento do pedido de separação” foi definido como o gatilho.
  2. Adicione um “For each” sobre changes.items.
  3. Dentro do loop, adicione uma condição: o campo trackingNumber do item do loop não esteja vazio e exista.
  4. Adicione “Enviar solicitação HTTP” com {{order.name}} e os valores trackingNumber e trackingUrl do item do loop. Selecione-os com “Adicionar variável”: o Shopify Flow exibe o item do loop ao lado dos dados do gatilho.
  5. Ative o fluxo de trabalho.

Alteração do status de exibição do pedido

É acionado quando o status de processamento, conforme exibido pelo administrador, é alterado: unfulfilled, in_progress, on_hold, scheduled, partially_fulfilled, fulfilled. O endereço Shopify não envia nenhum webhook para esses casos; portanto, o aplicativo verifica periodicamente.

Incêndios causados por Verificado periodicamente, pois o Shopify não envia nenhum webhook para isso
Permissão Acesso aos dados do pedido
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

  • Reaja quando um serviço de processamento de pedidos ou um PDV marcar um pedido como “Em andamento”.
  • Encaminhe para instâncias superiores os pedidos que estiverem em espera.

O que a notificação “Status da exibição do pedido alterado” envia ao seu fluxo de trabalho

Variável em Shopify Flow Tipo O que contém
order Pedido (Shopify) O pedido cujo status de processamento de exibição foi alterado. Trata-se de um pedido completo do Shopify, portanto, todos os seus campos e as ações próprias do Shopify Flow relacionadas ao pedido estão disponíveis.
oldDisplayFulfillmentStatus Texto O status anterior do processamento do pedido (por exemplo: não processado, em andamento, parcialmente processado, processado, em espera, agendado)
newDisplayFulfillmentStatus Texto O novo status de processamento do pedido (por exemplo: não processado, em andamento, parcialmente processado, processado, em espera, agendado)
fulfillmentStatus Texto O status atual do processamento do pedido (não processado, parcialmente processado, processado, reabastecido)
changes Objeto Alterações detectadas no status da exibição, com detalhes
changes.items Lista de objetos Lista das alterações detectadas
changes.items (each).changeType Texto Tipo de alteração: order_status_changed, fulfillment_display_status_changed
changes.items (each).fulfillmentId ID ID de processamento (para alterações no status de exibição por processamento)
changes.items (each).oldDisplayStatus Texto Status anterior da exibição
changes.items (each).newDisplayStatus Texto Novo status de exibição
eventId Texto O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Encaminhar pedidos que ficam em espera

  1. “Alteração do status de exibição do pedido de separação” como gatilho.
  2. Adicione uma condição: newDisplayFulfillmentStatus seja igual a on_hold.
  3. Adicione a opção “Enviar e-mail interno para o atendimento ao cliente” com {{order.name}}.
  4. Ative o fluxo de trabalho.

Alteração na situação financeira do pedido

Incêndios causados por Shopify Webhook e detecção de alterações
Permissão Acesso aos dados do pedido
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 às transferências bancárias e às faturas que são marcadas como pagas dias após o pedido.
  • Informe o departamento de contabilidade sobre os reembolsos.
  • Só libere um pedido de processamento após o pagamento ter sido efetuado.

O que o evento “Alteração do status financeiro do pedido” envia para o seu fluxo de trabalho

Variável em Shopify Flow Tipo O que contém
order Pedido (Shopify) O pedido cuja situação financeira sofreu alteração. Trata-se de um pedido completo do Shopify, portanto, todos os seus campos e as ações de pedido específicas do Shopify Flow estão disponíveis.
oldFinancialStatus Texto O status financeiro anterior (por exemplo, pendente, autorizado, pago)
newFinancialStatus Texto O novo status financeiro (por exemplo, pago, parcialmente reembolsado, reembolsado, anulado)
eventId Texto O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Liberar pedidos B2B quando a fatura for paga

  1. “Alteração do status financeiro do pedido de separação” como gatilho.
  2. Adicione uma condição: oldFinancialStatus seja igual a pending e newFinancialStatus seja igual a paid.
  3. Adicione e remova as tags de pedido awaiting-payment e um ciclo “For each” sobre order.fulfillmentOrders com o processo de processamento de pedidos de liberação.
  4. Ative o fluxo de trabalho.

Alteração do endereço de entrega do pedido

É acionado quando o endereço de entrega de um pedido é alterado após a realização do pedido. shippingAddress exibe tudo em uma única linha, enquanto shippingAddressDetails exibe os campos separadamente.

Incêndios causados por Shopify Webhook e detecção de alterações
Permissão Acesso aos dados de pedidos + Acesso aos dados de clientes
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

  • Interrompa ou redirecione uma remessa quando o endereço for alterado após o início da separação.
  • Execute novamente a validação de endereço ou uma verificação de fraude.

O que o evento “Alteração do endereço de entrega” envia para o seu fluxo de trabalho

Variável em Shopify Flow Tipo O que contém
order Pedido (Shopify) O pedido cujo endereço de entrega foi alterado. Trata-se de um pedido completo do Shopify, portanto, todos os seus campos e as ações de pedido próprias do Shopify Flow estão disponíveis.
shippingAddress Texto O endereço de envio (entrega) atual do pedido, em uma única linha formatada (pode estar vazio)
shippingAddressDetails Objeto O endereço de entrega atual do pedido, na forma de campos estruturados (pode estar em branco)
shippingAddressDetails.firstName Texto Nome próprio que consta 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 da 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 CEP
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 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: Manter um pedido cujo endereço foi alterado

  1. Alteração do endereço de entrega do pedido de separação no Shopify Flow. É necessário acesso aos dados do pedido e do cliente; ao ativá-lo na página “Gatilhos”, o aplicativo solicita ambos em uma única caixa de diálogo.
  2. Adicionar uma condição: order.displayFulfillmentStatus não é igual a FULFILLED.
  3. Adicione as tags de pedido address-changed e envie um e-mail interno para o depósito.
  4. Ative o fluxo de trabalho.

Próximos passos

Por padrão, o aplicativo monitora os pedidos dos últimos 60 dias, conforme concedido por Shopify. Para reagir a alterações em pedidos mais antigos, amplie o histórico de pedidos na página “Permissões”. Consulte Permissões e acesso aos dados.