اربط متجرك. وتتحول الطلبات إلى توصيلات.

الخطوة 1

قبل أن تبدأ: احصل على مفاتيحك

كل ربط، سواء عبر Shopify أو نظامك الخاص، يستخدم البيانات الثلاث نفسها من حساب الأعمال لدى DHB.

1. تحتاج إلى حساب أعمال لدى DHB. ليس لديك حساب؟ افتحه من صفحة الأعمال، ولن يستغرق سوى دقائق.
2. راسلنا عبر واتساب واطلب تفعيل الربط عبر API لحسابك.
3. سجّل الدخول إلى app.dhbahrain.bh وافتح API OAuth2 Keys. انسخ Client Id وClient Secret.
4. جهّز نطاق REST (API) أدناه، فستلصقه مع مفاتيحك.

نصيحةتعامل مع Client Secret ككلمة مرور. شاركه فقط مع الشخص الذي يجهّز متجرك، ولا تنشره في محادثة عامة أو قائمة بريدية.

الخطوة 2

ثبّت تطبيق Shopify واربطه

تطبيقنا على Shopify مجاني. يحوّل طلبات Shopify الجديدة إلى توصيلات DHB ويعيد رابط التتبع إلى الطلب.

1. في متجر تطبيقات Shopify، ابحث عن Onro - Local Delivery & Courier Integration. Onro هي الشريك التقني وراء منصة DHB.
2. اضغط Install واختر متجرك، ثم اضغط Open.
3. الصق Client ID وClient Secret من حسابك لدى DHB.
4. في حقل نطاق REST (API)، اكتب rest.dhbahrain.bh (بدون https://).
5. اضغط Submit. أصبح متجرك الآن مرتبطًا بـ DHB.

نصيحةيظهر التطبيق باسم Onro وشعارها داخل Shopify. وهو النظام نفسه الذي يشغّل تطبيق DHB، لذلك تظهر الطلبات في حسابك لدى DHB كالمعتاد.

الخطوة 3

حدّد موقع الاستلام

أخبر DHB من أين يستلم المندوب كل طلب.

1. في Shopify، انتقل إلى Apps ← Onro ← Settings ← Pickup Location.
2. اضغط Edit بجانب موقع متجرك في Shopify.
3. اختر العنوان: عنوان الموقع في Shopify، أو عنوانًا محفوظًا من دفتر عناوينك لدى DHB.
4. لإضافة عنوان محفوظ جديد، اضغط New واملأ البيانات ثم اضغط Submit.

الخطوة 4

فعّل طريقة توصيل

لا تصل الطلبات إلى DHB إلا عبر طريقة توصيل مفعّلة. جهّز الطريقة في Shopify أولًا، ثم فعّلها في التطبيق.

1. في التطبيق، افتح Settings واختر إحدى الطرق الأربع في الجدول أدناه.
2. اضغط Edit (أو Add Dynamic Rate) ثم اضغط Enable.
3. املأ إعدادات التوصيل الموضحة في الدليل التالي، ثم اضغط Save.

نصيحةفي Dynamic Rates لا يمكن تغيير Name وCode بعد الحفظ، لذا اخترهما بعناية.

الخطوة 5

اختر إعدادات التوصيل

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

1. Service: سرعة DHB لهذه الطلبات، مثل إكسبرس خلال ساعة أو التوصيل خلال 3 أو 5 ساعات.
2. Vehicle Type: مطلوب فقط للخدمات الفورية.
3. Payment Method: Cash by Receiver للدفع عند الاستلام، أو Cash by Sender، أو Customer Wallet للدفع من محفظتك لدى DHB.
4. Create delivery order when: مرحلة الطلب في Shopify التي يُرسل عندها إلى DHB، مثل عند الدفع أو التجهيز.
5. Fulfill Shopify order when: حالة DHB التي تجعل طلب Shopify مكتملًا، مثل عند التسليم.
6. Attach tracking info: فعّله لإضافة رابط التتبع المباشر من DHB إلى طلب Shopify.

نصيحةالمبالغ التي يحصّلها مندوبونا عند الاستلام تذهب إلى محفظتك لدى DHB، تمامًا مثل الطلبات التي تحجزها في التطبيق.

الخطوة 6

الطلبات والتتبع والإلغاء

بعد تفعيل الطريقة، تصل الطلبات إلى DHB تلقائيًا. إليك طريقة متابعتها.

1. يُتمّ عميلك الشراء بطريقة توصيل مفعّلة، فتنشئ DHB التوصيلة في المرحلة التي اخترتها، مع اسم العميل وعنوانه وهاتفه وبريده الإلكتروني.
2. في التطبيق، افتح Orders لترى كل توصيلة، وحمّل ملصق الشحن، وافتح التتبع المباشر أو ألغِ الطلب.
3. تحتاج مساعدة في طلب؟ أرسل لنا رمز الطلب من قائمة Orders وسنجده فورًا.
4. لمزامنة الإلغاء، افتح Settings ← Order Cancellation وفعّل أحد الخيارين أو كليهما.

نصيحةيحتاج كل طلب إلى عنوان شحن كامل في Shopify، وإلا فلن يُرسل إلى DHB.

الخطوة 7

اربط نظامك الخاص عبر API

لموقعك أو تطبيقك أو نظام ERP أو نقاط البيع. يحجز مطوّرك توصيلات DHB ويقرأ حالتها مباشرة.

1. احصل على Client Id وClient Secret كما في الدليل الأول.
2. يطلب مطوّرك رمز وصول OAuth2 بهذه المفاتيح، ثم يتصل بواجهة DHB على https://rest.dhbahrain.bh.
3. اطلب منا عبر واتساب أو البريد الإلكتروني وثائق API وتجربة اختبارية قبل التشغيل الفعلي.

نصيحةيجب أن تبقى المفاتيح على خادمك. لا تضع Client Secret في تطبيق جوال أو في كود موقع يمكن للعملاء رؤيته.