API

Λήψη στατιστικών για τα κανάλια πωλήσεων

GET/api/crm/v2/sales_channelsv2
operationId: salesChannels.default

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

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

api-token + language + role

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

date_creation_fromstring

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

date_creation_tostring

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

date_comparison_fromstring

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

Παράδειγμα: 01/07/2026

date_comparison_tostring

Παράδειγμα: 31/07/2026

chain_idinteger
branch_idinteger
delivery_methodstring (OrderDelivery)

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

Τιμές:courierpickup

payment_statusstring (OrderPayment)

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

Τιμές:not_paidwaitingpaid

operator_idinteger
downloadstring

Επιστρέφει έναν συνοπτικό πίνακα για την περίοδο A σε μορφή CSV αντί για JSON

Τιμές:yes

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

Απαντήσεις

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

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

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

downloadobject (FilterButtonDownloadCsv)

Κουμπί λήψης επιλογής: κατά το πάτημα, στείλτε download=yes

valuestring

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

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

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

periodsarray of object

Ένα στοιχείο ανά περίοδο· το δεύτερο — μόνο αν έχει οριστεί περίοδος σύγκρισης

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

a — κύρια περίοδος, b — περίοδος σύγκρισης

Τιμές:ab

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

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

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

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

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

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

Σύνολα περιόδου για όλα τα κανάλια

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

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

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

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

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

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

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

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

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

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

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

Ένα στοιχείο για κάθε κανάλι με παραγγελίες, σε σταθερή σειρά. Δεν υπάρχει στοιχείο για «όλα τα κανάλια»: για αυτό χρησιμοποιείται το total.

platformstring (OrderPlatform) υποχρεωτικό

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

Τιμές:androidapifbiosvksite

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

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

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

Ποσοστό παραγγελιών για την περίοδο σε ποσοστό %

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

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

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

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

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

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

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

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

Ποσοστό εσόδων περιόδου σε ποσοστό

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

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

Έσοδα διαιρεμένα με τον αριθμό των ολοκληρωμένων παραγγελιών

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

deltaobject (SalesChannelsDelta) υποχρεωτικόμπορεί να είναι null

Σύγκριση του καναλιού με το ίδιο κανάλι στην περίοδο B. null αν η περίοδος B δεν έχει οριστεί.

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

Παράδειγμα: -120400

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

null, αν το κανάλι δεν είχε έσοδα στη περίοδο B: δεν υπάρχει ποσοστιαία αύξηση από το μηδέν

Παράδειγμα: -6.09

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

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

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

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

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

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

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

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

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

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

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