O gatilho de atualização de pedidos do Shopify Flow e os gatilhos de pedidos desta aplicação

O gatilho de atualização de pedidos do Shopify Flow e os gatilhos de pedidos desta aplicação

Copiar página

Os campos que o gatilho Pedido atualizado do Shopify Flow monitoriza e envia, comparados com dez gatilhos de pedido que mostram o valor antes e depois.

O gatilho Pedido atualizado do Shopify Flow inicia um fluxo de trabalho quando um dos até cinco campos do pedido sofre uma alteração. A página de ajuda da Shopify descreve o que o fluxo de trabalho recebe em duas frases: «O gatilho “Pedido atualizado” fornece apenas os valores atuais do pedido e dos seus itens de linha.» e «Os valores anteriores dos campos que sofreram alterações não estão disponíveis no fluxo de trabalho.»

Esta aplicação dispõe de dez gatilhos para alterações a um pedido existente. Cada um deles é acionado para um tipo específico de alteração e apresenta os valores antes e depois da mesma. Esta página apresenta ambos lado a lado, campo a campo, para que possa escolher de acordo com o fluxo de trabalho.

O que se pode ver na série «Order» atualizada

Os campos da página de ajuda do Shopify, a partir de 20 de novembro de 2026:

Grupo Campos
Pedido cancellation, customAttributes, displayFinancialStatus, displayFulfillmentStatus, email, metafield.value, note, phone, tags
Totais subtotalPriceSet, totalCapturableSet, totalDiscountsSet, totalPriceSet, totalReceivedSet, totalRefundedSet, totalRefundedShippingSet, totalShippingPriceSet, totalTaxSet, totalTipReceivedSet
Itens de linha lineItems.currentQuantity, lineItems.customAttributes, lineItems.discountedTotalSet, lineItems.discountedUnitPriceAfterAllDiscountsSet, lineItems.discountedUnitPriceSet, lineItems.duties, lineItems.merchantEditable, lineItems.originalTotalSet, lineItems.priceAfterAllDiscountsBeforeTaxesSet, lineItems.quantity, lineItems.taxLines
Companhias de navegação shippingLines

O que a página da Shopify acrescenta:

  • Deve selecionar, no mínimo, um campo e, no máximo, cinco. Uma definição de metacampo ou um espaço de nomes completo conta como um dos cinco.
  • Um campo que termine em Set contém um montante em duas moedas. Qualquer alteração a qualquer um dos montantes dá início ao fluxo de trabalho. Para monitorizar um deles, selecione o campo shopMoney ou presentmentMoney.
  • A adição de um item de linha é considerada uma alteração nesse item de linha, e a adição ou remoção de uma linha de envio dá início a um fluxo de trabalho que monitoriza shippingLines.
  • Quando analisa em conjunto os campos do pedido e os campos do item de linha, a variável «Item de linha» pode estar vazia quando o fluxo de trabalho for executado.
  • No caso de um novo pedido, o Shopify indica o gatilho «Pedido criado».

Não constam da lista: a morada de envio e de faturação, o cliente, os números de processamento de encomendas e de acompanhamento, bem como as transações.

Campo a campo

O que mudou Pedido da Shopify Flow atualizado Gatilho desta aplicação O que o fluxo de trabalho ganha com isso
Tags tags: a lista de tags após a alteração Tags de pedido adicionadas, tags de pedido removidas addedTags, removedTags, previousTags, currentTags
Nota note: a nova nota Nota do pedido alterada oldNote, newNote
Estado do pagamento displayFinancialStatus: o novo estado Alteração do estado financeiro do pedido oldFinancialStatus, newFinancialStatus
Estado do processamento da encomenda displayFulfillmentStatus: o novo estado Alteração no processamento dos pedidos, alteração no estado de visualização dos pedidos o estado antes e depois, cada item de linha que foi ou não processado, cada atualização de rastreio com número, URL e transportadora, e o estado de entrega de cada envio antes e depois
Atributos personalizados customAttributes: os atributos após a alteração Atributos do pedido alterados por atributo em changes.items: changeType (adicionado, removido, alterado), key, oldValue, newValue
Itens de linha lineItems.quantity, lineItems.currentQuantity e mais nove, valores atuais Alterações nos itens de linha do pedido por linha em changes.items: changeType (adicionado, removido, quantidade_alterada, preço_alterado, variante_alterada) com a quantidade, o preço e a variante antigos e novos
Endereço de entrega não consta da lista Alteração da morada de entrega do pedido shippingAddress e oldShippingAddress, e cada parte de ambos como um campo próprio
Metacampo «Pedido» metafield.value: o novo valor Atualização do metacampo de pedido metafield.value, metafield.previousValue
Totais um total de dez campos, cada um em duas moedas Atualização do pedido, ou o modelo de gatilho personalizado Total do pedido alterado (antes e depois) o total antes e depois
E-mail, telefone, cancelamento, companhias de navegação email, phone, cancellation, shippingLines A função «Order Update» é acionada nestas atualizações. Nenhum gatilho desta aplicação mantém o seu valor anterior
Qualquer número destes num único fluxo de trabalho cinco, no máximo Atualização do pedido, limitada aos campos que assinalar changes.fields e changes.items com field, oldValue e newValue

Gatilhos de pedidos, passo a passo apresenta um exemplo prático para cada um dos dez gatilhos de pedido.

O que observámos quando ambos foram executados no mesmo pedido

A 20 de novembro de 2026, criámos um pedido numa loja de desenvolvimento e alterámo-lo em momentos específicos, com um fluxo de trabalho no pedido atualizado e os gatilhos desta aplicação ativos em simultâneo. A tabela completa encontra-se em Os gatilhos atualizados do Flow e as Workflow Trigger Extensions. Três resultados são relevantes para os fluxos de trabalho dos pedidos:

  • A criação foi considerada uma alteração. O pedido foi criado a partir de um pedido provisório. Antes de alguém o ter editado, o processo «Pedido atualizado» já tinha sido acionado duas vezes: uma vez para o estado financeiro e outra para o estado de processamento. Os gatilhos desta aplicação registam um novo pedido e são acionados a partir da sua primeira alteração efetiva.
  • Cada gravação corresponde a uma execução. Três tags adicionadas no espaço de um segundo deram origem a três execuções. Duas delas já apresentavam as três tags, pelo que o mesmo estado foi tratado mais do que uma vez. Esta aplicação enviou um evento que enumerava as três tags.
  • Uma execução apresenta a ordem tal como se apresenta no momento da execução. Duas alterações de nota num intervalo de um segundo deram origem a duas execuções, e ambas apresentaram a nota final. A função «Order Note Changed» enviou um evento com a nota anterior à primeira alteração e a nota posterior à última.
Os gatilhos Flow que acionam a aplicação na página de pedidos: alteração do estado financeiro de «pendente» para «pago» e adição de uma nota
A página do pedido no painel de administração do Shopify com o bloco de eventos desta aplicação: o estado antes e depois, e a nota que foi adicionada.

Fluxos de trabalho que necessitam do valor antes de

Liberte um pedido quando for recebido um pagamento pendente. Alteração do estado financeiro do pedido com a condição oldFinancialStatus igual a pending e newFinancialStatus igual a paid. Um fluxo de trabalho que apenas considere o estado «pago» não consegue distinguir este pedido de um que tenha sido pago no momento do Checkout. Pronto a utilizar: Assinalar os pedidos quando for recebido um pagamento pendente.

Informe o armazém quando a morada for alterada após o checkout. A mensagem «Morada de envio do pedido alterada» inclui a morada anterior e a nova, pelo que a mensagem pode indicar para onde o pedido se destinava e para onde se destina agora. Pronto a utilizar: Assinalar os pedidos quando a morada de entrega for alterada após o checkout.

Revisar pedidos editados. A lista «Itens de linha do pedido alterados» apresenta cada linha que foi adicionada, removida ou alterada, com a quantidade antes e depois. Uma condição no changeType distingue um item removido de uma quantidade alterada. Pronto a utilizar: Assinalar os pedidos quando os respetivos itens de linha forem editados.

Aja em relação a uma tag. As tags «Tags Adicionadas no Pedido» e «Tags Removidas no Pedido» indicam as tags que sofreram alterações. Consulte Executar um fluxo de trabalho quando uma tag específica for adicionada ou removida.

Reaja a uma alteração na mensagem de presente ou na data de entrega. A entrada «Atributos do pedido alterados» contém a chave de cada atributo que foi alterado, juntamente com o seu valor antigo e o novo, para que um fluxo de trabalho possa agir sobre um atributo e ignorar os restantes.

O fluxo de trabalho no Shopify Flow: marcar pedidos quando for recebido um pagamento pendente
O modelo para um pagamento pendente que chega: o gatilho, uma condição relativa ao estado anterior e ao novo, uma ação.

Quando «Pedido atualizado» é a escolha certa

  • Pretende receber um aviso imediato quando um de alguns campos for alterado, sendo que os valores atuais são suficientes.
  • Pode consultar o valor total numa determinada moeda, incluindo gorjetas, direitos aduaneiros, impostos ou custos de envio.
  • Deve verificar os detalhes do e-mail, do telefone ou do cancelamento do pedido.
  • O fluxo de trabalho tem de ser iniciado no prazo de um ou dois segundos após a alteração.

Ambos podem ser executados na mesma loja. Uma alteração que ambos monitorizem dá início a ambos os fluxos de trabalho; por isso, atribua cada tarefa a um deles.

A função «Pedido updated» apresenta o valor anterior?

Não. A página de ajuda da Shopify indica que o gatilho fornece apenas os valores atuais do pedido e dos seus itens de linha. Os gatilhos de pedido desta aplicação apresentam os valores anteriores e posteriores.

A função «Pedido atualizado» é executada quando é criado um pedido?

O Shopify indica o gatilho «Pedido criado» para novos pedidos. No nosso teste, um pedido criado a partir de um pedido provisório ainda assim acionou o gatilho «Pedido atualizado» duas vezes: para o estado financeiro e para o estado de processamento. Adicione uma condição caso um fluxo de trabalho baseado em campos de estado não deva ser acionado em novos pedidos.

É possível obter a morada de envio anterior de um pedido no Shopify Flow?

Sim, com a opção «Alteração da morada de envio do pedido». Esta opção apresenta a morada antes e depois da alteração, como texto formatado e em partes. A morada de envio não consta dos campos que a função «Pedido atualizado» pode monitorizar.

A função «Pedido atualizado» pode indicar-me qual foi a tag adicionada?

Não. Apresenta a lista de tags após a alteração. A secção «Tags adicionadas» indica as tags adicionadas e a secção «Tags removidas» as que foram removidas.

Que pedidos é que esta aplicação monitoriza?

Por predefinição, são apresentados os pedidos dos últimos 60 dias. Pode alargar o intervalo na aplicação para 180 dias, 12 meses, 24 meses ou uma data à sua escolha.

Posso utilizar ambos na mesma loja?

Sim. Não interferem. Decida, para cada fluxo de trabalho, qual o gatilho que o inicia.

Próximos passos