Sotuvlar va tushumni eksport qilish

Ikkita o’xshash so’rov turli metodlar bilan hal qilinadi:

Nima kerak	Metod	Granulyarlik
Sana uchun do’konlar bo’yicha yig’ma tushum	GET /v1/general-report-table	do’kon × sana
To’lov turlari bo’yicha taqsimot	GET /v1/transaction-report-table	tranzaksiya

Do’konlar bo’yicha yig’ma tushum

curl -X GET 'https://api-admin.billz.ai/v1/general-report-table?start_date=2026-08-22&end_date=2026-08-22&shop_ids=ID1,ID2&currency=UZS&detalization=day&limit=50&page=1' \
  -H 'Authorization: Bearer TOKEN'

detalization majburiy

Ruxsat etilgan qiymatlar — 30min, hour, day, week, month, year.

Hisobot qatori — bu «do’kon × sana» juftligi:

Maydon	Bu nima
date, shop_name	sana va do’kon
gross_sales	tushum
net_gross_sales	sof tushum: gross_sales − chegirmalar − qaytarishlar
gross_profit	yalpi foyda
discount_sum, discount_percent	chegirmalar
transactions_count, orders_count, returns_count, exchanges_count	turlari bo’yicha tranzaksiyalar soni
average_cheque, average_measurement_value	o’rtacha chek va undagi mahsulotlarning o’rtacha soni
products_sold, products_returned	sotilgan va qaytarilgan donalar

To’lov turlari bo’yicha taqsimot

«Qanchasi naqd pulda, qanchasi karta orqali o’tgani» kerak bo’lganda — GET /v1/transaction-report-table, yakunlar — GET /v1/transaction-report-totals. Filtr uchun to’lov turlari ma’lumotnomasi — GET /v1/transaction-report-payments, tur nomlari — GET /v1/company-payment-type.

Sahifama-sahifa o’qish o’rniga tayyor fayl

Ikkala hisobotning ham juft metodi bor: u fon rejimida .xlsx yig’adi va tayyor faylga havola qaytaradi — POST /v1/general-report-excel do’kon bo’yicha yig’ma hisobot, POST /v1/transaction-report-excel tranzaksiyalar. O’nlab sahifa o’rniga bitta so’rov; bunda Billz-Response-Channel: HTTP sarlavhasi majburiy, usiz havolani olib bo’lmaydi. Parametrlar, fayl ustunlari va o’n oltita hisobotning to’liq ro’yxati — hisobotlarni Excel’ga eksport qilish sahifasida.

Ruxsatlar

Barcha sanab o’tilgan hisobotlar integratsiya kaliti uchun ochiq bo’lgan marshrutlar ro’yxatiga kiradi.

Natijalarni token uchun ruxsat etilgan do’konlar ro’yxati cheklaydi: uzatilgan shop_ids ruxsat etilganlar bilan kesishadi.

Muntazam yuklab olish

• Kechagi kun to’liq bir marta olinadi: sotuv tahrirlanishi yoki orqa sana bilan qaytarilishi mumkin.
• Hisobotlardagi sanalar — kompaniya vaqt mintaqasida (Toshkent — UTC+5).
• 429 da eksponensial kechikish bilan takrorlash har doim zarur.