Valores antigos e novos: como um fluxo de trabalho pode aproveitá-los
Shopify Flow
Os gatilhos atualizados do Flow passam ao fluxo de trabalho o registro tal como ele está no momento. As páginas de ajuda do Shopify explicam isso para cada um deles: apenas os valores atuais estão disponíveis; os valores anteriores à alteração não estão. Para um alerta informando que algo mudou, isso é suficiente.
Muitos fluxos de trabalho exigem mais do que isso. “O preço caiu mais de 10%” requer o preço anterior. “O identificador foi alterado; redirecione a URL antiga” requer o identificador anterior. “O cliente cancelou a assinatura” precisa saber que ele estava inscrito anteriormente. Cada gatilho de alteração deste aplicativo contém ambos os valores; assim, esses fluxos de trabalho consistem em uma condição e uma ação, sem código e sem que nada seja armazenado manualmente.
De onde vem o valor anterior
O aplicativo armazena o último valor conhecido dos campos que monitora, por registro. Quando o Shopify reporta uma atualização, ele compara os valores e, caso um campo monitorado apresente diferença, aciona o gatilho com ambos os valores. Na prática, dois detalhes são importantes:
- Na primeira vez que o aplicativo detecta um registro, ele apenas o memoriza. Nada é acionado, pois não há nada com que comparar. Quando o senhor ativa um gatilho, o aplicativo lê os registros existentes uma vez em segundo plano, de modo que a primeira alteração real já acione o gatilho. Para pedidos, ele lê os últimos 60 dias por padrão, e o senhor pode ampliar esse intervalo no aplicativo.
- Os valores correspondem ao momento da alteração. Um fluxo de trabalho acionado por um gatilho Flow lê o registro quando o fluxo de trabalho é executado. Se o registro for alterado novamente um segundo depois, ou for excluído, esse fluxo de trabalho visualizará o estado mais recente ou não conseguirá carregar o registro. Um evento deste aplicativo mantém os valores com os quais foi criado. É possível consultá-los posteriormente no Histórico de Eventos do aplicativo.

O que só é possível construir com o valor anterior
| Fluxo de trabalho | Gatilho | A condição que requer o valor anterior | Pronto para uso |
|---|---|---|---|
| Redirecionar a URL antiga quando um produto ou coleção for renomeado | Alteração do identificador do produto, alteração do identificador da coleção | nenhum: o redirecionamento ocorre de oldHandle para newHandle |
Redirecionar URLs antigas de produtos quando o identificador de um produto for alterado, Redirecionar URLs antigas de coleções quando o identificador de uma coleção for alterado |
| Marque os produtos cujo preço caiu 10% ou mais | Alteração no preço da variante do produto | priceChange.percentChange menor ou igual a -10 |
Marque os produtos quando o preço de uma variante cair 10% ou mais |
| Marque um produto como em promoção e retire a marcação novamente | Alteração no preço da variante do produto | priceChange.oldCompareAtPrice.amount está vazio e priceChange.newCompareAtPrice.amount não está, ou vice-versa |
Marque os produtos como em promoção quando for adicionado um preço de comparação, Remova a tag de promoção quando o preço de comparação for removido |
| Liberar um pedido quando um pagamento pendente for recebido | Alteração na situação financeira do pedido | oldFinancialStatus igual a pending e newFinancialStatus igual a paid |
Marcar pedidos quando for recebido um pagamento pendente |
| Avisem o almoxarifado quando o endereço for alterado após o checkout | Alteração do endereço de entrega do pedido | nenhuma: a mensagem exibe oldShippingAddress e shippingAddress |
Marque os pedidos quando o endereço de entrega for alterado após a checkout |
| Marque os clientes que cancelarem a assinatura e remova a tag quando eles voltarem | Alteração no consentimento para o marketing por e-mail dos clientes | consentState é igual a unsubscribed; oldConsentState indica qual era o valor anterior |
Marque os clientes quando eles cancelarem a assinatura do e-mail de marketing |
| Mantenha o SKU anterior para o seu ERP ou feed | Alteração do SKU da variante do produto | nenhum: skuChange.oldSku é gravado em um metacampo |
Salvar o SKU anterior quando o SKU de uma variante for alterado |
| Reavalie a margem quando um custo aumentar | Alteração no custo da variante do produto | variantCostChange.percentChange maior que 5 |
Marque os produtos para uma revisão de margem quando o custo de uma variante aumentar |
| Tag um produto como “estoque baixo” uma única vez, quando ele atingir o limite | Alteração no 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 ficar abaixo de cinco unidades |
Mais três que os lojistas constroem por conta própria:
- Informe 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 paraoldEmailpor meio de uma ação de e-mail que receba 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 avisar. - Reaja a uma etapa em um status personalizado. Um metacampo
loyalty.tierpassa desilverparagold: a atualização do metacampo do cliente contémmetafield.previousValueemetafield.value, de modo que o fluxo de trabalho possa parabenizar pelo upgrade e não enviar nenhuma notificação em caso de downgrade. - Aja em relação a uma tag removida. Após a remoção de uma tag, um registro passa a se parecer com um que nunca a teve. As tags “Ordem”, “Cliente”, “Produto” e “Pedido provisório” indicam as tags 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 |
|---|---|
| Etiquetas de pedido adicionadas, etiquetas de pedido removidas | addedTags, removedTags, previousTags, currentTags |
| Nota do pedido alterada | oldNote, newNote |
| Alteração na situação financeira do pedido | oldFinancialStatus, newFinancialStatus |
| Alteração no processamento do pedido | oldFulfillmentStatus, newFulfillmentStatus e, por linha ou remessa, em changes.items: processado, não processado, rastreamento atualizado com número, URL e empresa |
| O status de exibição do pedido foi alterado | oldDisplayFulfillmentStatus, newDisplayFulfillmentStatus |
| Atributos do pedido alterados | changes.items, com changeType, key, oldValue e newValue |
| Itens de linha do pedido alterados | 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 do endereço de entrega do pedido | shippingAddress e oldShippingAddress, cada um deles também como campos separados |
| Atualização de metacampo de pedido | metafield.value, metafield.previousValue |
| Atualização do pedido | changes.fields e changes.items com field, oldValue e newValue para status financeiro, status de processamento, tags, notas, itens de linha e atributos personalizados |
Clientes
| Gatilho | Antes e depois |
|---|---|
| Tags de clientes adicionadas, tags de clientes removidas | addedTags, removedTags, previousTags, currentTags |
| Nota do cliente alterada | oldNote, newNote |
| Alteração no status do cliente | oldState, newState |
| Nome do cliente alterado | firstName, lastName, oldFirstName, oldLastName |
| E-mail do cliente alterado | email, oldEmail |
| Alteração do número de telefone do cliente | phone, oldPhone |
| Alteração do endereço do cliente | address e oldAddress, cada um deles também como campos separados |
| Alteração do consentimento para marketing por e-mail dos clientes; Alteração do consentimento para marketing por SMS dos clientes | consentState, optInLevel, oldConsentState, oldOptInLevel |
| Atualização do metacampo do cliente | metafield.value, metafield.previousValue |
| Atualização para o cliente | 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 |
| Título do produto, identificador, descrição, status, fornecedor e 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 no preço da variante do produto | priceChange.oldPrice, newPrice, oldCompareAtPrice, newCompareAtPrice, delta, percentChange, direction |
| Alteração no preço unitário da variante do produto | unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction |
| Alteração no 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, status, 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, tributável, título, opções e imagem |
Estoque, coleções, locais e muito mais
| Gatilho | Antes e depois |
|---|---|
| Alteração no nível de estoque, falta de estoque e reposição de estoque no local | inventoryLevel.oldAvailable``newAvailable``delta``percentChange``direction, juntamente com o local |
| Título, identificador e descrição da coleção foram alterados | o valor antigo e o novo |
| Atualização de local, Atualização da empresa, Atualização da localização da empresa, Atualização de desconto, Atualização do blog, Atualização de postagem no blog, Atualização da página | changes.fields e changes.items no registro, 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 dos pedidos: tags, notas, atributos, itens de linha, status, e-mail e endereços |
| Atualização de metacampos para 15 tipos de registros | metafield.value, metafield.previousValue |
Referência completa sobre gatilhos lista todos os gatilhos com todos os seus campos.
Os números já vêm com os cálculos feitos
As condições do Shopify Flow comparam valores, não realizam cálculos, e os valores monetários chegam ao Shopify Flow na forma de texto. Portanto, a expressão “caiu mais de 10%” não pode ser calculada dentro de um fluxo de trabalho a partir de dois preços. Os gatilhos de preço, preço unitário, custo e estoque, portanto, enviam o resultado na forma de números:
| Campo | Significado | Exemplo |
|---|---|---|
delta |
novo valor menos valor anterior | -5 |
percentChange |
a variação, expressa em porcentagem 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 seus próprios gatilhos atualizados. As páginas de ajuda do Shopify para os gatilhos “Produto atualizado”, “Pedido atualizado”, “Cliente atualizado” e outros gatilhos de atualização indicam que apenas os valores atuais estão disponíveis no fluxo de trabalho. Os gatilhos deste aplicativo enviam o valor anterior e o posterior.
Posso calcular o valor anterior no Shopify Flow?
Somente se o senhor mesmo tiver armazenado essa informação antes da alteração, por exemplo, copiando um valor para um metacampo por meio de outro fluxo de trabalho e recuperando-o posteriormente. Essa cópia precisa existir antes da primeira alteração e ser mantida em sincronia para cada registro. O aplicativo realiza esse controle para os campos que monitora.
O valor anterior está disponível para os metacampos?
Sim. Cada gatilho de metacampo deste aplicativo inclui metafield.previousValue junto com metafield.value, para 15 tipos de registros. Consulte Alterações nos metacampos no Shopify Flow: os gatilhos atualizados e os gatilhos de metacampos.
Por que não ocorreu nenhuma ação na primeira troca de disco?
O aplicativo precisa de um ponto de partida. Quando um gatilho é ativado, ele lê seus registros existentes uma vez em segundo plano. Uma alteração feita antes que essa leitura chegasse ao registro é apenas registrada. A próxima alteração é acionada. Histórico de eventos e solução de problemas mostra o estado dessa sincronização.
Próximos passos
- Os gatilhos atualizados do Flow e as Workflow Trigger Extensions - Comparação lado a lado entre os gatilhos atualizados do Shopify Flow e este aplicativo.
- Monitore mais de cinco campos em um único fluxo de trabalho - monitore qualquer número de campos em um único fluxo de trabalho.
- Modelos de fluxo de trabalho - fluxos de trabalho prontos, baseados em valores antigos e novos.
