API

Λήψη λίστας των bonus συναλλαγών πελατών

GET/api/crm/v2/clients_bonusesv2
operationId: clientsBonuses.default

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

api-token + language + role

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

page_numberinteger

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

date_creation_fromstring

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

date_creation_tostring

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

chain_idinteger

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

branch_idinteger
phone_format_idinteger

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

phone_numberstring

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

genderstring

Τιμές:womanman

downloadstring

Τιμές: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

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

phone_format_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

phone_numberobject (FilterInput)
valuestring

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

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

Παράδειγμα: integer or string

placeholderstring

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

modestring (FilterMode)

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

Τιμές:force_shownvalue_required

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

genderobject (FilterEnum)

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

valuestring

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

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

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

optionarray of string
modestring (FilterMode)

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

Τιμές:force_shownvalue_required

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

downloadobject (FilterButtonDownloadCsv)

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

valuestring

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

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

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

system_automationboolean

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

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

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

date_creationstring (DataTimeFormatSQL) υποχρεωτικό

Παράδειγμα: 2024-05-02 08:31:16

date_availablestring (DataTimeFormatSQL)

Παράδειγμα: 2024-05-02 08:31:16

date_expirationstring (DataTimeFormatSQL)

Παράδειγμα: 2024-05-02 08:31:16

date_changestring (DataTimeFormatSQL)

Παράδειγμα: 2024-05-02 08:31:16

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

Τιμές:birthdayfeedbackpromo_coderegistrationinvitationreferral_codereferralordergift

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

descriptionstring

Παράδειγμα: bonuses for the registration

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

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

order_idinteger

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

feedback_idinteger

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

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

Τιμές:availablenot_available

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

branch_idinteger

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

order_numberinteger

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

feedback_datestring (DataTimeFormatSQL)

Παράδειγμα: 2024-05-02 08:31:16

client_namestring

Παράδειγμα: client name

client_phone_format_idinteger

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

client_phone_numberstring

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

chain_namestring

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

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

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

paginationobject (Pagination)
max_countintegerυποχρεωτικό

Αριθμός στοιχείων ανά σελίδα

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

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

Αριθμός τρέχουσας σελίδας· περιορίζεται ώστε η μετατόπιση να μην υπερβαίνει το 1000

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

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

Υπάρχει επόμενη σελίδα

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

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

Υπάρχει προηγούμενη σελίδα

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