# Hisobotlarni Excel'ga eksport qilish

> Bir so'rov bilan tayyor hisobot faylini qanday olish mumkin va har bir hisobotda qanday ustunlar mavjud.

«Hisobotlarni eksport qilish» bo’limi metodlari tayyor faylga `.xlsx` havola beradi — bu BILLZ hisobotlar sahifalaridagi kabi hisobot va sahifalab o’qiladigan [hisobotlardagi](/uz/reference/api/) 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:

```plaintext
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.

```bash
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:

```json
{ "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

```json
{
  "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](/uz/reference/errors/). 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](/uz/reference/errors/) 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:

```json
{
  "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`](/uz/reference/api/operations/post_v1_general_report_excel/)                                     |
| Tranzaksiyalar | Tranzaksiyalar                         | [`POST /v1/transaction-report-excel`](/uz/reference/api/operations/post_v1_transaction_report_excel/)                             |
| Sotuvchilar    | Sotuvchilar bo’yicha xulosa            | [`POST /v1/seller-general-report-excel`](/uz/reference/api/operations/post_v1_seller_general_report_excel/)                       |
| Mijozlar       | Mijozlar bo’yicha xulosa               | [`POST /v1/customer-general-report-excel`](/uz/reference/api/operations/post_v1_customer_general_report_excel/)                   |
| Mijozlar       | Mijozlar xaridlari                     | [`POST /v1/customer-purchases-report-excel`](/uz/reference/api/operations/post_v1_customer_purchases_report_excel/)               |
| Moliya         | Foyda va zararlar                      | [`POST /v1/report-profit-and-lose-excel`](/uz/reference/api/operations/post_v1_report_profit_and_lose_excel/)                     |
| Moliya         | Moliyaviy tranzaksiyalar (PMH)         | [`POST /v1/cashflow-excel`](/uz/reference/api/operations/post_v1_cashflow_excel/)                                                 |
| Mahsulotlar    | Tovarlar bo’yicha sotuvlar             | [`POST /v1/product-general-report-excel`](/uz/reference/api/operations/post_v1_product_general_report_excel/)                     |
| Mahsulotlar    | Tovarlar samaradorligi                 | [`POST /v1/report-product-performance-excel`](/uz/reference/api/operations/post_v1_report_product_performance_excel/)             |
| Mahsulotlar    | Importlar                              | [`POST /v1/import-report-excel`](/uz/reference/api/operations/post_v1_import_report_excel/)                                       |
| Mahsulotlar    | Yetkazib beruvchilar bo’yicha sotuvlar | [`POST /v1/sells-supplier-report-excel`](/uz/reference/api/operations/post_v1_sells_supplier_report_excel/)                       |
| Mahsulotlar    | Buyurtma qaytarishlari                 | [`POST /v1/supplier-order-returned-export`](/uz/reference/api/operations/post_v1_supplier_order_returned_export/)                 |
| Mahsulotlar    | Inventarizatsiya natijalari            | [`POST /v1/stocktaking-summary-table-excel-export`](/uz/reference/api/operations/post_v1_stocktaking_summary_table_excel_export/) |
| Mahsulotlar    | Mahsulotlar bo’yicha qoldiqlar         | [`POST /v1/stock-report-excel`](/uz/reference/api/operations/post_v1_stock_report_excel/)                                         |
| Mahsulotlar    | Hisobdan chiqarishlar                  | [`POST /v1/write-off-report-table-export`](/uz/reference/api/operations/post_v1_write_off_report_table_export/)                   |
| Mahsulotlar    | Ko’chirishlar                          | [`POST /v1/transfer-report-excel-export`](/uz/reference/api/operations/post_v1_transfer_report_excel_export/)                     |

## Do’kon

### Do’kon bo’yicha yig’ma hisobot

[`POST /v1/general-report-excel`](/uz/reference/api/operations/post_v1_general_report_excel/) · fayl `<start_date> - <end_date> uchun jamlanma hisobot_<id>`

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

```json
{
  "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`](/uz/reference/api/operations/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.

```json
{
  "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`](/uz/reference/api/operations/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.

```json
{
  "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`](/uz/reference/api/operations/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.

```json
{
  "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`](/uz/reference/api/operations/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.

```json
{
  "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`](/uz/reference/api/operations/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.

```json
{
  "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`](/uz/reference/api/operations/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                                                                                                    |

```json
{
  "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`](/uz/reference/api/operations/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.

```json
{
  "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`](/uz/reference/api/operations/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. `fields`da atributlar va maxsus maydonlarning UUIDlari qabul qilinadi.

```json
{
  "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`](/uz/reference/api/operations/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.

```json
{
  "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`](/uz/reference/api/operations/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.

```json
{
  "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`](/uz/reference/api/operations/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.

```json
{
  "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`](/uz/reference/api/operations/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`](/uz/reference/api/operations/get_v2_stocktaking/) dan olinadi. `fields` da atributlar va maxsus maydonlarning UUID lari qabul qilinadi.

```json
{
  "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`](/uz/reference/api/operations/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.

```json
{
  "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`](/uz/reference/api/operations/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.

```json
{
  "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`](/uz/reference/api/operations/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.

```json
{
  "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](/uz/reference/permissions/) kiradi. Natijalarni tokenga ruxsat etilgan do’konlar ro’yxati cheklaydi: uzatilgan `shop_ids` ruxsat etilganlari bilan kesishadi.