Gatilho de metacampo de variante do produto
Inicie um fluxo de trabalho do Shopify Flow quando um metacampo de uma variante do produto for alterado. Acompanhe essa alteração nas Workflow Trigger
Um depósito armazena a prateleira de cada variante no metacampo de variante Localização no bin (custom.bin_location). Quando uma variante é transferida para outra prateleira, a equipe de separação precisa saber a nova localização antes que o próximo pedido seja embalado.
Esta página mostra como iniciar um fluxo de trabalho do Shopify Flow sempre que um metacampo de uma variante do produto for alterado, utilizando as Workflow Trigger Extensions. As etapas são as mesmas para todos os metacampos desse tipo de recurso; o exemplo utiliza a localização do compartimento (custom.bin_location).
O que o senhor precisa
- Uma definição de metacampo. Crie-a no painel de administração do Shopify, em Configurações > Metacampos e metaobjetos > Variantes. Um metacampo sem definição não pode ser rastreado.
- A permissão Acesso a dados de produtos, variantes e coleções. Conceda-a na página Permissões do aplicativo; consulte Permissões e acesso aos dados.
1. Acompanhar o metacampo
- Abra a seção Gatilhos de metacampo no aplicativo e clique em Adicionar gatilho.
- Escolha o tipo de recurso Variante do produto.
- Marque o metacampo, neste caso Localização da caixa. É possível marcar vários de uma só vez ou usar a opção Selecionar tudo.
- Clique em Adicionar gatilho.
Para acompanhar todos os metacampos desse tipo de recurso, incluindo aqueles que você criar posteriormente, selecione Todos os metacampos em vez de marcar cada um individualmente e, em seguida, clique em Acompanhar todos os metacampos.

O novo gatilho exibe Inicializando enquanto o aplicativo lê o valor atual do metacampo nas variantes do produto existentes e, em seguida, Ativo. Essa primeira leitura é o motivo pelo qual a primeira alteração já chega com o valor anterior correto.
Caso o metacampo não conste na lista, clique em Atualizar metacampos na página “Gatilhos de metacampos”: o aplicativo mantém a lista de definições por uma hora.
2. O que o fluxo de trabalho recebe
Cada alteração aciona o gatilho Metacampo Update no Shopify Flow com estes valores:
| Variável | Valor |
|---|---|
resourceType |
PRODUCTVARIANT |
resourceId |
O ID da variante do produto, por exemplo, gid://shopify/ProductVariant/1234567890 |
metafieldKey |
Espaço de nomes e chave, neste caso custom.bin_location |
metafield.value |
O novo valor |
metafield.previousValue |
O valor antes da alteração; vazio quando o metacampo foi definido pela primeira vez |
metafield.type |
O tipo do metacampo, por exemplo, single_line_text_field |
A Atualização do metacampo da variante do produto é um segundo gatilho para a mesma alteração. Ele é acionado além do “Atualização do metacampo” e inclui o produto pai como uma referência nativa do Shopify Flow. Ambos compartilham um único evento; portanto, o uso dos dois não é contabilizado duas vezes. Ative-o na página Gatilhos do aplicativo ou ative um fluxo de trabalho que o utilize.
3. Criar o fluxo de trabalho
- No Shopify Flow, crie um fluxo de trabalho e selecione o gatilho Atualização de metacampo das Workflow Trigger Extensions.
- Adicione uma condição:
resourceTypeé igual aPRODUCTVARIANT. A atualização dos metacampos é iniciada para cada tipo de recurso que você acompanha; portanto, essa condição restringe este fluxo de trabalho às variantes do produto. Caso você acompanhe vários metacampos desse tipo, adicionemetafieldKeyé igual acustom.bin_locationcomo um segundo critério. - Adicione a ação necessária. No exemplo, é enviado um e-mail interno com o valor antigo e o novo.

Comece pelo exemplo
- Faça o download do arquivo
.flow, anexado na parte inferior desta página. - No painel de administração do Shopify, abra o Shopify Flow, clique em Importar e selecione o arquivo.
- Abra a etapa Enviar e-mail interno e insira o destinatário. O arquivo não contém nenhum endereço propositalmente.
- Ative o fluxo de trabalho.
Faça disso algo seu
- Envie uma nova localização do contêiner para o sistema do seu armazém por meio da solicitação HTTP Send.
- Utilize a atualização do metacampo de variante do produto quando o fluxo de trabalho precisar marcar ou atualizar o produto pai.
- Adicione uma condição no
metafieldKeyquando você monitorar vários metacampos de variantes e desejar um fluxo de trabalho por metacampo.
Com que rapidez ele reage
O Shopify não envia nenhuma notificação quando um metacampo de variante é alterado; por isso, o aplicativo verifica seu catálogo aproximadamente uma vez por minuto e analisa apenas as variantes que sofreram alterações. O fluxo de trabalho deve ser concluído em poucos minutos; a primeira verificação de um catálogo extenso leva mais tempo.
É bom saber
- Um metacampo variante não aciona o Atualização do metacampo do produto: esse gatilho destina-se aos metacampos do próprio produto.
Mais
- Gatilhos de metacampo: como funcionam os gatilhos de metacampos, para cada tipo de recurso.
- Histórico de eventos e solução de problemas: visualize todos os eventos enviados pelo aplicativo, com os valores antigo e novo.
