O gatilho de atualização do produto do Shopify Flow e os gatilhos de produto desta aplicação
O que o gatilho Produto atualizado do Shopify Flow envia, o limite de cinco campos e que gatilhos de produto incluem valores antigos e variação percentual.
O gatilho Produto atualizado do Flow inicia um fluxo de trabalho quando um dos até cinco campos de um produto, das suas variantes, opções ou ficheiros multimédia é alterado. A página de ajuda da Shopify indica o que o fluxo de trabalho recebe: «O gatilho «Produto atualizado» fornece apenas os valores atuais do produto e das suas variantes, opções e multimédia.» e «Os valores anteriores dos campos que foram alterados não estão disponíveis no fluxo de trabalho.»
Esta aplicação dispõe de um gatilho para cada tipo de alteração de produto, e cada um deles contém os valores anteriores e posteriores: o preço antigo e o novo, com a diferença em percentagem; o endereço antigo para redirecionamento; e as tags que foram adicionadas ou removidas. Esta página compara-os campo a campo. As informações relativas ao gatilho Flow provêm da página de ajuda Shopify e dos nossos testes realizados numa loja de desenvolvimento a 26 de outubro e a 20 de novembro de 2026.
O que a funcionalidade «Atualização de produto» envia
Um fluxo de trabalho iniciado pela atualização do produto pode ter o seguinte conteúdo:
| Variável | Conteúdo | Sempre presente |
|---|---|---|
product |
o produto, valores atuais | sim |
shop |
a loja | sim |
productVariant |
uma variante que sofreu alterações, valores atuais | apenas quando um campo de variante é monitorizado e uma variante é alterada |
| Opção de produto, suporte, produto com listagem combinada | o elemento que sofreu alteração | apenas quando esse campo for monitorizado |
O que não envia:
- Não existe nenhum valor anterior. Não há nenhum preço anterior, título anterior, estado anterior nem lista de tags anteriores.
- Não existe uma lista de campos alterados para servir de base à ramificação. O Shopify Flow apresenta os percursos alterados nos dados da etapa de uma execução, mas, nos nossos testes, estes não foram disponibilizados como variáveis no editor do fluxo de trabalho.
- Não há dados relativos à variação: nem diferença, nem variação percentual, nem sentido.

Que produtos atualizados é possível ver
| 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 | meios, opções e valores das opções, componentes do pacote, listagens combinadas |
Não constam da lista: SKU, custo por unidade e peso (estes dados pertencem ao artigo de estoque; consulte O gatilho de atualização do item de estoque do Flow e o SKU, o custo e o stock nesta aplicação), 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 monitoriza entre 1 e 5 campos. O limite aplica-se por fluxo de trabalho, e não por loja: no nosso teste, dois fluxos de trabalho com cinco campos cada foram executados simultaneamente numa única edição. Para monitorizar mais campos, deve criar mais fluxos de trabalho e repetir as respetivas condições e ações.
Esta aplicação não tem esse limite. Cada campo monitorizado tem o seu próprio gatilho, e o gatilho genérico Atualização do produto pode ser restringido a qualquer número de campos nas suas definições. Consulte Acompanhe mais de cinco campos num único fluxo de trabalho.

Campo a campo
| O que mudou | Atualização do produto da Shopify Flow | Gatilho desta aplicação | Antes e depois |
|---|---|---|---|
| Preço | variants.price: apenas valor novo |
Alteração do preço de uma variante do produto | priceChange.oldPrice, newPrice, delta, percentChange, direction |
| Preço de comparação | variants.compareAtPrice: apenas o novo valor |
Alteração do preço de uma variante do produto | priceChange.oldCompareAtPrice, newCompareAtPrice |
| Preço unitário | não consta da lista (apenas variants.showUnitPrice) |
Alteração do preço unitário de uma variante do produto | unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction |
| Custo por unidade | Não em «Produto atualizado». A atualização do artigo do estoque inclui o campo unitCost; apenas o novo valor |
Alteração do custo da variante do produto | variantCostChange.oldCost, newCost, delta, percentChange, direction |
| SKU | não em «Produto atualizado». A atualização do artigo do estoque inclui o sku, apenas com um novo valor |
Alteração do SKU da variante do produto | skuChange.oldSku, newSku |
| Código de barras | variants.barcode``variants.barcodes; apenas valor novo |
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 |
| Existências num local | não consta da lista | Alteração do nível de estoque no local, esgotado no local, novamente disponível no local | inventoryLevel.oldAvailable``newAvailable``delta e a localização |
| Título | title: apenas valor novo |
Alteração do título do produto | oldTitle, newTitle |
| Pega | handle: apenas valor novo |
Alteração do nome do produto | oldHandle e newHandle, prontos para um redirecionamento de URL |
| Descrição | descriptionHtml: apenas valor novo |
Alteração na descrição do produto | oldDescription, newDescription |
| Estado | status: apenas valor novo |
Alteração do estado do produto | oldStatus, newStatus |
| Fornecedor | vendor: apenas valor novo |
Alteração do fornecedor do produto | oldVendor, newVendor |
| Tipo de produto | productType: apenas valor novo |
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 «Variante» | variants.metafield.value: apenas o novo valor |
Atualização do metacampo da variante do produto | metafield.value, metafield.previousValue |
| Várias destas num único fluxo de trabalho | cinco, no máximo | Atualização do produto, limitada aos campos que assinalar | changes.fields e changes.items com field, oldValue, newValue, um item por variante |
| Opções, meios, modelo e outros campos do produto | Sim, dentro dos cinco campos | A atualização do produto foi restringida a esses campos. No que diz respeito aos seus valores antes e depois, 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 da Shopify indica que, dependendo dos campos que monitoriza, a adição de um produto também pode desencadear o fluxo de trabalho: cada produto tem, pelo menos, uma variante, pelo que um fluxo de trabalho que monitorize
variants.priceé executado quando um produto é adicionado. Os gatilhos de alteração desta aplicação registam a existência de um novo produto e são acionados a partir da sua primeira alteração efetiva. - Vários campos numa única gravação. O gatilho Flow é executado uma única vez e não indica qual o campo que foi alterado. Esta aplicação aciona o gatilho correspondente para cada tipo de alteração, cada um com os seus próprios valores antes e depois.
- Uma defesa que não altera nada também não dá início a nada.
- Retrospetiva. O fluxo de trabalho das lojas Shopify permanece ativo durante 14 dias após a conclusão de uma execução. Esta aplicação dispõe do seu próprio «Histórico de Eventos», com os valores de cada evento, e de um bloco de eventos na página do registo no painel de administração do Shopify. Consulte Histórico de eventos e resolução de problemas e Acionar gatilhos na página de administração de um registo.
Fluxos de trabalho que necessitam do valor antes de
- Redirija o URL antigo quando um identificador for alterado. O redirecionamento é feito de
oldHandleparanewHandle. Sem o identificador antigo, não há nada a partir do qual se possa redirecionar. Redirigir os URLs antigos dos produtos quando o identificador de um produto for alterado - Marque uma redução de preço real.
priceChange.percentChange. Um valor inferior ou igual a-10distingue uma redução de preço de 10 por cento de qualquer outra alteração de preço. Marque os produtos quando o preço de uma variante baixar 10 por cento ou mais - Marcar um produto como em promoção e desmarcá-lo. O preço de comparação estava em branco e foi agora definido, ou vice-versa. Marque os produtos como estando em promoção quando for adicionado um preço de comparação e Retire a tag de promoção quando o preço de comparação for removido
- Manter o título ou o SKU anterior. Guardar o título anterior quando o título de um produto for alterado e Guardar o SKU anterior quando um SKU de variante for alterado
- Detete quando um produto sai de um canal de vendas. Marque os produtos quando forem retirados da Loja virtual
Qual deve utilizar
- Atualização do produto no Shopify Flow: basta saber que um dos até cinco campos foi alterado, ou pode acompanhar as opções, os meios de comunicação, os componentes do pacote ou as listagens combinadas.
- Esta aplicação: o seu fluxo de trabalho compara situações «antes» e «depois» (quedas de preço, produtos renomeados, tags removidas), necessita de SKU, custo e stock por local ou por canais de vendas num único local, ou monitoriza mais de cinco campos num único fluxo de trabalho.
Ambos podem funcionar na mesma loja.
A atualização do produto indica o preço anterior?
Não. A página de ajuda da Shopify indica que o gatilho fornece apenas os valores atuais. O gatilho «Alteração do preço da variante do produto» apresenta o preço antigo e o novo, a diferença, a variação em percentagem e a direção.
A função «Atualização do produto» é executada quando se cria um produto?
Sim, é possível. A página de ajuda da Shopify indica que um fluxo de trabalho que monitoriza um campo de variante, como variants.price, é executado quando um produto é adicionado, uma vez que cada produto tem, pelo menos, uma variante. A definição de campos do produto, como o título ou as tags, quando um produto é adicionado, não o aciona.
A funcionalidade «Atualização do produto» permite monitorizar o SKU ou o custo?
Não no produto. A Shopify incluiu ambos no item de estoque: o gatilho «Atualização do item de estoque» pode monitorizar sku e unitCost, mais uma vez apenas com o valor atual. Os gatilhos «Alteração do SKU da variante do produto» e «Alteração do custo da variante do produto» apresentam o valor anterior e o valor posterior.
Como posso reagir apenas a uma queda de preço de uma determinada magnitude?
Utilize uma condição «Alteração do preço da variante do produto» com uma condição baseada em priceChange.percentChange, por exemplo, «Menor ou igual a -10». A aplicação calcula a percentagem, uma vez que uma condição do Shopify Flow não tem capacidade para o fazer.
Próximos passos
- Gatilhos de produto, passo a passo e Gatilhos de variantes do produto, passo a passo - todos os gatilhos de produto e variante, acompanhados de um exemplo.
- Os gatilhos atualizados do Flow e as Workflow Trigger Extensions - a visão geral dos nove gatilhos atualizados.
- Valores antigos e novos: o que um fluxo de trabalho pode fazer com eles - todos os valores anteriores e posteriores, por gatilho.
