API

Satış kanalları üzrə statistikanı əldə et

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

Hər satış kanalı üzrə gəlir, sifariş sayı və orta çek qaytarılır. Bir sorğuya iki dövr daxil edilə bilər ki, aylar müqayisə olunsun. Dövr üzrə yekunlar artıq hesablanıb, qrafiklər üçün isə UTC-də boş olmayan saatlar qaytarılır. Onları istifadəçinin saat qurşağına çevirin və günlərə və ya aylara birləşdirin. Gəlirə yalnız tamamlanmış sifarişlər daxildir.

Avtorizasiya

api-token + language + role

Sorğu parametrləri

date_creation_fromstring

Nümunə: 01/08/2026

date_creation_tostring

Nümunə: 31/08/2026

date_comparison_fromstring

İkinci dövr; müqayisə ediləcək heç nə yoxdursa, boş olur

Nümunə: 01/07/2026

date_comparison_tostring

Nümunə: 31/07/2026

chain_idinteger
branch_idinteger
delivery_methodstring (OrderDelivery)

Çatdırılma üsulu: kuryer və ya özün götürmə

Dəyərlər:courierpickup

payment_statusstring (OrderPayment)

Ödəniş statusu: ödənilməyib, gözləyir, ödənilib

Dəyərlər:not_paidwaitingpaid

operator_idinteger
downloadstring

A dövrünün xülasə cədvəlini CSV formatında, JSON əvəzinə qaytarır

Dəyərlər:yes

Nümunə: yes

Cavablar

OK

object
statusstringmütləq

Dəyərlər:successerror

Nümunə: success

dataobject
filtersobject
date_creation_fromobject (FilterDateFrom)
valuestringnull ola bilər

Nümunə: 2026-08-01 00:00:00

typestringmütləq

Nümunə: date

modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

date_creation_toobject (FilterDateTo)
valuestringnull ola bilər

Nümunə: 2026-08-31 23:59:59

typestringmütləq

Nümunə: date

modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

date_creation_rangeobject (FilterDateRange)

Hazır tarix aralığı filtrləri; aşağı sərhəd istifadəçinin saat qurşağında hesablanır. value — cari *_from və *_to-ya uyğun olan aralıq; null — istənilən aralıq. default — serverin tarixsiz sorğuda təyin etdiyi aralıq: həmçinin bölmə ilk dəfə yüklənəndə və sıfırlama zamanı tətbiq olunur. Aralığın yuxarı sərhədi həmişə istifadəçinin cari gününə bərabərdir, buna görə option onu ehtiva etmir: hazır aralıq üçün *_to göndərmək lazım deyil, server onu özü təyin edir. Bir ildən uzun aralıq yeni sərhəd tərəfindən kəsilir.

valuestring (DateRange) null ola bilər

Hazır tarix aralığı filtri. Bunun üçün ayrıca sorğu parametri yoxdur: aşağı sərhəd artıq hesablanmış şəkildə option daxilində gəlir və *_from sahəsinə əlavə olunur. Yuxarı sərhəd nə cavabda, nə də sorğuda ötürülmür — o, həmişə istifadəçinin cari gününə bərabərdir və server tərəfindən təyin olunur.

Dəyərlər:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Nümunə: today

defaultstring (DateRange) mütləq

Hazır tarix aralığı filtri. Bunun üçün ayrıca sorğu parametri yoxdur: aşağı sərhəd artıq hesablanmış şəkildə option daxilində gəlir və *_from sahəsinə əlavə olunur. Yuxarı sərhəd nə cavabda, nə də sorğuda ötürülmür — o, həmişə istifadəçinin cari gününə bərabərdir və server tərəfindən təyin olunur.

Dəyərlər:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Nümunə: today

typestringmütləq

Nümunə: select

modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

optionarray of objectmütləq
valuestring (DateRange) mütləq

Hazır tarix aralığı filtri. Bunun üçün ayrıca sorğu parametri yoxdur: aşağı sərhəd artıq hesablanmış şəkildə option daxilində gəlir və *_from sahəsinə əlavə olunur. Yuxarı sərhəd nə cavabda, nə də sorğuda ötürülmür — o, həmişə istifadəçinin cari gününə bərabərdir və server tərəfindən təyin olunur.

Dəyərlər:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Nümunə: today

date_fromstringmütləq

Nümunə: 25/08/2026

date_comparison_fromobject (FilterDateFrom)
valuestringnull ola bilər

Nümunə: 2026-08-01 00:00:00

typestringmütləq

Nümunə: date

modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

date_comparison_toobject (FilterDateTo)
valuestringnull ola bilər

Nümunə: 2026-08-31 23:59:59

typestringmütləq

Nümunə: date

modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Hazır tarix aralığı filtrləri, standart dəyərsiz: default həmişə null-dır.

valuestring (DateRange) null ola bilər

Hazır tarix aralığı filtri. Bunun üçün ayrıca sorğu parametri yoxdur: aşağı sərhəd artıq hesablanmış şəkildə option daxilində gəlir və *_from sahəsinə əlavə olunur. Yuxarı sərhəd nə cavabda, nə də sorğuda ötürülmür — o, həmişə istifadəçinin cari gününə bərabərdir və server tərəfindən təyin olunur.

Dəyərlər:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Nümunə: today

defaultstring (DateRange) null ola bilər

Hazır tarix aralığı filtri. Bunun üçün ayrıca sorğu parametri yoxdur: aşağı sərhəd artıq hesablanmış şəkildə option daxilində gəlir və *_from sahəsinə əlavə olunur. Yuxarı sərhəd nə cavabda, nə də sorğuda ötürülmür — o, həmişə istifadəçinin cari gününə bərabərdir və server tərəfindən təyin olunur.

Dəyərlər:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Nümunə: today

typestringmütləq

Nümunə: select

optionarray of objectmütləq
valuestring (DateRange) mütləq

Hazır tarix aralığı filtri. Bunun üçün ayrıca sorğu parametri yoxdur: aşağı sərhəd artıq hesablanmış şəkildə option daxilində gəlir və *_from sahəsinə əlavə olunur. Yuxarı sərhəd nə cavabda, nə də sorğuda ötürülmür — o, həmişə istifadəçinin cari gününə bərabərdir və server tərəfindən təyin olunur.

Dəyərlər:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Nümunə: today

date_fromstringmütləq

Nümunə: 25/08/2026

chain_idobject (FilterSelectInteger)
valueinteger

Nümunə: 8920

typestringmütləq

Nümunə: select

optionarray of object
valueintegermütləq

Nümunə: 8920

namestringmütləq

Nümunə: Green Basket | Kaliningrad

modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

branch_idobject (FilterSelectInteger)
valueinteger

Nümunə: 8920

typestringmütləq

Nümunə: select

optionarray of object
valueintegermütləq

Nümunə: 8920

namestringmütləq

Nümunə: Green Basket | Kaliningrad

modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

delivery_methodobject (FilterEnum)

Filtr-siyahı — düz siyahı enum dəyərləri

valuestring

Nümunə: example

typestringmütləq

Nümunə: select

optionarray of string
modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

payment_statusobject (FilterEnum)

Filtr-siyahı — düz siyahı enum dəyərləri

valuestring

Nümunə: example

typestringmütləq

Nümunə: select

optionarray of string
modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

operator_idobject (FilterSelectInteger)
valueinteger

Nümunə: 8920

typestringmütləq

Nümunə: select

optionarray of object
valueintegermütləq

Nümunə: 8920

namestringmütləq

Nümunə: Green Basket | Kaliningrad

modestring (FilterMode)

İnterfeys filtrin işlənməsini belə idarə edir: adi filtrdə mode yoxdur. force_shown — həmişə göstərilir, gizlədilə bilməz. value_required — bölməyə giriş nöqtəsidir: həmişə göstərilir, boş dəyəri olmur (dəyər seçilməyənə qədər siyahı boşdur; "hamısı" seçimi yoxdur), ümumi sıfırlama onu təmizləmir.

Dəyərlər:force_shownvalue_required

Nümunə: value_required

downloadobject (FilterButtonDownloadCsv)

Seçimi yükləmə düyməsi: basıldıqda download=yes göndərin

valuestring

Nümunə: Download

typestringmütləq

Nümunə: button_download_csv

periodsarray of object

Bir element dövr üçün; ikincisi isə yalnız müqayisə dövrü təyin olunubsa

keystringmütləq

a — əsas dövr, b — müqayisə dövrü

Dəyərlər:ab

Nümunə: a

date_fromstringmütləq

Nümunə: 01/08/2026

date_tostringmütləq

Nümunə: 31/08/2026

totalobject (SalesChannelsTotal) mütləq

Bütün kanallar üzrə dövrün yekunları

orders_countintegermütləq

Nümunə: 4120

completed_countintegermütləq

Nümunə: 3894

completed_percentnumbermütləq

Nümunə: 94.51

revenuenumbermütləq

Nümunə: 4361280

averagenumbermütləq

Nümunə: 1120

channelsarray of objectmütləq

Hər sifariş kanalı üçün bir element, sabit ardıcıllıqla. "Bütün kanallar" elementi yoxdur: bunun üçün total istifadə olunur.

platformstring (OrderPlatform) mütləq

Sifariş platforması

Dəyərlər:androidapifbiosvksite

orders_countintegermütləq

Nümunə: 1810

orders_sharenumbermütləq

Dövr ərzində sifarişlərin faizi

Nümunə: 43.93

completed_countintegermütləq

Nümunə: 1702

completed_percentnumbermütləq

Nümunə: 94.03

revenuenumbermütləq

Nümunə: 1855180

revenue_sharenumbermütləq

Dövrün gəlir payı faizlə

Nümunə: 42.54

averagenumbermütləq

Gəlir, yerinə yetirilmiş sifarişlərin sayına bölünür

Nümunə: 1090

deltaobject (SalesChannelsDelta) mütləqnull ola bilər

Kanalın B dövründəki eyni kanalla müqayisəsi. B dövrü təyin edilməyibsə, null.

revenue_absolutenumbermütləq

Nümunə: -120400

revenue_percentnumbermütləqnull ola bilər

null, əgər B dövründə kanalın gəliri olmayıbsa: sıfırdan faiz artımı yoxdur

Nümunə: -6.09

bucketsarray of objectmütləq

Saatlara görə qruplaşdırılmış sifarişlər; yalnız boş olmayan saatlar. Vaxtı istifadəçinin saat qurşağına çevirin, sonra saatları qrafik nöqtələrinə toplayın: xətti qrafik üçün — günlər və ya aylar üzrə, sütunlu qrafik üçün — təqvim ayları üzrə. count, completed_count və revenue cəmləyin; orta göstəriciləri ortalamayın.

datetimestringmütləq

Sifarişlərin aid olduğu saat, UTC üzrə

Nümunə: 2026-08-01 09:00:00

countintegermütləq

Nümunə: 12

completed_countintegermütləq

Nümunə: 11

revenuenumbermütləq

Nümunə: 12100