يشرح هذا الدليل كيفية تكامل جاهز مطاعم مع سرداب، ويغطي إعداد المتجر، وإدارة الفئات والمنتجات، ومسار الطلبات، ومسؤوليات كل نظام.
ملاحظة: تكامل جاهز مطاعم منفصل عن تكامل جاهز (المتاجر). إذا كنت تبحث عن دليل جاهز للمتاجر، راجع دليل الربط مع جاهز.
١. إعداد المتجر والربط
يتم ربط متاجر جاهز مطاعم من قبل فريق سرداب. لربط متجرك، يرجى التواصل مع فريق الدعم.
بعد الربط، يُربط متجرك في جاهز بحسابك في سرداب وتبدأ الطلبات بالتدفق تلقائيًا. لا توجد عملية اعتماد من جانبك.
٢. الفروع
يقوم فريق سرداب بربط فروعك في جاهز بالفروع المقابلة لها في سرداب (الدارك ستور).
يمكنك الاطلاع على قائمة الفروع المربوطة في منصة سرداب، بما في ذلك اسم الفرع والمدينة والحي ورابط الموقع. تتم إدارة ربط الفروع من قبل سرداب وهي للعرض فقط.
٣. فئات القائمة
تُنظم المنتجات في متجرك على جاهز مطاعم ضمن فئات تقوم بإنشائها وإدارتها في سرداب.
إنشاء فئة
الاسم (بالعربية والإنجليزية): كلاهما إلزامي.
ترتيب العرض: رقم صحيح يبدأ من 1 (الافتراضي 1). تظهر الفئات على جاهز بهذا الترتيب.
الفروع المستثناة (اختياري): الفروع التي لا ترغب في ظهور الفئة فيها.
فئات البقالة في جاهز (اختياري)
لمتاجر البقالة فقط: ينطبق هذا الخيار فقط على المتاجر المسجلة لدى جاهز كمتاجر بقالة، ولا تأثير له على المتاجر العادية (المطاعم).
عند إنشاء فئة أو تعديلها، يمكنك ربطها بإحدى فئات البقالة المعرفة مسبقًا لدى جاهز، ويتم اختيارها من قائمة تُجلب مباشرة من جاهز.
يتحكم هذا الربط في مكان ظهور منتجاتك ضمن أقسام تصفح البقالة في جاهز، ولا يغير أي شيء في تفاصيل منتجاتك.
يظهر اسم فئة جاهز المربوطة بجانب فئتك في قائمة الفئات.
تعديل الفئات وحذفها
يمكن تعديل الفئات في أي وقت (الأسماء، ترتيب العرض، الفروع المستثناة، فئة البقالة في جاهز)، وتتم مزامنة التعديلات مع جاهز.
لا يمكن حذف فئة إلا إذا كانت غير مستخدمة من أي منتج. إذا كانت هناك منتجات مرتبطة بها، ستظهر رسالة: "الفئة مستخدمة من منتج واحد أو أكثر ولا يمكن حذفها".
٤. إدارة المنتجات
إضافة المنتجات
قبل إضافة المنتجات، تأكد من توفر ما يلي لكل منتج (يمكن تعديلها من صفحة المنتج):
صورة المنتج، وتُستخدم كصورة المنتج على جاهز (أو أدخل رابط صورة أثناء الإضافة).
وصف المنتج، ويُستخدم كوصف المنتج على جاهز (أو أدخل وصفًا أثناء الإضافة).
لإضافة المنتجات، حدد المنتجات التي ترغب في إدراجها وأدخل لكل منتج:
السعر (إلزامي): يجب أن يكون أكبر من صفر.
الفئة (إلزامي): إحدى الفئات التي قمت بإنشائها.
الأسماء والأوصاف بالعربية والإنجليزية (اختياري): إذا تُركت فارغة، يُستخدم اسم المنتج ووصفه المسجلان.
رابط الصورة (اختياري): إذا تُرك فارغًا، تُستخدم صورة المنتج المحفوظة.
عند النجاح: تدخل المنتجات قائمة المعالجة وتظهر على متجرك في جاهز بعد معالجتها.
إذا فشلت بعض المنتجات: تظهر قائمة بالمنتجات الفاشلة مع سبب الفشل لكل منها (مثل صورة مفقودة أو فئة غير صحيحة)، وتتم معالجة المنتجات الصحيحة بشكل طبيعي.
تعديل منتج
من قائمة المنتجات، يمكنك تعديل تفاصيل المنتج المدرج: السعر، والفئة، والاسم (بالعربية والإنجليزية)، والوصف (بالعربية والإنجليزية)، والصورة.
الحقول التي لا تقوم بتعديلها تحتفظ بقيمها الحالية.
بعد الحفظ، تتم مزامنة التفاصيل المحدثة مع متجرك على جاهز.
حذف منتج
يمكنك حذف منتج من متجرك على جاهز في أي وقت. يُحذف المنتج من جاهز ويُلغى إدراجه في سرداب، دون أي تأثير على المنتج (SKU) نفسه.
٥. التعديل الجماعي للمنتجات عبر ملف
للقوائم الكبيرة، يمكنك تعديل عدد كبير من المنتجات دفعة واحدة باستخدام ملف إكسل. يقتصر مسار الملف على تعديل المنتجات المدرجة مسبقًا على جاهز؛ أما المنتجات الجديدة فتُضاف من شاشة إضافة المنتجات.
الخطوة الأولى: التنزيل
تصدير: ينزّل ملف إكسل يضم جميع منتجاتك المدرجة بتفاصيلها الحالية، وهو نقطة البداية الموصى بها للتعديل الجماعي.
تحميل القالب: ينزّل ملفًا فارغًا يحتوي على الأعمدة المطلوبة.
العمود | ملاحظات |
merchant_sku | يحدد هوية المنتج؛ لا تقم بتغييره |
name_ar / name_en | اسم المنتج بالعربية والإنجليزية |
description_ar / description_en | وصف المنتج بالعربية والإنجليزية |
price | سعر المنتج |
image_path | رابط صورة المنتج |
category_id | الفئة التي ينتمي إليها المنتج |
الخطوة الثانية: تعديل الملف
لا تقم بإعادة تسمية الأعمدة أو تغيير ترتيبها أو حذفها أو حذف صف العناوين، ولا تغيّر قيمة merchant_sku.
الحقول القابلة للتعديل: الأسماء (بالعربية والإنجليزية)، والأوصاف (بالعربية والإنجليزية)، والسعر، ورابط الصورة، والفئة.
الخلية الفارغة تعني "الاحتفاظ بالقيمة الحالية"، ولا تؤدي إلى مسح الحقل.
الخطوة الثالثة: الرفع
ارفع الملف المعدل بصيغة .xlsx أو .xls أو .csv.
الصفوف التي لا تحتوي على تغييرات يتم تخطيها تلقائيًا، لذا فإن إعادة رفع الملف آمنة.
عند النجاح: تدخل الصفوف المعدلة قائمة المعالجة وتتم مزامنتها مع جاهز، وسترى عدد الصفوف المحدثة وعدد الصفوف غير المتغيرة.
إذا فشلت بعض الصفوف: تظهر قائمة بالصفوف الفاشلة مع رقم الصف وسبب الفشل (مثل merchant_sku غير معروف أو منتج غير مدرج على جاهز)، وتتم معالجة الصفوف الصحيحة بشكل طبيعي.
إذا تعذرت قراءة الملف (نوع ملف غير مدعوم أو أعمدة ناقصة): لا تتم معالجة أي صف ويظهر خطأ الملف.
٦. توفر المنتجات (نفدت الكمية)
التوفر تلقائي بالكامل ويتحكم به سرداب لكل فرع على حدة:
إذا توفر مخزون للمنتج في فرع ما، يظهر المنتج متاحًا في ذلك الفرع.
إذا لم يتوفر مخزون للمنتج في فرع ما، يظهر بحالة نفدت الكمية في ذلك الفرع.
إذا نفد مخزون المنتج في جميع الفروع، يُخفى المنتج من المتجر بالكامل حتى تتم إضافة مخزون جديد.
يُعاد فحص التوفر تلقائيًا مع كل تغيير في المخزون: استلام مخزون عبر عملية وارد يعيد المنتجات إلى حالة متاح، وصرف آخر الوحدات يحولها إلى نفدت الكمية.
لا يوجد تحكم يدوي في إظهار أو إخفاء منتجات جاهز مطاعم؛ التوفر يتبع المخزون دائمًا.
٧. مسار معالجة الطلبات
إنشاء الطلب
تُنشأ الطلبات على متجر جاهز وتُرسل إلى سرداب فورًا.
يقوم سرداب بقبول أو رفض كل طلب تلقائيًا لحظة وصوله. لا توجد خطوة قبول يدوية ولا مهلة زمنية للقبول.
يُرفض الطلب تلقائيًا في الحالات التالية: فرع جاهز غير مربوط بفرع في سرداب، أو نفاد مخزون منتج أو أكثر بالكامل، أو إغلاق الفرع حاليًا، أو وجود منتج أو أكثر غير مدرج في سرداب.
يُرسل سبب الرفض إلى جاهز.
الطلبات المقبولة
تُنشأ الطلبات المقبولة في سرداب كطلبات عاجلة معتمدة مسبقًا، ويُحجز المخزون فورًا للالتقاط الفوري.
يستلم مندوب جاهز الطلب من الفرع.
التنفيذ الجزئي
إذا توفر للمنتج مخزون أقل من الكمية المطلوبة، يُقبل الطلب ويُشحن بالكمية المتوفرة.
يُضاف تعليق على الطلب يوضح المنتجات المنفذة جزئيًا مع الكميات المطلوبة والكميات المرسلة.
يتم ترتيب استرداد المبلغ للعميل عن الكميات الناقصة مع ممثل جاهز الخاص بك.
مزامنة الحالات
عند استلام مندوب جاهز للطلب: في الطريق على جاهز وتم الشحن على سرداب.
عند تسليم الطلب: تم التوصيل على كل من جاهز وسرداب.
تحمل تحديثات الحالة من جاهز أيضًا طريقة الدفع (تُعرف بعد تسليم الطلب، مثل نقدًا أو مدى أو Apple Pay)، ويقوم سرداب بتحديث طريقة الدفع على الطلب تلقائيًا عند استلامها.
إذا أُلغي الطلب أو رُفض أو انتهت مهلته من جانب جاهز، يظهر بحالة ملغى على سرداب.
لا يوجد مسار إرجاع لهذه القناة؛ تتم معالجة الاستردادات من جانب جاهز.
٨. مسؤولية الحالات (سرداب وجاهز)
حالات يتحكم بها سرداب
القبول أو الرفض التلقائي للطلبات
توفر المخزون وحالة نفدت الكمية
تجهيز الطلبات وتنفيذها
حالات يتحكم بها جاهز
إنشاء الطلب
الإرسال والتوصيل وحالات الميل الأخير
الإلغاءات من جانب العميل والاستردادات