الأدلة
أساطيل التوصيل
المطبخ يملك الطلب حتى «جاهز»، والأسطول يملكه بعدها. ليتس بيتزا تربط الطرفين.
سير العمل#
- الفرع ← ليتس بيتزاالطلب جاهز
- ليتس بيتزا ← نظامكمهمة توصيل
order.ready - نظامك ← ليتس بيتزااستلم المندوب الطعام
status: out_for_delivery - نظامك ← ليتس بيتزاتم التوصيل (أو تعذّر بسبب)
status: delivered - نظامك ← ليتس بيتزاالمبلغ المحصّل عند الباب
POST …/events
القواعد#
- تبلغ حالات الطريق فقط: out_for_delivery · delivered · delivery_failed.
- «تعذّر التوصيل» يحمل سبباً: العميل لا يرد، أو العنوان خطأ، أو رفض الاستلام، أو حادث، أو غير ذلك.
- إلغاء المهمة لديك لا يلغي الطلب؛ يُنبَّه الفرع ليرتب بديلاً.
- بيانات العميل الكاملة (الاسم والجوال والعنوان) لا تصلك إلا لطلبات التوصيل التي تخصك.
الطلبات المستخدمة#
ما يحمل «قريباً» ليس منشوراً بعد في الواجهة، ويُضاف إلى المرجع فور نشره.
- GET
/partner/v1/ordersالطلبات الجديدة بالمؤشرorders:readمتاح - GET
/partner/v1/orders/{id}طلب واحد وحالتهorders:readمتاح - POST
/partner/v1/orders/{id}/statusإبلاغ حالةorders:statusمتاح - POST
/partner/v1/orders/{id}/eventsتسجيل واقعة على الطلبorders:eventsمتاح - GET
/partner/v1/orders/{id}/paymentsالدفع والتحصيل والردpayments:readمتاح