Gatilho do metacampo de transferência de estoque
Inicie um fluxo de trabalho do Shopify Flow quando um metacampo de transferência de estoque for alterado e receba o valor antigo e o novo.
Um lojista transfere mercadorias entre armazéns e introduz a referência de acompanhamento do transportador no metacampo de transferência Referência do transportador (custom.carrier_reference). Assim que for preenchido, o armazém de destino deverá recebê-la.
Esta página explica como iniciar um fluxo de trabalho do Shopify Flow sempre que um metacampo de uma transferência de estoque 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 referência da transportadora (custom.carrier_reference).
O que precisa
- Uma definição de metacampo. Crie-a no seu painel de administração do Shopify, em Definições > Metacampos e metaobjetos > Transferências. Um metacampo sem definição não pode ser monitorizado.
- A permissão Acesso aos dados de transferências de estoque. 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 Metacampo Triggers na aplicação e clique em Adicionar gatilho.
- Escolha o tipo de recurso Transferência.
- Assinale o metacampo, neste caso Referência da operadora. 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 gatilho fica ativo de imediato. Na primeira vez que a aplicação lê uma transferência de estoque, armazena o valor atual sem iniciar um fluxo de trabalho; qualquer alteração posterior dá início a um.
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 |
TRANSFER |
resourceId |
O ID da transferência de estoque, por exemplo, gid://shopify/InventoryTransfer/1234567890 |
metafieldKey |
Espaço de nomes e chave, neste caso custom.carrier_reference |
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 |
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 aTRANSFER. A atualização do metafield é iniciada para cada tipo de recurso que monitoriza, pelo que esta condição limita este fluxo de trabalho às transferências de inventário. Caso monitorize vários metafields desse tipo, adicionemetafieldKeyé igual acustom.carrier_referencecomo 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
- Adicione a condição «
metafield.previousValueestá vazio» para que a reação ocorra apenas quando a referência for preenchida pela primeira vez. - Envie a referência para o sistema do armazém de destino através da opção Enviar pedido HTTP.
- Adicione uma condição ao
metafieldKeyquando monitorizar vários metacampos de transferência.
Com que rapidez reage
O Shopify não envia qualquer notificação a este respeito, pelo que a aplicação lê os metacampos monitorizados aproximadamente uma vez por minuto. O fluxo de trabalho deverá ocorrer dentro de um ou dois minutos.
É bom saber
- São monitorizadas as transferências criadas nos últimos 90 dias. A alteração de um metacampo numa transferência mais antiga não dá início a nenhum fluxo de trabalho.
- Uma nova transferência é detetada pela primeira vez ao fim de cerca de um minuto. O valor que o metacampo já possui nesse momento constitui o seu valor inicial e não desencadeia qualquer fluxo de trabalho; todas as alterações posteriores a esse momento, por sua vez, desencadeiam-no.
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.
