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)

მიწოდების მეთოდი: კურიერი ან თვითგატანა

მნიშვნელობები: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)

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

valuestring

მაგალითი: example

typestringსავალდებულო

მაგალითი: select

optionarray of string
modestring (FilterMode)

როგორ ამუშავებს ინტერფეისი ფილტრს; ჩვეულებრივ ფილტრს mode არ აქვს. force_shown — ყოველთვის ნაჩვენებია, დამალვა შეუძლებელია. value_required — განყოფილების შესვლის წერტილი: ყოველთვის ნაჩვენებია, ცარიელი მნიშვნელობა არ აქვს (სანამ მნიშვნელობა არ არის არჩეული, სია ცარიელია; ვარიანტი „ყველა“ არ არსებობს), საერთო გასუფთავება მას არ აშორებს.

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

payment_statusobject (FilterEnum)

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

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