Hisobotlarni Excel'ga eksport qilish

«Hisobotlarni eksport qilish» bo’limi metodlari tayyor faylga .xlsx havola beradi — bu BILLZ hisobotlar sahifalaridagi kabi hisobot va sahifalab o’qiladigan hisobotlardagi ma’lumotlar bilan bir xil. Yuklamadagi farq: o’nlab sahifalar GET o’rniga — bitta POST va faylga havola.

Barcha metodlar JSON tanasiga ega POST ni qabul qiladi va bir xil javob qaytaradi.

Fayl qanday olinadi

Fayl bir zumda tayyorlanmaydi — yig’ish orqa fonda amalga oshiriladi. Ikkita rejim mavjud.

Javobda faylni kutish

Sarlavhani yuboring:

Billz-Response-Channel: HTTP

So’rov fayl tayyor bo’lishini 100 soniyagacha kutadi va havola bilan javob qaytaradi. Integratsiya uchun bu faylga havolani umuman olish mumkin bo’lgan yagona rejimdir.

curl -X POST 'https://api-admin.billz.ai/v1/stock-report-excel' \
  -H 'Authorization: Bearer TOKEN' \
  -H 'Billz-Response-Channel: HTTP' \
  -H 'Content-Type: application/json' \
  -d '{
    "shop_ids": ["6f244db4-75d6-4fac-9841-14867d45e36a"],
    "report_date": "2026-08-31",
    "currency": "UZS",
    "fields": ["product_name", "measurement_value", "supply_price", "retail_price"]
  }'

Kutmaslik

Sarlavhasiz metod darhol javob beradi:

{ "message": "7c1e2f3a-9b21-4e2a-8c31-3f4a2b1c9d0e" }

Bu so’rovning correlation_id.

Sarlavhasiz faylni API orqali olib bo’lmaydi

Bu rejimda faylga havola hech qachon qaytarilmaydi: tayyor fayl BILLZ interfeysiga bildirishnoma sifatida yuboriladi, APIda esa “faylni correlation_id bo’yicha olish” metodi mavjud emas. Integratsiya uchun Billz-Response-Channel: HTTP bo’lishi shart.

Javob

{
  "status_code": 200,
  "data": {
    "filename": "2026-08-31 uchun qoldiqlar hisoboti_7c1e2f3a-9b21-4e2a-8c31-3f4a2b1c9d0e",
    "url": "https://minio.billz.ai/report-excel/2026-08-31 uchun qoldiqlar hisoboti_7c1e2f3a-9b21-4e2a-8c31-3f4a2b1c9d0e"
  }
}

Fayl nomi <davr> uchun <hisobot nomi>_<unikal id> andozasi bo’yicha shakllanadi; har bir hisobotning andozasi quyida, uning bo’limida ko’rsatilgan. Xizmat lang va integratsiya tilidan qat’i nazar, nomni ruscha shakllantiradi — bu sahifaning tarjimalarida andozalar ma’nosiga ko’ra keltirilgan, biroq ruscha nom keladi.

Havolada kengaytma yo’q

Havola .xlsx bilan emas, balki identifikator bilan tugaydi. Bunda kontent odatiy .xlsx bo’ladi: saqlash paytida kengaytma qo’lda qo’shiladi.

Xatolar — umumiy formatda. Agar fayl 100 soniya ichida yig’ilishga ulgurmasa, so’rov 408 bilan error.code = TIMEOUT da tugaydi va yig’ish davom etadi. 100 soniyalik kutish faqat hisobotlarni eksport qilishda mavjud; qolgan asinxron metodlarda u uzoqroq.

Chastota cheklovchisi: soniyasiga 5 ta so’rov

Bo’limning o’nta metodida o’z cheklovchisi mavjud — soniyasiga 5 ta so’rov (keskin oshish 10 ta), platformaning barcha mijozlari uchun umumiy: general-report-excel, product-general-report-excel, seller-general-report-excel, customer-general-report-excel, customer-purchases-report-excel, sells-supplier-report-excel, transaction-report-excel, import-report-excel, stock-report-excel, transfer-report-excel-export. Me’yordan oshganda — 429, tahlil javob kodlarida keltirilgan. Bo’limning qolgan oltita metodida o’z cheklovchisi yo’q.

Ustunlar: fields parametri

fields — faylga tushadigan ustunlar ro’yxati, ular keltirilgan tartibda. Yaroqli qiymatlar har bir hisobotning «Ustunlar» jadvalida ko’rsatilgan.

fields bo’lmasa, fayl bo’sh bo’ladi

Metod faylni qaytaradi, biroq ma’lumotlar ustunlarisiz.

Mahsulot atributlari va kastom maydonlari bo’yicha ustunlar

Mahsulotlar bo’yicha hisobotlarda fields da ustun nomi o’rniga kompaniya katalogida sozlangan mahsulotning UUID atributini yoki kastom maydonini («O’lcham», «Rang») uzatish mumkin:

{
  "fields": ["product_name", "measurement_value", "9f1c2e3a-5b7d-4c1e-8a2f-3d6b0e4c7a91"]
}

Ustun katalogdan atribut nomini oladi, satrlarda esa har bir mahsulot uchun uning qiymatlari joylashadi. Mahsulotda qiymat bo’lmasa — katak bo’sh qoladi. Bu funksiya ishlaydigan hisobotlar quyida belgilangan.

Hisobotlar reestri

Bo’lim	Hisobot	Metod
Do’kon	Do’kon bo’yicha yig’ma hisobot	POST /v1/general-report-excel
Tranzaksiyalar	Tranzaksiyalar	POST /v1/transaction-report-excel
Sotuvchilar	Sotuvchilar bo’yicha xulosa	POST /v1/seller-general-report-excel
Mijozlar	Mijozlar bo’yicha xulosa	POST /v1/customer-general-report-excel
Mijozlar	Mijozlar xaridlari	POST /v1/customer-purchases-report-excel
Moliya	Foyda va zararlar	POST /v1/report-profit-and-lose-excel
Moliya	Moliyaviy tranzaksiyalar (PMH)	POST /v1/cashflow-excel
Mahsulotlar	Tovarlar bo’yicha sotuvlar	POST /v1/product-general-report-excel
Mahsulotlar	Tovarlar samaradorligi	POST /v1/report-product-performance-excel
Mahsulotlar	Importlar	POST /v1/import-report-excel
Mahsulotlar	Yetkazib beruvchilar bo’yicha sotuvlar	POST /v1/sells-supplier-report-excel
Mahsulotlar	Buyurtma qaytarishlari	POST /v1/supplier-order-returned-export
Mahsulotlar	Inventarizatsiya natijalari	POST /v1/stocktaking-summary-table-excel-export
Mahsulotlar	Mahsulotlar bo’yicha qoldiqlar	POST /v1/stock-report-excel
Mahsulotlar	Hisobdan chiqarishlar	POST /v1/write-off-report-table-export
Mahsulotlar	Ko’chirishlar	POST /v1/transfer-report-excel-export

Do’kon

Do’kon bo’yicha yig’ma hisobot

POST /v1/general-report-excel · fayl <start_date> - <end_date> uchun jamlanma hisobot_<id>

Davr uchun tushum, foyda, o’rtacha chek va tranzaksiyalar soni.

{
  "shop_ids": ["2339a738-a67f-48d2-bb60-8cf4ec54d6cd"],
  "start_date": "2026-08-01",
  "end_date": "2026-08-31",
  "currency": "UZS",
  "detalization": "day",
  "fields": ["date", "shop_name", "gross_sales", "net_gross_sales", "average_cheque"]
}

Ustunlar:

fields qiymati	Fayldagi ustun
date	Sana
shop_name	Do’kon
gross_sales	Tushum
discount_sum	Chegirma summasi
discount_percent	Chegirma foizi
products_returned	Qaytarilgan mahsulotlar soni
returned_supply_price	Xarid narxi bo’yicha qaytarishlar
returned_discount_price	Chegirmali narx bo’yicha qaytarishlar
returned_retail_price	Sotuv narxi bo’yicha qaytarishlar
sales_supply_price	Xarid narxi bo’yicha sotuvlar
net_gross_sales	Sof tushum
gross_profit	Yalpi foyda
average_cheque	O’rtacha chek
average_price	Chekdagi mahsulotning o’rtacha narxi
average_measurement_value	Chekdagi mahsulotlarning o’rtacha soni
average_extra_charge	O’rtacha ustama
products_sold	Sotilgan mahsulotlar soni
transactions_count	Jami tranzaksiyalar soni
orders_count	Sotuv tranzaksiyalari soni
returns_count	Qaytarish tranzaksiyalari soni
exchanges_count	Almashtirish tranzaksiyalari soni
sales_per_square	Kvadrat metr uchun sotuvlar

Tranzaksiyalar

Tranzaksiyalar

POST /v1/transaction-report-excel · fayl <start_date> - <end_date> uchun tranzaksiyalar bo'yicha hisobot_<id>

Davr uchun sotuvlar, qaytarishlar va almashtirishlar — har bir tranzaksiya uchun qator.

{
  "shop_ids": ["2339a738-a67f-48d2-bb60-8cf4ec54d6cd"],
  "start_date": "2026-08-01",
  "end_date": "2026-08-31",
  "order_types": ["SALE"],
  "fields": ["date", "order_type", "total_price", "seller_names"]
}

Ustunlar:

fields qiymati	Fayldagi ustun
date	Sana
external_id	Tranzaksiya ID si
shop_name	Do’kon
customer_name	Mijozning F.I.Sh.
cashier_name	Kassirning F.I.Sh.
seller_names	Sotuvchining F.I.Sh.
order_type	Tranzaksiya turi
sold_measurement_value	Sotilgan mahsulotlar va xizmatlar soni
returned_measurement_value	Qaytarilgan mahsulotlar soni
total_price	Tranzaksiya summasi
discount_percent	Chegirma
average_product_price	Chekdagi mahsulot yoki xizmatning o’rtacha narxi
gross_sales	Chegirmasiz to’lov summasi
comment	Tranzaksiyaga izoh
is_modified	Tahrirlar tarixi

Sotuvchilar

Sotuvchilar bo’yicha xulosa

POST /v1/seller-general-report-excel · fayl <start_date> - <end_date> uchun sotuvchilar bo'yicha hisobot_<id>

Kompaniya sotuvchilari kesimidagi sotuvlar.

Sotuvchilar bo’yicha saralash mavjud emas

Hisobot har doim kompaniyaning barcha sotuvchilari bo’yicha tuziladi. Uni faqat do’konlar (shop_ids) va hide_sellers_without_sales bayrog’i orqali cheklash mumkin.

{
  "shop_ids": ["2339a738-a67f-48d2-bb60-8cf4ec54d6cd"],
  "start_date": "2026-08-01",
  "end_date": "2026-08-31",
  "currency": "UZS",
  "price_type": 1,
  "hide_sellers_without_sales": true,
  "detalization": "day",
  "fields": ["date", "seller_name", "gross_sales", "net_gross_profit", "transaction_count"]
}

Ustunlar:

fields qiymati	Fayldagi ustun
date	Sana
shop_name	Do’kon
seller_name	Sotuvchi
gross_sales	Tushum
discount_sum	Chegirma summasi
discount_percent	Chegirma foizi
net_gross_sales	Sof tushum
net_gross_profit	Yalpi foyda
sum_returned	Qaytarmalar summasi
sold_measurement_value	Sotilgan mahsulotlar soni
returned_measurement_value	Qaytarilgan mahsulotlar soni
sold_without_return	Qaytarmalarni hisobga olgan holda sotilganlar soni
transaction_count	Tranzaksiyalar soni
orders_count	Sotuv tranzaksiyalari soni
average_cheque	O’rtacha chek
average_measurement_value	Mahsulotlarning o’rtacha soni
average_price	Mahsulotning o’rtacha narxi
net_sold_supply_sum	Yetkazib berish narxidagi sotuvlar
rounding_amount	Yaxlitlash summasi

Mijozlar

Mijozlar bo’yicha xulosa

POST /v1/customer-general-report-excel · fayl <start_date> - <end_date> uchun mijozlar bo'yicha hisobot_<id>

Har bir mijoz bo’yicha xaridlar, qaytarishlar va o’rtacha chek — barcha vaqt va tanlangan davr uchun.

{
  "shop_ids": ["2339a738-a67f-48d2-bb60-8cf4ec54d6cd"],
  "start_date": "2026-08-01",
  "end_date": "2026-08-31",
  "currency": "UZS",
  "price_type": 1,
  "fields": ["customer_name", "customer_phones", "total_purchase_sum", "total_sale_count"]
}

Ustunlar:

fields qiymati	Fayldagi ustun
registration_date	Ro’yxatdan o’tgan sana
registration_shop_name	Ro’yxatdan o’tgan do’kon
customer_name	Mijozning F.I.Sh.
birth_date	Tug’ilgan sana
customer_id	Mijoz IDsi
customer_phones	Telefon
customer_groups	Guruhlar va teglar
is_new_client	Yangi mijoz
is_returned_client	Qaytgan mijoz
total_sale_count	Sotuvlar (jami)
total_exchange_count	Almashtirishlar (jami)
total_return_count	Qaytarishlar (jami)
total_measurement_value	Xarid qilingan mahsulotlar soni (jami)
total_purchase_sum	Xaridlarning umumiy summasi (jami)
total_average_measurement_value	Chekdagi mahsulotlarning o’rtacha soni (jami)
total_average_purchase_sum	O’rtacha chek (jami)
total_average_purchase_discount	O’rtacha chegirma (jami)
total_returned_measurement_value	Qaytarilgan mahsulotlar soni (jami)
total_returned_sum	Qaytarilgan mahsulotlar summasi (jami)
period_sale_count	Davr uchun sotuvlar
period_exchange_count	Davr uchun almashtirishlar
period_return_count	Davr uchun qaytarishlar
period_measurement_value	Davr uchun xarid qilingan mahsulotlar soni
period_purchase_sum	Davr uchun xaridlarning umumiy summasi
period_average_measurement_value	Davr uchun chekdagi mahsulotlarning o’rtacha soni
period_average_purchase_sum	Davr uchun o’rtacha chek
period_average_purchase_discount	Davr uchun o’rtacha chegirma
period_returned_measurement_value	Davr uchun qaytarilgan mahsulotlar soni
period_returned_sum	Davr uchun qaytarilgan mahsulotlar summasi

Mijozlar xaridlari

POST /v1/customer-purchases-report-excel · fayl <start_date> - <end_date> uchun mijozlar xaridlari bo'yicha hisobot_<id>

Xaridlarning qatorma-qator ro’yxati: nima, kim va qachon sotib olgan.

{
  "shop_ids": ["2339a738-a67f-48d2-bb60-8cf4ec54d6cd"],
  "start_date": "2026-08-01",
  "end_date": "2026-08-31",
  "with_customers": true,
  "currency": "UZS",
  "fields": ["created_at", "customer_name", "product_name", "gross_sales"]
}

Ustunlar:

fields qiymati	Fayldagi ustun
created_at	Xarid sanasi
shop_name	Do’kon
order_type	Tranzaksiya turi
order_number	Tranzaksiya ID si
seller_name	Sotuvchi
customer_number	Mijoz IDsi
customer_name	Mijozning F.I.Sh.
phone_numbers	Telefon
tags	Teg
groups	Guruh
product_name	Nomi
product_brand_name	Brend
product_barcode	Shtrix-kod
product_sku	Artikul
categories_path	Kategoriya
level_1 … level_5	Kategoriya va 1–4-kichik kategoriyalar
free_price	Erkin narx
used_wholesale_price	Ulgurji narx
gross_sales	Tushum
net_sales	Sof tushum
net_sold_supply_sum	Tannarx bo’yicha sotuvlar
net_profit	Yalpi foyda
discount_percent	O’rtacha chegirma
sold_measurement_value	Sotilgan mahsulotlar soni
returned_measurement_value	Qaytarilgan mahsulotlar soni

Moliya

Foyda va zararlar

POST /v1/report-profit-and-lose-excel · fayl <start_date> - <end_date> uchun foyda va zararlar hisoboti_<id>

Kompaniyaning davrdagi daromadlari, xarajatlari va sof foydasi.

Hisobotda fields yo’q

Satrlar to’plami qat’iy belgilangan: kategoriyalar bo’yicha daromadlar, «Tushum», «Chegirmalar», «Qaytarishlar», «Sof tushum», «Yaxlitlash summasi», «JAMI DAROMADLAR», kategoriyalar bo’yicha xarajatlar, «MAHSULOTLAR TANNARXI», «MARJINAL FOYDA», «MARJINAL FOYDA RENTABELLIGI», «Tannarx bo’yicha hisobdan chiqarish», «JAMI XARAJATLAR», «SOF FOYDA».

Satr nomlari faqat lang: "ru" bo’lganda to’ldirilgan holda keladi; boshqa qiymatlarda ular bo’sh bo’ladi.

{
  "shop_ids": ["2339a738-a67f-48d2-bb60-8cf4ec54d6cd"],
  "start_date": "2026-08-01",
  "end_date": "2026-08-31",
  "currency": "UZS",
  "detalization": "day",
  "price_type": 1,
  "lang": "ru"
}

Moliyaviy tranzaksiyalar (PMH)

POST /v1/cashflow-excel · fayl <start_date> - <end_date> uchun pul mablag'lari harakati_<id>

Pul mablag’lari harakati: kirim, chiqim, inkassatsiya, konvertatsiya.

operation uchun operatsiya turlari vergul orqali sanab o’tiladi, masalan 1,2:

Qiymat	Operatsiya
1	Daromad
2	Xarajat
3	Smenani yopish — naqd pulsiz to’lov usullari uchun kassa smenasi yopilganda tizimning o’zi yaratadigan pul harakati
4	Ko’chirish — foydalanuvchi tashabbusi bilan kassalar va hisobraqamlar o’rtasida pullarni qo’lda o’tkazish
5	Konvertatsiya
6	Inkassatsiya
7	Ochilish summasi

{
  "shop_ids": ["2339a738-a67f-48d2-bb60-8cf4ec54d6cd"],
  "start_date": "2026-08-01",
  "end_date": "2026-08-31",
  "operation": "1,2",
  "fields": ["created_at", "cashbox", "operation", "amount_from_retail_currency", "user"]
}

Ustunlar:

fields qiymati	Fayldagi ustun
created_at	Sana va vaqt
cashbox	Kassa
payment_type	Pul operatsiyasi turi
operation	Tranzaksiya turi
from_account	Qayerdan
to_account	Qayerga
amount_from_retail_currency	Chiqim summasi (kompaniya valyutasida)
amount_to_retail_currency	Kirim summasi (kompaniya valyutasida)
amount_from_usd	Chiqim summasi (AQSH dollari)
amount_to_usd	Kirim summasi (AQSH dollari)
user	Foydalanuvchi

Mahsulotlar

Tovarlar bo’yicha sotuvlar

POST /v1/product-general-report-excel · fayl <start_date> - <end_date> uchun sotuvlar bo'yicha hisobot_<id>

Mahsulotlar kesimida sotuvlar statistikasi. fields da atributlar va maxsus maydonlarning UUID lari qabul qilinadi.

{
  "shop_ids": ["2339a738-a67f-48d2-bb60-8cf4ec54d6cd"],
  "start_date": "2026-08-01",
  "end_date": "2026-08-31",
  "currency": "UZS",
  "detalization": "day",
  "fields": ["product_name", "sold_measurement_value", "gross_sales", "net_profit"]
}

Ustunlar:

fields qiymati	Fayldagi ustun
date	Sana
product_name	Nomi
product_sku	Artikul
product_barcode	Shtrix-kod
product_brand_name	Brend
shop_name	Do’kon nomi
categories_path	Kategoriya
level_1 … level_5	Kategoriya va 1–4-kichik kategoriyalar
product_measurement_unit_short_name	O’lchov birligi
product_suppliers	Yetkazib beruvchi
sold_measurement_value	Sotilganlar soni
returned_measurement_value	Qaytarilganlar soni
net_sold_measurement_value	Qaytarilganlar chegirilgan holda sotilgan
gross_sales	Chegirmani hisobga olmagan holdagi sotuvlar
returned_sales_sum	Qaytarmalar summasi
net_sales	Qaytarilganlarni hisobga olgan holdagi chegirmali sotuvlar
net_profit	Yalpi foyda
sold_supply_sum	Xarid narxi bo’yicha sotuvlar
average_margin	O’rtacha ustama
discount	Chegirma
sold_with_discount	Chegirma bilan sotilgan
sold_without_discount	Chegirmasiz sotilgan
product_is_archived	Arxivlangan

Tovarlar samaradorligi

POST /v1/report-product-performance-excel · fayl <start_date> - <end_date> uchun Tovarlar Samaradorligi hisoboti_<id>

Davr davomida har bir mahsulot bo’yicha barcha harakatlar: davr boshi va oxiridagi qoldiqlar, import, sotuvlar, hisobdan chiqarishlar, ko’chirishlar, sotilish tezligi va aylanuvchanlik. fieldsda atributlar va maxsus maydonlarning UUIDlari qabul qilinadi.

{
  "shop_ids": ["2339a738-a67f-48d2-bb60-8cf4ec54d6cd"],
  "start_date": "2026-08-01",
  "end_date": "2026-08-31",
  "grouping_fields": "attribute.color",
  "group_id": "9f1c2e3a-5b7d-4c1e-8a2f-3d6b0e4c7a91",
  "filter": { "skus": ["SKU-001"] },
  "order_by": "+product_name",
  "currency": "UZS",
  "fields": ["name", "sold_amount", "sold_retail_sum"]
}

Mahsulot haqidagi ustunlar:

fields qiymati	Fayldagi ustun
shop_name	Do’kon
supplier_name	Yetkazib beruvchi
name	Nomi
sku	Artikul
bar_code	Shtrix-kod
is_archived	Arxivlangan
brand_name	Brend
categories_path	Kategoriya
level_1 … level_5	Kategoriya va 1–4-kichik kategoriyalar

Ko’rsatkich ustunlari, har bir guruh — tanlangan davr uchun:

Guruh	fields qiymatlari	Ustunlarda nimalar bor
Davr boshidagi qoldiq	stock_amount_begin, stock_supply_sum_begin, stock_retail_sum_begin	miqdor, yetkazib berish narxi bo’yicha summa, sotuv summasi
Mahsulot importi	import_amount, import_supply_sum, import_retail_sum	miqdor, yetkazib berish narxi bo’yicha summa, sotuv summasi
Mahsulot buyurtmalari	order_amount, order_supply_sum, order_retail_sum	miqdor, yetkazib berish narxi bo’yicha summa, sotuv summasi
Buyurtmani qaytarish	supplier_order_return_amount, supplier_order_return_supply_sum, supplier_order_return_retail_sum	miqdor, yetkazib berish narxi bo’yicha summa, sotuv summasi
Kiruvchi ko’chirish	inc_transfer_amount, inc_transfer_supply_sum, inc_transfer_retail_sum	miqdor, yetkazib berish narxi bo’yicha summa, sotuv summasi
Mahsulotlarni qaytarish	returned_amount, returned_supply_sum, returned_retail_sum, returned_sales_sum	miqdor, yetkazib berish narxi bo’yicha summa, sotuv summasi, chegirmali narx bo’yicha summa
Mahsulotlar sotuvi	sold_amount, sold_supply_sum, sold_retail_sum, sold_sales_sum, rounding_amount	miqdor, yetkazib berish narxi bo’yicha summa, sotuv summasi, chegirmali narx bo’yicha summa, yaxlitlash summasi
Mahsulotlarni hisobdan chiqarish	write_off_amount, write_off_supply_sum, write_off_retail_sum	miqdor, yetkazib berish narxi bo’yicha summa, sotuv summasi
Chiquvchi ko’chirish	out_transfer_amount, out_transfer_supply_sum, out_transfer_retail_sum	miqdor, yetkazib berish narxi bo’yicha summa, sotuv summasi
Qayta baholash	repricing_amount, repricing_supply_sum, repricing_retail_sum	miqdor, yetkazib berish narxi bo’yicha summa, sotuv summasi
Davr oxiridagi qoldiq	stock_amount_end, stock_supply_sum_end, stock_retail_sum_end	miqdor, yetkazib berish narxi bo’yicha summa, sotuv summasi
Sotuv tezligi	qty_sellout, sum_sellout	miqdori bo’yicha, sotuv summasi bo’yicha
Qoldiqning kunlardagi aylanuvchanligi	day_difference, sellout_in_number, sellout_by_days	kunlar soni, sotuv tezligi, aylanuvchanlik

Importlar

POST /v1/import-report-excel · fayl <start_date> - <end_date> uchun importlar bo'yicha hisobot_<id>

Importlar va yetkazib beruvchilarga qilingan buyurtmalar bo’yicha nimalar olib kelingan va keyinchalik ular bilan nima sodir bo’lgan: sotuvlar, hisobdan chiqarishlar, ko’chirishlar, qoldiq. fields da atributlar va maxsus maydonlarning UUID lari qabul qilinadi.

{
  "shop_ids": ["2339a738-a67f-48d2-bb60-8cf4ec54d6cd"],
  "start_date": "2026-08-01",
  "end_date": "2026-08-31",
  "import_type": "supplier_order",
  "fields": ["date", "shop_name", "imported_qty", "sold_qty"]
}

Ustunlar:

fields qiymati	Fayldagi ustun
date	Import sanasi
external_import_id	Import ID
external_supplier_order_id	Buyurtma IDsi
supplier_name	Yetkazib beruvchi
import_type	Import turi
shop_name	Do’kon
product_name	Nomi
product_brand_name	Brend
product_barcode	Shtrix-kod
product_sku	Artikul
is_archived	Arxivlangan
categories_path	Kategoriya
level_1 … level_5	Kategoriya va 1–4-kichik kategoriyalar
imported_qty	Import qilinganlar soni
imported_retail_sum	Sotuv narxi bo’yicha import summasi
imported_supply_sum	Yetkazib berish narxi bo’yicha import summasi
sold_qty	Sotuvlar, miqdori
sold_retail_sum	Sotuv narxi bo’yicha sotuvlar summasi
sold_supply_sum	Yetkazib berish narxi bo’yicha sotuvlar summasi
sold_sale_sum	Chegirmali narx bo’yicha sotuvlar summasi
written_off_qty	Hisobdan chiqarishlar, miqdori
written_off_retail_sum	Sotuv narxi bo’yicha hisobdan chiqarishlar summasi
written_off_supply_sum	Yetkazib berish narxi bo’yicha hisobdan chiqarishlar summasi
transfer_finished_qty	Yuborilgan ko’chirishlar, miqdori
transfer_finished_retail_sum	Sotuv narxi bo’yicha yuborilgan ko’chirishlar summasi
transfer_finished_supply_sum	Yetkazib berish narxi bo’yicha yuborilgan ko’chirishlar summasi
transfer_arrived_qty	Qabul qilingan ko’chirishlar, miqdori
transfer_arrived_retail_price	Sotuv narxi bo’yicha qabul qilingan ko’chirishlar summasi
transfer_arrived_supply_sum	Yetkazib berish narxi bo’yicha qabul qilingan ko’chirishlar summasi
repricing_qty	Qayta baholash, miqdori
repricing_retail_sum	Sotuv narxi bo’yicha qayta baholashlar summasi
repricing_supply_sum	Yetkazib berish narxi bo’yicha qayta baholashlar summasi
returned	Qaytarishlar, miqdori
returned_retail_sum	Sotuv narxi bo’yicha qaytarishlar summasi
returned_supply_sum	Yetkazib berish narxi bo’yicha qaytarmalar summasi
left_qty	Qoldiq, miqdori
left_retail_sum	Sotuv narxi bo’yicha qoldiqlar summasi
left_supply_sum	Yetkazib berish narxi bo’yicha qoldiqlar summasi
return_supplier_order_qty	Buyurtma qaytarmalari, miqdori
return_supplier_order_retail_sum	Sotuv narxi bo’yicha buyurtma qaytarmalari summasi
return_supplier_order_supply_sum	Yetkazib berish narxi bo’yicha buyurtma qaytarmalari summasi

Yetkazib beruvchilar bo’yicha sotuvlar

POST /v1/sells-supplier-report-excel · fayl <start_date> - <end_date> uchun yetkazib beruvchilar bo'yicha sotuvlar hisoboti_<id>

Yetkazib beruvchilar kesimida mahsulotlar sotuvi. fields da atributlar va maxsus maydonlarning UUID lari qabul qilinadi.

{
  "shop_ids": ["2339a738-a67f-48d2-bb60-8cf4ec54d6cd"],
  "supplier_ids": ["8c1a25e0-4f7b-4c6a-9d2e-1b0f5a3c7d94"],
  "start_date": "2026-08-01",
  "end_date": "2026-08-31",
  "currency": "UZS",
  "price_type": 1,
  "all_suppliers": 0,
  "detalization": "day",
  "fields": ["date", "supplier_name", "gross_sales", "net_profit"]
}

Ustunlar:

fields qiymati	Fayldagi ustun
date	Sana
supplier_name	Yetkazib beruvchi
product_name	Nomi
product_sku	Artikul
product_barcode	Shtrix-kod
product_brand_name	Brend
shop_name	Do’kon nomi
categories_path	Kategoriya
level_1 … level_5	Kategoriya va 1–4-kichik kategoriyalar
free_price	Erkin narx
used_wholesale_price	Ulgurji narx
product_measurement_unit_short_name	O’lchov birligi
product_suppliers	Yetkazib beruvchilar
sold_measurement_value	Sotilganlar soni
returned_measurement_value	Qaytarilganlar soni
net_sold_measurement_value	Qaytarilganlar chegirilgan holda sotilgan
gross_sales	Chegirmani hisobga olmagan holdagi sotuvlar
returned_sales_sum	Qaytarmalar summasi
net_sales	Qaytarilganlarni hisobga olgan holdagi chegirmali sotuvlar
net_profit	Yalpi foyda
sold_supply_sum	Xarid narxi bo’yicha sotuvlar
average_margin	O’rtacha ustama
discount	Chegirma
sold_with_discount	Chegirma bilan sotilgan
sold_without_discount	Chegirmasiz sotilgan

Buyurtma qaytarishlari

POST /v1/supplier-order-returned-export · fayl <start_date> - <end_date> uchun qaytarilgan buyurtmalar hisoboti_<id>

Buyurtmalar bo’yicha yetkazib beruvchilarga mahsulotlarni qaytarish. fields da atributlar va maxsus maydonlarning UUID lari qabul qilinadi.

{
  "shop_ids": ["2339a738-a67f-48d2-bb60-8cf4ec54d6cd"],
  "start_date": "2026-08-01",
  "end_date": "2026-08-31",
  "display_currency": "UZS",
  "fields": ["created_at", "product_name", "total_return_price"]
}

Ustunlar:

fields qiymati	Fayldagi ustun
return_operation_id	Qaytarish operatsiyasi ID si
order_operation_id	Buyurtma operatsiyasi ID si
shop_name	Do’kon
created_at	Sana va vaqt
created_by_name	Foydalanuvchi
product_name	Nomi
product_sku	Artikul
product_barcode	Shtrix-kod
product_brand	Brend
categories_path	Kategoriya
level_1 … level_5	Kategoriya va 1–4-kichik kategoriyalar
measurement_value	Miqdori
supply_price	Yetkazib berish narxi
retail_price	Sotuv narxi
supplier_order_name	Buyurtma
total_return_price	Qaytarish summasi
supplier_name	Yetkazib beruvchi

Inventarizatsiya natijalari

POST /v1/stocktaking-summary-table-excel-export · fayl Inventarizatsiya yakunlari hisoboti - <id>

Bitta inventarizatsiya yakunlari: uning natijalariga ko’ra nimalar ko’rsatilganligi, tekshirilganligi, hisobdan chiqarilganligi va qo’shimcha import qilinganligi. Hisobotning davri yo’q — bu surat. stocktaking_guid GET /v2/stocktaking dan olinadi. fields da atributlar va maxsus maydonlarning UUID lari qabul qilinadi.

{
  "stocktaking_guid": "eeeeaf2b-1360-4f03-aa74-87ad7cc2edd7",
  "currency": "UZS",
  "fields": ["product_name", "expected_measurement_value", "scanned_measurement_value"]
}

Ustunlar:

fields qiymati	Fayldagi ustun
stocktaking_external_id	ID
stocktaking_name	Inventarizatsiya nomi
shop_name	Do’kon
product_name	Nomi
product_sku	Artikul
product_barcode	Shtrix-kod
product_brand	Brend
product_is_archived	Arxivlangan
product_measurement_unit	O’lchov birligi
product_categories	Kategoriyalar
level_1	Kategoriya
level_2 … level_5	1–4-darajalar
expected_measurement_value	Ko’rsatilgan
scanned_measurement_value	Tekshirilgan
sold_measurement_value	Inventarizatsiya vaqtida sotilgan
postponed_measurement_value	Inventarizatsiya vaqtida olib qo’yilgan
written_off_measurement_value	Inventarizatsiya vaqtida hisobdan chiqarilgan
in_transfer_measurement_value	Inventarizatsiya vaqtida ko’chirish jarayonida
transferred_measurement_value	Inventarizatsiya vaqtida ko’chirilgan
imported_after_stocktaking_finish	Inventarizatsiya natijalari bo’yicha avtomatik import
imported_supply_price_sum	Yetkazib berish narxi bo’yicha ortiqchalar summasi
imported_retail_price_sum	Sotuv narxi bo’yicha ortiqchalar summasi
written_off_after_stocktaking	Inventarizatsiya natijalari bo’yicha avtomatik hisobdan chiqarish
written_off_supply_price_sum	Yetkazib berish narxi bo’yicha kamomadlar summasi
written_off_retail_price_sum	Sotuv narxi bo’yicha kamomadlar summasi

Mahsulotlar bo’yicha qoldiqlar

POST /v1/stock-report-excel · fayl <report_date> uchun qoldiqlar hisoboti_<id>

Tanlangan sana holatiga do’konlar bo’yicha mahsulotlar qoldig’i. fields da atributlar va maxsus maydonlarning UUID qabul qilinadi.

{
  "shop_ids": ["6f244db4-75d6-4fac-9841-14867d45e36a"],
  "report_date": "2026-08-31",
  "currency": "UZS",
  "fields": ["product_name", "measurement_value", "supply_price", "retail_price"]
}

Ustunlar:

fields qiymati	Fayldagi ustun
shop_name	Do’kon
product_name	Mahsulot nomi
supply_price	Yetkazib berish narxi
retail_price	Sotuv narxi
measurement_value	Miqdori
product_sku	Artikul
product_barcode	Shtrix-kod
product_measurement_unit_short_name	O’lchov birligi
product_brand_name	Brend
categories_path	Kategoriya
level_1	Kategoriya
level_2 … level_5	1–4-kichik kategoriyalar
supplier_name	Yetkazib beruvchi
estimated_margin	Marja, %
estimated_income	Qoldiqlar foydasi summasi
product_is_archived	Arxivlangan

Hisobdan chiqarishlar

POST /v1/write-off-report-table-export · fayl <start_date> - <end_date> uchun hisobdan chiqarishlar bo'yicha hisobot_<id>

Davr ichida hisobdan chiqarilgan mahsulotlar, ularning sabablari va summalari bilan. fields da atributlar va maxsus maydonlarning UUID qabul qilinadi.

{
  "shop_ids": ["2339a738-a67f-48d2-bb60-8cf4ec54d6cd"],
  "start_date": "2026-08-01",
  "end_date": "2026-08-31",
  "currency": "UZS",
  "fields": ["product_name", "written_off_measurement_value", "product_supply_price", "product_retail_price"]
}

Ustunlar:

fields qiymati	Fayldagi ustun
write_off_external_id	Hisobdan chiqarish IDsi
write_off_name	Hisobdan chiqarish nomi
write_off_reason	Hisobdan chiqarish sababi
shop_name	Do’kon nomi
created_by_name	Foydalanuvchi nomi
created_at	Yaratish vaqti
product_name	Mahsulot nomi
product_sku	Artikul
product_barcode	Shtrix-kod
categories	Kategoriyalar
level_1	Kategoriya
level_2 … level_5	1–4-darajalar
product_brand	Brend
supplier	Yetkazib beruvchi
product_is_archived	Arxivlangan
product_supply_price	Yetkazib berish narxi
product_retail_price	Sotuv narxi
written_off_measurement_value	Hisobdan chiqarilgan mahsulotlar soni
written_off_supply_price_sum	Yetkazib berish narxi bo’yicha summa
written_off_retail_price_sum	Sotuv narxi bo’yicha summa

Ko’chirishlar

POST /v1/transfer-report-excel-export · fayl <start_date> - <end_date> uchun transferlar bo'yicha hisobot_<id>

Do’konlar o’rtasida mahsulotlarni ko’chirish. fields da atributlar va maxsus maydonlarning UUID lari qabul qilinadi.

{
  "shop_ids": ["2339a738-a67f-48d2-bb60-8cf4ec54d6cd"],
  "start_date": "2026-08-01",
  "end_date": "2026-08-31",
  "display_currency": "UZS",
  "group_by": "product_name",
  "date_group": "day",
  "fields": ["product_name", "from_shop", "to_shop", "sent_quantity", "arrived_quantity", "sum_supply_price"]
}

Ustunlar:

fields qiymati	Fayldagi ustun
created_at	Yuborildi
accepted_at	Qabul qilindi
name	Ko’chirish
external_id	ID
from_shop	Qayerdan
to_shop	Qayerga
product_name	Nomi
product_sku	Artikul
product_barcode	Shtrix-kod
product_brand	Brend
categories_path	Kategoriya
product_attribute	Variatsiya
product_custom_field	Maxsus maydon
supplier	Yetkazib beruvchi
sent_quantity	Yuborilganlar soni
arrived_quantity	Qabul qilinganlar soni
sum_supply_price	Yetkazib berish narxi bo’yicha summa
sum_retail_price	Sotuv narxi bo’yicha summa
measurement_name	O’lchov birligi

Ruxsatlar

Barcha o’n oltita metod integratsiya kaliti marshrutlari ro’yxatiga kiradi. Natijalarni tokenga ruxsat etilgan do’konlar ro’yxati cheklaydi: uzatilgan shop_ids ruxsat etilganlari bilan kesishadi.