POS Tizimi bilan Integratsiya Qo'llanmasi

Umumiy Ma'lumot

Ushbu qo'llanma AOS cashback funksiyasini do'konlarning POS tizimlariga qanday ulashni tushuntiradi. U autentifikatsiya, QR kod skanerlash, tranzaksiya yuborish va bonus hisoblash jarayonlarini qamrab oladi.

🔁 Integratsiya Jarayoni

Quyida POS tizimini AOS bilan ulashning bosqichma-bosqich jarayoni keltirilgan:

1. Do'konni ro'yxatdan o'tkazish

Har bir filial AOS tizimiga qo'shiladi va har biriga alohida token beriladi.

2. Tokenlardan foydalanish

Tokenlar barcha API so'rovlarga qo'shiladi va filialni aniqlash uchun ishlatiladi.

3. Mijoz tizimga kirgan bo'lishi kerak

Mijoz AOS mobil ilovasini o'rnatgan va tizimga kirgan bo'lishi kerak.

4. QR kod skanerlash

Kassir mijozning QR kodini POS terminal orqali skaner qiladi.

5. Mijoz ma'lumotlarini olish

QR kodi API orqali yuboriladi va mijoz profili qaytariladi hamda ekranga chiqariladi.

6. Chek ma'lumotlarini kiritish

Kassir mahsulotlar va to'lov ma'lumotlarini kiritadi.

7. Bonus ishlatish (agar kerak bo'lsa)

Alohida oynada mijoz qancha cashback ishlatmoqchi ekanligini belgilaydi.

8. Tranzaksiyani yuborish

Hamma ma'lumotlar to'ldirilgach, API orqali AOS serveriga yuboriladi.

9. Javobni qayta ishlash

Success (muvaffaqiyatli) javobi kelsa, chek yopiladi va qog'oz nusxasi beriladi.

10. Mijoz balansi yangilanadi

Cashback hisoblanadi yoki kamayadi, mobil ilovada bu aks ettiriladi.

🖲️ POS Tizimida Bo'lishi Kerak Bo'lgan Funksiyalar

Muvaffaqiyatli integratsiya uchun POS dasturi quyidagi komponentlarni qo'llab-quvvatlashi kerak:

QR kodni skaner qilish uchun alohida tugma va oynacha bo'lishi kerak.

Mijoz ma'lumotlarini chiqarish

QR skan qilingach, mijoz ismi va cashback balansi ko'rinishi kerak.

Bonus ishlatish interfeysi

Cashback miqdorini kiritish uchun alohida oynacha va tugma kerak.

Chekda chegirma aks ettirish

Agar cashback ishlatilsa, uning miqdori chegirma sifatida chekka yozilishi kerak.

📡 API Endpointlar

1. Mijoz Profilini Olish

http GET https://dev-api.aos-shop.uz/store/customers/profile

Query parametrlari:

Parametr	Ta'rif
`filial`	Filialning tokeni (majburiy)
`client`	36 belgidan iborat QR code qiymati

Bu endpoint skan qilingan QR kod asosida mijoz ma'lumotlarini oladi va berilgan filial tokeni bilan tekshiradi.

2. Tranzaksiya Yuborish

http POST https://dev-api.aos-shop.uz/transactions

Body tuzilishi:

{
 "rTime": "string",
 "rDate": "string",
 "filial": "string",
 "client": "string",
 "cEmployee": "string",
 "rNumber": "string",
 "rTotal": 0,
 "bonus": 0,
 "items": [
   {
     "discount": 0,
     "price": 0,
     "barcode": "string",
     "amount": 0,
     "vatPercent": 0,
     "vat": 0,
     "name": "string",
     "classCode": "string",
     "other": 0,
     "commissionTIN": "string"
   }
 ],
 "payments": [
   {
     "item": "Наличные",
     "total": 150000.2
   }
 ],
 "cardType": "static",
 "percent": 0
}

Eslatmalar:

bonus: Mijoz tomonidan ishlatiladigan cashback miqdori (agar mavjud bo'lsa).
rTotal: Cashback qo'llanishidan oldingi umumiy chek miqdori.
payments: Naqd, karta yoki boshqa to'lov usullarini o'z ichiga olishi mumkin.

✅ Yakuniy Eslatmalar

QQS (VAT) va komissiya maydonlari soliq talablariga mos ravishda aniq bo'lishi kerak.
API javobi POS tomonida validatsiya bilan to'g'ri qayta ishlanishi shart.
Mijozga yo'naltirilgan fikr-mulohaza (masalan, olingan bonus) shaffoflik uchun real vaqtda ko'rsatilishi kerak.

Texnik yordam yoki savollar uchun AOS ishlab chiqish jamoasi bilan bog'laning.

POS Tizimi bilan Integratsiya Qo'llanmasi

Mundarija