تكامل نقاط البيع: MekanBook Connector API

ما الذي يمكن فعله؟

• اسحب الطلبات: الطلبات المقبولة من الطاولة (الأصناف والكميات والخيارات والملاحظات والطاولة) GET /api/pos/v1/orders. تُعاد حتى يُؤكَّد استلامها؛ فلا يضيع شيء.
• أرسل حالة المطبخ: قيد التحضير / جاهز / قُدّم / أُلغي POST /lines/{id}/status. يظهر فورًا في تطبيق الضيف.
• زامن القائمة والأسعار: PUT /menu. تُسجَّل تغييرات الأسعار؛ ولا تتغير أسعار الفواتير المفتوحة (لا مفاجآت).
• أبلغ عن المدفوعات المستلمة في الكاشير: نقدًا أو بالبطاقة POST /tables/{masa}/payments. تُحدَّث فاتورة الضيف في التطبيق؛ ولا يُحصَّل المبلغ نفسه مرتين.
• اعرض الفواتير المفتوحة وأغلقها: GET /tables, POST /checks/{id}/close.
• إشعار فوري: webhook موقّع إن فضّلت الدفع بدل السحب.

الأمان

مفتاح API وسر توقيع منفصلان لكل اتصال مطعم (يُنشآن من لوحة المطعم ويُعرضان مرة واحدة). يُوقَّع كل طلب بـ HMAC-SHA256؛ وتُرفض الطلبات الأقدم من 5 دقائق والمكررة. لا يصل المفتاح إلا إلى بيانات مطعمه. في وضع التجربة (sandbox) لا تغيّر عمليات الكتابة الفواتير الحقيقية.

المستندات

• دليل التكامل (بالتركية + ملخص بالإنجليزية) — خوارزمية التوقيع وأمثلة PHP وC# ورموز الأخطاء
• تعريف OpenAPI 3 (openapi.yaml)

للشراكات ومطعم تجريبي:: تواصل.

حالة الاتصال

• Adisyo — ربط مباشر
• SambaPOS — ربط مباشر
• Simpra — يمكن الربط عبر Connector API
• robotPOS — يمكن الربط عبر Connector API
• Menulux — يمكن الربط عبر Connector API
• Paket Taxi — يمكن الربط عبر Connector API
• Dijital Adisyon — يمكن الربط عبر Connector API
• Mikro (Hızlı Satış) — يمكن الربط عبر Connector API
• Logo — يمكن الربط عبر Connector API
• Sepettakip — يمكن الربط عبر Connector API
• Siparişmatik — يمكن الربط عبر Connector API
• Restoran Pro — يمكن الربط عبر Connector API