مطوّرو ليتس بيتزاv1.0.0

الأدلة

إبلاغ حالات الطلب

كل حالة تبلغها تنقل الطلب في آلة الحالات، وتُخطر العميل، وتخبر شركة التوصيل أن الطعام جاهز.

سير العمل#

  1. نظامك ← ليتس بيتزاقبول (مع وقت الجاهزية المتوقع)status: accepted
  2. ليتس بيتزا ← العميل«تم قبول طلبك»
  3. نظامك ← ليتس بيتزابدأ التحضيرstatus: preparing
  4. نظامك ← ليتس بيتزاجاهزstatus: ready
  5. ليتس بيتزا ← العميل«طلبك جاهز» والمندوب في الطريق إلى الفرع

الحالات المسموحة#

حالات المطبخ: accepted · rejected · preparing · ready · picked_up · cancelled. حالات الطريق: out_for_delivery · delivered · delivery_failed.

ما يحق لنظامك منها في settings.orders.statuses. القواعد الكاملة في دورة حياة الطلب.

معرّف الحدث#

كل تغيير حالة يحمل معرّفاً من نظامك. المعرّف نفسه مرتين يُطبّق مرة واحدة، والأحداث قد تصل بغير ترتيب فنعتمد على وقت وقوعها لا وقت وصولها.

POST /partner/v1/orders/{id}/status · PartnerStatusRequest
{
  "eventId": "BC-EVT-000985",
  "to": "preparing",
  "expectedFrom": "accepted",
  "occurredAt": "2026-11-19T19:35:02+03:00",
  "estimatedReadyAt": "2026-11-19T19:50:00+03:00"
}
200 · PartnerStatusResult
{
  "outcome": "applied",
  "status": "preparing",
  "reason": null
}

outcome: applied طُبّقت، duplicate سبق تطبيقها، ignored متأخرة أو مكررة فتُجوهلت، parked بانتظار قرار شخص (مثل إلغاء بعد بدء المطبخ).

الرفض والإلغاء#

  • الرفض والإلغاء يحملان سبباً. قبل بدء المطبخ يُطبّقان فوراً ويُرد المبلغ المدفوع إلكترونياً.
  • بعد بدء المطبخ يصل الإلغاء إلى مدير الفرع ليؤكده بسبب، لأن الطلب قد يكون مع المندوب.

الطلبات المستخدمة#

ما يحمل «قريباً» ليس منشوراً بعد في الواجهة، ويُضاف إلى المرجع فور نشره.