Dapatkan data pesanan
Dalam aliran kerja yang memerlukan data pesanan, anda boleh menggunakan tindakan Dapatkan data pesanan untuk mengambil semula maklumat pesanan dari kedai anda.
Pada halaman ini
Konfigurasi
Medan
Tindakan Dapatkan data pesanan mengandungi medan berikut, yang digunakan untuk membina pertanyaan:
| Medan | Penerangan |
|---|---|
| Isih data mengikut | Wajib. Parameter yang menetapkan cara data yang dikembalikan oleh pertanyaan carian diisih. |
| Bilangan hasil maksimum | Wajib. Jumlah maksimum hasil yang boleh dikembalikan oleh pertanyaan carian yang anda pilih. Anda boleh mengembalikan sehingga 100 hasil pada satu-satu masa. |
| Pertanyaan | Diperlukan. Pilih daripada pertanyaan biasa atau pilih Lanjutan untuk cipta pertanyaan anda sendiri. |
Rentetan Pertanyaan
Ini ialah contoh pertanyaan untuk mendapatkan pesanan yang dikemas kini pada hari sebelumnya:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Pemboleh ubah updated_at ialah penapis yang tersedia pada pertanyaan Pesanan dan boleh digunakan beberapa kali atau digabungkan dengan pemboleh ubah lain. Pemboleh ubah Liquid scheduledAt tersedia pada aliran kerja yang menggunakan pencetus Masa dijadualkan. Tag Liquid date_minus ialah tag Flow khas yang membolehkan anda menolak masa daripada tarikh.
Apabila menanyakan data, perkara ini berguna untuk diketahui:
- Senarai penapis pesanan yang tersedia
- Pertanyaan mesti mengikut sintaks tertentu
- Nilai medan pertanyaan tidak selalunya didokumentasikan. Dalam sesetengah kes, nilai tersebut boleh ditemui dengan melihat pada dokumen API. Sebagai alternatif, anda selalunya boleh mencari nilai medan dalam URL pada panel pentadbir apabila anda menapis. Contohnya, untuk mencari beberapa nilai pertanyaan Pesanan, tapis halaman Pesanan dalam panel pentadbir dan kemudian semak URL.
- Anda boleh menjalankan atau menguji pertanyaan di kedai anda dengan menggunakan aplikasi Shopify GraphiQL.
- Berhati-hati dengan perkara yang berlaku jika pertanyaan anda gagal. API selalunya akan mengembalikan semua hasil (bukan tiada hasil langsung).
Data yang dikembalikan
Semua tindakan Dapatkan data mengembalikan senarai yang mengandungi antara 0 hingga 100 sumber. Bergantung pada kes penggunaan anda, anda mungkin mahu menggunakan data ini dalam pelbagai cara:
- Jika anda perlu mengendalikan setiap item senarai secara individu, seperti menambah tag untuk setiap satu, maka anda boleh menggunakan tindakan Untuk setiap.
- Jika anda perlu mengagregat data, seperti mengira bilangan hasil yang dikembalikan, maka anda boleh menggunakan tindakan Kira atau Jumlah.
- Jika anda perlu mengeluarkan senarai, seperti menghantar e-mel dengan semua item, maka anda boleh menggunakan data yang dikembalikan secara terus dalam tindakan yang seterusnya.
Untuk mengakses data yang dikembalikan dalam langkah yang mengikuti tindakan ini, gunakan pemboleh ubah bernama Dapatkan data pesanan, iaitu senarai pesanan. Anda boleh menggunakan pemboleh ubah ini dalam kedua-dua syarat dan tindakan. Contohnya, anda boleh menghantar senarai pesanan dalam tindakan Hantar e-mel dalaman seperti ini:
{% for single_order in GetOrderData %}
* {{ single_order.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 anda tentukan, bukannya sebagai akibat sesuatu peristiwa. Oleh sebab tiada peristiwa khusus dalam kedai anda atau daripada aplikasi yang memulakan aliran kerja tersebut, tiada data yang disertakan secara automatik.
Butiran API
Templat
Batalkan pesanan untuk pelanggan yang kerap membuat pemulangan
Membatalkan pesanan daripada pelanggan yang telah memulangkan item lima kali atau lebih dalam masa enam bulan yang lalu. Ia mendapatkan data pesanan, mengira pemulangan dan membatalkan pesanan semasa, mengeluarkan bayaran balik dan melakukan penstokan semula item. Templat ini boleh digunakan untuk: mengurangkan kerugian daripada pelanggan yang lazim membuat pemulangan, menyelaraskan pengurusan pesanan dengan mengendalikan potensi pemulangan secara awal dan mengekalkan keuntungan dengan menghalang pemulangan yang berlebihan. Lihat templat
Batalkan pesanan jika pelanggan membuat lebih daripada 5 pesanan pada hari ini
Membatalkan pesanan jika pelanggan membuat lebih daripada lima pesanan dalam masa satu hari. Tindakan ini menyemak bilangan pesanan yang dibuat oleh pelanggan dalam tempoh 24 jam yang lalu dan membatalkan sebarang pesanan yang melebihi had ini, serta meletakkan tag pada pelanggan bagi potensi penipuan. Lihat templat
Tangguhkan pesanan pemenuhan untuk pelanggan yang mempunyai caj balik
Apabila pesanan sedia untuk dipenuhi, aliran kerja mengambil sebarang pesanan daripada pelanggan yang sama dalam tempoh 60 hari lalu yang mempunyai caj balik. Jika wujud mana-mana pesanan sedemikian, ia menangguhkan pemenuhan pada setiap pengiriman dan menghantar e-mel dalaman untuk memaklumkan operasi anda. Lihat templat
Tangguhkan pemenuhan jika pelanggan membuat berbilang pesanan dalam tempoh 24 jam
Semak untuk melihat jika pelanggan telah membuat berbilang pesanan dalam tempoh 24 jam. Jika benar, tangguhkan pemenuhan dan satukan pengiriman. Lihat templat
Tangguhkan pesanan jika pelanggan membuat lebih daripada 1 pesanan dalam tempoh 24 jam yang lalu
Apabila pesanan dicipta, semak jika pelanggan membuat sebarang pesanan lain dalam tempoh 24 jam yang lalu. Jika ya, tetapkan semua pesanan sebagai ditangguhkan. Lihat templat
Hantar pemberitahuan apabila volum Pesanan kurang daripada 10 dalam tempoh sejam yang lalu
Menghantar pemberitahuan denyutan nadi pesanan. Setiap jam, dapatkan sehingga 10 pesanan yang telah dicipta, dan kiranya. Jika kurang daripada 10, hantar pemberitahuan melalui E-mel. Menggunakan langkah Jadualkan masa, Dapatkan data pesanan dan Kira. Lihat templat
Hantar ringkasan e-mel bagi semua pesanan ke Kedai Dalam Talian pada hari sebelumnya
Setiap hari, mendapatkan pesanan bagi hari sebelumnya dan menghantar ringkasan e-mel dengan pesanan yang dibuat pada kedai dalam talian. Lihat templat
Hantar ringkasan e-mel dengan semua pesanan tidak dipenuhi yang melebihi 2 hari
Dapatkan ringkasan harian bagi semua pesanan tidak dipenuhi anda yang melebihi 2 hari, dengan menggunakan jadual, dapatkan data pesanan, kira dan jumlah. Lihat templat
Letakkan tag dan hantar ringkasan harian bagi pemenuhan yang lewat
Setiap hari, letakkan tag dan hantar ringkasan e-mel harian yang mengira jumlah bilangan dan nilai dolar bagi semua pesanan yang terlepas jaminan pengiriman 2 hari. Lihat templat
Letakkan tag pada pelanggan yang mempunyai caj balik
Setiap jam, aliran kerja ini mendapatkan pesanan yang mempunyai caj balik dan menambah tag pada pelanggan untuk pesanan tersebut. Menggunakan pencetus masa dijadualkan, dapatkan data pesanan dan untuk setiap gelung. Lihat templat
Letakkan tag pada pesanan tidak dipenuhi yang melebihi 2 hari
Setiap hari, aliran kerja mendapatkan semua pesanan tidak dipenuhi yang melebihi 2 hari dan menambah tag pada pesanan tersebut. Lihat templat
Gunakan tag untuk membahagikan pelanggan berdasarkan pesanan mereka untuk 6 bulan yang lalu
Apabila pesanan baharu dicipta, dapatkan jumlah pesanan dan bilangan pesanan pelanggan untuk tempoh 6 bulan yang lalu, dan kemudian tambah tag pada pelanggan. Menggunakan langkah Dapatkan data pesanan, Kira, Jumlah. Lihat templat