Obter datos do pedido preliminar

Nos fluxos de traballo que usan datos de pedidos preliminares, podes usar a acción Obter datos do pedido preliminar para recuperar información dos pedidos preliminares da túa tenda.

Configuración

Campos

A acción Obter datos do pedido preliminar contén os seguintes campos, que se usan para crear a consulta:

Campos usados nas accións Obter datos.
CampoDescrición
Ordenar datos porObrigatorio. Os parámetros mediante os cales se ordenan os datos devoltos pola consulta de busca.
Número máximo de resultadosObrigatorio. A cantidade máxima de resultados que pode devolver a consulta de busca que selecciones. Podes devolver ata 100 á vez.
ConsultaObrigatorio. Escolle entre consultas comúns ou selecciona Avanzada para crear a túa propia.

Cadea de consulta

Este é un exemplo de consulta para obter borradores de pedidos que se actualizaron no último día:

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

A variable updated_at é un filtro dispoñible na consulta de borradores de pedidos e pódese usar varias veces ou combinarse con outras variables. A variable de Liquid scheduledAt está dispoñible nos fluxos de traballo que usaron o activador de Hora programada. A etiqueta de Liquid date_minus é unha etiqueta especial de Flow que permite restar tempo a unha data.

Ao consultar datos, é útil saber o seguinte:

  • Lista de filtros de pedidos dispoñibles
  • As consultas deben seguir unha certa sintaxe
  • Os valores do campo de consulta non sempre están documentados. Nalgúns casos, os valores pódense atopar consultando a documentación da API. De forma alternativa, adoita ser posible atopar os valores dos campos nos URL do panel de administración ao filtrar. Por exemplo, para atopar algúns valores da consulta de Pedidos, filtra a páxina Pedidos no panel de administración e despois comproba o URL.
  • Podes executar ou probar unha consulta na túa tenda usando a aplicación de GraphiQL de Shopify.
  • Ten en conta que ocorre se a túa consulta falla. Moitas veces, a API devolverá todos os resultados (en lugar de ningún).

Datos devoltos

Todas as accións Obter datos devolven unha lista de entre 0 e 100 recursos. Dependendo do teu caso de uso, pode que queiras usar estes datos de varias formas:

  • Se necesitas xestionar cada artigo da lista individualmente, como para engadir unha etiqueta a cada un, podes usar a acción Para cada.
  • Se necesitas agregar datos, como por exemplo contar cantos resultados se devolveron, entón podes usar as accións Contar ou Sumar.
  • Se necesitas emitir a lista, como para enviar un correo electrónico con todos os artigos, podes usar os datos devoltos directamente en accións posteriores.

Para acceder aos datos devoltos nos pasos que seguen a esta acción, usa a variable chamada Obter datos do pedido preliminar, que é unha lista de borradores de pedidos. Podes usar esta variable tanto en condicións como en accións. Por exemplo, podes enviar a lista de borradores de pedidos nunha acción Enviar correo electrónico interno desta forma:

{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}

Activadores

Podes usar esta acción en calquera fluxo de traballo, incluíndo o activador de Hora programada. Nun fluxo de traballo que use o activador de Hora programada, o fluxo de traballo iníciase na hora que especificases, en lugar de como resultado dun evento. Como non hai ningún evento específico na túa tenda nin desde unha aplicación que inicie o fluxo de traballo, non se inclúe ningún dato automaticamente.

Modelos

Enviar notificación diaria con todos os pedidos preliminares abertos

Todos os días, obtén os borradores de pedidos abertos, cóntaos e envía unha mensaxe a Slack. Usa o activador de Hora programada e as accións Obter borradores de pedidos e Contar. Ver modelo