Obter dados de desconto

Em workflows que exigem dados de desconto, você pode usar a ação Obter dados de desconto para recuperar informações de desconto da sua loja.

Nesta página

Configuração

Campos

A ação Obter dados de desconto contém os seguintes campos, que são usados para criar a consulta:

Campos usados nas ações Obter dados.
Campo	Descrição
Classificar dados por	Obrigatório. Os parâmetros pelos quais os dados retornados pela consulta de pesquisa são classificados.
Número máximo de resultados	Obrigatório. O número máximo de resultados que a consulta de pesquisa selecionada pode retornar. É possível retornar até 100 de uma vez.
Consulta	Obrigatório. Escolha uma das consultas comuns ou selecione Avançado para criar uma própria.

String de consulta

Este é um exemplo de consulta para buscar descontos ativos que usam um código:

method:code AND status:active

As variáveis method e status são filtros disponíveis na consulta de nó de Desconto e podem ser usadas várias vezes ou combinadas com outras variáveis.

Ao consultar dados, é útil saber o seguinte:

Lista de filtros de desconto disponíveis.
As consultas precisam seguir uma sintaxe específica
Os valores do campo de consulta nem sempre são documentados. Em alguns casos, é possível encontrá-los na documentação da API. Como alternativa, muitas vezes é possível encontrar os valores do campo nos URLs do admin após aplicar um filtro. 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 em sua loja com 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 Obter dados retornam uma lista com 0 a 100 recursos. Dependendo do caso de uso, é possível usar esses dados de várias maneiras:

Se for preciso processar cada item da lista individualmente, como para adicionar uma tag a cada um, use a ação Para cada.
Se precisar agregar dados, como contar quantos resultados foram retornados, use as ações Contar ou Somar.
Para usar a lista como resultado, por exemplo, no envio de 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 essa ação, use a variável com o nome Get discount data, que é uma lista de descontos. Você pode usar essa variável em condições e ações. Por exemplo, é possível enviar a lista de descontos de apps automáticos em uma ação Enviar e-mail interno da seguinte forma:

{% for discount_item in getDiscountData %}
{% if discount_item.discount.__typename == "DiscountAutomaticApp" %}
*  {{discount_item.discount.DiscountAutomaticApp.title}}
{% endif %}
{% endfor %}

Acionadores

É possível usar esta ação em qualquer workflow, incluindo o acionador Horário agendado. Em um workflow que usa o acionador Horário agendado, o workflow é iniciado no horário que você especificou, 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

Modelos

Resumo semanal por e-mail de descontos ativos que usam um código

Envia um resumo por e-mail dos descontos ativos que usam um código. O workflow é executado de forma programada toda segunda-feira, às 9h. É possível personalizar o workflow para alterar o horário, a forma de recebimento do resumo, o tipo de desconto a ser incluído e o modo. Ver modelo