Valores antigos e novos: o que um fluxo de trabalho pode fazer com eles
Shopify Flow
Os gatilhos atualizados do Flow transmitem ao fluxo de trabalho o registo tal como se encontra neste momento. As páginas de ajuda da Shopify explicam-no para cada um deles: apenas os valores atuais estão disponíveis; os valores anteriores à alteração não estão. Para um alerta de que algo mudou, isso é suficiente.
Muitos fluxos de trabalho requerem mais do que isso. «O preço baixou mais de 10 por cento» requer o preço anterior. «O identificador mudou, redirecione o URL anterior» requer o identificador anterior. «O cliente cancelou a subscrição» precisa de saber que estava subscrito anteriormente. Cada gatilho de alteração desta aplicação inclui ambos os valores, pelo que estes fluxos de trabalho constituem uma condição e uma ação, sem código e sem que seja necessário armazenar nada manualmente.
De onde provém o valor anterior
A aplicação memoriza o último valor conhecido dos campos que monitoriza, por registo. Quando o Shopify comunica uma atualização, a aplicação compara os valores e, caso um campo monitorizado apresente uma diferença, aciona o gatilho com ambos os valores. Na prática, há dois pormenores importantes:
- A primeira vez que a aplicação deteta um registo, limita-se a memorizá-lo. Não é acionado nenhum evento, porque não há nada com que comparar. Quando ativa um gatilho, a aplicação lê os seus registos existentes uma vez em segundo plano, de modo a que a primeira alteração efetiva já acione o evento. No caso dos pedidos, por predefinição, a aplicação analisa os últimos 60 dias, podendo alargar esse intervalo na própria aplicação.
- Os valores referem-se ao momento da alteração. Um fluxo de trabalho associado a um gatilho «Atualização do Flow» lê o registo quando o fluxo de trabalho é executado. Se o registo for alterado novamente um segundo depois, ou for eliminado, esse fluxo de trabalho visualiza o estado mais recente ou não consegue carregar o registo. Um evento desta aplicação mantém os valores com que foi criado. Pode consultá-los posteriormente no Histórico de Eventos da aplicação.

O que só pode ser construído com o valor anterior
| Fluxo de trabalho | Gatilho | A condição que requer o valor anterior | Pronto a utilizar |
|---|---|---|---|
| Redirigir o URL antigo quando um produto ou uma coleção for renomeado(a) | Alteração do identificador do produto, alteração do identificador da coleção | nenhum: o redirecionamento é feito de oldHandle para newHandle |
Redirigir os URLs antigos dos produtos quando o identificador de um produto for alterado, Redirigir os URLs antigos das coleções quando o identificador de uma coleção for alterado |
| Marque os produtos cujo preço baixou 10 por cento ou mais | Alteração do preço de uma variante do produto | priceChange.percentChange inferior ou igual a -10 |
Marque os produtos quando o preço de uma variante baixar 10 por cento ou mais |
| Marque um produto como estando em promoção e retire essa marcação | Alteração do preço de uma variante do produto | priceChange.oldCompareAtPrice.amount está vazio e priceChange.newCompareAtPrice.amount não está, ou o contrário |
Marque os produtos como estando em promoção quando for adicionado um preço de comparação, Retire a tag de promoção quando o preço de comparação for removido |
| Liberar um pedido quando for recebido um pagamento pendente | Alteração do estado financeiro do pedido | oldFinancialStatus igual a pending e newFinancialStatus igual a paid |
Assinalar os pedidos quando for recebido um pagamento pendente |
| Avisar o armazém quando a morada for alterada após o checkout | Alteração da morada de entrega do pedido | nenhuma: a mensagem apresenta oldShippingAddress e shippingAddress |
Assinalar os pedidos quando a morada de entrega for alterada após o checkout |
| Marque os clientes que cancelarem a subscrição e retire a marcação quando regressarem | Alteração do consentimento do cliente para o marketing por e-mail | consentState é igual a unsubscribed; oldConsentState indica qual era o valor anterior |
Assigne uma etiqueta aos clientes quando estes cancelarem a subscrição do e-mail de marketing |
| Mantenha o SKU anterior para o seu ERP ou feed | Alteração do SKU da variante do produto | nenhum: o skuChange.oldSku é gravado num metacampo |
Guardar o SKU anterior quando um SKU de variante for alterado |
| Reavaliar a margem quando um custo aumentar | Alteração do custo da variante do produto | variantCostChange.percentChange superior a 5 |
Marque os produtos para uma revisão da margem sempre que o custo de uma variante aumentar |
| Tag um produto como «stock baixo» uma única vez, quando este atingir o limite | Alteração do nível de estoque no local | inventoryLevel.oldAvailable é maior ou igual a 5 e inventoryLevel.newAvailable é menor que 5 |
Marque os produtos como «estoque baixo» quando o estoque descer para menos de cinco unidades |
Mais três que os lojistas constroem eles próprios:
- Indique o endereço antigo quando o e-mail de um cliente for alterado. A notificação «E-mail do cliente alterado» contém
oldEmaileemail. Envie a notificação paraoldEmailatravés de uma ação de e-mail que aceite uma variável como destinatário, por exemplo, o Workflow Transactional Email. Sem o endereço antigo, não há mais ninguém a quem enviar o aviso. - Reaja a uma etapa num estado personalizado. Um metacampo
loyalty.tierpassa desilverparagold: a atualização do metacampo do cliente incluimetafield.previousValueemetafield.value, pelo que o fluxo de trabalho pode felicitar o cliente pela subida de nível e não emitir qualquer mensagem em caso de descida de nível. - Aja em relação a uma etiqueta removida. Após a remoção de uma etiqueta, um registo fica com o aspeto de um registo que nunca a teve. As etiquetas «Pedido», «Cliente», «Produto» e «Pedido provisório» removidas designam as etiquetas removidas. Consulte Executar um fluxo de trabalho quando uma tag específica for adicionada ou removida.
Todos os valores anteriores e posteriores, por gatilho
Pedidos
| Gatilho | Antes e depois |
|---|---|
| Tags de pedido adicionadas, Tags de pedido removidas | addedTags, removedTags, previousTags, currentTags |
| Nota do pedido alterada | oldNote, newNote |
| Alteração do estado financeiro do pedido | oldFinancialStatus, newFinancialStatus |
| Alteração no processamento de pedidos | oldFulfillmentStatus, newFulfillmentStatus e, por linha ou envio, em changes.items: processado, não processado, rastreio atualizado com número, URL e empresa |
| Alteração do estado de visualização do pedido | oldDisplayFulfillmentStatus, newDisplayFulfillmentStatus |
| Atributos do pedido alterados | changes.items, com changeType, key, oldValue e newValue |
| Alterações nos itens de linha do pedido | changes.items, com changeType (adicionado, removido, alteração na quantidade, no preço ou na variante) e a quantidade, o preço e a variante antigos e novos |
| Alteração da morada de entrega do pedido | shippingAddress e oldShippingAddress, cada um deles também como campos separados |
| Atualização do metacampo do pedido | metafield.value, metafield.previousValue |
| Atualização do pedido | changes.fields e changes.items com field, oldValue e newValue para o estado financeiro, o estado de processamento, as tags, a nota, os itens de linha e os atributos personalizados |
Clientes
| Gatilho | Antes e depois |
|---|---|
| Tags de cliente adicionadas, tags de cliente removidas | addedTags, removedTags, previousTags, currentTags |
| Nota do cliente alterada | oldNote, newNote |
| Alteração do estado do cliente | oldState, newState |
| Alteração do nome do cliente | firstName, lastName, oldFirstName, oldLastName |
| O endereço de e-mail do cliente foi alterado | email, oldEmail |
| Alteração do número de telefone do cliente | phone, oldPhone |
| Alteração da morada do cliente | address e oldAddress, cada um deles também como campos separados |
| Alteração do consentimento para o marketing por e-mail dos clientes, alteração do consentimento para o marketing por SMS dos clientes | consentState, optInLevel, oldConsentState, oldOptInLevel |
| Atualização do metacampo do cliente | metafield.value, metafield.previousValue |
| Atualização para os clientes | changes.fields e changes.items para tags, notas e estado |
Produtos e variantes
| Gatilho | Antes e depois |
|---|---|
| Tags de produto adicionadas, Tags de produto removidas | addedTags, removedTags, previousTags, currentTags |
| O título do produto, o identificador, a descrição, o estado, o fornecedor e o tipo foram alterados | o valor antigo e o novo, por exemplo, oldTitle e newTitle |
| Produto publicado no canal, produto retirado do canal | channels.added, channels.removed, channels.current |
| Alteração do preço de uma variante do produto | priceChange.oldPrice, newPrice, oldCompareAtPrice, newCompareAtPrice, delta, percentChange, direction |
| Alteração do preço unitário de uma variante do produto | unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction |
| Alteração do custo da variante do produto | variantCostChange.oldCost, newCost, delta, percentChange, direction |
| Alteração do SKU da variante do produto | skuChange.oldSku, newSku |
| O código de barras da variante do produto foi alterado | barcodeChange.oldBarcode, newBarcode, as listas de códigos de barras antigos e novos, added, removed |
| Atualização do metacampo do produto, atualização do metacampo da variante do produto | metafield.value, metafield.previousValue |
| Atualização do produto | changes.fields e changes.items para título, identificador, descrição, estado, fornecedor, tipo de produto e tags; e, por variante, para preço, Preço de comparação, SKU, código de barras, política de estoque, sujeito a imposto, título, opções e imagem |
Existências, coleções, locais e muito mais
| Gatilho | Antes e depois |
|---|---|
| Alteração do nível de estoque, esgotamento e reposição de estoque na localização | inventoryLevel.oldAvailable``newAvailable``delta``percentChange``direction, juntamente com a localização |
| Título, identificador e descrição da coleção alterados | o valor antigo e o novo |
| Atualização da localização, Atualização da empresa, Atualização da localização da empresa, Atualização do desconto, Atualização do blogue, Atualização de uma publicação no blogue, Atualização da página | changes.fields e changes.items no registo, sempre |
| Atualização da coleção, atualização do pedido provisório, atualização do mercado | a mesma lista changes, quando a opção Enviar valores antigos e novos estiver ativada |
| Os dez fatores que desencadeiam os pedidos provisórios | o mesmo padrão que os pedidos: tags, notas, atributos, itens de linha, estado, e-mail e endereços |
| Atualização de metacampos para 15 tipos de registos | metafield.value, metafield.previousValue |
Referência completa sobre os gatilhos apresenta todos os gatilhos com todos os seus campos.
Os números já vêm com os cálculos feitos
As condições do Flow são comparadas, não calculadas, e os montantes monetários chegam ao Flow sob a forma de texto. Por isso, a expressão «diminuiu mais de 10 por cento» não pode ser calculada no âmbito de um fluxo de trabalho a partir de dois preços. Os gatilhos de preço, preço unitário, custo e stock enviam, portanto, o resultado sob a forma de números:
| Campo | Significado | Exemplo |
|---|---|---|
delta |
novo valor menos valor anterior | -5 |
percentChange |
a variação, expressa em percentagem do valor anterior | -12.5 significa uma queda de 12,5 por cento |
direction |
increase, decrease ou unchanged |
decrease |


O Shopify Flow fornece o valor anterior de um campo?
Não com os seus próprios gatilhos atualizados. As páginas de ajuda da Shopify relativas aos gatilhos «Produto atualizado», «Pedido atualizado», «Cliente atualizado» e aos outros gatilhos de atualização indicam que apenas os valores atuais estão disponíveis no fluxo de trabalho. Os gatilhos desta aplicação enviam o valor anterior e o valor posterior.
Posso calcular o valor anterior no Shopify Flow?
Apenas se o tiver guardado você mesmo antes da alteração, por exemplo, copiando um valor para um metacampo através de outro fluxo de trabalho e recuperando-o posteriormente. Essa cópia tem de existir antes da primeira alteração e ser mantida em sincronia para cada registo. A aplicação trata deste registo para os campos que monitoriza.
O valor anterior está disponível para os metacampos?
Sim. Cada gatilho de metacampo desta aplicação inclui metafield.previousValue juntamente com metafield.value, para 15 tipos de registos. Consulte Alterações nos metacampos no Shopify Flow: os gatilhos atualizados e os gatilhos dos metacampos.
Por que razão não se disparou nada na primeira mudança de disco?
A aplicação necessita de um ponto de partida. Quando um gatilho é ativado, a aplicação lê os seus registos existentes uma vez em segundo plano. Uma alteração efetuada antes de essa leitura ter chegado ao registo é apenas registada. A alteração seguinte é acionada. Histórico de eventos e resolução de problemas mostra o estado dessa sincronização.
Próximos passos
- Os gatilhos atualizados do Flow e as Workflow Trigger Extensions - Os gatilhos atualizados do Shopify Flow e esta aplicação, lado a lado.
- Acompanhe mais de cinco campos num único fluxo de trabalho - monitorize qualquer número de campos num único fluxo de trabalho.
- Modelos de fluxo de trabalho - fluxos de trabalho prontos, baseados em valores antigos e novos.
