Workflow Trigger ExtensionsWorkflow Trigger Extensions
Gatilhos baseados em tempo e em estoque a partir de modelos

Gatilhos baseados em tempo e em estoque a partir de modelos

Copiar página

Quatro modelos de gatilhos personalizados para o Shopify Flow: pedido não atendido há N dias, remessa parada, data em metacampo e estoque baixo por local.

O Shopify Flow reage quando algo ocorre. Algumas das automações mais úteis são acionadas quando algo não ocorre ou quando chega uma determinada data: um pedido que ainda não foi despachado após três dias, um pacote cujo rastreamento parou, uma data de lançamento armazenada em um metacampo. Outras exigem uma regra que uma condição do Shopify Flow não consegue expressar, como um limite de estoque mínimo diferente para cada local.

Existem quatro modelos que abrangem esses casos. Cada um deles é um gatilho personalizado: basta selecionar o modelo no editor de gatilhos personalizados, definir alguns valores na parte superior do código, testá-lo e ativá-lo. Não é necessário escrever o código por conta própria.

Os quatro modelos

Modelo Como funciona A que ele reage
Pedido não atendido há N dias De acordo com um horário, a cada hora Um pedido em aberto que ainda não foi processado, ou apenas parcialmente, pelo número de dias que o senhor definiu após a sua realização
A remessa está parada há N dias De acordo com um horário, a cada hora Uma remessa que não foi entregue, embora não tenha ocorrido nenhuma alteração no pedido durante o número de dias que o senhor definiu
Data em um metacampo atingida De acordo com um cronograma, a cada 6 horas Um metacampo de data de um produto ou pedido que já tenha ocorrido ou que esteja a um determinado número de dias de distância
O estoque ficou abaixo do limite estabelecido pela própria unidade local A cada alteração no estoque Estoque disponível em um local que fique abaixo do limite que o senhor definiu para esse local

O intervalo é o valor inicial do modelo. É possível alterá-lo no editor.

Utilize um modelo

Crie um gatilho personalizado na página “Gatilhos”, na seção Seus gatilhos personalizados. Atribua um nome e um identificador a ele. O identificador é o critério de filtragem do seu fluxo de trabalho e não pode ser alterado posteriormente.

Para os três modelos programados:

  1. Na seção O que faz com que isso seja executado, escolha a opção De acordo com uma programação.
  2. No cartão Agendamento, abra a lista Começar a partir de um modelo e selecione o modelo. Isso substitui o código e define o intervalo.
  3. Edite os valores na parte superior do código. Eles estão descritos abaixo, por modelo.
  4. Teste-o. Um teste executa seu código uma vez, não envia nada para o Shopify Flow e não armazena nada; portanto, você pode repeti-lo quantas vezes desejar.
  5. Ative o gatilho e salve.

Para o modelo padrão:

  1. Na seção O que faz com que isso funcione, escolha a opção “Um evento do Shopify”.
  2. Abra a lista Iniciar a partir de um modelo e selecione o modelo de estoque. O sistema seleciona o evento Alteração no nível de estoque no local e preenche o código.
  3. Edite os valores na parte superior do código.
  4. Registre um evento real alterando o estoque de uma variante em sua loja e, em seguida, execute um teste com base nele.
  5. Ative o gatilho e salve.

Utilize-o no Shopify Flow

Todos os quatro aparecem no Shopify Flow como o gatilho personalizado. Adicione-o a um fluxo de trabalho e defina uma condição: o campo Identificador do gatilho deve ser igual ao identificador do seu gatilho. Cada valor enviado pelo modelo corresponde a um campo no gatilho.

Os três modelos programados também passam o pedido ou o produto como o ID do registro do evento. Adicione uma etapa como Obter dados do pedido ou Obter dados do produto para carregar o registro completo e trabalhar com ele nas etapas seguintes.

Pedido não atendido há N dias

Identifica remessas atrasadas antes mesmo que o cliente pergunte.

Valor no código Começa como Significado
DAYS 3 Número de dias após a realização do pedido
ONLY_PAID true Somente os pedidos pagos são contabilizados. Um pedido não pago geralmente aguarda o pagamento, e não a sua intervenção

O gatilho inicia seu fluxo de trabalho uma vez para cada pedido aberto que ainda esteja pendente ou tenha sido processado apenas parcialmente quando atingir o prazo que você definiu. Um pedido que tenha sido processado dentro do prazo nunca aciona o gatilho.

A verificação ocorre uma vez por pedido, naquele momento. Um pedido que ainda não tenha sido atendido uma semana depois não aciona o fluxo de trabalho uma segunda vez. Com a configuração “somente pago”, um pedido que seja pago somente após esse momento também não será processado.

Campo enviado para Shopify Flow Contém
name O número do pedido, por exemplo, #1042
placedAt Quando o pedido foi feito
daysSinceOrder A idade do pedido em dias
fulfillmentStatus O status de processamento do pedido
financialStatus O status de pagamento do pedido
thresholdDays O número de dias que o(a) senhor(a) definir

O pedido em si é passado como o ID do registro do evento.

O código do modelo “Pedido não atendido há N dias” no editor de gatilhos personalizados, começando com os valores DAYS e ONLY_PAID
O modelo no editor. Os dois valores na parte superior do código são aqueles que o(a) senhor(a) deve editar.

A remessa está parada há N dias

Responde à pergunta “onde está meu pedido” antes mesmo que ela seja feita.

Valor no código Começa como Significado
DAYS 5 Número de dias sem nenhuma alteração
ONLY_WITH_TRACKING true Remessas sem número de rastreamento são excluídas. Elas nunca podem ser registradas como entregues
DONE DELIVERED, PICKED_UP, CANCELED Estados da remessa que são considerados concluídos

O Shopify não permite realizar pesquisas com base na data da última movimentação de uma remessa. Por isso, o modelo utiliza o pedido como critério. Ele procura pedidos concluídos ou parcialmente concluídos que não tenham sido atualizados pelo número de dias definido por você e que ainda tenham uma remessa pendente.

Qualquer alteração no pedido reinicia a contagem. Uma atualização de rastreamento faz isso, assim como uma nota editada ou uma nova tag.

O gatilho inicia seu fluxo de trabalho uma vez por remessa retida; portanto, um pedido com duas encomendas retidas o inicia duas vezes. São verificadas até três remessas por pedido.

Campo enviado para o Shopify Flow Contém
name O nome do pedido
fulfillmentId O número de identificação da remessa
shipmentStatus O status atual da remessa
lastTrackingStatus O status do último evento de rastreamento
lastMovedAt Quando a remessa foi movimentada pela última vez
daysWithoutMovement Dias desde a última movimentação da remessa
shippedAt Quando a remessa foi criada
estimatedDeliveryAt A data estimada de entrega, caso a transportadora a informe
carrier O nome da transportadora
trackingNumber O número de rastreamento
trackingUrl O link de rastreamento
thresholdDays O número de dias que o(a) senhor(a) definir

O pedido em si é passado como o ID do registro do evento.

Data em um metacampo atingida

Para datas de lançamento, garantias, prazos de validade, datas de renovação: qualquer informação que o senhor ou a senhora mantenha como data em um produto ou em um pedido.

Valor no código Começa como Significado
RESOURCE "products" Onde o metacampo se encontra: nos produtos ou nos pedidos
NAMESPACE "custom" O namespace do metacampo
KEY "release_date" A chave do metacampo
OFFSET_DAYS 0 Número de dias antes ou depois da data. Veja os exemplos a seguir

Três exemplos de deslocamento:

Deslocamento Quando o seu fluxo de trabalho for iniciado
0 Na própria data
-7 Sete dias antes da data
30 Trinta dias após a data

O gatilho inicia seu fluxo de trabalho uma vez para cada produto ou pedido cuja data de vencimento seja nesse dia. Os dias são referidos em UTC. O gatilho processa um dia de cada vez; portanto, os dias que não foram processados são recuperados em ordem. Quando há mais de 100 registros com vencimento em um único dia, os demais são processados nas execuções seguintes.

Campo enviado para Shopify Flow Contém
name O título do produto ou o nome do pedido
date A data armazenada no metacampo
reachedOn O dia em que o registro deveria ser entregue
offsetDays O deslocamento que o(a) senhor(a) definiu

O próprio produto ou pedido é passado como o ID do registro do evento.

O estoque ficou abaixo do limite estabelecido pela própria unidade local

Uma regra de estoque mínimo por local: 20 no depósito, 3 na loja.

Valor no código Começa como Significado
THRESHOLDS { "Main warehouse": 20, "Pop-up store": 3 } O limite de cada local, por nome do local
DEFAULT 5 O limite para cada local que não esteja listado
ALSO_WHEN_RESTOCKED false Se o seu fluxo de trabalho também é acionado quando o estoque volta a atingir ou ultrapassar o limite

Para ignorar um local, atribua a ele o limite null. Para monitorar apenas os locais listados, defina o limite padrão como null.

O gatilho aciona seu fluxo de trabalho uma única vez, no momento da transição: o estoque estava igual ou acima do limite antes da alteração e ficou abaixo dele depois. Ele não reage a todas as vendas enquanto o estoque já estiver baixo. Isso é possível porque o aplicativo conhece o nível de estoque antes e depois de cada alteração.

Escreva os nomes dos locais exatamente como aparecem no painel de administração do Shopify, em Configurações > Locais.

Este modelo precisa que o gatilho Nível de estoque alterado no local esteja ativado, com as respectivas permissões concedidas. É isso que faz com que o aplicativo acompanhe os níveis de estoque. Consulte A página “Gatilhos” (anteriormente “Configurações”) e Permissões e acesso aos dados.

Campo enviado para Shopify Flow Contém
event O que ocorreu: a cotação caiu abaixo do limite ou voltou a subir
productTitle O título do produto
variantTitle A variante do título
sku O SKU da variante
location O nome do local
locationId O ID do local
oldAvailable Estoque disponível antes da alteração
newAvailable Estoque disponível após a alteração
threshold O limite que se aplicava

O campo referente ao que ocorreu contém um dos dois valores:

Valor Significado
below As ações caíram abaixo do limite
restocked O estoque voltou a ficar no nível do limite ou acima dele
Por que meu fluxo de trabalho não iniciou depois que ativei o gatilho?

A primeira execução de um modelo programado lembra apenas seu ponto de partida. O gatilho reage a pedidos, remessas e datas que ultrapassam esse ponto a partir daí, e não àqueles que já o haviam ultrapassado.

Posso executar a verificação com frequência maior do que a cada hora?

Sim, o intervalo é de sua escolha, desde a cada 30 segundos até uma vez por dia. Um intervalo mais curto significa mais execuções, e cada execução conta para o seu plano. Para uma regra medida em dias, uma vez por hora costuma ser mais do que suficiente.

O gatilho de data apresenta um erro. O que está acontecendo?

Quase sempre, trata-se da definição do metacampo. Ele deve ser do tipo Data e ter a opção Filtragem ativada em Configurações > Dados personalizados. Verifique também se o namespace e a chave no código correspondem exatamente à definição.

Um modelo pode alterar meus pedidos ou produtos?

Não. Um gatilho personalizado apenas realiza a leitura. Para marcar o pedido, enviar um e-mail ou atualizar um Metacampo, adicione essas ações ao fluxo de trabalho que se inicia com o gatilho.

Uma remessa ficou retida por mais tempo do que os dias que eu defini, e meu fluxo de trabalho não foi iniciado. Por quê?

A contagem é calculada a partir da última alteração no pedido. Se, nesse intervalo, o pedido tiver sido editado pela equipe, por outro aplicativo ou por uma atualização de rastreamento, a contagem recomeça a partir desse momento.

Próximos passos