# Sotuvlar va tushumni eksport qilish

> Ma'lum davr uchun cheklarni qanday olish va sana uchun do'konlar bo'yicha yig'ma tushumni qanday olish mumkin.

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

```bash
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](/uz/reference/report-export/) 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.