تخط وانتقل إلى المحتوى الرئيسي

دليل الربط مع جاهز (Jahez)

كيفية ربط متجر جاهز مع سرداب: إنشاء المتجر، إدارة المنتجات، الإدراج الجماعي عبر الملفات، ومسار الطلبات

يشرح هذا الدليل كيفية تكامل جاهز مع سرداب، ويغطي إنشاء المتجر، وإدارة المنتجات، ومسار الطلبات، ومسؤوليات كل نظام.

١. إنشاء المتجر واعتماده

الخطوة الأولى: إنشاء المتجر

يمكنك إنشاء متجر جاهز مباشرة من منصة سرداب: انتقل إلى الوفاء بالطلبات (Fulfilment) ثم التكاملات (Integrations)، واضغط على ربط (Connect) في قسم جاهز.

ملاحظة: إذا كان لديك متجر جاهز نشط بالفعل، يرجى التواصل مع فريق الدعم لنقوم بربطه بحسابك في سرداب.

التفاصيل المطلوبة تشمل:

  • الشعار

  • اسم المتجر (بالعربية والإنجليزية)

  • الوصف (بالعربية والإنجليزية)

  • تفاصيل العنوان (يدويًا أو عبر العنوان المختصر)

الخطوة الثانية: الإرسال إلى جاهز

  • بعد إنشاء المتجر، يتم إرسال طلب إلى فريق جاهز للاعتماد.

  • يتضمن الطلب تفاصيل المتجر، بالإضافة إلى بيانات السجل التجاري والرقم الضريبي المسجلة لدى منصة سرداب.

  • يبقى المتجر في حالة قيد الانتظار خلال هذه المرحلة، وسيتم إشعارك فور وصول رد من فريق جاهز.

الخطوة الثالثة: الاعتماد

  • يراجع فريق جاهز بيانات المتجر.

  • عند الموافقة، تتحول حالة المتجر إلى متصل.

  • في حال الرفض، تظهر حالة مرفوض مع عرض سبب الرفض.

٢. إدارة الفروع

  • يتم إنشاء الفروع وإدارتها في سرداب وربطها بالفروع المقابلة لها في جاهز.

  • أثناء الربط، تتم مزامنة عناوين الفروع ومواقعها وساعات العمل من سرداب إلى جاهز.

٣. إدارة المنتجات

بعد اعتماد المتجر، يمكنك إدراج منتجات سرداب (SKUs) كمنتجات على جاهز وإدارة المنتجات المدرجة.

إدراج المنتجات

يجب أن يحتوي كل منتج يتم إدراجه على جاهز على صورة ووصف. يمكن حفظهما في صفحة المنتج، أو إدخالهما مباشرة في نموذج إضافة المنتجات أثناء الإدراج.

  • لإدراج منتجات جديدة، اضغط على إدارة المنتجات (Manage Products).

  • الخطوة الأولى: اختيار المنتجات. ستظهر نافذة إضافة المنتجات (Add Products) وفيها قائمة بجميع المنتجات غير المدرجة. حدد المنتجات التي ترغب في إدراجها باستخدام مربعات الاختيار، ثم اضغط على التالي (Next).

  • الخطوة الثانية: تفاصيل المنتجات. يظهر نموذج لكل منتج تم اختياره يتضمن الحقول التالية:

    • رابط الصورة: رابط صورة المنتج. إذا تُرك فارغًا، تُستخدم صورة المنتج المحفوظة.

    • اسم المنتج بالإنجليزية والعربية: يُعبأ الاسم الإنجليزي تلقائيًا باسم المنتج، وإذا تُرك الاسم العربي فارغًا يُستخدم اسم المنتج.

    • الوصف بالإنجليزية والعربية: إذا تُرك فارغًا، يُستخدم وصف المنتج المحفوظ.

    • السعر (إلزامي): يجب أن يكون أكبر من صفر.

    • النشاط (Industry) (إلزامي): اختر نشاط جاهز المناسب للمنتج.

مهم: إذا كان مخزون المنتج في أحد الفروع صفرًا، سيظهر تلقائيًا بحالة "نفدت الكمية" على تطبيق جاهز في ذلك الفرع.

نتائج الإدراج

  • عند النجاح: يظهر كل منتج تمت معالجته بنجاح في جدول المنتجات ويتم إدراجه على متجر جاهز.

  • عند الفشل: يتم إرسال بريد إلكتروني إلى مديري الحساب يتضمن تفاصيل الأخطاء.

تعديل منتج

  • من جدول المنتجات، يمكنك تعديل تفاصيل المنتج المدرج: السعر، والاسم (بالعربية والإنجليزية)، والوصف (بالعربية والإنجليزية)، والنشاط.

  • الحقول التي لا تقوم بتعديلها تحتفظ بقيمها الحالية.

  • تُدار صور المنتجات من صفحة المنتج ولا يمكن تعديلها من هذه الشاشة.

  • بعد الحفظ، تتم مزامنة التفاصيل المحدثة مع متجرك على جاهز.

٤. إجراءات الملف (File Actions)

تجمع قائمة إجراءات الملف (File Actions) في صفحة المنتجات العمليات المعتمدة على الملفات: تحميل القالب (Download template) وتصدير المنتجات (Export products) ورفع منتجات جديدة (Upload new products). وتتيح لك معًا إدراج عدد كبير من المنتجات دفعة واحدة بدلاً من تحديدها واحدًا تلو الآخر.

تحميل القالب

اضغط على إجراءات الملف (File Actions) ثم تحميل القالب (Download template) للحصول على ملف إكسل فارغ يحتوي على الأعمدة المطلوبة:

العمود

إلزامي

ملاحظات

type

نعم

sku للمنتج أو bundle للباقة

merchant_sku

نعم

رمز المنتج الخاص بك كما هو مسجل في منصة سرداب

name_ar / name_en

لا

إذا تُرك فارغًا، يُستخدم اسم المنتج أو الباقة

description_ar / description_en

لا

إذا تُرك فارغًا، يُستخدم وصف المنتج

price

نعم

رقم أكبر من صفر

industry

نعم

اسم النشاط بالإنجليزية كما هو معتمد لدى جاهز، مثل Other

image_url

فقط للمنتجات التي لا تملك صورة

رابط صورة واحد فقط. إذا تُرك فارغًا، تُستخدم صورة المنتج المحفوظة. الباقات لا تحتاج إلى صورة

ملاحظة: لا تقم بإعادة تسمية الأعمدة أو تغيير ترتيبها أو حذفها، وحافظ على صف العناوين كما هو.

تصدير المنتجات

  • اضغط على إجراءات الملف (File Actions) ثم تصدير المنتجات (Export products) لتنزيل ملف إكسل يضم جميع المنتجات المدرجة حاليًا على جاهز، بأسمائها وأوصافها وأسعارها وأنشطتها وروابط صورها الحالية.

  • ملف التصدير بنفس تنسيق وأعمدة القالب، لذا يمكن استخدامه كمثال معبأ لكيفية تعبئة صفوف الرفع.

  • جميع المنتجات في ملف التصدير مدرجة بالفعل على جاهز، لذا فإن إعادة رفعه كما هو لن تنشئ منتجات جديدة: الصفوف الخاصة بالمنتجات المدرجة يتم تخطيها دائمًا.

رفع منتجات جديدة

  • يقتصر رفع الملف على إنشاء منتجات جديدة فقط: فهو لا يقوم أبدًا بتحديث المنتجات المدرجة مسبقًا على جاهز. لتعديل منتج مدرج، استخدم التعديل من جدول المنتجات.

  • عبّئ صفًا واحدًا لكل منتج جديد ترغب في إدراجه على جاهز، بدءًا من القالب (أو من ملف التصدير للاطلاع على شكل الصفوف المكتملة).

  • اضغط على إجراءات الملف (File Actions) ثم رفع منتجات جديدة (Upload new products) واختر الملف بصيغة ‎.xlsx أو ‎.xls أو ‎.csv.

نتائج الرفع

  • الصفوف الصحيحة تدخل قائمة المعالجة وتظهر في جدول المنتجات بعد معالجتها وإدراجها على جاهز.

  • الصفوف الخاصة بمنتجات مدرجة مسبقًا على جاهز يتم تخطيها تلقائيًا، لذا فإن إعادة رفع نفس الملف آمنة وتُكمل المنتجات الناقصة فقط.

  • إذا احتوت بعض الصفوف على أخطاء، تظهر قائمة بالصفوف الفاشلة مع رقم الصف وسبب الفشل (مثل سعر مفقود أو نشاط غير معروف)، وتتم معالجة الصفوف الصحيحة بشكل طبيعي.

  • إذا تعذرت قراءة الملف نفسه (نوع ملف غير مدعوم أو أعمدة ناقصة)، لا تتم معالجة أي صف ويظهر خطأ الملف.

٥. التحكم في ظهور المنتجات

يتحكم سرداب بالكامل في توفر المخزون. يخضع كل منتج لحالتين تديرهما سرداب:

١. نفدت الكمية (Sold Out)

  • افتراضيًا، تكون المنتجات متاحة في جميع الفروع المحددة عند إنشاء المتجر.

  • تتم إدارة توفر المخزون لكل فرع على حدة: إذا توفر مخزون، يظهر المنتج متاحًا في ذلك الفرع، وإذا لم يتوفر، يظهر بحالة نفدت الكمية.

  • يُعاد فحص المخزون عند إضافة مخزون عبر عملية وارد (تعود المنتجات التي نفدت كميتها إلى حالة متاح)، وعند صرف آخر مخزون متاح عبر عملية صادر (يتحول المنتج إلى حالة نفدت الكمية).

٢. مخفي (Hidden)

  • من واجهة سرداب، يحتوي كل منتج مدرج على خيار الفروع المخفية (Hidden Branches).

  • يمكنك تحديد فروع معينة لإخفاء المنتج فيها.

  • بعد الإخفاء، لا يظهر المنتج على جاهز في الفروع المحددة.

٦. مسار معالجة الطلبات

  • تُنشأ الطلبات من متجر جاهز وتُرسل إلى سرداب.

  • عند استلام سرداب للطلب، يجري عدة تحققات قبل إنشائه: التأكد من ربط جميع المنتجات بشكل صحيح، وتوفر مخزون كافٍ للكميات المطلوبة، وأن المستودع يعمل حاليًا. إذا فشل أي من هذه التحققات، يُرفض الطلب تلقائيًا وتتم مزامنة الرفض مع جاهز.

  • بعد هذه المرحلة، تنتقل إدارة حالة الطلب إلى جاهز.

  • عند استلام مندوب جاهز للطلب، تتحول الحالة إلى في الطريق على جاهز وتم الشحن على سرداب.

  • عند تسليم الطلب، تتحول الحالة إلى تم التوصيل على كل من جاهز وسرداب.

٧. حالات فشل التوصيل والطلبات المرفوضة والملغاة

  • في حال فشل التوصيل، يحدد مندوب جاهز الطلب كـلم يتم التوصيل. عندها يبدأ سرداب إجراء إرجاع للطلب، وتُعاد المنتجات إلى الفرع المناسب.

  • في حال عدم توفر منتج، أو إغلاق المتجر، أو لأي سبب آخر، يمكن لمشغل المتجر رفض الطلب. يظهر الطلب بحالة مرفوض على جاهز وملغى على سرداب.

  • قبل قبول الطلب وبدء تجهيزه، يمكن للعميل إلغاؤه من متجر جاهز، وعندها يُلغى الطلب على سرداب أيضًا.

٨. مسؤولية الحالات (سرداب وجاهز)

حالات يتحكم بها سرداب

  • قبول الطلب أو رفضه

  • التجهيز والالتقاط

  • قرارات نفاد المخزون

حالات يتحكم بها جاهز

  • إنشاء الطلب

  • الإرسال والتوصيل وحالات الميل الأخير

  • إتمام الطلب أو إلغاؤه من جانب العميل

هل أجاب هذا عن سؤالك؟