O gatilho de atualização de produto do Shopify Flow e os gatilhos de produto deste aplicativo

O gatilho de atualização de produto do Shopify Flow e os gatilhos de produto deste aplicativo

Copiar página

Veja o que o gatilho Produto atualizado do Shopify Flow envia, seu limite de cinco campos e quais gatilhos trazem valores anteriores e variação de preço.

O gatilho Produto atualizado do Flow inicia um fluxo de trabalho quando ocorre uma alteração em um dos até cinco campos de um produto, de suas variantes, opções ou mídia. A página de ajuda do Shopify explica o que o fluxo de trabalho recebe: “O gatilho ‘Produto atualizado’ fornece apenas os valores atuais do produto e de suas variantes, opções e mídia.” e “Os valores anteriores dos campos que foram alterados não estão disponíveis no fluxo de trabalho.”

Este aplicativo possui um gatilho para cada tipo de alteração no produto, e cada um deles contém os valores anteriores e posteriores: o preço antigo e o novo, com a diferença em porcentagem; o link antigo para redirecionamento; e as tags que foram adicionadas ou removidas. Esta página compara esses dados campo a campo. As informações sobre o gatilho do Flow foram extraídas da página de ajuda Shopify e de nossos testes realizados em uma loja de desenvolvimento nos dias 26 de outubro e 20 de novembro de 2026.

O que o “Product updated” envia

Um fluxo de trabalho iniciado pela atualização do produto pode ser o seguinte:

Variável Conteúdo Sempre presente
product o produto, valores atuais sim
shop a loja sim
productVariant uma variante que sofreu alteração, valores atuais somente quando um campo de variante estiver sendo monitorado e uma variante for alterada
Opção de produto, mídia, produto com listagem combinada o item que sofreu alteração somente quando tal campo for monitorado

O que não é enviado:

  • Não há valor anterior. Não há preço anterior, título anterior, status anterior nem lista de tags anterior.
  • Não há uma lista de campos alterados para servir de base à ramificação. O Flow mostra os caminhos alterados nos dados da etapa de uma execução, mas, em nossos testes, eles não foram disponibilizados como variáveis no editor de fluxo de trabalho.
  • Não há números relativos à variação: nem diferença, nem variação percentual, nem direção.
Dados da etapa de execução do Shopify Flow do gatilho “Produto atualizado”, com os caminhos alterados nos valores de entrada e os valores atuais nos valores de saída
Uma execução do gatilho “Atualização de produto” do Shopify Flow: os caminhos alterados constam na entrada da etapa, enquanto a saída contém apenas os valores atuais.

Quais produtos atualizados podem ser visualizados

Grupo Campos
Produto category, combinedListingRole, descriptionHtml, giftCardTemplateSuffix, handle, metafield.value, productType, requiresSellingPlan, status, tags, templateSuffix, title, vendor
Variantes variants.barcode, variants.barcodes, variants.compareAtPrice, variants.inventoryPolicy, variants.media, variants.metafield.value, variants.position, variants.price, variants.productVariantComponents, variants.requiresComponents, variants.showUnitPrice, variants.taxable, variants.title
Mais grupos mídia, opções e valores das opções, componentes do pacote, listagens combinadas

Não constam na lista: SKU, custo por item e peso (esses dados pertencem ao item de estoque; consulte O gatilho de atualização de item de estoque do Flow e o SKU, o custo e o estoque neste aplicativo), o preço unitário, as quantidades em estoque e os canais de vendas.

O limite de cinco campos

Cada gatilho de atualização de produto monitora de 1 a 5 campos. O limite se aplica por fluxo de trabalho, e não por loja: em nosso teste, dois fluxos de trabalho com cinco campos cada foram executados em uma única edição. Para monitorar mais campos, crie mais fluxos de trabalho e repita suas condições e ações.

Este aplicativo não possui tal limite. Cada campo rastreado possui seu próprio gatilho, e o gatilho genérico Atualização de produto pode ser restringido a qualquer número de campos em suas configurações. Consulte Monitore mais de cinco campos em um único fluxo de trabalho.

Configurações de atualização do produto Workflow Trigger Extensions com uma árvore de campos para selecionar quais alterações acionam o gatilho e um botão para enviar os valores antigos e novos
Atualização do produto nas Workflow Trigger Extensions: selecione quaisquer campos de um produto real e ative a opção “Enviar valores antigos e novos”.

Campo por campo

O que mudou Atualização do produto da Shopify Flow Gatilho da funcionalidade principal deste aplicativo Antes e depois
Preço variants.price: apenas novo valor Alteração no preço da variante do produto priceChange.oldPrice, newPrice, delta, percentChange, direction
Preço de comparação variants.compareAtPrice: apenas o novo valor Alteração no preço da variante do produto priceChange.oldCompareAtPrice, newCompareAtPrice
Preço unitário não consta na lista (apenas variants.showUnitPrice) Alteração no preço unitário da variante do produto unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction
Custo por item não em “Produto atualizado”. A atualização do item de estoque inclui unitCost; apenas o novo valor Alteração no custo da variante do produto variantCostChange.oldCost, newCost, delta, percentChange, direction
SKU não em “Produto atualizado”. A atualização do item de estoque inclui o sku; apenas o novo valor Alteração do SKU da variante do produto skuChange.oldSku, newSku
Código de barras variants.barcode, variants.barcodes, apenas novo valor O código de barras da variante do produto foi alterado o código de barras principal antigo e o novo, as listas de códigos de barras antigas e novas, e o que foi adicionado e removido
Estoque em um local não consta da lista Alteração no nível de estoque no local, sem estoque no local, estoque restabelecido no local inventoryLevel.oldAvailable``newAvailable``delta e a localização
Título title: somente novo valor Alteração do título do produto oldTitle, newTitle
Alça handle: apenas novo valor Alteração do nome do produto oldHandle e newHandle, prontos para um redirecionamento de URL
Descrição descriptionHtml: apenas valor novo Descrição do produto alterada oldDescription, newDescription
Status status: apenas novo valor Alteração no status do produto oldStatus, newStatus
Fornecedor vendor: somente novo valor Mudança do fornecedor do produto oldVendor, newVendor
Tipo de produto productType: somente novo valor Alteração do tipo de produto oldType, newType
Tags tags: a lista após a alteração Tags de produto adicionadas, Tags de produto removidas addedTags, removedTags, previousTags, currentTags
Canais de vendas não consta da lista Produto publicado no canal, produto retirado do canal channels.added, channels.removed, channels.current
Metacampo do produto metafield.value: apenas o novo valor Atualização do metacampo do produto metafield.value, metafield.previousValue
Metacampo de variante variants.metafield.value: apenas novo valor Atualização do metacampo de variantes do produto metafield.value, metafield.previousValue
Várias dessas etapas em um único fluxo de trabalho cinco, no máximo Atualização do produto, restrita aos campos que o(a) senhor(a) marcar changes.fields e changes.items com field, oldValue e newValue, um item por variante
Opções, mídia, modelo e outros campos do produto sim, dentro dos cinco campos A atualização do produto foi restrita a esses campos. Quanto aos valores anteriores e posteriores, o modelo de gatilho personalizado Campos do produto alterados (antes e depois)
Componentes de pacotes, listagens combinadas sim, dentro dos cinco campos sem gatilho

Diferenças de comportamento que vale a pena conhecer

  • Um novo produto. A página de ajuda do Shopify informa que, dependendo dos campos que você monitora, a adição de um produto também pode acionar o fluxo de trabalho: todo produto possui pelo menos uma variante; portanto, um fluxo de trabalho que monitore variants.price é executado quando um produto é adicionado. Os gatilhos de alteração deste aplicativo reconhecem um novo produto e são acionados a partir da primeira alteração efetiva do mesmo.
  • Vários campos em um único salvamento. O gatilho Flow é executado uma única vez e não informa qual campo foi alterado. Este aplicativo aciona o gatilho correspondente para cada tipo de alteração, cada um com seus próprios valores antes e depois.
  • Um salvamento que não altera nada também não dá início a nada.
  • Análise retrospectiva. O fluxo de trabalho das lojas do Shopify permanece ativo por 14 dias após a conclusão de uma execução. Este aplicativo possui seu próprio Histórico de Eventos com os valores de cada evento, além de um bloco de eventos na página do registro no painel de administração do Shopify. Consulte Histórico de eventos e solução de problemas e Gatilhos na página de administração de um registro.

Fluxos de trabalho que precisam do valor antes de

Qual deles utilizar

  • Atualização do produto no Shopify Flow: basta saber que um dos até cinco campos foi alterado, ou acompanhar opções, mídias, componentes de pacotes ou listagens combinadas.
  • Esta aplicação: seu fluxo de trabalho compara situações “antes e depois” (quedas de preço, produtos renomeados, tags removidas), necessita de SKU, custo e estoque por local ou canal de vendas em um único local, ou monitora mais de cinco campos em um único fluxo de trabalho.

Ambos podem ser executados na mesma loja.

A função “Atualizar produto” exibe o preço antigo?

Não. A página de ajuda do Shopify informa que o gatilho fornece apenas os valores atuais. O gatilho “Alteração no preço da variante do produto” apresenta o preço antigo e o novo, a diferença, a variação em porcentagem e a direção.

A função “Atualização de produto” é executada quando um produto é criado?

Sim, é possível. A página de ajuda do Shopify informa que um fluxo de trabalho que monitora um campo de variante, como variants.price, é executado quando um produto é adicionado, pois todo produto possui pelo menos uma variante. Definir campos do produto, como título ou tags, no momento em que um produto é adicionado, não aciona esse fluxo de trabalho.

A função “Atualização de produto” permite monitorar o SKU ou o custo?

Não no produto. O Shopify incluiu ambos no item de estoque: o gatilho “Item de estoque atualizado” pode monitorar sku e unitCost, mais uma vez apenas com o valor atual. Os gatilhos “Alteração no SKU da variante do produto” e “Alteração no custo da variante do produto” apresentam os valores antes e depois.

Como faço para reagir apenas a uma queda de preço de um determinado valor?

Utilize a condição “Preço da variante do produto alterado” com uma condição baseada em priceChange.percentChange, por exemplo, “Menor ou igual a -10”. O aplicativo calcula a porcentagem, pois uma condição do Shopify Flow não é capaz de fazer esse cálculo.

Próximos passos