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

الأدلة

المطابقة اليومية

كل يوم، بعد إغلاق اليوم التشغيلي، قارن ما سجله نظامك بما لدينا. الفرق يكشف طلباً لم يصل أو سعراً تغيّر في طرف دون الآخر.

سير العمل#

  1. نظامك ← ليتس بيتزايوم أمس لكل فرع كما نعدّهGET /partner/v1/reports/daily?date=…
  2. ليتس بيتزا ← نظامكالعدد والمخدوم والمنتهي والمفتوح والمبالغ والطلبات المخدومة
  3. نظامك ← ليتس بيتزاعدّك أنت للمقارنةPOST /partner/v1/reports/reconciliation
  4. ليتس بيتزا ← نظامكتطابق أم لا، والأرقام الناقصة والزائدة

تقرير اليوم#

طلباتك التي أُنشئت في يوم بتوقيت الرياض (من 00:00 إلى 24:00 بفارق ‎+03:00) في الفروع التي يراها مفتاحك. لكل فرع: عدد الطلبات، والمخدوم منها (تم التوصيل أو الاستلام)، وما انتهى دون خدمة، وما زال مفتوحاً، ومجموع المخدوم والمسترد بالهللة شاملة الضريبة؛ ومعها الطلبات المخدومة بأرقامك. حدّد اليوم بـ date والفرع بـ branchId.

200 · PartnerDailyReport
{
  "date": "string",
  "branches": [
    {
      "branchId": "28",
      "externalCode": "STORE-28",
      "orders": 0,
      "served": 0,
      "ended": 0,
      "open": 0,
      "servedTotal": 0,
      "refunded": 0
    }
  ],
  "orders": [
    {
      "orderId": "7f3a2c10-5b8e-4d21-9c47-1a2b3c4d5e01",
      "number": "261119-0041",
      "branchId": "28",
      "status": "pending_payment",
      "total": 0,
      "externalOrderNo": "string",
      "createdAt": "2026-11-19T19:30:12+03:00"
    }
  ]
}

المقارنة#

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

POST /partner/v1/reports/reconciliation · PartnerReconciliationRequest
{
  "date": "string",
  "branches": [
    {
      "branchId": "28",
      "served": 0,
      "servedTotal": 0,
      "externalOrderNos": [
        "string"
      ]
    }
  ]
}
200 · PartnerReconciliation
{
  "date": "string",
  "matched": true,
  "branches": [
    {
      "branchId": "28",
      "ours": {
        "served": 0,
        "servedTotal": 0
      },
      "theirs": {
        "served": 0,
        "servedTotal": 0
      },
      "matched": true,
      "missingAtPartner": [
        "string"
      ],
      "unknownAtLp": [
        "string"
      ]
    }
  ]
}

متى تشغّلها#

الأيام بتوقيت الرياض. شغّل المطابقة كل صباح بعد الساعة 04:00 لليوم السابق، حتى تكتمل الطلبات المتأخرة ليلاً. والفرق يكشف طلباً لم يصل إلى نظامك أو سعراً تغيّر في طرف دون الآخر.

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

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