Obter datos do contrato de subscrición

Nos fluxos de traballo que utilicen datos dos contratos de subscrición, podes usar a acción Obter datos do contrato de subscrición para recuperar información dos contratos de subscrición da túa tenda.

Nesta páxina

Configuración

Campos

A acción Obter datos do contrato de subscrición contén os seguintes campos que se utilizan para crear a consulta:

Campos usados nas accións Obter datos.
Campo	Descrición
Ordenar datos por	Obrigatorio. Os parámetros para ordenar os datos que devolve a consulta de busca.
Número máximo de resultados	Obrigatorio. O número máximo de resultados que pode devolver a consulta de busca que selecciones. Pódese devolver un máximo de 100 á vez.
Consulta	Obrigatorio. Escolle entre as consultas habituais ou selecciona Avanzado para crear a túa propia.

Cadea de consulta

Este é un exemplo de consulta para obter os contratos de subscrición co estado ACTIVE:

status: ACTIVE

A variable status é un filtro dispoñible na consulta dos contratos de subscrición e pódese usar varias veces.

Para consultar datos, é útil saber o seguinte:

Lista de filtros dispoñibles
As consultas deben seguir unha determinada sintaxe
Os valores do campo da consulta non sempre están documentados. Nalgúns casos, os valores poden atoparse na documentación da API. En ocasións, tamén podes atopar os valores dos campos nos URL do panel de administración cando aplicas filtros. Por exemplo, para atopar algúns valores de consulta de pedidos, filtra a páxina Pedidos no panel de administración e logo comproba o URL.
Podes executar ou probar unha consulta na túa tenda usando a aplicación Shopify GraphiQL.
Ten en conta que pasa se falla a túa consulta. A miúdo a API devolverá todos os resultados (en vez de ningún).

Datos devoltos

Todas as accións Obter datos devolven unha lista de entre 0 e 100 recursos. Dependendo do teu caso, quizais queiras usar estes datos de diferentes maneiras:

Se tes que xestionar cada artigo da lista de forma individual, por exemplo, para engadir unha etiqueta a cada un deles, podes usar a acción Para cada.
Se tes que agregar datos, por exemplo para contar o número de resultados devoltos, podes usar as accións Contar ou Sumar.
Se necesitas mostrar a lista, por exemplo para enviar un correo electrónico con todos os artigos, podes usar directamente os datos devoltos en accións posteriores.

Para acceder aos datos devoltos nos pasos posteriores a esta acción, utiliza a variable co nome Obter datos do contrato de subscrición, que é unha lista de contratos de subscrición. Podes usar esta variable tanto nas condicións como nas accións. Por exemplo, podes enviar a lista dos pedidos nunha acción Enviar correo electrónico interno así:

{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% endfor %}

Activadores

Podes usar esta acción en calquera fluxo de traballo, incluído o activador Hora programada. Nun fluxo de traballo que utilice o activador Hora programada, o fluxo de traballo iníciase nun momento que especificases en lugar de facelo como resultado dun evento. Como non hai ningún evento en concreto na túa tenda nin nunha aplicación que inicie o fluxo de traballo, non se inclúen datos de forma automática.