Obtener datos de pedido preliminar
En los flujos de trabajo que usan datos de pedidos preliminares, puedes usar la acción Obtener datos de pedido preliminar para recuperar información de pedidos preliminares de la tienda.
En esta página
Configuración
Campos
La acción Obtener datos de pedido preliminar contiene los siguientes campos, que se usan para crear la consulta:
| Campo | Descripción |
|---|---|
| Ordenar datos por | Obligatorio. Parámetros para ordenar los datos que devuelve la consulta. |
| Número máximo de resultados | Obligatorio. Número máximo de resultados que puede devolver la consulta que selecciones. Puedes obtener hasta 100 por vez. |
| Consulta | Obligatorio. Elige entre consultas comunes o selecciona Avanzada para crear una propia. |
Cadena de consulta
Este es un ejemplo de consulta para obtener pedidos preliminares que se actualizaron en el último día:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'La variable updated_at es un filtro disponible en la Draft orders query y se puede usar varias veces o combinar con otras variables. La variable de Liquid scheduledAt está disponible en los flujos de trabajo que usan el Scheduled time trigger. La etiqueta de Liquid date_minus es una etiqueta especial de Flow que permite restar tiempo a una fecha.
Cuando consultes datos, conviene saber lo siguiente:
- List of available order filters
- Las consultas deben seguir una certain syntax
- Los valores de los campos de la consulta no siempre están documentados. En algunos casos, puedes encontrarlos en la API docs. También puedes encontrar los valores de los campos en las URL del panel de control cuando aplicas filtros. Por ejemplo, para encontrar algunos valores de la consulta de pedidos, filtra la página Pedidos en el panel de control y luego revisa la URL.
- Puedes ejecutar o probar una consulta en la tienda con la Shopify GraphiQL app.
- Ten en cuenta qué pasa si la consulta falla. A menudo, la API devuelve todos los resultados (en lugar de ninguno).
Datos devueltos
Todas las acciones de Obtener datos devuelven una lista de entre 0 y 100 recursos. Según el caso de uso, puedes emplear estos datos de distintas maneras:
- Si necesitas gestionar cada elemento de la lista por separado, por ejemplo para agregar una etiqueta a cada uno, usa la acción For each.
- Si necesitas realizar agregaciones, como contar cuántos resultados se devolvieron, usa las acciones Count o Sum.
- Si necesitas mostrar la lista, por ejemplo enviar un correo electrónico con todos los elementos, puedes usar los datos devueltos directamente en las acciones posteriores.
Para acceder a los datos devueltos en los pasos que siguen a esta acción, usa la variable llamada Obtener datos de pedido preliminar, que es una lista de pedidos preliminares. Puedes usar esta variable tanto en condiciones como en acciones. Por ejemplo, puedes enviar la lista de pedidos preliminares en una acción Enviar correo electrónico interno de esta manera:
{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}Activadores
Puedes usar esta acción en cualquier flujo de trabajo, incluido el activador Scheduled time. En un flujo de trabajo que usa el activador Scheduled time, el flujo empieza a la hora que especifiques, y no como resultado de un evento. Como no hay un evento específico en la tienda o de una aplicación que inicie el flujo, no se incluye ningún dato automáticamente.
Detalles de la API
Plantillas
Enviar notificación diaria con todos los pedidos preliminares abiertos
Todos los días, obtén los pedidos preliminares abiertos, cuéntalos y envía un mensaje de Slack. Usa el activador Scheduled time, la acción Obtener pedidos preliminares y la acción Contar. View template