ნაღდი ფულის აღრიცხვის სესიის მონაცემების მიღება
სამუშაო პროცესებში, რომლებიც მოითხოვს ნაღდი ფულის აღრიცხვის სესიის მონაცემებს, შეგიძლია გამოიყენო ნაღდი ფულის აღრიცხვის სესიის მონაცემების მიღების ქმედება, რათა დააბრუნო ნაღდი ფულის აღრიცხვის სესიის ინფორმაცია შენი POS Pro-დან. ნაღდი ფულის აღრიცხვის სესიები გამოიყენება შენი მაღაზიის სალაროებში ნაღდი ფულის აღსარიცხად.
კონფიგურაცია
ველები
ქმედება ნაღდი ფულის აღრიცხვის სესიის მონაცემების მიღება (Get cash tracking session data) შეიცავს შემდეგ ველებს.
| ველი | აღწერა |
|---|---|
| მონაცემების დახარისხება | სავალდებულოა. პარამეტრები, რომელთა მიხედვითაც ხარისხდება საძიებო მოთხოვნის მიერ დაბრუნებული მონაცემები. |
| შედეგების მაქსიმალური რაოდენობა | სავალდებულოა. შენ მიერ არჩეული საძიებო მოთხოვნის შედეგად დაბრუნებული შედეგების მაქსიმალური რაოდენობა. ერთ ჯერზე შეგიძლია, დააბრუნო მაქსიმუმ 100. |
| მოთხოვნა | სავალდებულოა. აირჩიე სტანდარტული მოთხოვნებიდან ან მონიშნე Advanced შენი საკუთარის შესაქმნელად. |
მოთხოვნის სტრიქონი
ეს არის მოთხოვნის მაგალითი ბოლო დღის განმავლობაში დახურული ნაღდი ფულის აღრიცხვის სესიების მისაღებად:
closing_time:<='{{ scheduledAt }}' AND closing_time:>'{{ scheduledAt | date_minus: "1 day" }}'ცვლადი closing_time არის ფილტრი, რომელიც ხელმისაწვდომია CashTrackingSessions მოთხოვნაში და მისი გამოყენება შესაძლებელია რამდენჯერმე, ან სხვა ცვლადებთან კომბინაციაში. Liquid ცვლადი scheduledAt ხელმისაწვდომია იმ სამუშაო პროცესებზე, რომლებშიც გამოყენებულია დაგეგმილი დროის (Scheduled time) ტრიგერი. Liquid-ის თეგი date_minus არის Flow-ს სპეციალური თეგი, რომელიც თარიღისთვის დროის გამოკლების საშუალებას გაძლევს.
მონაცემების გამოთხოვისას სასარგებლოა იცოდე:
მოთხოვნები უნდა მიჰყვებოდეს გარკვეულ სინტაქსს
მოთხოვნის ველის მნიშვნელობები ყოველთვის დოკუმენტირებული არ არის. ზოგიერთ შემთხვევაში, მნიშვნელობების პოვნა API-ის დოკუმენტაციაშია შესაძლებელი. ალტერნატივის სახით, ფილტრაციისას ველის მნიშვნელობების პოვნა ხშირად შეიძლება ადმინ პანელში (Admin), URL-ებში. მაგალითად, შეკვეთის (Order) მოთხოვნის ზოგიერთი მნიშვნელობის საპოვნელად, გაფილტრე „შეკვეთების“ (Orders) გვერდი ადმინ პანელში და შემდეგ შეამოწმე URL.
შენს მაღაზიაში მოთხოვნის გაშვება ან ტესტირება შეგიძლია აპით Shopify GraphiQL.
გაითვალისწინე, რა მოხდება, თუ შენი მოთხოვნა წარუმატებელი აღმოჩნდება. ხშირად API დააბრუნებს ყველა შედეგს (ნაცვლად არცერთისა).
დაბრუნებული მონაცემები
მონაცემების მიღების (Get data) ყველა ქმედება აბრუნებს სიას, რომელიც 0-დან 100-მდე რესურსს შეიცავს. შენი საჭიროებიდან გამომდინარე, შეგიძლია, ეს მონაცემები სხვადასხვა გზით გამოიყენო:
- თუ გჭირდება სიის თითოეული ერთეულის ინდივიდუალურად დამუშავება, მაგალითად, თითოეულისთვის თეგის დამატება, შეგიძლია გამოიყენო ქმედება თითოეულისთვის (For each).
- თუ გჭირდება მონაცემების აგრეგირება, მაგალითად იმის დათვლა, თუ რამდენი შედეგი დაბრუნდა, შეგიძლია გამოიყენო ქმედება დათვლა (Count) ან ჯამი (Sum).
- თუ გჭირდება სიის გამოტანა, მაგალითად, ყველა ერთეულის ელფოსტით გაგზავნა, შეგიძლია დაბრუნებული მონაცემები პირდაპირ გამოიყენო მომდევნო ქმედებებში.
ამ ქმედების მომდევნო ნაბიჯებში დაბრუნებულ მონაცემებზე წვდომისთვის, გამოიყენე ცვლადი, სახელად Get cash tracking session data (ნაღდი ფულის აღრიცხვის სესიის მონაცემების მიღება), რომელიც ნაღდი ფულის აღრიცხვის სესიების სიაა. ამ ცვლადის გამოყენება შეგიძლია როგორც პირობებში (conditions), ასევე ქმედებებში (actions). მაგალითად, შეგიძლია გააგზავნო ნაღდი ფულის აღრიცხვის სესიების სია ქმედებაში შიდა ელფოსტის გაგზავნა (Send internal email) ამგვარად:
{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% endfor %}ტრიგერები
ამ ქმედების გამოყენება შეგიძლია ნებისმიერ სამუშაო პროცესში, მათ შორის ტრიგერით დაგეგმილი დრო (Scheduled time). სამუშაო პროცესში, რომელიც იყენებს ტრიგერს დაგეგმილი დრო, პროცესი იწყება შენ მიერ მითითებულ დროს და არა რაიმე მოვლენის შედეგად. რადგან არ არსებობს შენს მაღაზიაში ან აპში კონკრეტული მოვლენა, რომელიც დაიწყებს სამუშაო პროცესს, მონაცემები ავტომატურად არ დაერთვის.
API ცნობარი
ამ ქმედებაში გამოყენებული API-ს შესახებ დამატებითი ინფორმაციისთვის იხილე CashTrackingSessions მოთხოვნა.