# Integratsiyaning namunaviy ssenariylari

> BILLZ bilan to'rtta namunaviy integratsiya va har biri uchun hujjatlar bo'yicha qisqa yo'riqnoma.

Har bir ssenariy uchun alohida hujjatlar yo’riqnomasi ko’zda tutilgan to’rtta namunaviy ssenariy.

To’rttalasiga ham umumiy baza kerak: [integratsiya kaliti](/uz/start/integration-key/) → [birinchi so’rov](/uz/start/first-request/).

## 1. Vitrina: sayt yoki marketpleys BILLZ mahsulotlarini ko’rsatadi

Katalog, qoldiqlar va narxlar BILLZ’dan tashqariga uzatiladi. Bunda sotuvlar istalgan joyda amalga oshirilishi mumkin.

1. [Katalog sinxronizatsiyasi](/uz/guides/sync-catalog/) — birlamchi yuklash va inkrement
2. [Qoldiqlar va narxlar](/uz/guides/sync-stocks/) — katalogni tez-tez yangilash uchun nimalar kerakligi
3. [Ikki xil sinxronlash rejimi](/uz/guides/sync-catalog/#vitrina-sinxronizatsiyasining-ikkita-rejimi) — har soatda delta, kuniga bir marta to’liq

Asosiy metod — `GET /v2/products`

## 2. Sotuvlar: tashqi tizim BILLZ’da sotuvni amalga oshiradi

Onlayn-do’kon, shaxsiy kassa, kuryer ilovasi — tashqaridagi biror vosita xaridni rasmiylashtiradi va bu xarid BILLZ’da aks etishi kerak.

1. [Birinchi sotuv](/uz/start/first-sale/) — to’rtta metodga asoslangan eng qisqa yo’l
2. [Tashqi tizimdan onlayn-buyurtma](/uz/guides/ecommerce-order/) — to’liq ssenariy: mijoz, chegirma, to’lov, fiskal chek
3. [Tashqi tizimdan sotuv](/uz/guides/create-sale/) — sertifikatlar, kechiktirilgan sotuvlar, bir necha usulda to’lov

Asosiy farq shundaki, [BILLZ’dagi «buyurtma» **yetkazib beruvchiga** berilgan buyurtmani](/uz/guides/ecommerce-order/#atamalardagi-farqlar) anglatadi, mijozning xaridi esa sotuv deb ataladi.

## 3. Ombor: hisob tizimidan mahsulot harakati

Yetkazib berish, do’konlar o’rtasida ko’chirish, hisobdan chiqarish, inventarizatsiya.

1. [Ombor jarayonlari](/uz/concepts/processes/) — «yig’ish → to’ldirish → o’tkazish» umumiy sxemasi
2. [Mahsulotni hisobdan chiqarish](/uz/guides/write-off/) — jarayonning oxirigacha tahlil qilingan namunasi

Asosiy qoida: **hujjat yaratish qoldiqni o’zgartirmaydi**, uni o’tkazma o’zgartiradi. Va o’tkazma ruxsati yaratish ruxsatidan alohida beriladi.

## 4. Analitika: ma’lumotlarni BI yoki 1C’ga yuklash

Tushum, cheklar, tranzaksiyalar, mahsulot harakati — tashqariga, o’qish uchun.

1. [Sotuvlar va tushumni yuklab olish](/uz/guides/sales-export/) — yig’ma hisobotlar va cheklar taqqoslamasi
2. [Kalit marshrutlari](/uz/reference/permissions/) — kalit uchun qaysi hisobotlar ochiq

## Muammolar diagnostikasi

[Muammolarni hal qilish](/uz/troubleshooting/) bo’limi simptomlar asosida tuzilgan: `403`, `404`, `200` samarasiz, `408`, `429`.

## Ommaviy API’da nimalar yo’q

Bu imkoniyatlar mavjud emas, ularni aylanib o’tish metodlari ko’zda tutilmagan.

| Nimalar yo’q                                                                  | Nima qilish kerak?                                                                                                       |
| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Sotuv bo’yicha tayyor yuk xati yoki bosma shakl                               | `GET /v2/order/:id` dan yig’ish — [batafsil](/uz/guides/ecommerce-order/#yuk-xati-qanday-korinishda-beriladi)            |
| STIR / INN bo’yicha xaridorni qidirish                                        | bog’lanishni o’zida saqlash — [batafsil](/uz/guides/ecommerce-order/#qidiruv)                                            |
| Idempotentlik sarlavhasi                                                      | o’z tarafida dubllardan himoyalanish — [batafsil](/uz/guides/ecommerce-order/#ozida-qaysi-identifikatorni-saqlash-kerak) |
| Webhooks — Biznes hodisalariga obunalar (sotuv amalga oshdi, qoldiq o’zgardi) | jadval bo’yicha so’rov yuborish — [katalogni sinxronlashtirish](/uz/guides/sync-catalog/)                                |
| BILLZ CDN orqali mahsulot suratlarini bevosita tarqatish                      | Mediani o’zingizda keshlash [qoidalar bilan taqiqlangan](/uz/guides/sync-catalog/#nima-qilmaslik-kerak)                  |

> **Hozircha hodisalar yoki javoblar uchun vebxuklar nazarda tutilmagan**