API

Satış kanalları istatistiklerini al

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

Her satış kanalı için gelir, sipariş sayısı ve ortalama fiş tutarını döndürür. Bir istekte, karşılaştırma için iki döneme kadar veri döner (ör. ay bazında karşılaştırma). Dönem toplamları önceden hesaplanmıştır, grafikler için ise yalnızca boş olmayan saatler UTC olarak döner. Saatleri kullanıcı saat dilimine çevirin ve gün veya ay bazında gruplayın. Gelire yalnızca tamamlanmış siparişler dahildir.

Yetkilendirme

api-token + language + role

Sorgu parametreleri

date_creation_fromstring

Örnek: 01/08/2026

date_creation_tostring

Örnek: 31/08/2026

date_comparison_fromstring

İkinci dönem; karşılaştıracak bir şey yoksa boştur

Örnek: 01/07/2026

date_comparison_tostring

Örnek: 31/07/2026

chain_idinteger
branch_idinteger
delivery_methodstring (OrderDelivery)

Teslimat yöntemi: kurye veya self-servis

Değerler:courierpickup

payment_statusstring (OrderPayment)

Ödeme durumu: ödenmedi, beklemede, ödendi

Değerler:not_paidwaitingpaid

operator_idinteger
downloadstring

A döneminin özet tablosunu CSV formatında, JSON yerine döndürür

Değerler:yes

Örnek: yes

Yanıtlar

OK

object
statusstringzorunlu

Değerler:successerror

Örnek: success

dataobject
filtersobject
date_creation_fromobject (FilterDateFrom)
valuestringnull olabilir

Örnek: 2026-08-01 00:00:00

typestringzorunlu

Örnek: date

modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

date_creation_toobject (FilterDateTo)
valuestringnull olabilir

Örnek: 2026-08-31 23:59:59

typestringzorunlu

Örnek: date

modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

date_creation_rangeobject (FilterDateRange)

Hazır tarih filtre dönemleri; alt sınır, kullanıcının saat diliminde hesaplanır. value — mevcut *_from ve *_to ile eşleşen dönem; null — özel dönem. default — sunucunun tarih belirtilmeyen istekte kullandığı dönemdir: ayrıca bölüm ilk yüklendiğinde ve sıfırlama yapıldığında da uygulanır. Dönemin üst sınırı her zaman kullanıcının bugünkü tarihine eşittir, bu nedenle option bunu içermez: hazır dönem için *_to göndermeye gerek yoktur, sunucu bunu otomatik olarak ayarlar. Bir yıldan uzun dönemler, yeni tarihe yakın taraftan kesilir.

valuestring (DateRange) null olabilir

Hazır tarih aralığı filtresi. Bunun için ayrı bir sorgu parametresi yoktur: alt sınır, önceden hesaplanmış olarak option içinde gelir ve *_from alanına eklenir. Üst sınır ise ne yanıtta ne de istekte iletilir — her zaman kullanıcının bugünkü tarihiyle aynıdır ve sunucu tarafından belirlenir.

Değerler:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Örnek: today

defaultstring (DateRange) zorunlu

Hazır tarih aralığı filtresi. Bunun için ayrı bir sorgu parametresi yoktur: alt sınır, önceden hesaplanmış olarak option içinde gelir ve *_from alanına eklenir. Üst sınır ise ne yanıtta ne de istekte iletilir — her zaman kullanıcının bugünkü tarihiyle aynıdır ve sunucu tarafından belirlenir.

Değerler:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Örnek: today

typestringzorunlu

Örnek: select

modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

optionarray of objectzorunlu
valuestring (DateRange) zorunlu

Hazır tarih aralığı filtresi. Bunun için ayrı bir sorgu parametresi yoktur: alt sınır, önceden hesaplanmış olarak option içinde gelir ve *_from alanına eklenir. Üst sınır ise ne yanıtta ne de istekte iletilir — her zaman kullanıcının bugünkü tarihiyle aynıdır ve sunucu tarafından belirlenir.

Değerler:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Örnek: today

date_fromstringzorunlu

Örnek: 25/08/2026

date_comparison_fromobject (FilterDateFrom)
valuestringnull olabilir

Örnek: 2026-08-01 00:00:00

typestringzorunlu

Örnek: date

modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

date_comparison_toobject (FilterDateTo)
valuestringnull olabilir

Örnek: 2026-08-31 23:59:59

typestringzorunlu

Örnek: date

modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

date_comparison_rangeobject (FilterDateRangeOptional)

Hazır tarih aralığı filtreleri, varsayılan değer olmadan: default her zaman null'dır.

valuestring (DateRange) null olabilir

Hazır tarih aralığı filtresi. Bunun için ayrı bir sorgu parametresi yoktur: alt sınır, önceden hesaplanmış olarak option içinde gelir ve *_from alanına eklenir. Üst sınır ise ne yanıtta ne de istekte iletilir — her zaman kullanıcının bugünkü tarihiyle aynıdır ve sunucu tarafından belirlenir.

Değerler:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Örnek: today

defaultstring (DateRange) null olabilir

Hazır tarih aralığı filtresi. Bunun için ayrı bir sorgu parametresi yoktur: alt sınır, önceden hesaplanmış olarak option içinde gelir ve *_from alanına eklenir. Üst sınır ise ne yanıtta ne de istekte iletilir — her zaman kullanıcının bugünkü tarihiyle aynıdır ve sunucu tarafından belirlenir.

Değerler:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Örnek: today

typestringzorunlu

Örnek: select

optionarray of objectzorunlu
valuestring (DateRange) zorunlu

Hazır tarih aralığı filtresi. Bunun için ayrı bir sorgu parametresi yoktur: alt sınır, önceden hesaplanmış olarak option içinde gelir ve *_from alanına eklenir. Üst sınır ise ne yanıtta ne de istekte iletilir — her zaman kullanıcının bugünkü tarihiyle aynıdır ve sunucu tarafından belirlenir.

Değerler:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Örnek: today

date_fromstringzorunlu

Örnek: 25/08/2026

chain_idobject (FilterSelectInteger)
valueinteger

Örnek: 8920

typestringzorunlu

Örnek: select

optionarray of object
valueintegerzorunlu

Örnek: 8920

namestringzorunlu

Örnek: Green Basket | Kaliningrad

modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

branch_idobject (FilterSelectInteger)
valueinteger

Örnek: 8920

typestringzorunlu

Örnek: select

optionarray of object
valueintegerzorunlu

Örnek: 8920

namestringzorunlu

Örnek: Green Basket | Kaliningrad

modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

delivery_methodobject (FilterEnum)

Filtre-enum — düz enum değerleri listesi

valuestring

Örnek: example

typestringzorunlu

Örnek: select

optionarray of string
modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

payment_statusobject (FilterEnum)

Filtre-enum — düz enum değerleri listesi

valuestring

Örnek: example

typestringzorunlu

Örnek: select

optionarray of string
modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

operator_idobject (FilterSelectInteger)
valueinteger

Örnek: 8920

typestringzorunlu

Örnek: select

optionarray of object
valueintegerzorunlu

Örnek: 8920

namestringzorunlu

Örnek: Green Basket | Kaliningrad

modestring (FilterMode)

Arayüzün filtreyi nasıl işlediği; standart bir filtrede mode yoktur. force_shown — her zaman gösterilir, gizlenemez. value_required — bölüme giriş noktasıdır: her zaman gösterilir, boş değeri yoktur (değer seçilene kadar liste boştur; "tümü" seçeneği yoktur), genel sıfırlama bunu temizlemez.

Değerler:force_shownvalue_required

Örnek: value_required

downloadobject (FilterButtonDownloadCsv)

İndirme düğmesi: tıklandığında download=yes iletin

valuestring

Örnek: Download

typestringzorunlu

Örnek: button_download_csv

periodsarray of object

Birinci öğe dönem için; ikincisi ise yalnızca karşılaştırma dönemi belirtilmişse

keystringzorunlu

a — ana dönem, b — karşılaştırma dönemi

Değerler:ab

Örnek: a

date_fromstringzorunlu

Örnek: 01/08/2026

date_tostringzorunlu

Örnek: 31/08/2026

totalobject (SalesChannelsTotal) zorunlu

Dönem boyunca tüm kanalların toplamı

orders_countintegerzorunlu

Örnek: 4120

completed_countintegerzorunlu

Örnek: 3894

completed_percentnumberzorunlu

Örnek: 94.51

revenuenumberzorunlu

Örnek: 4361280

averagenumberzorunlu

Örnek: 1120

channelsarray of objectzorunlu

Her sipariş kanalı için sabit bir sırada bir öğe. "Tüm kanallar" öğesi yoktur: bunun için total kullanılır.

platformstring (OrderPlatform) zorunlu

Sipariş platformu

Değerler:androidapifbiosvksite

orders_countintegerzorunlu

Örnek: 1810

orders_sharenumberzorunlu

Dönem siparişlerinin yüzdesi

Örnek: 43.93

completed_countintegerzorunlu

Örnek: 1702

completed_percentnumberzorunlu

Örnek: 94.03

revenuenumberzorunlu

Örnek: 1855180

revenue_sharenumberzorunlu

Dönem gelir payı yüzdesi

Örnek: 42.54

averagenumberzorunlu

Gelir, tamamlanan sipariş sayısına bölünerek elde edilir

Örnek: 1090

deltaobject (SalesChannelsDelta) zorunlunull olabilir

Kanalın, B dönemindeki aynı kanalla karşılaştırılması. B dönemi belirtilmemişse null.

revenue_absolutenumberzorunlu

Örnek: -120400

revenue_percentnumberzorunlunull olabilir

null, B döneminde kanalda gelir yoksa: sıfırdan yüzde artış hesaplanmaz

Örnek: -6.09

bucketsarray of objectzorunlu

Saatlere göre gruplanmış siparişler; yalnızca boş olmayan saatler. Zamanı kullanıcının saat dilimine çevirin, ardından saatleri grafik noktalarına toplayın: çizgi grafik için günlere veya aylara göre, çubuk grafik için takvim aylarına göre. count, completed_count ve revenue değerlerini toplayın; ortalama değerleri ortalamayın.

datetimestringzorunlu

Siparişlerin ait olduğu saat, UTC cinsinden

Örnek: 2026-08-01 09:00:00

countintegerzorunlu

Örnek: 12

completed_countintegerzorunlu

Örnek: 11

revenuenumberzorunlu

Örnek: 12100