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

الطلبات

POST /orders يقبل مهام التوصيل بشكل غير متزامن. Lynq تُرجع 202 Accepted مع ULID الطلب.

طلب التقاط واحد​

الحقول الأساسية:

  • pickup / dropoff مع lat، lng، short_address
  • dropoff يتطلب contact_name وcontact_phone
  • quote_id اختياري من عروض الأسعار
  • partner_order_number اختياري لمرجع OMS

عدم التكرار (Idempotency)​

إعادة استخدام نفس partner_order_number تُرجع الطلب الحالي بدل إنشاء م duplicate. احفظ ULID Lynq كمعرّف أساسي.

حالة الطلب​

استطلع GET /orders/\{order_id\} أو اعتمد على webhooks:

الحالةالمعنى
pendingمُرسَل / بانتظار التعيين
confirmedتم تعيين مندوب
picked_upتم الالتقاط
in_transitفي الطريق
deliveredمُسلّم
cancelledملغى
returnedمُرتجع
rejectedمرفوض

قيم type في webhook تصف الأحداث — اقرأ data.object.status لحالة دورة الحياة.

الإلغاء​

استخدم نقطة الإلغاء في مرجع API. توقّع 409 Conflict عندما لا يُسمح بالإلغاء.

ذات صلة​