API

Добијте топлотну мапу поруџбина по времену

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

Враћа топлотну мапу поруџбина: сати у дану по данима у недељи, календарским данима или месецима. Један захтев враћа до два периода ради поређења недеље са недељом или месеца са месецом. Поруџбине се агрегирају по сатима у UTC и враћају се само непразни сати. Пребацивање у временску зону корисника, груписање по редовима и празне ћелије обрађује клијент.

Ауторизација

api-token + language + role

Parametri upita

date_creation_fromstring

Пример: 25/04/2024

date_creation_tostring

Пример: 26/04/2024

date_comparison_fromstring

Drugi period; prazan ako nema sa čim da se uporedi

Пример: 25/03/2024

date_comparison_tostring

Пример: 26/03/2024

granularitystring (OrdersOverTimeGranularity)

Редови мреже: дани у недељи, календарски дани или месеци. Утиче само на приказ и никада на агрегацију.

Vrednosti:weekdaydaymonth

chain_idinteger
branch_idinteger
order_statusstring (OrderStatus)

Статус поруџбине: на путу, завршен, паковање, у кухињи, необрађен, спреман за слање, чека слање у кухињу, чека преправку, отказан, потврђен, припремљен

Vrednosti:in_transitdoneassemblyin_kitchennot_processedready_to_transitwait_to_kitchenwait_remadecanceledconfirmedcooked

Пример: confirmed

platformstring (OrderPlatform)

Платформа за наручивање

Vrednosti:androidapifbiosvksite

delivery_methodstring (OrderDelivery)

Način isporuke: kurir ili lično preuzimanje

Vrednosti:courierpickup

payment_statusstring (OrderPayment)

Статус плаћања: није плаћено, у току, плаћено

Vrednosti:not_paidwaitingpaid

operator_idinteger
courier_idinteger

Одговори

OK

object
statusstringобавезно

Vrednosti: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 — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti: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 — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

date_creation_rangeobject (FilterDateRange)

Gotovi periodi filtera po datumu; donja granica se računa u korisničkoj vremenskoj zoni. value — period kojem odgovaraju trenutni *_from i *_to; null — proizvoljan period. default — period koji server automatski postavlja u zahtev bez datuma: koristi se pri prvom učitavanju sekcije i pri resetovanju filtera. Gornja granica perioda uvek odgovara trenutnom danu korisnika, zato je option ne sadrži: nije potrebno slati *_to za gotov period, server je postavlja automatski. Period duži od godinu dana se skraćuje sa strane novije granice.

valuestring (DateRange) може бити null

Готов период филтера по датуму. Нема сопственог параметра захтева: доња граница је већ израчуната у option и поставља се у *_from. Горња граница се не шаље ни у одговору, ни у захтеву — увек је једнака тренутном дану корисника и поставља је сервер.

Vrednosti:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Пример: today

defaultstring (DateRange) обавезно

Готов период филтера по датуму. Нема сопственог параметра захтева: доња граница је већ израчуната у option и поставља се у *_from. Горња граница се не шаље ни у одговору, ни у захтеву — увек је једнака тренутном дану корисника и поставља је сервер.

Vrednosti:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Пример: today

typestringобавезно

Пример: select

modestring (FilterMode)

Как интерфейс обрађује филтер; обичан филтер нема mode. force_shown — увек је приказан, не може се сакрити. value_required — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

optionarray of objectобавезно
valuestring (DateRange) обавезно

Готов период филтера по датуму. Нема сопственог параметра захтева: доња граница је већ израчуната у option и поставља се у *_from. Горња граница се не шаље ни у одговору, ни у захтеву — увек је једнака тренутном дану корисника и поставља је сервер.

Vrednosti: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 — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti: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 — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Готови периоди за филтрирање датума без подразумеване вредности: default је увек null.

valuestring (DateRange) може бити null

Готов период филтера по датуму. Нема сопственог параметра захтева: доња граница је већ израчуната у option и поставља се у *_from. Горња граница се не шаље ни у одговору, ни у захтеву — увек је једнака тренутном дану корисника и поставља је сервер.

Vrednosti:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Пример: today

defaultstring (DateRange) може бити null

Готов период филтера по датуму. Нема сопственог параметра захтева: доња граница је већ израчуната у option и поставља се у *_from. Горња граница се не шаље ни у одговору, ни у захтеву — увек је једнака тренутном дану корисника и поставља је сервер.

Vrednosti:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Пример: today

typestringобавезно

Пример: select

optionarray of objectобавезно
valuestring (DateRange) обавезно

Готов период филтера по датуму. Нема сопственог параметра захтева: доња граница је већ израчуната у option и поставља се у *_from. Горња граница се не шаље ни у одговору, ни у захтеву — увек је једнака тренутном дану корисника и поставља је сервер.

Vrednosti:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Пример: today

date_fromstringобавезно

Пример: 25/08/2026

granularityobject (FilterEnum)

Филтер-енум — раван списак вредности енума

valuestring

Пример: example

typestringобавезно

Пример: select

optionarray of string
modestring (FilterMode)

Как интерфейс обрађује филтер; обичан филтер нема mode. force_shown — увек је приказан, не може се сакрити. value_required — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

chain_idobject (FilterSelectInteger)
valueinteger

Пример: 8920

typestringобавезно

Пример: select

optionarray of object
valueintegerобавезно

Пример: 8920

namestringобавезно

Пример: Green Basket | Kaliningrad

modestring (FilterMode)

Как интерфейс обрађује филтер; обичан филтер нема mode. force_shown — увек је приказан, не може се сакрити. value_required — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti: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 — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

order_statusobject (FilterEnum)

Филтер-енум — раван списак вредности енума

valuestring

Пример: example

typestringобавезно

Пример: select

optionarray of string
modestring (FilterMode)

Как интерфейс обрађује филтер; обичан филтер нема mode. force_shown — увек је приказан, не може се сакрити. value_required — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

platformobject (FilterEnum)

Филтер-енум — раван списак вредности енума

valuestring

Пример: example

typestringобавезно

Пример: select

optionarray of string
modestring (FilterMode)

Как интерфейс обрађује филтер; обичан филтер нема mode. force_shown — увек је приказан, не може се сакрити. value_required — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

delivery_methodobject (FilterEnum)

Филтер-енум — раван списак вредности енума

valuestring

Пример: example

typestringобавезно

Пример: select

optionarray of string
modestring (FilterMode)

Как интерфейс обрађује филтер; обичан филтер нема mode. force_shown — увек је приказан, не може се сакрити. value_required — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

payment_statusobject (FilterEnum)

Филтер-енум — раван списак вредности енума

valuestring

Пример: example

typestringобавезно

Пример: select

optionarray of string
modestring (FilterMode)

Как интерфейс обрађује филтер; обичан филтер нема mode. force_shown — увек је приказан, не може се сакрити. value_required — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti: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 — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

courier_idobject (FilterSelectInteger)
valueinteger

Пример: 8920

typestringобавезно

Пример: select

optionarray of object
valueintegerобавезно

Пример: 8920

namestringобавезно

Пример: Green Basket | Kaliningrad

modestring (FilterMode)

Как интерфейс обрађује филтер; обичан филтер нема mode. force_shown — увек је приказан, не може се сакрити. value_required — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

periodsarray of object
keystringобавезно

Vrednosti:ab

Пример: a

date_fromstringобавезно

Пример: 25/04/2024

date_tostringобавезно

Пример: 26/04/2024

rangestringобавезноможе бити null

Унапред дефинисани период чије су границе задате; null ако је период произвољан

Пример: week

totalobject (OrdersOverTimeValues) обавезно
countintegerобавезно

Пример: 47

sumnumberобавезно

Пример: 52640

averagenumberобавезно

Пример: 1120

bucketsarray of objectобавезноможе бити null

Porudžbine grupisane po satima; samo sati koji nisu prazni. Prvo konvertujte vreme u korisničku vremensku zonu, zatim prema rezultatu odredite red i kolonu i popunite praznine nulama.

datetimestringобавезно

Време на које се односе поруџбине, у UTC

Пример: 2024-04-25 14:00:00

countintegerобавезно

Пример: 47

sumnumberобавезно

Пример: 52640