รับข้อมูลเซสชันการติดตามเงินสด
ในเวิร์กโฟลว์ที่ต้องใช้ข้อมูลเซสชันการติดตามเงินสด คุณสามารถใช้การดำเนินการรับข้อมูลเซสชันการติดตามเงินสดเพื่อกู้คืนข้อมูลเซสชันการติดตามเงินสดจาก POS Pro ของคุณได้ โดยเซสชันการติดตามเงินสดจะใช้เพื่อติดตามเงินสดในเครื่องบันทึกเงินของร้านค้าคุณ
การกำหนดค่า
ช่อง
การดำเนินการรับข้อมูลเซสชันการติดตามเงินสดประกอบด้วยช่องต่อไปนี้
| ช่อง | คำอธิบาย |
|---|---|
| จัดเรียงข้อมูลตาม | จำเป็น พารามิเตอร์ที่ใช้จัดเรียงข้อมูลที่ส่งคืนโดยคำค้นหา |
| จำนวนผลลัพธ์สูงสุด | จำเป็น จำนวนผลลัพธ์สูงสุดที่คำค้นหาที่คุณเลือกสามารถส่งคืนได้ คุณสามารถส่งคืนได้สูงสุดครั้งละ 100 รายการ |
| การค้นหา | จำเป็น เลือกจากการค้นหาทั่วไป หรือเลือกขั้นสูงเพื่อสร้างการค้นหาของคุณเอง |
สตริงการค้นหา
นี่คือตัวอย่างการค้นหาเพื่อรับเซสชันการติดตามเงินสดที่ปิดไปในวันล่าสุด
closing_time:<='{{ scheduledAt }}' AND closing_time:>'{{ scheduledAt | date_minus: "1 day" }}'ตัวแปร closing_time คือตัวกรองที่มีให้ใช้งานในการค้นหา CashTrackingSessions และสามารถใช้งานได้หลายครั้ง หรือใช้ร่วมกับตัวแปรอื่นๆ ได้ ตัวแปร Liquid scheduledAt จะมีให้ใช้งานในเวิร์กโฟลว์ที่ใช้ทริกเกอร์เวลาที่กำหนด แท็ก Liquid date_minus เป็นแท็ก Flow พิเศษที่ให้คุณลบเวลาออกจากวันที่ได้
เมื่อทำการค้นหาข้อมูล สิ่งที่ควรรู้มีดังนี้
การค้นหาต้องเป็นไปตามไวยากรณ์ที่กำหนด
ค่าช่องการค้นหาอาจไม่ได้ระบุไว้ในเอกสารเสมอไป ในบางกรณี สามารถดูค่าได้จากเอกสาร API หรืออีกทางหนึ่งคือ คุณมักจะพบค่าของช่องได้ใน URL ในส่วนผู้ดูแลเมื่อคุณใช้ตัวกรอง ตัวอย่างเช่น หากต้องการค้นหาค่าการค้นหาคำสั่งซื้อบางค่า ให้กรองหน้าคำสั่งซื้อในส่วนผู้ดูแล จากนั้นจึงตรวจสอบ URL
คุณสามารถเรียกใช้หรือทดสอบการค้นหาในร้านค้าของคุณได้โดยใช้แอป Shopify GraphiQL
โปรดระวังสิ่งที่เกิดขึ้นหากการค้นหาของคุณล้มเหลว โดยบ่อยครั้งที่ API จะส่งคืนผลลัพธ์ทั้งหมด (แทนที่จะไม่ส่งคืนเลย)
ข้อมูลที่ส่งคืน
การดำเนินการรับข้อมูลทั้งหมดจะส่งคืนรายการทรัพยากรตั้งแต่ 0 ถึง 100 รายการ คุณอาจต้องการใช้ข้อมูลนี้ในรูปแบบต่างๆ ทั้งนี้ขึ้นอยู่กับกรณีการใช้งานของคุณ
- หากคุณต้องการจัดการแต่ละรายการในลิสต์แยกกัน เช่น การเพิ่มแท็กสำหรับแต่ละรายการ คุณสามารถใช้การดำเนินการสำหรับแต่ละรายการได้
- หากคุณต้องการรวบรวมข้อมูล เช่น นับจำนวนผลลัพธ์ที่ส่งคืน คุณสามารถใช้การดำเนินการนับ หรือ ผลรวมได้
- หากคุณต้องการเอาท์พุตรายการ เช่น ส่งอีเมลพร้อมกับทุกรายการ คุณสามารถใช้ข้อมูลที่ส่งคืนได้โดยตรงในการดำเนินการที่ตามมา
หากต้องการเข้าถึงข้อมูลที่ส่งคืนในขั้นตอนที่ตามหลังการดำเนินการนี้ ให้ใช้ตัวแปรที่ชื่อว่า รับข้อมูลเซสชันการติดตามเงินสด ซึ่งเป็นรายการของเซสชันการติดตามเงินสด คุณสามารถใช้ตัวแปรนี้ได้ทั้งในเงื่อนไขและการดำเนินการ ตัวอย่างเช่น คุณสามารถส่งรายการของเซสชันการติดตามเงินสดในการดำเนินการส่งอีเมลภายในได้ดังนี้
{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% endfor %}ทริกเกอร์
คุณสามารถใช้การดำเนินการนี้ในเวิร์กโฟลว์ใดก็ได้ รวมถึงทริกเกอร์เวลาที่กำหนด ในเวิร์กโฟลว์ที่ใช้ทริกเกอร์เวลาที่กำหนด เวิร์กโฟลว์จะเริ่มทำงานในเวลาที่คุณระบุไว้ แทนที่จะเริ่มจากการเกิดเหตุการณ์ เนื่องจากไม่มีเหตุการณ์เฉพาะในร้านค้าของคุณหรือจากแอปที่เริ่มเวิร์กโฟลว์ จึงไม่มีข้อมูลที่รวมอยู่โดยอัตโนมัติ
การอ้างอิง API
ดูข้อมูลเพิ่มเติมเกี่ยวกับ API ที่ใช้ในการดำเนินการนี้ได้ที่การค้นหา CashTrackingSessions