API

Dobijanje statistike po prodajnim kanalima

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

Враћа приход, број поруџбина и просечан износ по сваком продајном каналу. За један захтев враћа се до два периода ради поређења месеца са месецом. Резултати периода су већ израчунати, а за графиконе се враћају непразни сати у UTC. Преведите их у временску зону корисника и групишите по данима или месецима. У приход улазе само извршене поруџбине.

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

api-token + language + role

Parametri upita

date_creation_fromstring

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

date_creation_tostring

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

date_comparison_fromstring

Другi период; празан ако нема са чим да се упореди

Пример: 01/07/2026

date_comparison_tostring

Пример: 31/07/2026

chain_idinteger
branch_idinteger
delivery_methodstring (OrderDelivery)

Način isporuke: kurir ili lično preuzimanje

Vrednosti:courierpickup

payment_statusstring (OrderPayment)

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

Vrednosti:not_paidwaitingpaid

operator_idinteger
downloadstring

Враћа збирну табелу периода A у CSV формату уместо JSON

Vrednosti:yes

Пример: yes

Одговори

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

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

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

downloadobject (FilterButtonDownloadCsv)

Дугме за преузимање избора: при клику пошаљите download=yes

valuestring

Пример: Download

typestringобавезно

Пример: button_download_csv

periodsarray of object

Један елемент по период; други — само ако је задат период за поређење

keystringобавезно

a — основни период, b — период за поређење

Vrednosti: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) обавезно

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

Vrednosti:androidapifbiosvksite

orders_countintegerобавезно

Пример: 1810

orders_sharenumberобавезно

Проценат поруџбина у периоду

Пример: 43.93

completed_countintegerобавезно

Пример: 1702

completed_percentnumberобавезно

Пример: 94.03

revenuenumberобавезно

Пример: 1855180

revenue_sharenumberобавезно

Удео прихода за период у процентима

Пример: 42.54

averagenumberобавезно

Prihod podeljen sa brojem izvršenih porudžbina

Пример: 1090

deltaobject (SalesChannelsDelta) обавезноможе бити null

Поређење канала са истим каналом у периоду B. null ако период B није задат.

revenue_absolutenumberобавезно

Пример: -120400

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

null, ако у периоду B канал није имао приход: нема процентуалног раста од нуле

Пример: -6.09

bucketsarray of objectобавезно

Porudžbine grupisane po satima; samo sati sa podacima. Prvo konvertujte vreme u korisničku vremensku zonu, zatim grupišite sate u tačke grafikona: linijski grafikon — po danima ili mesecima, stubičasti — po kalendarskim mesecima. Sabirajte count, completed_count i revenue; nemojte prosečiti srednje vrednosti.

datetimestringобавезно

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

Пример: 2026-08-01 09:00:00

countintegerобавезно

Пример: 12

completed_countintegerобавезно

Пример: 11

revenuenumberобавезно

Пример: 12100