REGOS × laCafe

Saytda, mehmon ilovasida, Telegram botda va operator orqali qabul qilingan yetkazib berish va olib ketish buyurtmalari REGOS'ga chakana buyurtma (Заказ клиента, DocOrderDelivery) bo'lib tushadi. Holat laCafe'ga qaytadi, menyu va narxlar REGOS'dan olinadi.

1. REGOS'da lokal integratsiya

  1. REGOS.Online → Интеграции → Локальная интеграция → yangi integratsiya yarating (nomi, masalan, «laCafe»).
  2. Tizim endpoint beradi: https://integration.regos.uz/gateway/out/<kalit>/v1. Uni nusxa oling.
  3. Integratsiya foydalanuvchisiga kerakli omborlar (Склады) ga ruxsat bering — buyurtmalar shu omborlarga tushadi.
  4. Источник заказа (DeliveryFrom) ma'lumotnomasida «laCafe» manbasini yarating.
  5. Yetkazish narxi uchun xizmat turidagi tovar (masalan, «Доставка») bo'lsin — REGOS buyurtmasida yetkazish narxi uchun alohida maydon yo'q.

2. laCafe'da

  1. laCafe paneli → Ilovalar → REGOS → o'rnating.
  2. «Ulanish»ga endpoint'ni (yoki faqat kalitni) kiriting va «Tekshirish»ni bosing. Kalit laCafe platformasiga uzatilmaydi — ilovaning o'z bazasida shifrlangan holda saqlanadi.
  3. «REGOS sozlamalari»: buyurtma manbai, narx turi, yetkazib berish va olib ketish turi, yangi mijozlar guruhi, yetkazish xizmati va menyuga kiradigan guruhlarni tekshiring.
  4. «To'lov turlari»: har laCafe to'lov usuli qaysi REGOS to'lov turi bilan yozilishini tanlang.
  5. «Filiallar»: har laCafe filialini REGOS omboriga biriktiring va «Menyuni yangilash»ni bosing.

3. Webhook (ixtiyoriy, tavsiya etiladi)

Webhook bo'lmasa, holat har 30 soniyada so'raladi. Webhook bilan — darhol. Ilova sahifasida «Webhook» → «Manzil yaratish», so'ng manzilni lokal integratsiyaning Endpoint maydoniga qo'ying va hodisalarga obuna bo'ling:

MaqsadHodisalar
Buyurtma holatiDocOrderDeliveryStatusSet, DocOrderDeliveryEdited, DocOrderDeliveryDeleted, DocOrderDeliveryDeleteMarked, DocOrderDeliveryPerformed
Menyu va narxItemAdded, ItemEdited, ItemDeleteMarked, ItemGroupAdded, ItemGroupEdited, ItemGroupDeleted, DocSetPricePerformed
Stop-list (qoldiq)DocChequeClosed, DocPurchasePerformed, DocMovementPerformed, DocInOutPerformed, DocInventoryClosed

REGOS webhook'ni imzolamaydi: manzildagi kalit tasodifiy va maxfiy, tanadagi connected_integration_id tekshiriladi, holat esa har safar REGOS API'dan qayta o'qiladi. Takrorlar event_id bo'yicha tashlanadi.

4. Buyurtma qanday yoziladi

laCafeREGOS (DocOrderDelivery/AddFull)
laCafe buyurtma id'siexternal_code — takroriy yuborishda ikkinchi hujjat ochilmaydi
filialstock_id — biriktirilgan ombor
taom, soni, narxioperations[] (item_id, quantity, price)
modifikator (REGOS tovari)alohida qator; bog'lanmagani — izohda
chegirma / promo-kodqatorlar narxiga mutanosib taqsimlanadi (jami laCafe summasiga teng), izohda ko'rsatiladi
yetkazish narxitanlangan xizmat qatori
mijoztelefon bo'yicha RetailCustomer (bo'lmasa tanlangan guruhga yaratiladi)
to'lov usulipayment_type_id; to'langanmi va keshbek — izohda
manzil, xarita nuqtasi, vaqtaddress, location, delivery_date

Holatlar: Новый → yangi, Подтверждён → qabul qilindi, В обработке → tayyorlanmoqda, Оплата → tayyor, Завершён → yopildi, Отменён → bekor. laCafe'da bekor qilingan buyurtma REGOS'da ham bekor qilinadi.

Digital Restaurant LLC · lacafe.uz · REGOS API: docs.regos.uz