Obtener datos de intentos de facturación de suscripción
En los flujos de trabajo que requieren datos de intentos de facturación de suscripción, puedes usar la acción Obtener datos de intentos de facturación de suscripción para recuperar información sobre los pedidos de la tienda.
En esta página
Configuración
Campos
La acción Obtener datos de intentos de facturación de suscripción contiene los siguientes campos, que se usan para crear la consulta:
| Campo | Descripción |
|---|---|
| Ordenar datos por | Obligatorio. Los parámetros con que se ordenan los datos obtenidos por la consulta de búsqueda. |
| Cantidad máxima de resultados | Obligatorio. La cantidad máxima de resultados que puede mostrar la consulta de búsqueda que selecciones. Puedes mostrar hasta 100 a la vez. |
| Consulta | Obligatorio. Elige entre las consultas comunes o selecciona Avanzada para crear la tuya. |
Cadena de consulta
Esta es una consulta de ejemplo para obtener los intentos de facturación de suscripción que se crearon en los últimos tres días:
created_at:>'{{ createdAt | date_minus: "3 day" }}'La variable created_at es un filtro disponible en la consulta de intentos de facturación de suscripción y puede usarse para seleccionar mensajes de error específicos de los intentos de facturación de suscripción.
Cuando se consultan datos, es útil saber lo siguiente:
- Lista de filtros disponibles de intentos de facturación de suscripción - Las consultas deben seguir una sintaxis determinada.
- Los nombres de campo para todas las consultas se pueden encontrar en los documentos del desarrollador para el objeto QueryRoot.
- Los valores de campo de consulta no siempre se documentan. En algunos casos, los valores se pueden encontrar si se revisan los documentos de la API. O bien, a menudo puedes encontrarlos en las URL en el panel de control cuando filtras. Por ejemplo, para encontrar algunos valores de consulta de pedidos, filtra la página Pedidos en el panel de control y luego verifica la URL.
- Puedes ejecutar o probar una consulta en la tienda mediante la aplicación Shopify GraphiQL.
- Ten cuidado con lo que sucede si falla la consulta. A menudo, la API mostrará todos los resultados (en lugar de ninguno).
Datos obtenidos
Todas las acciones Obtener datos muestran una lista de 0 a 100 recursos desde cualquier lugar. Según corresponda, es posible que desees utilizar estos datos de varias maneras:
- Si necesitas gestionar cada elemento de la lista de forma individual, como agregar una etiqueta para cada uno, puedes usar la acción Para cada.
- Si necesitas sumar los datos, como contar cuántos resultados se mostraron, puedes usar las acciones Recuento o Suma.
- Si necesitas exportar la lista, como enviar un correo electrónico con todos los elementos, puedes usar los datos obtenidos directamente en acciones posteriores.
Para acceder a los datos obtenidos en los pasos que siguen a esta acción, usa la variable Obtener datos de intentos de facturación de suscripción, que es una lista de intentos de facturación de suscripción. Puedes usar esta variable en condiciones y acciones. Por ejemplo, puedes enviar dicha lista en la acción Enviar correo electrónico interno del siguiente modo:
{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
{{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}Ejemplo
Por ejemplo, se programa un flujo de trabajo para ejecutarse todos los domingos a las 9:00 a. m. La acción Obtener datos de intentos de facturación de suscripción se usa para recopilar datos de los intentos de facturación de suscripción creados en la última semana. Si tienen un mensaje de error, se envía un correo electrónico con los intentos de facturación.