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

شحنة محلية (مسترجعة)

POST 
/auth/api/v1/orders/order-create

وش يعني طلب الإرجاع (Return Order)؟​

طلب الإرجاع هو عملية استلام شحنة من العميل النهائي وارجاعها لمستودع التاجر أو لأي موقع ثاني يتم تحديده.

تقدر من خلال هذي الواجهة تبدأ طلب إرجاع محلي عن طريق تزويدنا بتفاصيل الاستلام والإرجاع المطلوبة.

warning

واجهة API الخاصة بالإرجاع تدعم الطلبات المحلية فقط. ما تشتغل على الشحنات الدولية.

هالدليل يشرح لك خطوة بخطوة كيف تنشئ طلب إرجاع محلي باستخدام Return API.

⚠️ مهم: تأكد إنك ترسل اسم الموقع المسجل عند Logistiq في الحقل return_info_name.


حقول اختيارية لكنها مُوصى بها​

الحقول التالية مو إلزامية، لكن ننصح بشدة بإرسالها عشان تسهّل عملية الاستلام وتحسن تجربة العميل:

الحقلالغرض
customer_emailيُتيح تتبع الإرجاع وإرسال التحديثات للعميل.
customer_phoneيسهل إرسال إشعارات SMS وتنسيق الاستلام.
delivery_instructionsيساهم في رفع نسبة نجاح الاستلام من المحاولة الأولى.

💡 نصيحة: تضمين هذه الحقول يمكن أن يُحسن بشكل كبير من موثوقية العمليات ورضا العملاء.


الحقول الإلزامية للعنوان الوطني (وفق نظام السعودية)​

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

الحقلالغرض
customer_city (required)مدينة العميل.
customer_building_numberيحدد رقم المبنى أو الفيلا بدقة لضمان موقع التسليم الصحيح.
customer_street_nameيضمن تطابق العنوان مع هيكل العنوان الوطني الرسمي ويساعد في توجيه البريد/المندوب.
customer_postal_codeيحدد الحي أو المنطقة لتوجيه الشحنة بشكل صحيح إلى المنطقة المخصصة.
customer_zip_codeيوفر الرمز البريدي الرسمي المكوّن من 5 أرقام المطلوب وفق المعايير السعودية.
customer_additional_numberيدعم التحقق من العنوان ويساعد في تحديد نقطة التسليم بدقة داخل المبنى.
customer_unit_numberرقم الشقة أو المكتب لتجنب أي تعقيدات بين المندوب والعميل.
short_addressالعنوان المختصر للعنوان الوطني.

Short Address​

حقل اختياري: يمكن تضمينه في طلب حجز الشحنة عبر واجهة برمجة التطبيقات.

  • التنسيق: سلسلة مكونة من 8 أحرف وأرقام.
  • أول 4 أحرف يجب أن تكون حروفًا (A-Z، غير حساس لحالة الأحرف).
  • آخر 4 أحرف يجب أن تكون أرقامًا (0-9).
  • لا يُسمح باستخدام أي رموز خاصة.
  • لا يُسمح بوجود مسافات في أي مكان داخل القيمة.
  • سيتم تلقائيًا إزالة المسافات الزائدة في البداية والنهاية.

💡 نصيحة: تأكد من أن القيمة تطابق النمط AAAA9999 لضمان التحقق الناجح.

💡 ملاحظة: 🇸🇦 ملاحظة: ابتداءً من يناير 2025، يجب على شركات التوصيل في السعودية التحقق من العنوان الوطني الكامل وتخزينه. توفير هذه الحقول يقلّل بشكل كبير من التأخير، والشحنات الموجهة بشكل خاطئ، ومحاولات التسليم الفاشلة.


Responses​

Order created successfully or forwarded to workflow handler