الأدلة
التوفّر والأصناف النافدة
عندما ينفد صنف في فرع يختفي من الموقع والتطبيق لذلك الفرع خلال ثوانٍ، ويرفضه محرك التسعير.
سير العمل#
- الفرع ← نظامكنفد الصنف في الفرع
- نظامك ← ليتس بيتزاإيقاف الصنف في الفرع
PUT …/branches/{id}/availability - ليتس بيتزايختفي من الموقع والتطبيق
- ليتس بيتزا ← نظامكحدث 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 يعيد ما أوقفته أنت. | لحظة نفاد صنف أو عودته. |
{
"items": [
{
"kind": "product",
"id": "649",
"available": false
}
]
}{
"branchId": "28",
"off": 1,
"on": 0,
"keptStaff": 0,
"unknown": [],
"unavailable": [
{
"kind": "product",
"id": "649"
}
]
}مثال الحدث#
{
"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
}
]
}
}الطلبات المستخدمة#
ما يحمل «قريباً» ليس منشوراً بعد في الواجهة، ويُضاف إلى المرجع فور نشره.