Obtenir dades de l'article d'inventari

Als fluxos de treball que requereixen dades de l'article d'inventari, pots utilitzar l'acció Obtenir dades de l'article d'inventari per recuperar la informació de l'article d'inventari de la teva botiga. Els articles d'inventari representen les unitats d'estoc reals de les quals es fa el seguiment per a les variants del producte.

Nota

Aquest és un tipus d'acció Obtenir dades. Per entendre com utilitzar aquest tipus d'acció amb l'esdeveniment desencadenant Hora programada i les iteracions 'per a cada', consulta Programacions, obtenció de dades i fluxos de treball d'iteració a Shopify Flow.

Configuració

Camps

L'acció Obtenir dades de l'article d'inventari conté els camps següents:

Camps utilitzats a les accions Obtenir dades.

Camp	Descripció
Ordena les dades per	Obligatori. Els paràmetres pels quals s'ordenen les dades que retorna la consulta de cerca.
Nombre màxim de resultats	Obligatori. La quantitat màxima de resultats que pot retornar la consulta de cerca que seleccionis. Es poden retornar un màxim de 100 resultats alhora.
Consulta	Obligatori. Tria entre les consultes freqüents o selecciona Advanced per crear-ne una de pròpia.

Cadena de la consulta

Aquest és un exemple de consulta per obtenir els articles d'inventari dels quals es fa el seguiment:

tracked:true

La variable tracked és un filtre disponible a la consulta d'articles d'inventari i es pot utilitzar diverses vegades o combinar-se amb altres variables.

Quan es consulten dades, és útil saber el següent:

• Llista de filtres d'article d'inventari disponibles

• Les consultes han de seguir una sintaxi determinada

• Els valors dels camps de consulta no sempre estan documentats. En alguns casos, els valors es poden trobar mirant als documents de l'API. Com a alternativa, sovint pots trobar els valors dels camps als URL del panell d'administració quan hi filtres resultats. Per exemple, per trobar alguns valors de consulta de comanda, filtra la pàgina Comandes al panell d'administració i comprova l'URL.

• Pots executar o provar una consulta a la teva botiga mitjançant l'aplicació Shopify GraphiQL.

• Tingues en compte el que passa si la consulta falla. Sovint, l'API retornarà tots els resultats (en comptes de cap).

Dades retornades

Totes les accions Obtén dades retornen una llista d'entre 0 i 100 recursos. Segons el teu cas d'ús, pots utilitzar aquestes dades de diverses maneres:

• Si has de gestionar cada article de la llista individualment, per exemple, per afegir una etiqueta a cadascun, pots utilitzar l'acció Per a cada.
• Si has d'agregar dades, com ara comptar quants resultats s'han retornat, pots utilitzar les accions Compta o Suma.
• Si has d'emetre la llista, com ara enviar un correu electrònic amb tots els articles, pots utilitzar les dades retornades directament en accions posteriors.

Per accedir a les dades retornades en els passos posteriors a aquesta acció, utilitza la variable Obtén dades de l'article d'inventari, que és una llista d'articles d'inventari. Pots utilitzar aquesta variable tant en condicions com en accions. Per exemple, pots enviar la llista d'articles d'inventari en una acció Envia un correu electrònic intern similar a aquesta:

{% for single_inventory_item in getInventoryItemData %}
  * SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% endfor %}

Nota

Si una acció Obtén dades s'utilitza diverses vegades en un sol flux de treball, s'afegeix un número al nom de la variable. Per exemple, en un flux de treball que utilitza l'acció Obtén dades de la comanda dues vegades, la primera variable per a les dades retornades és getOrderData i la segona és getOrderData1. Aquest nom no es pot personalitzar.

Esdeveniments desencadenants

Pots utilitzar aquesta acció en qualsevol flux de treball, inclòs l'esdeveniment desencadenant Hora programada. En un flux de treball que utilitza l'esdeveniment desencadenant Hora programada, el flux de treball s'inicia a l'hora que hagis especificat en lloc de fer-ho com a resultat d'un esdeveniment. Com que no hi ha cap esdeveniment específic a la teva botiga ni des d'una aplicació que iniciï el flux de treball, no s'inclou cap dada de manera automàtica.

Referència de l'API

Per obtenir més informació sobre l'API que s'utilitza en aquesta acció, consulta la consulta d'articles d'inventari.