API

Λήψη θερμικού χάρτη παραγγελιών ανά ώρα

GET/api/crm/v2/orders_over_timev2
operationId: ordersOverTime.default

Επιστρέφει έναν θερμικό χάρτη παραγγελιών: ώρες της ημέρας ανά ημέρα εβδομάδας, ημερολογιακή ημέρα ή μήνα. Ένα αίτημα επιστρέφει έως δύο περιόδους για σύγκριση εβδομάδας με εβδομάδα ή μήνα με μήνα. Οι παραγγελίες ομαδοποιούνται ανά ώρα σε UTC και επιστρέφονται μόνο οι ώρες με δεδομένα. Η μετατροπή στη ζώνη ώρας του χρήστη, η ομαδοποίηση ανά γραμμή και τα κενά κελιά γίνονται στην πλευρά του πελάτη.

Εξουσιοδότηση

api-token + language + role

Παράμετροι ερωτήματος

date_creation_fromstring

Παράδειγμα: 25/04/2024

date_creation_tostring

Παράδειγμα: 26/04/2024

date_comparison_fromstring

Δεύτερη περίοδος· κενό αν δεν υπάρχει σύγκριση

Παράδειγμα: 25/03/2024

date_comparison_tostring

Παράδειγμα: 26/03/2024

granularitystring (OrdersOverTimeGranularity)

Γραμμές πλέγματος: ημέρες εβδομάδας, ημερολογιακές ημέρες ή μήνες. Επηρεάζει μόνο την εμφάνιση και ποτέ τη συγκέντρωση.

Τιμές:weekdaydaymonth

chain_idinteger
branch_idinteger
order_statusstring (OrderStatus)

Κατάσταση παραγγελίας: σε διαδρομή, ολοκληρώθηκε, σε συναρμολόγηση, στην κουζίνα, μη επεξεργασμένη, έτοιμη για αποστολή, αναμένει αποστολή στην κουζίνα, αναμένει επανεκτέλεση, ακυρώθηκε, επιβεβαιώθηκε, παρασκευάστηκε

Τιμές:in_transitdoneassemblyin_kitchennot_processedready_to_transitwait_to_kitchenwait_remadecanceledconfirmedcooked

Παράδειγμα: confirmed

platformstring (OrderPlatform)

Πλατφόρμα παραγγελίας

Τιμές:androidapifbiosvksite

delivery_methodstring (OrderDelivery)

Τρόπος παράδοσης: courier ή παραλαβή

Τιμές:courierpickup

payment_statusstring (OrderPayment)

Κατάσταση πληρωμής: δεν έχει πληρωθεί, σε αναμονή, πληρωμένο

Τιμές:not_paidwaitingpaid

operator_idinteger
courier_idinteger

Απαντήσεις

OK

object
statusstringυποχρεωτικό

Τιμές:successerror

Παράδειγμα: success

dataobject
filtersobject
date_creation_fromobject (FilterDateFrom)
valuestringμπορεί να είναι null

Παράδειγμα: 2026-08-01 00:00:00

typestringυποχρεωτικό

Παράδειγμα: date

modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

date_creation_toobject (FilterDateTo)
valuestringμπορεί να είναι null

Παράδειγμα: 2026-08-31 23:59:59

typestringυποχρεωτικό

Παράδειγμα: date

modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

date_creation_rangeobject (FilterDateRange)

Έτοιμες περίοδοι φίλτρου κατά ημερομηνία· το κάτω όριο υπολογίζεται στη ζώνη ώρας του χρήστη. Το value είναι η περίοδος που αντιστοιχεί στα τρέχοντα *_from και *_to· το null σημαίνει προσαρμοσμένη περίοδο. Το default είναι η περίοδος που ο διακομιστής ορίζει στο αίτημα χωρίς ημερομηνίες: εφαρμόζεται επίσης κατά την πρώτη φόρτωση της ενότητας και όταν γίνεται επαναφορά. Το ανώτερο όριο της περιόδου είναι πάντα η τρέχουσα ημέρα του χρήστη, επομένως το option δεν το περιέχει: δεν χρειάζεται να αποστείλετε *_to για έτοιμη περίοδο, ο διακομιστής το ορίζει αυτόματα. Περίοδος μεγαλύτερη από ένα έτος περικόπτεται από την πιο πρόσφατη πλευρά.

valuestring (DateRange) μπορεί να είναι null

Έτοιμη περίοδος φίλτρου κατά ημερομηνία. Δεν διαθέτει δική της παράμετρο αιτήματος: το κάτω όριο υπολογίζεται εκ των προτέρων στο option και τοποθετείται στο *_from. Το άνω όριο δεν μεταδίδεται ούτε στην απάντηση ούτε στο αίτημα — είναι πάντα ίσο με την τρέχουσα ημέρα του χρήστη και ορίζεται από τον διακομιστή.

Τιμές:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Παράδειγμα: today

defaultstring (DateRange) υποχρεωτικό

Έτοιμη περίοδος φίλτρου κατά ημερομηνία. Δεν διαθέτει δική της παράμετρο αιτήματος: το κάτω όριο υπολογίζεται εκ των προτέρων στο option και τοποθετείται στο *_from. Το άνω όριο δεν μεταδίδεται ούτε στην απάντηση ούτε στο αίτημα — είναι πάντα ίσο με την τρέχουσα ημέρα του χρήστη και ορίζεται από τον διακομιστή.

Τιμές:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Παράδειγμα: today

typestringυποχρεωτικό

Παράδειγμα: select

modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

optionarray of objectυποχρεωτικό
valuestring (DateRange) υποχρεωτικό

Έτοιμη περίοδος φίλτρου κατά ημερομηνία. Δεν διαθέτει δική της παράμετρο αιτήματος: το κάτω όριο υπολογίζεται εκ των προτέρων στο option και τοποθετείται στο *_from. Το άνω όριο δεν μεταδίδεται ούτε στην απάντηση ούτε στο αίτημα — είναι πάντα ίσο με την τρέχουσα ημέρα του χρήστη και ορίζεται από τον διακομιστή.

Τιμές:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Παράδειγμα: today

date_fromstringυποχρεωτικό

Παράδειγμα: 25/08/2026

date_comparison_fromobject (FilterDateFrom)
valuestringμπορεί να είναι null

Παράδειγμα: 2026-08-01 00:00:00

typestringυποχρεωτικό

Παράδειγμα: date

modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

date_comparison_toobject (FilterDateTo)
valuestringμπορεί να είναι null

Παράδειγμα: 2026-08-31 23:59:59

typestringυποχρεωτικό

Παράδειγμα: date

modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Έτοιμες περίοδοι φίλτρου ημερομηνιών χωρίς προεπιλεγμένη τιμή: το default είναι πάντα null.

valuestring (DateRange) μπορεί να είναι null

Έτοιμη περίοδος φίλτρου κατά ημερομηνία. Δεν διαθέτει δική της παράμετρο αιτήματος: το κάτω όριο υπολογίζεται εκ των προτέρων στο option και τοποθετείται στο *_from. Το άνω όριο δεν μεταδίδεται ούτε στην απάντηση ούτε στο αίτημα — είναι πάντα ίσο με την τρέχουσα ημέρα του χρήστη και ορίζεται από τον διακομιστή.

Τιμές:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Παράδειγμα: today

defaultstring (DateRange) μπορεί να είναι null

Έτοιμη περίοδος φίλτρου κατά ημερομηνία. Δεν διαθέτει δική της παράμετρο αιτήματος: το κάτω όριο υπολογίζεται εκ των προτέρων στο option και τοποθετείται στο *_from. Το άνω όριο δεν μεταδίδεται ούτε στην απάντηση ούτε στο αίτημα — είναι πάντα ίσο με την τρέχουσα ημέρα του χρήστη και ορίζεται από τον διακομιστή.

Τιμές:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Παράδειγμα: today

typestringυποχρεωτικό

Παράδειγμα: select

optionarray of objectυποχρεωτικό
valuestring (DateRange) υποχρεωτικό

Έτοιμη περίοδος φίλτρου κατά ημερομηνία. Δεν διαθέτει δική της παράμετρο αιτήματος: το κάτω όριο υπολογίζεται εκ των προτέρων στο option και τοποθετείται στο *_from. Το άνω όριο δεν μεταδίδεται ούτε στην απάντηση ούτε στο αίτημα — είναι πάντα ίσο με την τρέχουσα ημέρα του χρήστη και ορίζεται από τον διακομιστή.

Τιμές:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Παράδειγμα: today

date_fromstringυποχρεωτικό

Παράδειγμα: 25/08/2026

granularityobject (FilterEnum)

Φίλτρο-απαρίθμηση — επίπεδη λίστα τιμών απαρίθμησης

valuestring

Παράδειγμα: example

typestringυποχρεωτικό

Παράδειγμα: select

optionarray of string
modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

chain_idobject (FilterSelectInteger)
valueinteger

Παράδειγμα: 8920

typestringυποχρεωτικό

Παράδειγμα: select

optionarray of object
valueintegerυποχρεωτικό

Παράδειγμα: 8920

namestringυποχρεωτικό

Παράδειγμα: Green Basket | Kaliningrad

modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

branch_idobject (FilterSelectInteger)
valueinteger

Παράδειγμα: 8920

typestringυποχρεωτικό

Παράδειγμα: select

optionarray of object
valueintegerυποχρεωτικό

Παράδειγμα: 8920

namestringυποχρεωτικό

Παράδειγμα: Green Basket | Kaliningrad

modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

order_statusobject (FilterEnum)

Φίλτρο-απαρίθμηση — επίπεδη λίστα τιμών απαρίθμησης

valuestring

Παράδειγμα: example

typestringυποχρεωτικό

Παράδειγμα: select

optionarray of string
modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

platformobject (FilterEnum)

Φίλτρο-απαρίθμηση — επίπεδη λίστα τιμών απαρίθμησης

valuestring

Παράδειγμα: example

typestringυποχρεωτικό

Παράδειγμα: select

optionarray of string
modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

delivery_methodobject (FilterEnum)

Φίλτρο-απαρίθμηση — επίπεδη λίστα τιμών απαρίθμησης

valuestring

Παράδειγμα: example

typestringυποχρεωτικό

Παράδειγμα: select

optionarray of string
modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

payment_statusobject (FilterEnum)

Φίλτρο-απαρίθμηση — επίπεδη λίστα τιμών απαρίθμησης

valuestring

Παράδειγμα: example

typestringυποχρεωτικό

Παράδειγμα: select

optionarray of string
modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

operator_idobject (FilterSelectInteger)
valueinteger

Παράδειγμα: 8920

typestringυποχρεωτικό

Παράδειγμα: select

optionarray of object
valueintegerυποχρεωτικό

Παράδειγμα: 8920

namestringυποχρεωτικό

Παράδειγμα: Green Basket | Kaliningrad

modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

courier_idobject (FilterSelectInteger)
valueinteger

Παράδειγμα: 8920

typestringυποχρεωτικό

Παράδειγμα: select

optionarray of object
valueintegerυποχρεωτικό

Παράδειγμα: 8920

namestringυποχρεωτικό

Παράδειγμα: Green Basket | Kaliningrad

modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

periodsarray of object
keystringυποχρεωτικό

Τιμές:ab

Παράδειγμα: a

date_fromstringυποχρεωτικό

Παράδειγμα: 25/04/2024

date_tostringυποχρεωτικό

Παράδειγμα: 26/04/2024

rangestringυποχρεωτικόμπορεί να είναι null

Έτοιμη περίοδος που αντιστοιχεί στα όρια· null αν η περίοδος είναι αυθαίρετη

Παράδειγμα: week

totalobject (OrdersOverTimeValues) υποχρεωτικό
countintegerυποχρεωτικό

Παράδειγμα: 47

sumnumberυποχρεωτικό

Παράδειγμα: 52640

averagenumberυποχρεωτικό

Παράδειγμα: 1120

bucketsarray of objectυποχρεωτικόμπορεί να είναι null

Παραγγελίες ομαδοποιημένες ανά ώρα· μόνο ώρες με παραγγελίες. Μετατρέψτε την ώρα στη ζώνη ώρας του χρήστη, στη συνέχεια καθορίστε τη γραμμή και τη στήλη με βάση το αποτέλεσμα και συμπληρώστε τα κενά με μηδενικά.

datetimestringυποχρεωτικό

Η ώρα στην οποία αναφέρονται οι παραγγελίες, σε UTC

Παράδειγμα: 2024-04-25 14:00:00

countintegerυποχρεωτικό

Παράδειγμα: 47

sumnumberυποχρεωτικό

Παράδειγμα: 52640