Obtener datos de sesiones de seguimiento de transacciones en efectivo

En los flujos de trabajo que requieren datos de sesiones de seguimiento de transacciones en efectivo, puedes usar la acción Obtener datos de sesiones de seguimiento de transacciones en efectivo para recuperar información de sesiones de seguimiento de transacciones en efectivo desde POS Pro. Cash tracking sessions se usan para hacer seguimiento del efectivo en las cajas de la tienda.

Configuración

Campos

La acción Obtener datos de sesiones de seguimiento de transacciones en efectivo contiene los siguientes campos.

Campos usados en las acciones de Obtener datos.
CampoDescripción
Ordenar datos porObligatorio. Los parámetros por los que se ordenan los datos devueltos por la consulta.
Número máximo de resultadosObligatorio. La cantidad máxima de resultados que puede devolver la consulta que selecciones. Puedes devolver hasta 100 a la vez.
ConsultaObligatorio. Elige entre consultas comunes o selecciona Avanzada para crear la tuya.

Cadena de consulta

Esta es una consulta de ejemplo para obtener sesiones de seguimiento de transacciones en efectivo que se cerraron durante el último día:

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

La variable closing_time es un filtro disponible en la CashTrackingSessions 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 consultas datos, es útil saber lo siguiente:

  • List of available cash tracking session filters

  • Las consultas deben seguir una certain syntax

  • Los valores de los campos de las consultas no siempre están documentados. En algunos casos, los valores se pueden encontrar en la API docs. Como alternativa, a menudo puedes encontrarlos en las URL del panel de control cuando aplicas filtros. Por ejemplo, para encontrar algunos valores de consultas 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é sucede 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 utilizar estos datos de distintas maneras:

  • Si necesitas manejar cada elemento de la lista por separado, por ejemplo para agregar una etiqueta a cada uno, puedes usar la acción For each.
  • Si necesitas hacer agregaciones, como contar cuántos resultados se devolvieron, puedes usar 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 siguientes.

Para acceder a los datos devueltos en los pasos posteriores a esta acción, usa la variable denominada Get cash tracking session data, que es una lista de sesiones de seguimiento de transacciones en efectivo. Puedes usar esta variable tanto en condiciones como en acciones. Por ejemplo, puedes enviar la lista de sesiones de seguimiento de transacciones en efectivo en una acción Enviar correo electrónico interno así:

{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% endfor %}

Activadores

Puedes usar esta acción en cualquier flujo de trabajo, incluido el activador Hora programada. En un flujo de trabajo que usa el activador Hora programada, el flujo comienza en el momento que especificaste, en lugar de iniciarse por un evento. Como no hay un evento específico en la tienda ni de una aplicación que inicie el flujo, no se incluye ningún dato automáticamente.

Referencia de la API

Para obtener más información sobre la API que se usa en esta acción, consulta la CashTrackingSessions query.