Integratsiyaning namunaviy ssenariylari

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

To’rttalasiga ham umumiy baza kerak: integratsiya kaliti → birinchi so’rov.

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 — birlamchi yuklash va inkrement
2. Qoldiqlar va narxlar — katalogni tez-tez yangilash uchun nimalar kerakligi
3. Ikki xil sinxronlash 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 — to’rtta metodga asoslangan eng qisqa yo’l
2. Tashqi tizimdan onlayn-buyurtma — to’liq ssenariy: mijoz, chegirma, to’lov, fiskal chek
3. Tashqi tizimdan sotuv — sertifikatlar, kechiktirilgan sotuvlar, bir necha usulda to’lov

Asosiy farq shundaki, BILLZ’dagi «buyurtma» yetkazib beruvchiga berilgan buyurtmani 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 — «yig’ish → to’ldirish → o’tkazish» umumiy sxemasi
2. Mahsulotni hisobdan chiqarish — 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 — yig’ma hisobotlar va cheklar taqqoslamasi
2. Kalit marshrutlari — kalit uchun qaysi hisobotlar ochiq

Muammolar diagnostikasi

Muammolarni hal qilish 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
STIR / INN bo’yicha xaridorni qidirish	bog’lanishni o’zida saqlash — batafsil
Idempotentlik sarlavhasi	o’z tarafida dubllardan himoyalanish — batafsil
Webhooks — Biznes hodisalariga obunalar (sotuv amalga oshdi, qoldiq o’zgardi)	jadval bo’yicha so’rov yuborish — katalogni sinxronlashtirish
BILLZ CDN orqali mahsulot suratlarini bevosita tarqatish	Mediani o’zingizda keshlash qoidalar bilan taqiqlangan

Hozircha hodisalar yoki javoblar uchun vebxuklar nazarda tutilmagan