Obțineți datele articolului de inventar

În fluxurile de lucru care necesită date despre articolele de inventar, puteți utiliza acțiunea Obțineți datele articolului de inventar pentru a recupera informații despre articolele de inventar din magazinul dumneavoastră. Articolele de inventar reprezintă unitățile de stoc efective care sunt urmărite pentru variantele de produs.

Pe această pagină

Configurație

Câmpuri

Acțiunea Obțineți datele articolului de inventar conține următoarele câmpuri:

Câmpuri utilizate în acțiunile Obține date.
Câmp	Descriere
Sortează datele după	Obligatoriu. Parametrii după care sunt sortate datele returnate de interogarea de căutare.
Numărul maxim de rezultate	Obligatoriu. Numărul maxim de rezultate care pot fi returnate de interogarea de căutare pe care o selectați. Puteți returna până la 100 simultan.
Interogare	Obligatoriu. Alegeți dintre interogările frecvente sau selectați Avansat pentru a vă crea propria interogare.

Șirul interogării

Acesta este un exemplu de interogare pentru obținerea articolelor de inventar care sunt urmărite:

tracked:true

Variabila tracked este un filtru disponibil în Interogarea pentru articolele de inventar și poate fi utilizată de mai multe ori sau combinată cu alte variabile.

Când interogați date, este util să știți următoarele:

Lista de filtre disponibile pentru articolele de inventar
Interogările trebuie să urmeze o anumită sintaxă
Valorile câmpurilor de interogare nu sunt întotdeauna documentate. În unele cazuri, valorile pot fi găsite consultând documentația API. Alternativ, puteți găsi adesea valorile câmpurilor în adresele URL din panoul de administrare atunci când filtrați. De exemplu, pentru a găsi anumite valori de interogare pentru comenzi, filtrați pagina Comenzi din panoul de administrare și apoi verificați adresa URL.
Puteți rula sau testa o interogare în magazinul dumneavoastră utilizând aplicația Shopify GraphiQL.
Fiți atent la ce se întâmplă dacă interogarea dumneavoastră eșuează. Adesea, API-ul va returna toate rezultatele (în loc de niciunul).

Datele returnate

Toate acțiunile Obține date returnează o listă de oriunde între 0 și 100 de resurse. În funcție de cazul dumneavoastră de utilizare, ați putea dori să utilizați aceste date în diverse moduri:

Dacă trebuie să gestionați fiecare articol din listă în mod individual, cum ar fi să adăugați o etichetă pentru fiecare, atunci puteți utiliza acțiunea Pentru fiecare.
Dacă trebuie să agregați date, cum ar fi numărarea rezultatelor returnate, atunci puteți utiliza acțiunile Numără sau Sumă.
Dacă trebuie să afișați lista, de exemplu, să trimiteți un e-mail cu toate articolele, puteți utiliza datele returnate direct în acțiunile ulterioare.

Pentru a accesa datele returnate în pașii care urmează acestei acțiuni, folosiți variabila numită Obține datele articolului de inventar, care este o listă de articole de inventar. Puteți folosi această variabilă atât în condiții, cât și în acțiuni. De exemplu, puteți trimite lista de articole de inventar într-o acțiune Trimite e-mail intern similară cu aceasta:

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

Declanșatoare

Puteți utiliza această acțiune în orice flux de lucru, inclusiv cu declanșatorul Oră programată. Într-un flux de lucru care utilizează declanșatorul Oră programată, fluxul de lucru începe la ora pe care ați specificat-o, nu ca rezultat al unui eveniment. Deoarece nu există niciun eveniment specific în magazinul dumneavoastră sau dintr-o aplicație care să înceapă fluxul de lucru, nu sunt incluse automat date.

Referință API

Pentru mai multe informații despre API-ul utilizat în această acțiune, consultați interogarea pentru articole de inventar.