Dapatkan data sesi penjejakan tunai
Dalam aliran kerja yang memerlukan data sesi penjejakan tunai, anda boleh menggunakan tindakan Dapatkan data sesi penjejakan tunai untuk mengambil maklumat sesi penjejakan tunai daripada POS Pro anda. Sesi penjejakan tunai digunakan untuk menjejak tunai dalam daftar kedai anda.
Pada halaman ini
Konfigurasi
Medan
Tindakan Dapatkan data sesi penjejakan tunai mengandungi medan berikut.
| Medan | Perihalan |
|---|---|
| Isih data mengikut | Diperlukan. Parameter yang digunakan untuk mengisih data yang dikembalikan oleh pertanyaan carian. |
| Bilangan hasil maksimum | Diperlukan. Jumlah hasil maksimum yang boleh dikembalikan oleh pertanyaan carian yang anda pilih. Anda boleh mengembalikan sehingga 100 hasil pada satu-satu masa. |
| Pertanyaan | Diperlukan. Pilih daripada pertanyaan lazim atau pilih Terperinci untuk mencipta pertanyaan anda sendiri. |
Rentetan pertanyaan
Ini ialah contoh pertanyaan untuk mendapatkan sesi penjejakan tunai yang ditutup pada hari terakhir:
closing_time:<='{{ scheduledAt }}' AND closing_time:>'{{ scheduledAt | date_minus: "1 day" }}'Pemboleh ubah closing_time ialah penapis yang tersedia pada pertanyaan CashTrackingSessions dan boleh digunakan berulang kali atau digabungkan dengan pemboleh ubah lain. Pemboleh ubah Liquid scheduledAt tersedia pada aliran kerja yang menggunakan pencetus Masa yang dijadualkan. Tag Liquid date_minus ialah tag Flow khusus yang membolehkan anda menolak masa daripada tarikh.
Apabila membuat pertanyaan data, perkara berikut berguna untuk diketahui:
Pertanyaan mesti mengikut sintaks tertentu
Nilai medan pertanyaan tidak semestinya didokumenkan. Dalam sesetengah keadaan, nilai tersebut boleh didapati dengan melihat 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 pada panel pentadbir, kemudian semak URL tersebut.
Anda boleh menjalankan atau menguji pertanyaan di kedai anda dengan menggunakan aplikasi Shopify GraphiQL.
Sila ambil perhatian tentang perkara yang berlaku jika pertanyaan anda gagal. Selalunya API akan mengembalikan semua hasil (dan bukannya tiada).
Data yang dikembalikan
Semua tindakan Dapatkan data mengembalikan senarai yang terdiri daripada 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 berasingan, seperti menambah tag untuk setiap item, 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 yang seterusnya.
Untuk mengakses data yang dikembalikan dalam langkah yang mengikuti tindakan ini, gunakan pemboleh ubah bernama Dapatkan data sesi penjejakan tunai, iaitu senarai sesi penjejakan tunai. Anda boleh menggunakan pemboleh ubah ini dalam keadaan dan tindakan. Contohnya, anda boleh menghantar senarai sesi penjejakan tunai dalam tindakan Hantar e-mel dalaman seperti ini:
{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% endfor %}Pencetus
Anda boleh menggunakan tindakan ini dalam mana-mana aliran kerja, termasuk pencetus Masa yang dijadualkan. Dalam aliran kerja yang menggunakan pencetus Masa yang dijadualkan, aliran kerja bermula pada masa yang anda tetapkan dan bukannya disebabkan peristiwa tertentu. Memandangkan tiada peristiwa khusus dalam kedai anda atau daripada aplikasi yang memulakan aliran kerja, tiada data disertakan secara automatik.
Rujukan API
Untuk mendapatkan maklumat lanjut tentang API yang digunakan dalam tindakan ini, lihat pertanyaan CashTrackingSessions.