Obținere date comandă de onorare

Puteți utiliza acțiunea Obținere date comandă de onorare pentru a recupera informații despre comanda de onorare din magazinul dumneavoastră.

Configurare

Câmpuri

Acțiunea Obținere date comandă de onorare conține următoarele câmpuri, care sunt utilizate pentru a construi interogarea:

Câmpuri utilizate în acțiunile Obținere date.
CâmpDescriere
Sortare date dupăObligatoriu. Parametrii după care sunt sortate datele returnate de interogarea de căutare.
Numărul maxim de rezultateObligatoriu. 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 odată.
InterogareObligatoriu. Alegeți dintre interogările obișnuite sau selectați Avansat pentru a vă crea propria interogare.

Șir de interogare

Acesta este un exemplu de interogare pentru obținerea comenzilor de onorare care sunt în prezent în așteptare:

status:ON_HOLD

Variabila status este un filtru disponibil în interogarea Comenzi de onorare și poate fi utilizată de mai multe ori sau combinată cu alte variabile.

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

  • Listă de filtre disponibile pentru comenzile de onorare
  • Interogările trebuie să respecte 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 unele valori pentru interogarea de Comandă, filtrați pagina Comenzi din panoul de administrare, apoi verificați adresa URL.
  • Puteți rula sau testa o interogare în magazinul dumneavoastră folosind aplicația Shopify GraphiQL.
  • Fiți atent la ce se întâmplă dacă interogarea eșuează. Adesea, API-ul va returna toate rezultatele (în loc de niciunul).

Date returnate

Toate acțiunile de tip Preluare date returnează o listă de la 0 la 100 de resurse. În funcție de cazul dumneavoastră de utilizare, este posibil să doriți să utilizați aceste date în diverse moduri:

  • Dacă trebuie să gestionați fiecare articol din listă individual, cum ar fi pentru a adăuga o etichetă pentru fiecare, atunci puteți utiliza acțiunea Pentru fiecare.
  • Dacă trebuie să agregați date, cum ar fi să numărați câte rezultate au fost returnate, puteți utiliza acțiunile Contorizare sau Însumare.
  • Dacă trebuie să generați lista ca rezultat, cum ar fi 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, utilizați variabila denumită Preluare date comandă de onorare, care este o listă de comenzi de onorare. Puteți utiliza această variabilă atât în condiții, cât și în acțiuni. De exemplu, puteți trimite lista de comenzi de onorare într-o acțiune Trimitere e-mail intern în acest fel:

{% for fulfillment_order in GetFulfillmentOrderData %}
* Order: {{ fulfillment_order.order.name }} Location: {{ fulfillment_order.assignedLocation.name }}
{% endfor %}

Declanșatori

Puteți utiliza această acțiune în orice flux de lucru, inclusiv în declanșatorul Oră programată. Într-un flux de lucru care utilizează declanșatorul Oră programată, fluxul de lucru pornește la o oră specificată de dumneavoastră, mai degrabă decât ca urmare a unui eveniment. Deoarece nu există niciun eveniment specific în magazinul dumneavoastră sau dintr-o aplicație care să pornească fluxul de lucru, nu există date incluse automat.

Detalii API

Șabloane

Trimitere sumar zilnic prin e-mail cu lista comenzilor de onorare care sunt în așteptare

În fiecare zi, acest flux de lucru va interoga toate comenzile de onorare care sunt în așteptare (până la 100 odată). Va trimite un sumar prin e-mail cu numele comenzii și locația de onorare alocată. Vizualizare șablon