REGOS ishlab chiquvchilari uzoq vaqt davomida dasturiy ta’minotni o‘z kuchingiz bilan yoki uchinchi tomon dasturchilari yordamida kengaytirish imkonini beradigan platforma ustida ishlamoqda — bu Integratsiyalar katalogi va Lokal integratsiyalar. Tajriba shuni ko‘rsatdiki, bu tushunchalar global standart bo‘lsa ham va IT sohasida yangilik bo‘lmasa-da, ko‘pchilik baribir tez-tez so‘raydi:
“REGOS bilan integratsiyani qanday qilish mumkin?”
Bu savol oddiy foydalanuvchilardan tortib boshqa IT mahsulot vakillarigacha tegishli. Shu sababli biz bu masalani bir marta va butunlay tushuntirishga qaror qildik.
Ushbu maqolada:
Hamkorlik
DASTYOR TECHNOLOGIES jamoasi REGOS SOFTWARE bilan hamkorlikda 7 yildan ortiq vaqt davomida o‘rta va yirik bizneslar uchun tayyor yechimlar yaratib kelmoqda.
REGOS uchun biz bir nechta tayyor integratsiyalar ishlab chiqdik (bepul va pullik), jumladan:
- https://apps.regos.uz/integration/details/console (CONSOLE – Biznesni boshqarish)
- https://apps.regos.uz/integration/details/photo-upload (Foto yuklash vositasi — nomenklatura rasmlarini tez va qulay yuklash)
Bizning missiyamiz:
“Biznes egalari va xodimlarining hayot sifatini yaxshilash — savdo, ombor va moliyaviy operatsiyalarni hisobga olish uchun IT yechimlarni ishlab chiqish, joriy etish va qo‘llab-quvvatlash orqali.”
Shuningdek, biz IT rivojlanishni alohida noyob hunar sifatida qadrlaymiz va ushbu maqola hamkasb dasturchilarni qo‘llab-quvvatlash uchun yozilgan.
Ushbu maqolalar seriyasida biz o‘z tajribamizni ulashmoqchimiz va bu sizga foydali bo‘lishiga umid qilamiz.
E’tibor bering, bu maqola texnik hujjatdan ko‘ra ko‘proq tushuntiruvchi hikoya shaklida yozilgan. Chunki dasturlash — aniq fan bo‘lib, real so‘rov/javoblar, maydonlar tavsifi va boshqalar bilan batafsil tushuntirishni talab qiladi. Bu yerda esa biz oddiy tilda umumiy prinsipni tushuntirmoqchimiz. Texnik hujjatlarni docs.regos.uz saytida batafsil yozib qo‘yganmiz (boshidan oxirigacha o‘qishni tavsiya qilamiz).
Tushunchalar
Keling, asosiy tushunchalardan boshlaymiz:
- REGOS tizimi — 90–95% biznes jarayonlarini avtomatlashtirish imkonini beruvchi tayyor funksiyalar to‘plami (ombor boshqaruvi, kassir ish joyi, boshqaruv paneli va h.k.).
- Uchinchi tomon ilovasi — REGOS imkoniyatlarini kengaytirish uchun yaratilgan tizim.
- Akkount — REGOS foydalanuvchisiga tegishli ma’lumotlar bazasi (bu yerda foydalanuvchi — REGOS xizmatidan foydalanuvchi shaxs, tizim ichidagi user bilan adashtirmang).
- Qo‘shimcha dastur (Qo‘shimcha PO) — akkount ma’lumotlari bilan ishlash interfeyslari (masalan: REGOS:POS).
- API — qo‘shimcha dasturlar va/yoki uchinchi tomon ilovalari bilan akkount o‘rtasida aloqa ta’minlovchi dastur instansi.
- Lokal integratsiya — ma’lum bir akkount uchun yaratiladigan obyekt bo‘lib, connected_integration_id parametri orqali API orqali shu akkount ma’lumotlariga murojaat qiladi.
- Tirajlanadigan integratsiya — Integratsiyalar katalogida e’lon qilinadigan obyekt bo‘lib, key parametriga ega va avtomatik lokal integratsiyalar yaratish uchun xizmat qiladi. Uni har qanday REGOS foydalanuvchisi o‘z akkountiga ulashi mumkin.
- Soddalashtirish uchun keyingi o‘rinlarda “integratsiya” termini har ikkala holat uchun ishlatiladi: qo‘lda yaratilgan lokal integratsiya yoki tirajlanadigan integratsiya orqali ulangan lokal integratsiya
- Uchinchi tomon ilovasi API’ga faqat quyidagi manzil orqali murojaat qilishi mumkin: https://integration.regos.uz/gateway/out/{{connected_integration_id}}/v1/
Qo‘shimcha dasturlar allaqachon REGOS bilan ishlash uchun ichki mexanizmlar bilan jihozlangan va ular ham mohiyatan uchinchi tomon servislaridan farq qilmaydi, faqat ba’zi maxsus integratsiyalar mavjud.
Amaliy misol
Faraz qilaylik, kassir savdo qiladi va biz (egasi sifatida) bu savdo haqida Telegram’da xabar olishni xohlaymiz.
Shuni aytib o‘tish kerakki, bunday vazifa uchun allaqachon BEPUL tayyor integratsiya mavjud:
https://apps.regos.uz/integration/details/regos_telegram_notifier
Manba kodi:
https://github.com/regos-software/py-integrations/tree/main/clients/telegram_bot_notification
Quyida esa soddalashtirilgan o‘zimiz yozadigan variantni ko‘rib chiqamiz.
1. Lokal integratsiya yaratamiz
Va unda DocChequeClosed webhook’ini tanlaymiz (to‘liq ro‘yxat: https://docs.regos.uz/ru/integration/webhooks#kassa-i-cheki)
2. Handler (qabul qiluvchi) manzilini ko‘rsatamiz:
https://myapp.com/regos_webhook_handler/
3. Yaratilgandan so‘ng endpoint olinadi:
https://integration.regos.uz/gateway/out/8aacd123xvaK23KLNAS23azb75/
Bu yerda oxirgi qism — connected_integration_id.
4. Kassada savdo amalga oshiriladi
Savdodan so‘ng API sizning serveringizga quyidagi ma’lumot bilan so‘rov yuboradi:
```
{
"action": "HandleWebhook",
"connected_integration_id": "8aacd123xvaK23KLNAS23azb75",
"data": {
"action": "DocChequeClosed",
"data": {
"uuid": “f81d4fae-7dec-11d0-a765-00a0c91e6bf6”
}
}
}```
5. Sizning ilovangiz quyidagilarni bajaradi:
- Chek bo‘yicha batafsil ma’lumot olish:
https://integration.regos.uz/gateway/out/.../v1/DocCheque/Get - Chek summasi, vaqti, raqami va boshqalarni oladi
- So‘ng Telegram API orqali (BotFather’dan olingan token bilan) xabar yuboradi
