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

التكامل مع 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. ستتم إعادتك إلى سرداب.

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

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

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

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

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

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

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

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

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

  3. تأكد من:

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

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

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

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

العنوان الوطني السعودي (اختياري ولكن موصى به)

لا تحتوي صفحة الدفع في Shopify على حقل مخصص للرمز المختصر للعنوان الوطني السعودي (مثل RIYD2929). تتم عملية التوصيل بشكل سليم بدونه باستخدام حقول العنوان القياسية، لكن إدراجه يُحسّن دقة التوصيل في المناطق الحضرية المزدحمة ويقلل من حالات فشل التسليم.

كيف يتم تسجيله

اطلب من عملائك إدراج الرمز المختصر في حقل Apartment, suite, etc. أثناء الدفع، بعد اسم الحي. مثال:

  • Olaya District, RIYD2929

  • Al Hamra, JEDH5678

الصيغة دائمًا 4 أحرف لاتينية كبيرة متبوعة بـ 4 أرقام (LLLL####). يقوم سرداب تلقائيًا باكتشاف هذه الصيغة في أي مكان داخل حقول العنوان، واستخراج الرمز، وتمريره لشركة الشحن — لا يحتاج العميل وضعه في موقع محدد.

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

ماذا لو لم يُدرج العميل الرمز؟

يستمر الطلب في التدفق بشكل طبيعي إلى سرداب ويتم توصيله باستخدام الرمز البريدي والمدينة والحي والشارع — تمامًا مثل أي طلب آخر من Shopify.

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

بمجرد ربط المتجر:

  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

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

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

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

رابط فيديو توضيحي: https://www.loom.com/share/1e64d9687b4c4ad2af9740b64bb0f9e4

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