O gatilho de atualização do produto do Shopify Flow e os gatilhos de produto desta aplicação

O gatilho de atualização do produto do Shopify Flow e os gatilhos de produto desta aplicação

Copiar página

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.
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 do produto» do Shopify Flow: os caminhos alterados encontram-se na entrada da etapa; a saída contém apenas os valores atuais.

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.

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

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

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