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

التكامل مع Shopify لخدمات تجهيز وشحن طلبات المتاجر الإلكترونية

اربط متجر Shopify الخاص بك مع سرداب لمزامنة الطلبات تلقائيًا وتجهيزها وشحنها.

نظرة عامة

يتيح التكامل مع Shopify لمنصة سرداب استقبال طلبات متجرك الإلكتروني وتجهيزها وشحنها بشكل تلقائي. بمجرد ربط المتجر، تُرسل كل الطلبات إلى سرداب للتخزين والتجهيز والتوصيل.

المتطلبات الأساسية

  • حساب تاجر فعّال على سرداب (سجّل عبر sirdab.app/sign-up)

  • اختيار خدمة "التخزين بالجملة وخدمات تجهيز وشحن طلبات المتاجر الإلكترونية" عند التسجيل

  • متجر Shopify فعّال مع صلاحيات المسؤول (Admin)

  • إعداد متجر Shopify لسوق المملكة العربية السعودية (KSA) وضبط العملة على الريال السعودي SAR (ر.س)

  • إضافة رقم SKU لكل منتج/متغير في Shopify قبل الربط — سرداب يعتمد على رقم الـ SKU لمطابقة المنتجات

الخطوة 1: ضبط السوق والعملة في Shopify

سرداب يقوم بتجهيز الطلبات للسوق السعودي. قبل الربط، تأكد من أن إعدادات Shopify مهيّأة لذلك.

  1. في لوحة تحكم Shopify، اذهب إلى Settings ← Markets وتأكد من اختيار Saudi Arabia كسوق رئيسي.

  2. اذهب إلى Settings ← Store details وتأكد من أن عملة المتجر هي SAR (ر.س). عدّلها إذا لزم الأمر.

⚠️ الطلبات بالدولار الأمريكي أو أي عملة غير الريال السعودي قد لا تتم مزامنتها مع سرداب بشكل صحيح.

الخطوة 2: إضافة رموز SKU للمنتجات

يقوم سرداب بربط كل منتج/متغير في Shopify بمنتج (SKU) أو حزمة (Bundle) في سرداب من خلال حقل SKU. وفي حال عدم وجود SKU، لن يتم تجهيز الطلب.

  1. في Shopify، اذهب إلى Products وافتح كل منتج.

  2. في قسم Inventory، أدخل قيمة الـ SKU لتطابق نفس الـ SKU المستخدم في سرداب (الـ Merchant SKU).

  3. إذا كان للمنتج متغيرات (مقاس، لون، إلخ)، أضف رقم SKU فريدًا لكل متغير.

  4. اضغط Save.

💡 رموز SKU حساسة لحالة الأحرف، ويجب أن تتطابق تمامًا بين Shopify وسرداب.

الخطوة 3: ربط Shopify من بوابة سرداب

  1. سجّل الدخول إلى بوابة التاجر في سرداب.

  2. اذهب إلى Dashboard ← Fulfillment ← Integrations.

  3. ابحث عن بطاقة Shopify ضمن Available Integrations واضغط على Connect.

  4. ستظهر نافذة Configure Shopify Integration — أدخل اسم متجر Shopify فقط، بدون الرابط الكامل.

  5. اضغط Connect. ستتم إعادة توجيهك إلى Shopify لتفويض تطبيق سرداب.

  6. راجع الصلاحيات المطلوبة:

    • قراءة وكتابة طلبات التجهيز المخصصة (Assigned Fulfillment Orders)

    • قراءة وكتابة عمليات التجهيز (Fulfillments)

    • قراءة وكتابة المخزون (Inventory)

    • قراءة المواقع (Locations)

    • قراءة وكتابة المرتجعات (Returns)

  7. اضغط Install app. ستتم إعادتك إلى سرداب.

طريقة بديلة: التثبيت من Shopify App Store

تطبيق Sirdab Fulfillment متاح على Shopify App Store (تثبيت مجاني). يمكنك بدء عملية الربط من جانب Shopify بدلًا من البدء من بوابة سرداب:

  1. افتح صفحة تطبيق Sirdab Fulfillment على Shopify App Store. اضغط View demo store أولًا إن أردت معاينة التكامل قبل التثبيت.

  2. اضغط Install.

  3. راجع الصلاحيات المطلوبة واضغط Install app.

  4. ستتم إعادة توجيهك إلى بوابة التاجر في سرداب — سجّل الدخول بحساب سرداب الخاص بك (أو أنشئ حسابًا إن لم يكن لديك).

  5. بمجرد تسجيل الدخول، يتم ربط متجر Shopify تلقائيًا بحسابك في سرداب. سيظهر ضمن Fulfillment ← Integrations ← Connected Integrations.

النتيجة النهائية مطابقة للخطوات أعلاه — نفس الصلاحيات ونفس حالة الربط.

الخطوة 4: التحقق من حالة الربط

  1. في سرداب، عُد إلى Fulfillment ← Integrations.

  2. يجب أن يظهر متجر Shopify الآن ضمن Connected Integrations مع:

    • 🟢 نقطة خضراء بحالة Integrated

    • اسم متجرك معروضًا

    • زر Manage لإعدادات إضافية

الخطوة 5: التحقق من ربط المنتجات

  1. اضغط Manage على بطاقة تكامل Shopify.

  2. افتح قسم Mapped Products.

  3. تأكد من:

    • ظهور المنتجات بحالة Mapped

    • تطابق رموز SKU بين Shopify وسرداب

    • ربط جميع المتغيرات

إذا ظهر أي منتج بحالة Unmapped، اضغط Map بجانبه واختر الـ SKU المطابق من مخزون سرداب.

الخطوة 6: تفعيل حقل العنوان الوطني السعودي في صفحة الدفع

⚠️ تتطلب اشتراك Shopify Plus. تعمل البلوكات المخصصة في صفحة الدفع (بما في ذلك حقل العنوان الوطني) فقط للمتاجر المشتركة في خطة Shopify Plus. هذا قيد من Shopify وليس من سرداب. راجع توثيق Shopify الرسمي.

يقوم سرداب بإضافة بلوك مخصص باسم National Address Code داخل صفحة الدفع في متجر Shopify الخاص بك. يجب تفعيل هذا البلوك من محرر صفحة الدفع (Checkout Editor) ليظهر الحقل للعميل أثناء الدفع. كل من عنوان الشحن القياسي ورمز العنوان الوطني السعودي إلزاميان — لن يتمكن العميل من إكمال الدفع بدونهما.

📹 شرح بالفيديو:-
​

كيفية تفعيل البلوك في محرر صفحة الدفع

  1. في لوحة تحكم Shopify، اذهب إلى Settings ← General.

  2. اضغط Customize بجانب صفحة الدفع المفعّلة.

  3. في القائمة اليسرى، ابحث عن قسم Delivery.

  4. اضغط + Add block أسفل قسم Delivery.

  5. اختر National Address Code من القائمة.

  6. اسحب البلوك إلى الموقع المناسب — يُفضّل أسفل بلوك Delivery address مباشرة.

  7. اضغط Save في أعلى الصفحة.

سيظهر الآن حقل National Address Code أسفل حقول العنوان في صفحة الدفع، بنص توضيحي: National Address Code (e.g. RIYD2929).

ما يجب على العميل إدخاله أثناء الدفع

يجب على العميل إكمال جميع الحقول التالية قبل التمكن من الدفع:

  • الدولة، الاسم الكامل، عنوان الشحن الكامل (الشارع، المدينة، الرمز البريدي)

  • رقم جوال سعودي (يُدخل في قسم Contact)

  • الرمز المختصر للعنوان الوطني بصيغة LLLL#### (4 أحرف لاتينية كبيرة + 4 أرقام، مثل RIYD2929)

إذا ترك العميل حقل العنوان الوطني فارغًا أو أدخله بصيغة غير صحيحة، فإن زر Continue to shipping يصبح غير قابل للضغط، وتظهر رسالة خطأ تحت الحقل: "National Address Code is required" أو "Format must be 4 letters followed by 4 digits".

💡 يمكن للعملاء معرفة الرمز المختصر الخاص بهم من تطبيق العنوان الوطني، أو بالبحث عن عنوانهم على splonline.com.sa.

ما يحدث بعد إتمام الطلب بنجاح

يتم تلقائيًا التعامل مع الرمز المختصر للعنوان الوطني كما يلي:

  • يُحفظ مع عنوان العميل في سرداب (يظهر في Fulfillment ← Orders ← Location Details).

  • يُمرَّر إلى شركة الشحن (Aramex، SMSA، OTO، إلخ) لتحقيق دقة أعلى في التوصيل.

  • يُحفظ في لوحة Additional details الخاصة بالطلب في Shopify لأغراض المرجعية.

استكشاف الأخطاء وإصلاحها

  • عدم ظهور "National Address Code" في قائمة + Add block — قد يكون إصدار تطبيق سرداب على متجرك قديمًا. اذهب إلى Settings ← Apps and sales channels، اضغط على تكامل سرداب، واقبل أي تحديث متاح. ثم حدّث محرر صفحة الدفع.

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

  • العميل لا يعرف الرمز المختصر — وجّهه إلى تطبيق العنوان الوطني أو splonline.com.sa للبحث عن الرمز باستخدام عنوانه.

الخطوة 7: تفعيل طلب التجهيز التلقائي

بشكل افتراضي، تتطلب Shopify من التاجر الضغط يدويًا على Request fulfillment في كل طلب جديد. تفعيل التجهيز التلقائي يُرسل الطلبات إلى سرداب فور إتمام الدفع — دون الحاجة إلى ضغط يدوي.

كيفية التفعيل

  1. في لوحة تحكم Shopify، اذهب إلى Settings ← General.

  2. مرّر إلى قسم Order processing.

  3. ضمن After an order has been paid، فعّل Automatically fulfill the order's line items.

  4. اضغط Save.


​

ما الذي يتغير

  • الطلبات الجديدة المدفوعة تُرسل إلى سرداب تلقائيًا.

  • الطلب ينتقل مباشرة من Paid + Unfulfilled إلى Fulfillment accepted.

  • لا حاجة إلى زر Request fulfillment في العمليات اليومية.

متى لا يُفعَّل

إذا كنت تحتاج إلى مراجعة يدوية لكل طلب (كاكتشاف الاحتيال أو إدارة الطلبات المباعة زيادة عن المخزون أو معالجة خاصة)، اترك هذه الإعدادات معطلة وعالج الطلبات يدويًا.

الخطوة 8: تفعيل موقع سرداب لخدمة الطلبات الإلكترونية

لكي يستخدم متجرك مخزون سرداب، يجب تفعيل موقع سرداب للتجهيز ضمن قنوات البيع الإلكترونية. بدون ذلك، قد تظهر المنتجات بحالة Sold out حتى لو كان المخزون متوفرًا لدى سرداب.

كيفية التفعيل

  1. في لوحة تحكم Shopify، اذهب إلى Settings ← Locations.

  2. اضغط على موقع سرداب للتجهيز (مثلاً Lama Najd - Jeddah أو اسم مستودعك).

  3. تأكد من تفعيل Fulfill online orders from this location، وأن الموقع مشمول ضمن قناة بيع Online Store.

  4. (موصى به) اجعله موقع التجهيز الافتراضي ليتم تحويل المنتجات الجديدة لاستخدام سرداب تلقائيًا.

  5. اضغط Save.

لماذا هذه الخطوة مهمة

تحدد Shopify الموقع الذي يمكنه تجهيز الطلب بناءً على المواقع التي تحتوي على مخزون و المواقع المفعّلة لقناة البيع التي يستخدمها العميل. إذا كان لدى سرداب 100 وحدة لكن الموقع غير مفعّل لقناة Online Store، فسيعتبر متجرك المنتج نافذًا.

الأعراض الأكثر شيوعًا

إذا ظهر منتج بحالة Sold out في متجرك بينما تجد المخزون متوفرًا في سرداب → هذا الإعداد هو السبب. فعّله ثم حدّث متجرك.

آلية تجهيز الطلبات

بمجرد ربط متجرك مع سرداب وتفعيل التجهيز التلقائي، تتم معالجة الطلبات كما يلي:

  1. يقوم العميل بإنشاء طلب على متجرك في Shopify.

  2. توجّه Shopify الطلب إلى موقع سرداب للتجهيز.

  3. يُزامَن الطلب تلقائيًا مع سرداب ويتم إنشاء أمر تجهيز.

  4. يقوم سرداب بعمليات التجميع والتغليف والشحن.

  5. تُعاد بيانات التتبع وحالة الشحن إلى Shopify ليطّلع العميل على التحديثات لحظيًا.

المرتجعات

يدعم سرداب آلية المرتجعات الكاملة في Shopify. يمكن للتاجر بدء عملية المرتجع من لوحة تحكم Shopify، وسيقوم سرداب باستلام المنتجات وفحصها وتحديث حالة المرتجع في Shopify بشكل تلقائي.

كيف تعمل عملية المرتجع

  1. يقوم العميل (أو التاجر) بطلب مرتجع من Shopify (Orders ← اختر الطلب ← Return items).

  2. يقوم Shopify بإخطار سرداب لحظيًا عبر الـ Webhook.

  3. يُنشئ سرداب أمر مرتجع مقابل ويُرتّب لاستلام المنتجات من العميل.

  4. بمجرد وصول المنتجات إلى مستودع سرداب، يقوم فريقنا بفحصها ومعالجتها.

  5. عند اكتمال المرتجع في سرداب، يتم إغلاق المرتجع في Shopify تلقائيًا — وعندها يمكن للتاجر إصدار المبلغ المسترد من Shopify.

  6. إذا تم إلغاء المرتجع في أي مرحلة من سرداب، يتم إلغاء المرتجع المقابل في Shopify تلقائيًا.

أسباب المرتجع

يقوم سرداب بربط أسبابه الداخلية بأسباب المرتجع المعتمدة في Shopify:

  • تعذّر الوصول للعميل (Customer Unreachable) ← UNWANTED

  • إلغاء الطلب من العميل (Cancelled order by customer) ← UNWANTED

  • منتجات تالفة (Damaged Items) ← DEFECTIVE

  • منتجات خاطئة أو مفقودة (Incorrect / Missing Items) ← WRONG_ITEM

  • أخرى (Other) ← OTHER

متابعة حالة المرتجع

يمكنك متابعة حالة أي مرتجع في موقعين:

  • لوحة تحكم Shopify — افتح الطلب الأصلي لرؤية حالة المرتجع (Open / Closed / Cancelled).

  • بوابة التاجر في سرداب — اذهب إلى Fulfillment ← Returns لمتابعة تفاصيل الاستلام والفحص ومعالجة المستودع.

💡 يتم إصدار المبالغ المستردة دائمًا من لوحة تحكم Shopify، وليس من سرداب. سرداب يتولى فقط لوجستيات الاسترجاع الفعلي وتحديث حالة المرتجع في Shopify عند إكتماله.

مشاكل شائعة

  • المرتجع لا يظهر في سرداب — تأكد من أن الطلب الأصلي تم تجهيزه عن طريق سرداب. المرتجعات الخاصة بطلبات تم تجهيزها في مكان آخر لا تتم مزامنتها.

  • حالة المرتجع تظهر "Open" في Shopify بعد إكماله في سرداب — انتظر بضع دقائق حتى تتم معالجة الـ Webhook. إذا استمرت الحالة بعد 10 دقائق، تواصل مع دعم سرداب مع تزويدنا بمعرّف المرتجع في Shopify.

إلغاء تجهيز الطلب

لا يمكن إلغاء الطلبات التي تم تجهيزها أو شحنها بالفعل.

يمكن تنفيذ الإلغاء من أي من الجانبين — سرداب أو Shopify — ويتم تحديث الجانب الآخر تلقائيًا:

  • من Shopify — افتح الطلب (Orders ← اختر الطلب ← More actions ← Cancel order). سيُخطر Shopify سرداب لإلغاء التجهيز.

  • من سرداب — افتح أمر التجهيز في بوابة التاجر في سرداب وألغِه. سيقوم سرداب بإخطار Shopify لتحديد الطلب كملغي.

إعادة محاولة الطلبات الفاشلة

قد يفشل الطلب لأحد سببين:

  • نقص المخزون — لا يتوفر لدى سرداب الكمية المطلوبة من أحد المنتجات.

  • منتجات غير مربوطة — لا يعرف سرداب أي SKU أو حزمة يقابل المنتج في Shopify.

قم بمعالجة السبب (تعويض المخزون أو ربط المنتج) ثم أعد إرسال الطلب من صفحة الطلب على Shopify.

استكشاف الأخطاء وإصلاحها

المنتجات لا تتم مزامنتها مع سرداب

  • تأكد من إضافة رموز SKU لجميع متغيرات المنتجات في Shopify.

  • تأكد من تطابق رموز SKU تمامًا (حساسة لحالة الأحرف) بين Shopify وسرداب.

  • تأكد من أن المنتجات بحالة Active في Shopify.

الطلبات لا تظهر في سرداب

  • تأكد من أن جميع منتجات الطلب لها رموز SKU مطابقة في سرداب.

  • تأكد من أن عنوان الشحن داخل المملكة العربية السعودية.

  • تأكد من أن عملة المتجر هي SAR.

أخطاء في العملة أو الأسعار

  • اضبط عملة المتجر على SAR من Settings ← Store details.

  • حدّث أسعار المنتجات بالريال السعودي.

ظهور SKU بحالة "Unmapped"

  • تأكد من تطابق صيغة الـ SKU بدقة (بدون مسافات إضافية، مع مراعاة حالة الأحرف).

  • تأكد من وجود الـ SKU في مخزون سرداب.

  • قم بربط المنتج يدويًا من إعدادات تكامل Shopify إذا لم يتم الربط تلقائيًا.

هل تحتاج إلى مساعدة؟

في حال واجهتك أي مشكلة أثناء الإعداد، تواصل مع فريق دعم سرداب عبر الدردشة داخل التطبيق أو البريد الإلكتروني [email protected]، مع إرفاق:

  • اسم متجر Shopify

  • أرقام الطلبات المتأثرة

  • لقطة شاشة للمشكلة

  • الخطوات التي قمت بها بالفعل

رابط فيديو توضيحي:
- طريقه ربط شوبيفاي مع سرداب من جانب سرداب


​
- طريقه ربط شوبيفاي مع سرداب من جانب شوبيفاي
​

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