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

الأدلة

التوفّر والأصناف النافدة

عندما ينفد صنف في فرع يختفي من الموقع والتطبيق لذلك الفرع خلال ثوانٍ، ويرفضه محرك التسعير.

سير العمل#

  1. الفرع ← نظامكنفد الصنف في الفرع
  2. نظامك ← ليتس بيتزاإيقاف الصنف في الفرعPUT …/branches/{id}/availability
  3. ليتس بيتزايختفي من الموقع والتطبيق
  4. ليتس بيتزا ← نظامكحدث availability.changed للمشتركينavailability.changed

القواعد#

  • إيقاف الموظفين يغلب دائماً: الصنف غير متاح إذا أوقفه نظامك أو أوقفه موظفو الفرع، ولا يزيل نظامك إيقافاً وضعه الموظفون (يُعدّ في keptStaff).
  • تشير إلى الصنف بمعرّفنا (id) أو برمزك (code، ومعه variant عند الحاجة). الرمز غير المربوط يعود في unknown ولا يُطبَّق.
  • لا يُطبَّق توفّرك إلا إذا كانت settings.availability تساوي true (وإلا 403 AVAILABILITY_NOT_ENABLED)، وفي فرع مفعّل لنظامك (وإلا 409 BRANCH_NOT_LIVE).
  • يصل التغيير إلى الموقع والتطبيق فوراً. الطلب المؤكد قبله لا يتأثر؛ يتبع الفرع تعليمات العميل عند عدم التوفّر.

القائمة الكاملة أو التغييرات#

الطلبما يعنيهمتى تستخدمه
PUTالقائمة الكاملة لما نفد في الفرع الآن. ما أوقفه نظامك سابقاً ولم تذكره يعود متاحاً.مزامنة دورية، أو بعد إعادة تشغيل نظامك.
PATCHالأصناف المذكورة فقط: available: false يوقف، وtrue يعيد ما أوقفته أنت.لحظة نفاد صنف أو عودته.
PATCH /partner/v1/branches/{id}/availability · PartnerAvailabilityRequest
{
  "items": [
    {
      "kind": "product",
      "id": "649",
      "available": false
    }
  ]
}
200 · PartnerAvailabilityResult
{
  "branchId": "28",
  "off": 1,
  "on": 0,
  "keptStaff": 0,
  "unknown": [],
  "unavailable": [
    {
      "kind": "product",
      "id": "649"
    }
  ]
}

مثال الحدث#

availability.changed
{
  "version": 1,
  "id": "2219.availability.changed",
  "type": "availability.changed",
  "occurredAt": "2026-10-31T10:05:00.000Z",
  "branchId": "28",
  "data": {
    "branch": {
      "id": "28",
      "names": {
        "ar": "التخصصي",
        "en": "At Takhassusi"
      }
    },
    "changes": [
      {
        "kind": "product",
        "itemId": "649",
        "available": false
      }
    ]
  }
}

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

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