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

التكامل مع 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: اعدادات المنتجات

2.1 ال SKU و الباركود

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

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

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

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

  4. أدخل قيمة الباركود في حقل الباركود( Barcode (ISBN, UPC, GTIN, etc.)) ايضا.

  5. استخدم رقم باركود صحيحًا مثل (EAN-13 او UPC )

  6. اضغط Save.

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

💡 تتم مزامنة الباركود إلى سرداب تلقائيًا عند مزامنة المنتجات. وكما هو الحال مع رموز SKU، يُفضَّل ضبط الباركود قبل الربط للحصول على أفضل مطابقة. وإذا أضفت أو غيّرت باركودًا لاحقًا ولم يظهر في سرداب، تواصل مع الدعم.

2.2 الرسوم والرسوم الإضافية وبطاقات الهدايا

يقوم سرداب بتجهيز المنتجات الفعلية فقط. أي بند في الطلب ليس منتجًا فعليًا — مثل رسوم الدفع عند الاستلام، أو رسوم خدمة، أو بطاقة هدايا رقمية — يتم تخطّيه تلقائيًا ولا يُعامَل كـ SKU له مخزون. ولا يتأثر إجمالي الطلب ولا المبلغ المُحصَّل عند الدفع عند الاستلام.

لضمان تخطّي أي رسوم:

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

  2. انزل إلى بطاقة Shipping وألغِ تفعيل خيار "This is a physical product"، ثم اضغط Save. يصبح البند غير قابل للشحن ويتخطّاه سرداب.

أين تجد الخيار:

- المنتجات بدون متغيّرات (variants): خيار "This is a physical product" موجود في بطاقة Shipping داخل صفحة المنتج.

- المنتجات التي لها متغيّرات: افتح المتغيّر المحدّد؛ ستجد نفس الخيار "This is a physical product" في قسم Shipping الخاص بذلك المتغيّر.

- بطاقات الهدايا: المنتج المُنشأ بنوع Gift card في Shopify يكون غير فعلي تلقائيًا (لا توجد بطاقة Shippin

) — ولا يلزم أي إجراء.

💡ملاحظة: الطريقة الأنظف لإضافة رسوم الدفع عند الاستلام هي كرسوم إضافية (Surcharge) — مثلًا عبر تطبيق رسوم COD يعتمد على Cart Transform Function — وليس كمنتج. فالرسوم الإضافية ليست بندًا قابلًا للتجهيز، وبالتالي لا تصل إلى سرداب كـ SKU.

وإذا كانت جميع بنود الطلب غير فعلية (مثل طلب يحتوي على بطاقة هدايا فقط)، فلا يوجد ما يشحنه سرداب، ولذلك لا يتم تجهيز الطلب.

الخطوة 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 للبحث عن الرمز باستخدام عنوانه.

💡طريقة بديلة: إدخال العنوان الوطني عبر حقل الشركة (Company)

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

  • اذهب إلى: Settings ثم Checkout في Shopify،

  • في Form options ابحث عن Company name.

  • اضبطه على Optional (أو Required) ثم اضغط Save.

💡ما يفعله العميل: عند الدفع، يُدخل العميل رمز العنوان الوطني المختصر في حقل الشركة (Company)، وهو أربعة أحرف يتبعها أربعة أرقام، مثل RIYD2929.

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

الخطوة 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: موقع التنفيذ الخاص بسِرداب والطلبات الإلكترونية

عند ربط سِرداب، يقوم التطبيق تلقائيًا بإنشاء وإدارة موقع تنفيذ (Fulfillment Location) في متجرك. ستجده في الإعدادات ← المواقع (Settings → Locations)، ضمن قسم App and custom fulfillment locations (باسم مستودعك، مثل "Sirdab Fulfillment Location").

لا تحتاج إلى ضبط هذا الموقع، ولن يسمح لك Shopify بذلك. الموقع تتم إدارته بواسطة تطبيق سِرداب، لذلك يظهر في لوحة التحكم للقراءة فقط: لا يمكن الضغط عليه، وليست له صفحة إعدادات، ولا يمكن تعيينه كموقعك الافتراضي (Default location).

هذا أمر طبيعي ومتوقَّع. وبحسب توثيق Shopify الرسمي:
"Apps and deactivated locations can't be set as the default location."

(لا يمكن تعيين مواقع التطبيقات أو المواقع المعطَّلة كموقع افتراضي.)

"If you're using a dropshipping app or fulfillment service to fulfill all of your orders, then you don't need to make any changes to your locations or the default location."

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

بعبارة أخرى: عند ربط سِرداب، اترك مواقعك والموقع الافتراضي كما هي دون أي تعديل.


المصدر: مركز مساعدة Shopify — إعداد تنفيذ الطلبات للمواقع

https://help.shopify.com/en/manual/fulfillment/setup/locations/fulfillment

كيفيه تفعيل سرداب كا ابلكيشن تنفيذ طلبات افتراضيا ؟

من خلال تلك الفيديو يمكنك معرفه الطريقه بالتفصيل

https://www.loom.com/share/e1bfa869723f46ba9215ecc330cd66e3

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

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

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

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

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

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

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

تعديل الطلبات قبل طلب التنفيذ (Shopify)

💡 بمجرد طلب تنفيذ الطلب من سرداب، يتم قفل المنتجات والكميات الخاصة به. قم بإجراء جميع التعديلات على المنتجات والكميات في Shopify قبل طلب التنفيذ.

✅ **افعل:** راجِع المنتجات والكميات وأكمِلها في Shopify قبل طلب التنفيذ.

🚫 **تجنّب:** إضافة أو حذف أو تعديل المنتجات في Shopify بعد طلب التنفيذ — لن تتم مزامنة هذه التغييرات مع سرداب.

ما الذي يتم تحديثه تلقائيًا بعد إنشاء الطلب:-

  • حالة الدفع (مثل: قيد الانتظار ← مدفوع).

  • إجماليات الطلب (المجموع الفرعي، الضريبة، الخصم، الإجمالي).

  • بيانات العميل وجهة الاتصال (الاسم، البريد الإلكتروني، رقم الجوال).

  • عنوان الشحن — إذا تم إنشاء الطلب بعنوان غير مكتمل، فإن إكماله في Shopify سيؤدي إلى إنهاء الطلب في سرداب.

هل تحتاج إلى تغيير المنتجات بعد طلب التنفيذ؟

  • قم بإلغاء طلب التنفيذ / الطلب، ثم

  • أعِد إنشاءه في 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

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

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

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

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


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

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