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

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

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

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

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

الواجهة هذي تدعم الشحنات المحلية والدولية — ويعتمد التحديد على القيم اللي ترسلها مثل customer_country_code في الحمولة (Payload).

هذا الدليل يركّز على طريقة حجز طلب إرسال دولي.

⚠️ مهم: لازم تستخدم اسم الموقع المسجل عند Logistiq في الحقلين pickup_info_name و return_info_name.


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

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

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

Short Address​

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

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

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

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

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


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

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


Responses​

Order created successfully or forwarded to workflow handler