API

Ստանալ վաճառքի ալիքների վիճակագրությունը

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

Վերադարձնում է եկամուտը, պատվերների քանակը և միջին չեկը յուրաքանչյուր վաճառքի ալիքի համար։ Մեկ հարցման ընթացքում վերադարձվում է մինչև երկու ժամանակաշրջան՝ ամսվա համեմատության համար։ Ժամանակաշրջանի արդյունքները արդեն հաշվարկված են, իսկ գրաֆիկների համար վերադարձվում են ոչ դատարկ ժամերը UTC-ում։ Դրանք փոխարկեք օգտագործողի ժամանակային գոտու մեջ և խմբավորեք ըստ օրերի կամ ամիսների։ Եկամուտի մեջ ներառված են միայն կատարված պատվերները։.

Հավաստագրում

api-token + language + role

Հարցման պարամետրեր

date_creation_fromstring

Օրինակ: 01/08/2026

date_creation_tostring

Օրինակ: 31/08/2026

date_comparison_fromstring

Երկրորդ ժամանակաշրջան; դատարկ է, եթե համեմատելու ոչինչ չկա

Օրինակ: 01/07/2026

date_comparison_tostring

Օրինակ: 31/07/2026

chain_idinteger
branch_idinteger
delivery_methodstring (OrderDelivery)

Առաքման եղանակը՝ սուրհանդակ կամ ինքնաբերում

Արժեքներ:courierpickup

payment_statusstring (OrderPayment)

Վճարման կարգավիճակ՝ չվճարված, սպասում է, վճարված

Արժեքներ:not_paidwaitingpaid

operator_idinteger
downloadstring

Վերադարձնում է ժամանակաշրջան A-ի համառոտ աղյուսակը CSV ձևաչափով JSON-ի փոխարեն

Արժեքներ:yes

Օրինակ: yes

Պատասխաններ

OK

object
statusstringպարտադիր

Արժեքներ: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 — բաժնի մուտքի կետն է. միշտ ցուցադրվում է, չունի դատարկ արժեք (քանի դեռ արժեքը ընտրված չէ, ցուցակը դատարկ է; «բոլորը» տարբերակ չկա), ընդհանուր մաքրելը չի մաքրում այն։.

Արժեքներ: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 — բաժնի մուտքի կետն է. միշտ ցուցադրվում է, չունի դատարկ արժեք (քանի դեռ արժեքը ընտրված չէ, ցուցակը դատարկ է; «բոլորը» տարբերակ չկա), ընդհանուր մաքրելը չի մաքրում այն։.

Արժեքներ:force_shownvalue_required

Օրինակ: value_required

date_creation_rangeobject (FilterDateRange)

Պատրաստի ամսաթվային ֆիլտրի ժամանակահատվածներ; ստորին սահմանը հաշվարկվում է օգտագործողի ժամային գոտու հիման վրա։ value — ժամանակահատված, որին համապատասխանում են ընթացիկ *_from և *_to; null — կամայական ժամանակահատված։ default — ժամանակահատված, որը սերվերը օգտագործում է առանց ամսաթվերի հարցման դեպքում. նույնը կիրառվում է բաժնի առաջին բեռնումից և վերականգնման ժամանակ։ Ժամանակահատվածի վերին սահմանը միշտ համընկնում է օգտագործողի ընթացիկ օրվա հետ, ուստի option-ը այն չի պարունակում. պատրաստի ժամանակահատվածի համար անհրաժեշտ չէ փոխանցել *_to, սերվերը այն սահմանում է ինքնուրույն։ Տարեկանից երկար ժամանակահատվածը կրճատվում է թարմ սահմանից։.

valuestring (DateRange) կարող է լինել null

Պատրաստի ամսաթվային ֆիլտրի ժամանակահատված։ Այն չունի սեփական հարցման պարամետր․ ստորին սահմանը արդեն հաշվարկված է գալիս option-ում և օգտագործվում է որպես *_from։ Վերին սահմանը չի փոխանցվում ոչ պատասխանով, ոչ հարցմամբ՝ այն միշտ հավասար է օգտագործողի ընթացիկ օրվան և սահմանվում է սերվերի կողմից։.

Արժեքներ:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Օրինակ: today

defaultstring (DateRange) պարտադիր

Պատրաստի ամսաթվային ֆիլտրի ժամանակահատված։ Այն չունի սեփական հարցման պարամետր․ ստորին սահմանը արդեն հաշվարկված է գալիս option-ում և օգտագործվում է որպես *_from։ Վերին սահմանը չի փոխանցվում ոչ պատասխանով, ոչ հարցմամբ՝ այն միշտ հավասար է օգտագործողի ընթացիկ օրվան և սահմանվում է սերվերի կողմից։.

Արժեքներ:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Օրինակ: today

typestringպարտադիր

Օրինակ: select

modestring (FilterMode)

Ինչպես է ինտերֆեյսը մշակում ֆիլտրը; սովորական ֆիլտրի համար mode չկա։ force_shown — միշտ ցուցադրվում է, հնարավոր չէ թաքցնել։ value_required — բաժնի մուտքի կետն է. միշտ ցուցադրվում է, չունի դատարկ արժեք (քանի դեռ արժեքը ընտրված չէ, ցուցակը դատարկ է; «բոլորը» տարբերակ չկա), ընդհանուր մաքրելը չի մաքրում այն։.

Արժեքներ:force_shownvalue_required

Օրինակ: value_required

optionarray of objectպարտադիր
valuestring (DateRange) պարտադիր

Պատրաստի ամսաթվային ֆիլտրի ժամանակահատված։ Այն չունի սեփական հարցման պարամետր․ ստորին սահմանը արդեն հաշվարկված է գալիս option-ում և օգտագործվում է որպես *_from։ Վերին սահմանը չի փոխանցվում ոչ պատասխանով, ոչ հարցմամբ՝ այն միշտ հավասար է օգտագործողի ընթացիկ օրվան և սահմանվում է սերվերի կողմից։.

Արժեքներ: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 — բաժնի մուտքի կետն է. միշտ ցուցադրվում է, չունի դատարկ արժեք (քանի դեռ արժեքը ընտրված չէ, ցուցակը դատարկ է; «բոլորը» տարբերակ չկա), ընդհանուր մաքրելը չի մաքրում այն։.

Արժեքներ: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 — բաժնի մուտքի կետն է. միշտ ցուցադրվում է, չունի դատարկ արժեք (քանի դեռ արժեքը ընտրված չէ, ցուցակը դատարկ է; «բոլորը» տարբերակ չկա), ընդհանուր մաքրելը չի մաքրում այն։.

Արժեքներ:force_shownvalue_required

Օրինակ: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Պատրաստի ամսաթվային միջակայքերի ֆիլտրեր առանց լռելյայն արժեքի՝ default միշտ հավասար է null:.

valuestring (DateRange) կարող է լինել null

Պատրաստի ամսաթվային ֆիլտրի ժամանակահատված։ Այն չունի սեփական հարցման պարամետր․ ստորին սահմանը արդեն հաշվարկված է գալիս option-ում և օգտագործվում է որպես *_from։ Վերին սահմանը չի փոխանցվում ոչ պատասխանով, ոչ հարցմամբ՝ այն միշտ հավասար է օգտագործողի ընթացիկ օրվան և սահմանվում է սերվերի կողմից։.

Արժեքներ:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Օրինակ: today

defaultstring (DateRange) կարող է լինել null

Պատրաստի ամսաթվային ֆիլտրի ժամանակահատված։ Այն չունի սեփական հարցման պարամետր․ ստորին սահմանը արդեն հաշվարկված է գալիս option-ում և օգտագործվում է որպես *_from։ Վերին սահմանը չի փոխանցվում ոչ պատասխանով, ոչ հարցմամբ՝ այն միշտ հավասար է օգտագործողի ընթացիկ օրվան և սահմանվում է սերվերի կողմից։.

Արժեքներ:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Օրինակ: today

typestringպարտադիր

Օրինակ: select

optionarray of objectպարտադիր
valuestring (DateRange) պարտադիր

Պատրաստի ամսաթվային ֆիլտրի ժամանակահատված։ Այն չունի սեփական հարցման պարամետր․ ստորին սահմանը արդեն հաշվարկված է գալիս option-ում և օգտագործվում է որպես *_from։ Վերին սահմանը չի փոխանցվում ոչ պատասխանով, ոչ հարցմամբ՝ այն միշտ հավասար է օգտագործողի ընթացիկ օրվան և սահմանվում է սերվերի կողմից։.

Արժեքներ: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 — բաժնի մուտքի կետն է. միշտ ցուցադրվում է, չունի դատարկ արժեք (քանի դեռ արժեքը ընտրված չէ, ցուցակը դատարկ է; «բոլորը» տարբերակ չկա), ընդհանուր մաքրելը չի մաքրում այն։.

Արժեքներ: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 — բաժնի մուտքի կետն է. միշտ ցուցադրվում է, չունի դատարկ արժեք (քանի դեռ արժեքը ընտրված չէ, ցուցակը դատարկ է; «բոլորը» տարբերակ չկա), ընդհանուր մաքրելը չի մաքրում այն։.

Արժեքներ:force_shownvalue_required

Օրինակ: value_required

delivery_methodobject (FilterEnum)

Զտիչ-թվարկում — թվարկման արժեքների հարթ ցուցակ

valuestring

Օրինակ: example

typestringպարտադիր

Օրինակ: select

optionarray of string
modestring (FilterMode)

Ինչպես է ինտերֆեյսը մշակում ֆիլտրը; սովորական ֆիլտրի համար mode չկա։ force_shown — միշտ ցուցադրվում է, հնարավոր չէ թաքցնել։ value_required — բաժնի մուտքի կետն է. միշտ ցուցադրվում է, չունի դատարկ արժեք (քանի դեռ արժեքը ընտրված չէ, ցուցակը դատարկ է; «բոլորը» տարբերակ չկա), ընդհանուր մաքրելը չի մաքրում այն։.

Արժեքներ:force_shownvalue_required

Օրինակ: value_required

payment_statusobject (FilterEnum)

Զտիչ-թվարկում — թվարկման արժեքների հարթ ցուցակ

valuestring

Օրինակ: example

typestringպարտադիր

Օրինակ: select

optionarray of string
modestring (FilterMode)

Ինչպես է ինտերֆեյսը մշակում ֆիլտրը; սովորական ֆիլտրի համար mode չկա։ force_shown — միշտ ցուցադրվում է, հնարավոր չէ թաքցնել։ value_required — բաժնի մուտքի կետն է. միշտ ցուցադրվում է, չունի դատարկ արժեք (քանի դեռ արժեքը ընտրված չէ, ցուցակը դատարկ է; «բոլորը» տարբերակ չկա), ընդհանուր մաքրելը չի մաքրում այն։.

Արժեքներ: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 — բաժնի մուտքի կետն է. միշտ ցուցադրվում է, չունի դատարկ արժեք (քանի դեռ արժեքը ընտրված չէ, ցուցակը դատարկ է; «բոլորը» տարբերակ չկա), ընդհանուր մաքրելը չի մաքրում այն։.

Արժեքներ:force_shownvalue_required

Օրինակ: value_required

downloadobject (FilterButtonDownloadCsv)

Նմուշի ներբեռնման կոճակ՝ սեղմելիս փոխանցեք download=yes

valuestring

Օրինակ: Download

typestringպարտադիր

Օրինակ: button_download_csv

periodsarray of object

Մեկ տարր յուրաքանչյուր ժամանակաշրջանի համար, երկրորդը՝ միայն եթե նշված է համեմատության ժամանակաշրջան:

keystringպարտադիր

a — հիմնական ժամանակահատված, b — համեմատական ժամանակահատված

Արժեքներ: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) պարտադիր

Պատվերի հարթակ

Արժեքներ:androidapifbiosvksite

orders_countintegerպարտադիր

Օրինակ: 1810

orders_sharenumberպարտադիր

Պատվերների բաժինը ժամանակաշրջանում տոկոսներով

Օրինակ: 43.93

completed_countintegerպարտադիր

Օրինակ: 1702

completed_percentnumberպարտադիր

Օրինակ: 94.03

revenuenumberպարտադիր

Օրինակ: 1855180

revenue_sharenumberպարտադիր

Պարբերականի եկամտի բաժինը տոկոսներով

Օրինակ: 42.54

averagenumberպարտադիր

Եկամուտը, բաժանված կատարված պատվերների քանակին

Օրինակ: 1090

deltaobject (SalesChannelsDelta) պարտադիրկարող է լինել null

Համեմատություն ալիքի նույն ալիքի հետ B ժամանակահատվածում։ null, եթե B ժամանակահատվածը նշված չէ։.

revenue_absolutenumberպարտադիր

Օրինակ: -120400

revenue_percentnumberպարտադիրկարող է լինել null

null, եթե B ժամանակահատվածում ալիքը եկամուտ չի ունեցել

Օրինակ: -6.09

bucketsarray of objectպարտադիր

Պատվերները, խմբավորված ըստ ժամերի; միայն ոչ դատարկ ժամերը։ Ժամանակը փոխարկեք օգտագործողի ժամային գոտուն, ապա ժամերը հավաքեք գրաֆիկի կետերում՝ գծային գրաֆիկի համար՝ ըստ օրերի կամ ամիսների, սյունայինի համար՝ ըստ օրացուցային ամիսների։ Գումարեք count, completed_count և revenue; միջին արժեքները մի միջինացրեք։.

datetimestringպարտադիր

Այն ժամը (UTC), որին վերաբերում են պատվերները

Օրինակ: 2026-08-01 09:00:00

countintegerպարտադիր

Օրինակ: 12

completed_countintegerպարտադիր

Օրինակ: 11

revenuenumberպարտադիր

Օրինակ: 12100