API

Buyurtmalarni vaqt bo‘yicha issiqlik xaritasini olish

GET/api/crm/v2/orders_over_timev2
operationId: ordersOverTime.default

Buyurtmalar issiqlik xaritasini qaytaradi: haftaning kunlari bo‘yicha soatlar, kalendar kunlari yoki oylar. Bitta so‘rovda ikki davrgacha qaytariladi, haftani hafta bilan yoki oyni oy bilan solishtirish uchun. Buyurtmalar UTC bo‘yicha soatlar kesimida agregatsiya qilinadi va faqat bo‘sh bo‘lmagan soatlar qaytariladi. Foydalanuvchi vaqt mintaqasiga o‘tkazish, qatorlar bo‘yicha guruhlash va bo‘sh katakchalar — mijoz tomonida amalga oshiriladi.

Avtorizatsiya

api-token + language + role

So‘rov parametrlari

date_creation_fromstring

Misol: 25/04/2024

date_creation_tostring

Misol: 26/04/2024

date_comparison_fromstring

Ikkinchi davr; taqqoslash uchun hech narsa bo'lmasa, bo'sh

Misol: 25/03/2024

date_comparison_tostring

Misol: 26/03/2024

granularitystring (OrdersOverTimeGranularity)

Tarmoq satrlari: hafta kunlari, kalendar kunlari yoki oylar. Faqat ko‘rsatishda ta’sir qiladi va hech qachon agregatsiyaga ta’sir qilmaydi.

Qiymatlar:weekdaydaymonth

chain_idinteger
branch_idinteger
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

platformstring (OrderPlatform)

Buyurtma platformasi

Qiymatlar:androidapifbiosvksite

delivery_methodstring (OrderDelivery)

Yetkazib berish usuli: kuryer yoki o‘zi olib ketish

Qiymatlar:courierpickup

payment_statusstring (OrderPayment)

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

Qiymatlar:not_paidwaitingpaid

operator_idinteger
courier_idinteger

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

date_comparison_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_comparison_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_comparison_rangeobject (FilterDateRangeOptional)

Tayyor sana filtrlash davrlari, standart qiymat yo‘q: default har doim null ga teng.

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) 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

typestringmajburiy

Misol: select

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

granularityobject (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

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

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

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

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

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

operator_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

courier_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

periodsarray of object
keystringmajburiy

Qiymatlar:ab

Misol: a

date_fromstringmajburiy

Misol: 25/04/2024

date_tostringmajburiy

Misol: 26/04/2024

rangestringmajburiynull bo‘lishi mumkin

Tayyor davr, chegaralari mos keladi; null, agar davr ixtiyoriy bo‘lsa

Misol: week

totalobject (OrdersOverTimeValues) majburiy
countintegermajburiy

Misol: 47

sumnumbermajburiy

Misol: 52640

averagenumbermajburiy

Misol: 1120

bucketsarray of objectmajburiynull bo‘lishi mumkin

Soatlar bo‘yicha guruhlangan buyurtmalar; faqat bo‘sh bo‘lmagan soatlar. Vaqtni foydalanuvchi vaqt mintaqasiga o‘tkazing, so‘ng natijaga ko‘ra satr va ustunni aniqlang va bo‘sh joylarni nol bilan to‘ldiring.

datetimestringmajburiy

Buyurtmalar tegishli bo‘lgan soat, UTC bo‘yicha

Misol: 2024-04-25 14:00:00

countintegermajburiy

Misol: 47

sumnumbermajburiy

Misol: 52640