Obter dados da variante do produto

Em fluxos de trabalho que usam dados de variantes de produto, é possível usar a ação Obter dados da variante do produto para recuperar informações de variantes do produto da loja.

Configuração

Campos

A ação Obter dados da variante do produto contém os seguintes campos, que são usados para criar a consulta:

String de consulta

Este é um exemplo de consulta para obter variantes de produto atualizadas no último dia:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

A variável updated_at é um filtro disponível na consulta de variantes de produto e pode ser usada várias vezes ou combinada com outras variáveis. A variável do Liquid scheduledAt está disponível em fluxos de trabalho que usam o acionador de horário agendado. A tag do Liquid date_minus é uma tag especial do Flow que permite subtrair um período de uma data.

Ao consultar dados, é útil saber o seguinte:

• Lista de filtros de variantes de produto disponíveis
• As consultas precisam seguir uma sintaxe específica
• Os valores dos campos de consulta nem sempre são documentados. Em alguns casos, os valores podem ser encontrados na documentação da API. Como alternativa, muitas vezes é possível encontrar os valores dos campos nos URLs do admin ao filtrar. Por exemplo, para encontrar alguns valores de consulta de pedido, filtre a página “Pedidos” no admin e verifique o URL.
• É possível executar ou testar uma consulta na loja usando o app Shopify GraphiQL.
• Fique atento ao que acontece se a consulta falhar. Muitas vezes, a API retorna todos os resultados, em vez de nenhum.

Dados retornados

Todas as ações para Obter dados retornam uma lista de 0 a 100 recursos. Dependendo do caso de uso, esses dados podem ser usados de várias maneiras:

• Se for preciso processar cada item da lista individualmente, por exemplo, para adicionar uma tag a cada um, use a ação Para cada.
• Se for preciso agregar dados, por exemplo, para contar quantos resultados foram retornados, use as ações Contar ou Somar.
• Se for preciso gerar a lista como resultado, por exemplo, para enviar um e-mail com todos os itens, use os dados retornados diretamente nas ações subsequentes.

Para acessar os dados retornados nas etapas seguintes a esta ação, use a variável chamada Obter dados da variante do produto, que é uma lista de variantes de produto. É possível usar essa variável em condições e ações. Por exemplo, é possível enviar a lista de pedidos em uma ação Enviar e-mail interno desta forma:

{% for single_variant in GetProductVariantData %}
* {{ single_variant.name }}
{% endfor %}

Acionadores

É possível usar esta ação em qualquer workflow, inclusive com o acionador Horário agendado. Nesse caso, o workflow começa em um horário especificado, e não como resultado de um evento. Como não há um evento específico na sua loja ou de um app que inicie o workflow, nenhum dado é incluído automaticamente.

Detalhes da API

• Recurso de variante do produto
• Filtros de consulta de variante do produto

Modelos

Adicionar item grátis (com 100% de desconto) a novos pedidos

Este modelo adiciona um item grátis a novos pedidos, se o item estiver em estoque. Ele verifica o estoque, aplica um desconto de 100% e atualiza o pedido sem notificar o cliente. Essa automação é útil para: (1) aumentar a satisfação do cliente ao incluir um item surpresa grátis no pedido; (2) promover produtos novos ou menos conhecidos, adicionando-os como amostras grátis nos pedidos; ou (3) otimizar promoções, automatizando a inclusão e o desconto de itens grátis. Ver modelo

Enviar resumo semanal por e-mail com lista de variantes com pouco estoque

Este workflow é executado de forma programada (como uma vez por semana). Ele busca uma lista de variantes de produto com pouco estoque, conta os resultados e envia um resumo por e-mail com os títulos das variantes e um link para a página da variante no admin. Ver modelo