Obtener datos de contrato de suscripción

En los flujos de trabajo que usan datos de contratos de suscripción, puedes usar la acción Obtener datos de contrato de suscripción para recuperar información de contratos de suscripción de la tienda.

En esta página

Configuración

Campos

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

Campos usados en las acciones de Obtener datos.
Campo	Descripción
Ordenar datos por	Obligatorio. Los parámetros por los que se ordenan los datos devueltos por la consulta de búsqueda.
Número máximo de resultados	Obligatorio. La cantidad máxima de resultados que puede devolver la consulta de búsqueda que selecciones. Puedes devolver hasta 100 a la vez.
Consulta	Obligatorio. Elige entre consultas comunes o selecciona Avanzado para crear una propia.

Cadena de consulta

Este es un ejemplo de consulta para obtener contratos de suscripción con el estado ACTIVE:

status: ACTIVE

La variable status es un filtro disponible en la consulta de contratos de suscripción y se puede usar varias veces.

Cuando haces consultas de datos, conviene saber lo siguiente:

Lista de filtros disponibles
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 contacto de suscripción, que es una lista de contratos de suscripción. Puedes usar esta variable tanto en condiciones como en acciones. Por ejemplo, puedes enviar la lista de pedidos en una acción de Enviar correo electrónico interno de esta manera:

{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% 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 a la hora que especificaste y no como resultado de un evento. Como no hay un evento específico en la tienda ni en una aplicación que inicie el flujo, no se incluye ningún dato de forma automática.