API

კლიენტების ბონუს ოპერაციების სიის მიღება

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)

ფილტრი-ჩამონათვალი — ბრტყელი ჩამონათვალი enum მნიშვნელობების

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