Acionadores de variantes de produto, passo a passo

Shopify notifica uma variante alterada como «o produto foi atualizado». Estes quatro gatilhos analisam internamente: são acionados uma vez por cada variante cujo preço, SKU, código de barras ou preço unitário tenha sido alterado, indicando os valores anterior e posterior. O preço e o preço unitário também incluem delta, percentChange e direction, uma vez que uma condição do Flow não pode realizar operações aritméticas e os valores monetários são apresentados como texto.

Nesta página: Alteração do preço de uma variante de produto, Alteração do SKU de uma variante de produto, Alteração do código de barras de uma variante de produto, Alteração do preço unitário de uma variante de produto

Onde os encontrar: em Shopify Flow, selecione «Select a trigger», aceda a Workflow Trigger Extensions e procure por «Variant».

Alteração do preço de uma variante do produto

É acionado uma vez por cada variante cujo preço ou preço de referência tenha sido alterado. Um produto com cinco variantes, todas com um novo preço, aciona o processo cinco vezes.


Incêndios causados por	Shopify webhook e deteção de alterações
Autorização	Acesso aos dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Flow que o utilize ativa-o. O seu próprio botão de ativação encontra-se na página «Desencadeadores» da aplicação

Utilize-o para

Notificar a equipa de merchandising sobre reduções de preço que ultrapassem um determinado limiar.
Mantenha os preços dos pacotes, do B2B ou do mercado em sintonia com o preço dos componentes.
Detete erros de fixação de preços: um preço que desceu mais de metade raramente é intencional.

O que a notificação «Alteração do preço de uma variante do produto» envia para o seu fluxo de trabalho

Variável no fluxo	Tipo	O que contém
`productVariant`	Objeto	A variante do produto com o preço atualizado
`productVariant.id`	ID	Identificador global da variante do produto
`productVariant.title`	Texto	O título da variante
`productVariant.sku`	Texto	O SKU da variante
`productVariant.barcode`	Texto	O código de barras (EAN) da variante
`productVariant.price`	Dinheiro (montante, código da moeda)	O preço atual da variante
`productVariant.compareAtPrice`	Dinheiro (montante, código da moeda)	O preço de referência da variante
`productVariant.product`	Objeto	O produto ao qual esta variante pertence
`productVariant.product.id`	ID	Identificador global do produto
`productVariant.product.title`	Texto	O título do produto
`productVariant.product.handle`	Texto	A pega do produto
`priceChange`	Objeto	Detalhes da alteração de preço (valores antigos e novos)
`priceChange.oldPrice`	Dinheiro (montante, código da moeda)	O preço anterior
`priceChange.newPrice`	Dinheiro (montante, código da moeda)	O novo preço
`priceChange.oldCompareAtPrice`	Dinheiro (montante, código da moeda)	O preço de referência anterior
`priceChange.newCompareAtPrice`	Dinheiro (montante, código da moeda)	O novo preço de referência
`priceChange.delta`	Número	Novo valor menos valor antigo. Nulo quando qualquer um dos valores é desconhecido
`priceChange.percentChange`	Número	Variação em percentagem em relação ao valor anterior (-12,5 = diminuição de 12,5 por cento). Nulo quando o valor anterior for 0 ou for desconhecido
`priceChange.direction`	Texto	aumento, diminuição ou sem alterações
`eventId`	Texto	O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Alerta em caso de descontos superiores a 10 por cento

Selecione «Alteração do preço da variante do produto» como gatilho.
Adicionar uma condição: priceChange.percentChange Menor que -10.
Adicionar «Enviar e-mail interno»: {{productVariant.product.title}} / {{productVariant.title}}: {{priceChange.oldPrice.amount}} -> {{priceChange.newPrice.amount}} {{priceChange.newPrice.currencyCode}} ({{priceChange.percentChange}}%).
Ative o fluxo de trabalho e altere o preço de uma variante de teste.

Alteração do SKU da variante do produto

É executado uma vez por cada variante cujo SKU tenha sido alterado.


Incêndios provocados por	Shopify webhook e deteção de alterações
Autorização	Acesso aos dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O respetivo botão de ativação encontra-se na página «Desencadeadores» da aplicação

Utilize-o para

Informe o armazém ou o ERP de que um SKU foi renomeado antes de chegar a próxima encomenda com o novo SKU.
Impedir alterações acidentais de SKU em produtos ativos.

O que a notificação «SKU da variante do produto alterado» envia para o seu fluxo de trabalho

Variável no fluxo	Tipo	O que contém
`productVariant`	Objeto	A variante do produto com o SKU atualizado
`productVariant.id`	ID	Identificador global da variante do produto
`productVariant.title`	Texto	O título da variante
`productVariant.sku`	Texto	O SKU da variante
`productVariant.barcode`	Texto	O código de barras da variante
`productVariant.price`	Dinheiro (montante, código da moeda)	O preço atual da variante
`productVariant.product`	Objeto	O produto ao qual esta variante pertence
`productVariant.product.id`	ID	Identificação global do produto
`productVariant.product.title`	Texto	O título do produto
`productVariant.product.handle`	Texto	A pega do produto
`skuChange`	Objeto	Os detalhes da alteração do SKU (valores antigo e novo)
`skuChange.oldSku`	Texto	O SKU anterior
`skuChange.newSku`	Texto	O novo SKU
`eventId`	Texto	O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Enviar o SKU antigo e o novo para o sistema do armazém

Selecione «SKU da variante do produto alterado» como gatilho.
Envie um pedido HTTP para o seu ponto de extremidade do ERP ou WMS com um corpo JSON que contenha {{skuChange.oldSku}}, {{skuChange.newSku}} e {{productVariant.id}}.
Adicione uma condição no início, caso os SKUs em branco devam ser ignorados: skuChange.oldSku Não estiver vazio e existir.
Ative o fluxo de trabalho.

Alteração do código de barras da variante do produto

Executa uma vez por cada variante cujo código de barras (EAN, UPC, ISBN) tenha sido alterado.


Incêndios provocados por	Shopify webhook e deteção de alterações
Autorização	Acesso aos dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Flow que o utilize ativa-o. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Reenviar um produto para um marketplace ou para o Google Merchant Center que corresponda ao GTIN.
Reimprimir etiquetas de prateleira para pontos de venda.

O que a notificação «Código de barras da variante do produto alterado» envia para o seu fluxo de trabalho

Variável no fluxo	Tipo	O que contém
`productVariant`	Objeto	A variante do produto com o código de barras atualizado
`productVariant.id`	ID	Identificador global da variante do produto
`productVariant.title`	Texto	O título da variante
`productVariant.sku`	Texto	O SKU da variante
`productVariant.barcode`	Texto	O código de barras (EAN) da variante
`productVariant.price`	Dinheiro (montante, código da moeda)	O preço atual da variante
`productVariant.product`	Objeto	O produto ao qual esta variante pertence
`productVariant.product.id`	ID	Identificador global do produto
`productVariant.product.title`	Texto	O título do produto
`productVariant.product.handle`	Texto	A pega do produto
`barcodeChange`	Objeto	Os detalhes da alteração do código de barras (valores antigo e novo)
`barcodeChange.oldBarcode`	Texto	O código de barras anterior
`barcodeChange.newBarcode`	Texto	O novo código de barras
`eventId`	Texto	O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Pedir ao departamento de retalho que reimprima uma etiqueta

Selecione «Código de barras da variante do produto alterado» como gatilho.
Adicionar «Enviar e-mail interno à equipa da loja: {{productVariant.product.title}} / {{productVariant.title}}: barcode {{barcodeChange.oldBarcode}} is now {{barcodeChange.newBarcode}}».
Ative o fluxo de trabalho.

Alteração do preço unitário de uma variante do produto

Apresenta, uma vez por variante cujo preço unitário tenha sofrido alteração, o «preço por 100 g» que alguns países exigem que conste ao lado do preço.


Incêndios causados por	Shopify webhook e deteção de alterações
Autorização	Acesso aos dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Flow que o utilize ativa-o. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

Verifique novamente os preços unitários exigidos por lei após uma alteração no preço ou no tamanho da embalagem.
Atualizar as etiquetas de preço impressas que indicam o preço unitário.

O que a notificação «Preço unitário da variante do produto alterado» envia para o seu fluxo de trabalho

Variável no fluxo	Tipo	O que contém
`productVariant`	Objeto	A variante do produto com o preço unitário atualizado
`productVariant.id`	ID	Identificador global da variante do produto
`productVariant.title`	Texto	O título da variante
`productVariant.sku`	Texto	O SKU da variante
`productVariant.barcode`	Texto	O código de barras (EAN) da variante
`productVariant.price`	Dinheiro (montante, código da moeda)	O preço atual da variante
`productVariant.unitPrice`	Dinheiro (montante, código da moeda)	O preço unitário atual da variante
`productVariant.product`	Objeto	O produto ao qual esta variante pertence
`productVariant.product.id`	ID	Identificador global do produto
`productVariant.product.title`	Texto	O título do produto
`productVariant.product.handle`	Texto	A pega do produto
`unitPriceChange`	Objeto	Detalhes da alteração do preço unitário (valores antigo e novo)
`unitPriceChange.oldUnitPrice`	Dinheiro (montante, código da moeda)	O preço unitário anterior
`unitPriceChange.newUnitPrice`	Dinheiro (montante, código da moeda)	O novo preço unitário
`unitPriceChange.delta`	Número	Novo valor menos valor anterior. Nulo quando qualquer um dos valores é desconhecido
`unitPriceChange.percentChange`	Número	Variação em percentagem em relação ao valor anterior (-12,5 = diminuição de 12,5 por cento). Nulo quando o valor anterior é 0 ou desconhecido
`unitPriceChange.direction`	Texto	aumento, diminuição ou sem alterações
`eventId`	Texto	O ID deste evento. Procura-o no Histórico de Eventos da aplicação para veres exatamente o que foi enviado.

Exemplo: Analisar os preços unitários que aumentaram

Selecione «Alteração do preço unitário da variante do produto» como condição de ativação.
Adicionar uma condição: unitPriceChange.direction é igual a increase.
Adicionar «Enviar e-mail interno» com {{unitPriceChange.oldUnitPrice.amount}} e {{unitPriceChange.newUnitPrice.amount}}.
Ative o fluxo de trabalho.

Próximos passos

Referência completa sobre gatilhos - todos os gatilhos numa única página.
Escolher o gatilho certo - qual é a que se adequa ao seu caso.
Gatilhos personalizados - quando nenhum gatilho integrado for adequado, crie o seu próprio.
Histórico de eventos e resolução de problemas - ver o que disparou e o que transportava.
Acionar eventos na página de administração de um registo - os eventos mais recentes de um registo, na sua própria página na área de administração do Shopify.