🚗 تكامل كريم (Careem)

📌 نبذة سريعة

---

🎯 ما فائدة تكامل كريم؟

ربط نظام إيصال مع تطبيق كريم (Careem) يتيح لك:

• 📲 استقبال طلبات كريم تلقائياً في نظامك

• 📋 مزامنة القائمة — تعديلاتك تنعكس على كريم فوراً

• 🔄 تحديث حالة الطلب — العميل يتتبع طلبه

• 📊 إدارة الطلبات من لوحة تحكم إيصال

---

👤 لمن هذه الصفحة؟

---

🚀 دليل الإعداد

الخطوة 1: اشتراك كريم

1. سجل في Careem for Business

2. أكمل عملية التسجيل والتحقق
3. احصل على بيانات الحساب:

   🔑 Client ID
   🔐 Client Secret
   🆔 Store ID

الخطوة 2: تفعيل الإضافة في إيصال

1. سجل الدخول إلى بوابة المشترك

2. اذهب إلى الإضافات ← تكامل كريم

3. اضغط تفعيل (15 د.أ / فرع / شهر)

الخطوة 3: إعداد التكامل

1. اذهب إلى الإعدادات ← التكاملات ← كريم

2. أدخل بيانات حساب كريم:

   ┌─────────────────────────────────────────┐
   │  🔗 إعداد تكامل كريم                    │
   ├─────────────────────────────────────────┤
   │ 🔑 Client ID: [أدخل المعرف]            │
   │ 🔐 Client Secret: [أدخل السر]           │
   │ 🆔 Store ID: [أدخل الرقم]              │
   │                                         │
   │ 🌐 البيئة:                             │
   │   ● إنتاج (Production)                 │
   │   ○ اختبار (Staging)                   │
   │                                         │
   │ 🤖 القبول التلقائي: ✅                  │
   │                                         │
   │ [🔌 اختبار الاتصال]  [💾 حفظ]          │
   └─────────────────────────────────────────┘

الخطوة 4: مزامنة القائمة

1. اضغط مزامنة القائمة الآن

2. ⏳ انتظر حتى تنتهي المزامنة
3. ✅ تأكد من تطابق المنتجات والأسعار

الخطوة 5: تفعيل الاستقبال التلقائي

1. فعّل القبول التلقائي للطلبات

2. ✅ من الآن، أي طلب من كريم يصل تلقائياً لنظامك

---

🔄 دورة حياة الطلب

📱 العميل يطلب عبر كريم
         ↓
🏪 كريم تستلم الطلب
         ↓
🔗 إيصال يستقبل الطلب (Webhook)
         ↓
🖥️ يظهر على شاشة المطبخ (KDS)
         ↓
🍳 الشيف يبدأ التحضير → حالة "قيد التحضير"
         ↓
✅ الطلب جاهز → حالة "جاهز"
         ↓
🛵 السائق يستلم → حالة "قيد التوصيل"
         ↓
🏠 تم التوصيل → حالة "مكتمل"

---

❓ الأسئلة الشائعة

كيف أحصل على Client ID من كريم؟

سجل في Careem Partner Portal، اذهب إلى Developer ← My Apps، أنشئ تطبيقاً جديداً لتحصل على المفاتيح.

هل يدعم كريم البيئة الاختبارية (Sandbox)؟

نعم! استخدم:

• Staging: identity.qa.careem-engineering.com/token

• Production: identity.careem.com/token

هل يتطلب تكامل كريم اشتراكاً إضافياً من كريم؟

قد تحتاج إلى اشتراك تجاري مع كريم (Careem Food). تواصل مع فريق كريم للمطاعم.

ما الفرق بين كريم العادية و Careem POS API؟

إصدار Careem POS API v2.1.0 هو التكامل الرسمي والأحدث الذي يستخدمه نظام إيصال. أسرع وأدق من الإصدارات القديمة.

هل يمكن اختبار التكامل قبل التفعيل؟

نعم، استخدم وضع الاختبار (Dry Run) من إعدادات التكامل لاختبار استقبال الطلبات بدون تطبيق فعلي.

---

🔧 استكشاف المشاكل

---

📎 مواضيع ذات صلة

• دليل التكاملات العام

• إضافة التوصيل

• شاشة المطبخ KDS