Gatilhos de variantes do produto, passo a passo
Gatilhos do Shopify Flow para preço, SKU, código de barras e preço unitário de variantes, com valores antigos, novos e variação percentual.
Shopify relata uma variante alterada como “o produto foi atualizado”. Esses quatro gatilhos realizam uma verificação interna: são acionados uma vez por 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, pois uma condição do Shopify Flow não pode realizar operações aritméticas e os valores monetários são fornecidos como texto.
Nesta página: Alteração no preço da variante do produto, Alteração no SKU da variante do produto, Alteração no código de barras da variante do produto, Alteração no preço unitário da variante do produto
Alteração no preço da variante do produto
É acionado uma vez por variante cujo preço ou preço de comparação tenha sido alterado. Um produto com cinco variantes, todas com novo preço, aciona o evento cinco vezes.
| Incêndios causados por | Shopify webhook e detecção de alterações |
| Permissão | Acesso aos dados de produtos, variantes e coleções |
| Ligado | Ativar um fluxo de trabalho do Flow que o utilize aciona esse recurso. O botão de ativação específico está na página “Gatilhos” do aplicativo |
Utilize-o para
- Notifique a equipe de merchandising sobre reduções de preço acima de um limite.
- Mantenha os preços dos pacotes, do B2B ou do marketplace alinhados com o preço dos componentes.
- Identifique erros de precificação: um preço que caiu mais da metade raramente é intencional.
O que o evento “Alteração no preço da variante do produto” envia para o seu fluxo de trabalho
| Variável em Shopify Flow | Tipo | O que contém |
|---|---|---|
productVariant |
Objeto | A variante do produto com o preço atualizado |
productVariant.id |
ID | ID 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 (valor, código da moeda) | O preço atual da variante |
productVariant.compareAtPrice |
Dinheiro (valor, código da moeda) | O preço de comparação 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 alça do produto |
priceChange |
Objeto | Detalhes da alteração de preço (valores antigo e novo) |
priceChange.oldPrice |
Dinheiro (valor, código da moeda) | O preço anterior |
priceChange.newPrice |
Dinheiro (valor, código da moeda) | O novo preço |
priceChange.oldCompareAtPrice |
Dinheiro (valor, código da moeda) | O preço de comparação anterior |
priceChange.newCompareAtPrice |
Dinheiro (valor, código da moeda) | O novo preço de comparação |
priceChange.delta |
Número | Novo valor menos valor antigo. Nulo quando qualquer um dos valores for desconhecido |
priceChange.percentChange |
Número | Variação expressa como porcentagem do valor anterior (-12,5 = queda de 12,5%). Nulo quando o valor anterior é 0 ou desconhecido |
priceChange.direction |
Texto | aumento, diminuição ou sem alteração |
eventId |
Texto | O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado. |
Exemplo: Alerta sobre descontos superiores a 10 por cento
- Selecione “Alteração no preço da variante do produto” como gatilho.
- Adicionar uma condição:
priceChange.percentChangeMenor que-10. - Adicione “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 no SKU da variante do produto
É executado uma vez por variante cujo SKU tenha sido alterado.
| Incêndios causados por | Shopify Webhook e detecção de alterações |
| Permissão | Acesso aos dados de produtos, variantes e coleções |
| Ligado | Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo |
Utilize-o para
- Informe ao almoxarifado ou ao ERP que um SKU foi renomeado antes que o próximo pedido chegue com o novo SKU.
- Impedir edições acidentais de SKUs em produtos ativos.
O que o evento “Alteração do SKU da variante do produto” envia para o seu fluxo de trabalho
| Variável em Shopify Flow | Tipo | O que contém |
|---|---|---|
productVariant |
Objeto | Variante do produto com o SKU atualizado |
productVariant.id |
ID | ID 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 (valor, 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 alça 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. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado. |
Exemplo: Enviar o SKU antigo e o novo para o sistema do armazém
- Selecione “Alteração do SKU da variante do produto” como gatilho.
- Envie uma solicitação HTTP para o seu endpoint do ERP ou WMS com um corpo JSON contendo
{{skuChange.oldSku}},{{skuChange.newSku}}e{{productVariant.id}}. - Adicione uma condição no início, caso os SKUs em branco devam ser ignorados:
skuChange.oldSkuNão estiver vazio e existir. - Ative o fluxo de trabalho.
O código de barras da variante do produto foi alterado
Gera um relatório uma vez para cada variante cujo código de barras (EAN, UPC, ISBN) tenha sido alterado.
| Incêndios causados por | Shopify Webhook e detecção de alterações |
| Permissão | Acesso aos dados de produtos, variantes e coleções |
| Ligado | Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação encontra-se na página “Gatilhos” do aplicativo |
Utilize-o para
- Reenviar um produto para um marketplace ou para o Google Merchant Center cujo GTIN corresponda.
- Reimprima as etiquetas de prateleira para os locais 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 em Shopify Flow | Tipo | O que contém |
|---|---|---|
productVariant |
Objeto | A variante do produto com o código de barras atualizado |
productVariant.id |
ID | ID 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 (valor, 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 alça 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. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado. |
Exemplo: Solicite ao varejo que reimprima uma etiqueta
- Selecione “Alteração do código de barras da variante do produto” como gatilho.
- Adicione “Enviar e-mail interno para a equipe 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 da variante do produto
Exibe uma vez por variante cujo preço unitário tenha sido alterado 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 detecção de alterações |
| Permissão | Acesso aos dados de produtos, variantes e coleções |
| Ligado | Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. O botão de ativação específico desse fluxo de trabalho está na página “Gatilhos” do aplicativo |
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.
- Atualize as tags 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 ao seu fluxo de trabalho
| Variável em Shopify Flow | Tipo | O que contém |
|---|---|---|
productVariant |
Objeto | A variante do produto com o preço unitário atualizado |
productVariant.id |
ID | ID 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 (valor, código da moeda) | O preço atual da variante |
productVariant.unitPrice |
Dinheiro (valor, 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 alça do produto |
unitPriceChange |
Objeto | Detalhes da alteração do preço unitário (valores antigo e novo) |
unitPriceChange.oldUnitPrice |
Dinheiro (valor, código da moeda) | O preço unitário anterior |
unitPriceChange.newUnitPrice |
Dinheiro (valor, 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 for desconhecido |
unitPriceChange.percentChange |
Número | Variação expressa como porcentagem do valor anterior (-12,5 = queda de 12,5 por cento). Nulo quando o valor anterior for 0 ou desconhecido |
unitPriceChange.direction |
Texto | aumento, diminuição ou sem alteração |
eventId |
Texto | O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado. |
Exemplo: Analise os preços unitários que aumentaram
- Selecione “Alteração no preço unitário da variante do produto” como gatilho.
- Adicione uma condição:
unitPriceChange.directionseja igual aincrease. - Adicione a opção “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 em uma única página.
- Escolhendo o gatilho certo - qual delas se aplica ao seu caso.
- Gatilhos personalizados - quando nenhum gatilho integrado for adequado, crie o seu próprio.
- Histórico de eventos e solução de problemas - verificar o que foi disparado e o que estava carregado.
- Acionar gatilhos na página de administração de um registro - os eventos mais recentes de um registro, em sua própria página no painel de administração do Shopify.