Obter dados de rascunho de pedido
Em fluxos de trabalho que usam dados de rascunho de pedido, é possível usar a ação Obter dados de rascunho de pedido para recuperar informações de rascunhos de pedido da loja.
Configuração
Campos
A ação Obter dados de rascunho de pedido contém os seguintes campos, que são usados para criar a consulta:
| 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 podem ser retornados pela consulta de pesquisa que você selecionar. É possível retornar até 100 por vez. |
| Consulta | Obrigatório. Escolha entre as consultas comuns ou selecione Avançado para criar uma própria. |
String de consulta
Este é um exemplo de consulta para obter rascunhos de pedido que foram atualizados 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 rascunhos de pedido 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 usaram o acionador Horário programado. 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 pedido disponíveis
- As consultas precisam seguir uma determinada sintaxe
- Os valores dos campos de consulta nem sempre estão documentados. Em alguns casos, é possível encontrá-los na documentação da API. Como alternativa, muitas vezes os valores dos campos podem ser encontrados nos URLs do painel do admin ao filtrar. Por exemplo, para encontrar alguns valores de consulta de Pedido, filtre a página Pedidos no painel do 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 Obter dados retornam uma lista de 0 a 100 recursos. Dependendo do seu caso de uso, é possível usar esses dados de várias maneiras:
- Se você precisar lidar com cada item da lista individualmente, como para adicionar uma tag a cada um, use a ação Para cada.
- Se você precisar agregar dados, como contar quantos resultados foram retornados, use as ações Contar ou Somar.
- Se precisar da lista de resultados, como para enviar um e-mail com todos os itens, você poderá usar 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 de rascunho de pedido, que é uma lista de rascunhos de pedido. É possível usar essa variável em condições e ações. Por exemplo, você pode enviar a lista de rascunhos de pedido em uma ação Enviar e-mail interno, desta forma:
{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}Acionadores
É possível usar esta ação em qualquer fluxo de trabalho, inclusive com o acionador Horário programado. Em um fluxo de trabalho que usa o acionador Horário programado, o fluxo de trabalho é iniciado em um horário especificado por você, e não como resultado de um evento. Como não há um evento específico na loja ou de um app que inicie o fluxo de trabalho, nenhum dado é incluído automaticamente.
Detalhes da API
Modelos
Enviar notificação diária com todos os pedidos em rascunho abertos
Diariamente, obtém os pedidos em rascunho abertos, faz a contagem e envia uma mensagem no Slack. Usa o acionador Horário programado e as ações Obter rascunhos de pedido e Contar. Ver modelo