API

Aksiyalar tahlilini olish

GET/api/crm/v2/special_offers_analyticsv2
operationId: specialOffersAnalytics.default

Avtorizatsiya

api-token + language + role

So‘rov parametrlari

date_creation_fromstring

Misol: 25/04/2024

date_creation_tostring

Misol: 26/04/2024

chain_idinteger
branch_idinteger
promo_codestring

Misol: SALE20

typestring

Misol: percent_discount_on_all_order

special_offer_idinteger

Misol: 152410

platformstring (OrderPlatform)

Buyurtma platformasi

Qiymatlar:androidapifbiosvksite

order_statusstring (OrderStatus)

Buyurtma holati: yo‘lda, bajarilgan, yig‘ilmoqda, oshxonada, qayta ishlanmagan, jo‘natishga tayyor, oshxonaga yuborilishini kutmoqda, qayta ishlashni kutmoqda, bekor qilingan, tasdiqlangan, tayyorlangan

Qiymatlar:in_transitdoneassemblyin_kitchennot_processedready_to_transitwait_to_kitchenwait_remadecanceledconfirmedcooked

Misol: confirmed

payment_statusstring (OrderPayment)

Toʻlov holati: toʻlanmagan, kutilmoqda, toʻlangan

Qiymatlar:not_paidwaitingpaid

delivery_methodstring (OrderDelivery)

Yetkazib berish usuli: kuryer yoki o‘zi olib ketish

Qiymatlar:courierpickup

Javoblar

OK

object
statusstringmajburiy

Qiymatlar:successerror

Misol: success

dataobject
filtersobject
date_creation_fromobject (FilterDateFrom)
valuestringnull bo‘lishi mumkin

Misol: 2026-08-01 00:00:00

typestringmajburiy

Misol: date

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

date_creation_toobject (FilterDateTo)
valuestringnull bo‘lishi mumkin

Misol: 2026-08-31 23:59:59

typestringmajburiy

Misol: date

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

date_creation_rangeobject (FilterDateRange)

Tayyor sana filtrlash davrlari; pastki chegara foydalanuvchi vaqt mintaqasida hisoblanadi. value — joriy *_from va *_to ga mos keladigan davr; null — ixtiyoriy davr. default — server sanalarsiz so‘rovda avtomatik qo‘llaydigan davr: shu davr bo‘lim birinchi yuklanganda va filtrlash tiklanganda ishlatiladi. Davrning yuqori chegarasi har doim foydalanuvchining joriy kuniga teng, shuning uchun option uni o‘z ichiga olmaydi: tayyor davr uchun *_to uzatish shart emas, server uni o‘zi belgilaydi. Davr bir yildan uzun bo‘lsa, yangi chegara tomonidan qisqartiriladi.

valuestring (DateRange) null bo‘lishi mumkin

Tayyor sana bo‘yicha filtr davri. Uning alohida so‘rov parametri yo‘q: quyi chegara allaqachon hisoblangan holda option da keladi va *_from ga qo‘yiladi. Yuqori chegara javobda ham, so‘rovda ham uzatilmaydi — u har doim foydalanuvchining joriy kuniga teng va server tomonidan belgilanadi.

Qiymatlar:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Misol: today

defaultstring (DateRange) majburiy

Tayyor sana bo‘yicha filtr davri. Uning alohida so‘rov parametri yo‘q: quyi chegara allaqachon hisoblangan holda option da keladi va *_from ga qo‘yiladi. Yuqori chegara javobda ham, so‘rovda ham uzatilmaydi — u har doim foydalanuvchining joriy kuniga teng va server tomonidan belgilanadi.

Qiymatlar:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Misol: today

typestringmajburiy

Misol: select

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

optionarray of objectmajburiy
valuestring (DateRange) majburiy

Tayyor sana bo‘yicha filtr davri. Uning alohida so‘rov parametri yo‘q: quyi chegara allaqachon hisoblangan holda option da keladi va *_from ga qo‘yiladi. Yuqori chegara javobda ham, so‘rovda ham uzatilmaydi — u har doim foydalanuvchining joriy kuniga teng va server tomonidan belgilanadi.

Qiymatlar:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Misol: today

date_fromstringmajburiy

Misol: 25/08/2026

chain_idobject (FilterSelectInteger)
valueinteger

Misol: 8920

typestringmajburiy

Misol: select

optionarray of object
valueintegermajburiy

Misol: 8920

namestringmajburiy

Misol: Green Basket | Kaliningrad

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

branch_idobject (FilterSelectInteger)
valueinteger

Misol: 8920

typestringmajburiy

Misol: select

optionarray of object
valueintegermajburiy

Misol: 8920

namestringmajburiy

Misol: Green Basket | Kaliningrad

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

promo_codeobject (FilterInput)
valuestring

Misol: example

typestringmajburiy

Misol: integer or string

placeholderstring

Misol: string

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

typeobject (FilterEnum)

Filter-enum — enum qiymatlarining tekis ro‘yxati

valuestring

Misol: example

typestringmajburiy

Misol: select

optionarray of string
modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

special_offer_idobject (FilterSelectInteger)
valueinteger

Misol: 8920

typestringmajburiy

Misol: select

optionarray of object
valueintegermajburiy

Misol: 8920

namestringmajburiy

Misol: Green Basket | Kaliningrad

modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

platformobject (FilterEnum)

Filter-enum — enum qiymatlarining tekis ro‘yxati

valuestring

Misol: example

typestringmajburiy

Misol: select

optionarray of string
modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

order_statusobject (FilterEnum)

Filter-enum — enum qiymatlarining tekis ro‘yxati

valuestring

Misol: example

typestringmajburiy

Misol: select

optionarray of string
modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

payment_statusobject (FilterEnum)

Filter-enum — enum qiymatlarining tekis ro‘yxati

valuestring

Misol: example

typestringmajburiy

Misol: select

optionarray of string
modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

delivery_methodobject (FilterEnum)

Filter-enum — enum qiymatlarining tekis ro‘yxati

valuestring

Misol: example

typestringmajburiy

Misol: select

optionarray of string
modestring (FilterMode)

Interfeys filtrni qanday ishlashini belgilaydi; oddiy filtrda mode mavjud emas. force_shown — doim ko‘rsatiladi, yashirib bo‘lmaydi. value_required — bo‘limga kirish nuqtasi: doim ko‘rsatiladi, bo‘sh qiymatga ega emas (qiymat tanlanmaguncha ro‘yxat bo‘sh; “barchasi” varianti yo‘q), umumiy tozalash uni tozalamaydi.

Qiymatlar:force_shownvalue_required

Misol: value_required

totalobject (SpecialOffersAnalyticsValues)
countintegermajburiy

Misol: 412

sumnumbermajburiy

Misol: 531420.5

averagenumbermajburiy

Misol: 1289.86

completed_countintegermajburiy

Buyurtmalar, done yoki confirmed statusiga yetganlar

Misol: 379

completed_sharenumbermajburiy

Ushbu yarm ichida yakunlangan buyurtmalar ulushi, foizlarda

Misol: 91.99

share_of_countnumbermajburiy

Davr mobaynida barcha buyurtmalardagi ulushi, foizda

Misol: 34.2

share_of_sumnumbermajburiy

Misol: 29.7

segmentsarray of object
keystringmajburiy

Nimani anglatadi yarim. Agar promo-kod, aksiya turi yoki aniq aksiya tanlansa, birinchi yarim qisqaradi va juftlik matched_filter va rest ga aylanadi; har qanday holatda ham maxraj — davr ichidagi barcha buyurtmalar. Yarimni key bo‘yicha aniqlang, pozitsiya bo‘yicha emas.

Qiymatlar:with_promo_codewithout_promo_codematched_filterrest

Misol: with_promo_code

valuesobject (SpecialOffersAnalyticsValues) majburiy
countintegermajburiy

Misol: 412

sumnumbermajburiy

Misol: 531420.5

averagenumbermajburiy

Misol: 1289.86

completed_countintegermajburiy

Buyurtmalar, done yoki confirmed statusiga yetganlar

Misol: 379

completed_sharenumbermajburiy

Ushbu yarm ichida yakunlangan buyurtmalar ulushi, foizlarda

Misol: 91.99

share_of_countnumbermajburiy

Davr mobaynida barcha buyurtmalardagi ulushi, foizda

Misol: 34.2

share_of_sumnumbermajburiy

Misol: 29.7

differenceobject

Birinchi yarmi minus ikkinchi yarmi, mutlaq qiymatda; ulushlar foiz punktlarida ayiriladi

countinteger

Misol: -284

sumnumber

Misol: -412300.1

averagenumber

Misol: 180.4

completed_sharenumber

Misol: -3.11