شحنة دولية (مرسلة)
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 | يساعد على ضمان نجاح التوصيل في الميل الأخير في بلد الوجهة. |
Responses
- 200
- 400
Order created successfully or forwarded to workflow handler
Validation error or order processing failure