O gatilho de atualização de pedidos do Shopify Flow e os gatilhos de pedidos desta aplicação
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
Setconté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 camposhopMoneyoupresentmentMoney. - 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.

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.

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
- Gatilhos de pedidos, passo a passo - todos os gatilhos de pedido, acompanhados de um exemplo.
- Valores antigos e novos: o que um fluxo de trabalho pode fazer com eles - todos os valores anteriores e posteriores, por gatilho.
- Atualização dos gatilhos relativos ao processamento de pedidos, reembolsos e devoluções, e o que esta aplicação acrescenta - pedidos de processamento, reembolsos e devoluções.
