Obtener datos de intentos de cobro de suscripción

En los flujos de trabajo que requieren datos de intentos de cobro de suscripción, puedes usar la acción Obtener datos de intentos de cobro de suscripción para recuperar información de pedidos de la tienda.

Configuración

Campos

La acción Obtener datos de intentos de cobro de suscripción incluye los siguientes campos, que se usan para crear la consulta:

Cadena de consulta

Esta es una consulta de ejemplo para obtener intentos de cobro 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 cobro de suscripción y se puede usar para filtrar por un mensaje de error específico de los intentos de cobro de suscripción.

Cuando consultes datos, conviene tener en cuenta:

• Lista de filtros disponibles para intentos de cobro de suscripción
• Las consultas deben seguir una sintaxis específica
• Los valores de los campos de la consulta no siempre están documentados. En algunos casos, puedes encontrarlos en la documentación de la API. También puedes hallarlos a menudo en las URL del 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 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, quizá quieras usar estos datos de distintas maneras:

• Si necesitas procesar cada elemento de la lista por separado, por ejemplo para agregar una etiqueta a cada uno, puedes usar la acción Para cada.
• Si necesitas agregar datos, por ejemplo contar cuántos resultados se devolvieron, puedes usar las acciones Contar o Sumar.
• Si necesitas mostrar la lista, por ejemplo enviar un correo electrónico con todos los artículos, 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 intentos de cobro de suscripción, que es una lista de intentos de cobro de suscripción. Puedes usar esta variable tanto en condiciones como en acciones. Por ejemplo, puedes enviar la lista de intentos de cobro de suscripción en una acción de Enviar correo electrónico interno de esta manera:

{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
  {{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}

Ejemplo

Por ejemplo, un flujo de trabajo está programado para ejecutarse todos los domingos a las 9:00 a. m. La acción Obtener datos de intentos de cobro de suscripción se usa para recopilar datos de los intentos de cobro de suscripción creados durante la última semana. Si tienen un mensaje de error, envía por correo electrónico los intentos de cobro.

Referencia de la API

• Recurso de intento de cobro de suscripción
• Filtros de consulta de intentos de cobro de suscripción