Dapatkan data pesanan pemenuhan
Anda boleh menggunakan tindakan Dapatkan data pesanan pemenuhan untuk mengambil semula maklumat pesanan pemenuhan dari kedai anda.
Pada halaman ini
Konfigurasi
Medan
Tindakan Dapatkan data pesanan pemenuhan mengandungi medan berikut, yang digunakan untuk membina pertanyaan:
| Medan | Penerangan |
|---|---|
| Isih data mengikut | Diperlukan. Parameter yang digunakan untuk mengisih data yang dikembalikan oleh pertanyaan carian. |
| Bilangan maksimum hasil | Diperlukan. Amaun maksimum bagi hasil yang boleh dikembalikan oleh pertanyaan carian yang anda pilih. Anda boleh mengembalikan sehingga 100 pada satu masa. |
| Pertanyaan | Diperlukan. Pilih daripada pertanyaan biasa atau pilih Lanjutan untuk mencipta pertanyaan anda sendiri. |
Rentetan pertanyaan
Ini ialah contoh pertanyaan untuk mendapatkan pesanan pemenuhan yang sedang ditangguhkan:
status:ON_HOLDPemboleh ubah status ialah penapis yang tersedia pada pertanyaan Pesanan Pemenuhan dan boleh digunakan berulang kali atau digabungkan dengan pemboleh ubah lain.
Apabila menanyakan data, perkara berikut berguna untuk diketahui:
- Senarai penapis pesanan pemenuhan yang tersedia
- Pertanyaan mesti mengikut sintaks tertentu
- Nilai medan pertanyaan tidak sentiasa didokumentasikan. Dalam sesetengah kes, nilai tersebut boleh didapati dengan melihat dokumen API. Sebagai alternatif, anda juga boleh mencari nilai medan dalam URL dalam Admin apabila anda menapis. Sebagai contoh, untuk mencari sesetengah nilai pertanyaan Pesanan, tapis halaman Pesanan dalam Admin, kemudian semak URL tersebut.
- Anda boleh menjalankan atau menguji pertanyaan di kedai anda dengan menggunakan aplikasi Shopify GraphiQL.
- Ambil perhatian tentang perkara yang berlaku jika pertanyaan anda gagal. API sering kali akan mengembalikan semua hasil (bukan tiada hasil langsung).
Data yang dikembalikan
Semua tindakan Dapatkan data mengembalikan senarai mana-mana antara 0 hingga 100 sumber. Bergantung pada kes penggunaan anda, anda mungkin mahu menggunakan data ini melalui pelbagai cara:
- Jika anda perlu mengendalikan setiap item senarai secara berasingan, seperti menambah tag untuk setiap satu, anda boleh menggunakan tindakan Untuk setiap.
- Jika anda perlu mengagregat data, seperti mengira bilangan hasil yang dikembalikan, anda boleh menggunakan tindakan Kira atau Jumlah.
- Jika anda perlu mengeluarkan senarai, seperti menghantar e-mel dengan semua item, anda boleh menggunakan data yang dikembalikan secara langsung dalam tindakan seterusnya.
Untuk mengakses data yang dikembalikan dalam langkah-langkah yang mengikuti tindakan ini, gunakan pemboleh ubah bernama Dapatkan data pesanan pemenuhan, iaitu senarai pesanan pemenuhan. Anda boleh menggunakan pemboleh ubah ini dalam kedua-dua syarat dan tindakan. Sebagai contoh, anda boleh menghantar senarai pesanan pemenuhan dalam tindakan Hantar e-mel dalaman seperti ini:
{% for fulfillment_order in GetFulfillmentOrderData %}
* Order: {{ fulfillment_order.order.name }} Location: {{ fulfillment_order.assignedLocation.name }}
{% endfor %}Pencetus
Anda boleh menggunakan tindakan ini dalam mana-mana aliran kerja, termasuk pencetus Masa dijadualkan. Dalam aliran kerja yang menggunakan pencetus Masa dijadualkan, aliran kerja bermula pada masa yang telah anda tentukan, bukannya hasil daripada sesuatu peristiwa. Oleh sebab tiada peristiwa khusus dalam kedai anda atau daripada aplikasi yang memulakan aliran kerja, tiada data yang disertakan secara automatik.
Butiran API
Templat
Hantar ringkasan e-mel harian dengan senarai pesanan pemenuhan yang ditangguhkan
Setiap hari, aliran kerja ini akan membuat pertanyaan untuk semua pesanan pemenuhan yang ditangguhkan (sehingga 100 pada satu-satu masa). Ia akan menghantar ringkasan e-mel dengan nama pesanan dan lokasi pemenuhan yang ditetapkan. Lihat templat