Gatilho de metacampo de variante do produto
Inicie um fluxo do Shopify Flow quando um metacampo de variante do produto muda e receba o valor antigo e o novo, como a localização na prateleira.
Um armazém regista a prateleira de cada variante no metacampo de variante Localização na prateleira (custom.bin_location). Quando uma variante é transferida para outra prateleira, a equipa de preparação de pedidos necessita de conhecer a nova localização antes de o próximo pedido ser 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. Os passos são os mesmos para todos os metacampos deste tipo de recurso; o exemplo utiliza a localização do compartimento (custom.bin_location).
O que precisa
- Uma definição de metacampo. Crie-a no seu painel de administração do Shopify, em Definições > Metacampos e metaobjetos > Variantes. Um metacampo sem definição não pode ser monitorizado.
- A permissão Acesso a dados de produtos, variantes e coleções. Conceda-a na página Permissões da aplicação; consulte Autorizações e acesso aos dados.
1. Acompanhar o metacampo
- Abra a secção Metacampos de gatilhos na aplicação e clique em Adicionar gatilho.
- Escolha o tipo de recurso Variante do produto.
- Assinale o metacampo, neste caso Localização da caixa. Pode assinalar vários de uma só vez ou utilizar a opção Selecionar tudo.
- Clique em Adicionar gatilho.
Para acompanhar todos os metacampos deste tipo de recurso, incluindo aqueles que criar posteriormente, selecione Todos os metacampos em vez de assinalar cada um individualmente e, em seguida, clique em Acompanhar todos os metacampos.

O novo gatilho apresenta a mensagem A inicializar enquanto a aplicação lê o valor atual do metacampo nas variantes do produto existentes e, em seguida, Ativo. É essa primeira leitura que faz com que a primeira alteração já seja recebida com o valor anterior correto.
Se o metacampo não constar da lista, clique em Atualizar metacampos na página «Gatilhos de metacampos»: a aplicação guarda a lista de definições durante uma hora.
2. O que o fluxo de trabalho recebe
Cada alteração aciona o gatilho Metacampo Update no Shopify Flow, com os seguintes 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. É acionado em complemento ao «Atualização do metacampo» e inclui o produto pai como uma referência nativa do Flow. Ambos partilham um único evento, pelo que a utilização de ambos não conta duas vezes. Ative-o na página Gatilhos da aplicação 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 monitoriza, pelo que esta condição limita este fluxo de trabalho às variantes do produto. Caso monitorize vários metacampos deste tipo, adicionemetafieldKeyé igual acustom.bin_locationcomo segundo critério. - Adicione a ação que necessitar. O exemplo envia um e-mail interno com o valor antigo e o novo.

Comece pelo exemplo
- Descarregue o ficheiro
.flow, que se encontra em anexo na parte inferior desta página. - No seu painel de administração do Shopify, abra o Shopify Flow, clique em Importar e selecione o ficheiro.
- Abra o passo Enviar e-mail interno e introduza o destinatário. O ficheiro não contém qualquer endereço, propositadamente.
- Ative o fluxo de trabalho.
Faça-o seu
- Envie uma nova localização do contentor para o seu sistema de armazém através da opção Enviar pedido HTTP.
- Utilize a opção Atualização do metacampo da variante do produto quando o fluxo de trabalho tiver de tagar ou atualizar o produto principal.
- Adicione uma condição ao
metafieldKeyquando monitorizar vários metacampos de variantes e pretender um fluxo de trabalho por metacampo.
Com que rapidez reage
O Shopify não envia qualquer notificação quando um metacampo de variante é alterado; por isso, a aplicação verifica o seu catálogo aproximadamente uma vez por minuto e analisa apenas as variantes que sofreram alterações. O fluxo de trabalho deverá estar concluído em poucos minutos; a primeira verificação de um catálogo de grande dimensão demora mais tempo.
É bom saber
- Um metacampo variante não aciona o Product Metafield Update: esse gatilho destina-se aos metacampos do próprio produto.
Mais
- Gatilhos de metacampo: como funcionam os gatilhos de metacampo, para cada tipo de recurso.
- Histórico de eventos e resolução de problemas: veja todos os eventos enviados pela aplicação, com o valor antigo e o novo.
