Gatilho de metacampo de variante do produto

Gatilho de metacampo de variante do produto

Copiar página

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

  1. Abra a secção Metacampos de gatilhos na aplicação e clique em Adicionar gatilho.
  2. Escolha o tipo de recurso Variante do produto.
  3. Assinale o metacampo, neste caso Localização da caixa. Pode assinalar vários de uma só vez ou utilizar a opção Selecionar tudo.
  4. 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.

A caixa de diálogo «Adicionar Gatilho de Metacampo» com o tipo de recurso «Variante do produto» e o metacampo «Localização do compartimento», custom.bin_location, assinalado
Tipo de recurso «Variante do produto», com o metacampo assinalado. A opção «Todos os metacampos» monitoriza, em vez disso, todos os metacampos desse tipo.

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

  1. No Shopify Flow, crie um fluxo de trabalho e selecione o gatilho Atualização de metacampo das Workflow Trigger Extensions.
  2. Adicione uma condição: resourceType é igual a PRODUCTVARIANT. 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, adicione metafieldKey é igual a custom.bin_location como segundo critério.
  3. Adicione a ação que necessitar. O exemplo envia um e-mail interno com o valor antigo e o novo.
O fluxo de trabalho de exemplo no Shopify Flow: Atualização de metacampo, uma condição no tipo de recurso PRODUCTVARIANT e Envio de e-mail interno
O fluxo de trabalho de exemplo: o gatilho, a condição relativa ao tipo de recurso e uma ação.

Comece pelo exemplo

  1. Descarregue o ficheiro .flow, que se encontra em anexo na parte inferior desta página.
  2. No seu painel de administração do Shopify, abra o Shopify Flow, clique em Importar e selecione o ficheiro.
  3. Abra o passo Enviar e-mail interno e introduza o destinatário. O ficheiro não contém qualquer endereço, propositadamente.
  4. 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 metafieldKey quando 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