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

شحنة محلية (مرسلة)

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

ما هي الشحنة المُرسلة (Forward)؟​

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

تدعم هذه الواجهة الشحنات المحلية والدولية — ويتم تحديد ذلك من خلال قيم مثل customer_country_code في ال (Payload) الخاصة بك.

يركز هذا الدليل على إرسال طلب شحنة محلية.

⚠️ مهم: يجب استخدام اسم الموقع المسجل لدى Logistiq في الحقلين pickup_info_name و 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