Dapatkan data pesanan pemenuhan

Anda boleh menggunakan tindakan Dapatkan data pesanan pemenuhan untuk mengambil semula maklumat pesanan pemenuhan dari kedai anda.

Konfigurasi

Medan

Tindakan Dapatkan data pesanan pemenuhan mengandungi medan berikut, yang digunakan untuk membina pertanyaan:

Medan yang digunakan dalam tindakan Dapatkan data.
MedanPenerangan
Isih data mengikutDiperlukan. Parameter yang digunakan untuk mengisih data yang dikembalikan oleh pertanyaan carian.
Bilangan maksimum hasilDiperlukan. Amaun maksimum bagi hasil yang boleh dikembalikan oleh pertanyaan carian yang anda pilih. Anda boleh mengembalikan sehingga 100 pada satu masa.
PertanyaanDiperlukan. 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_HOLD

Pemboleh 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