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

الأدلة

استلام الطلبات بالسحب

أبسط طريقة: لا تحتاج إلى عنوان عام ولا إلى استقبال اتصالات. مناسبة لنقاط البيع وشاشات المطبخ خلف جدار حماية. تعمل عندما تكون settings.orders.delivery تساوي pull.

سير العمل#

  1. العميل ← ليتس بيتزايؤكد الطلب ويدفع
  2. ليتس بيتزاالطلب placed ينتظر تأكيدك
  3. نظامك ← ليتس بيتزاهل من جديد؟GET /partner/v1/orders?cursor=…
  4. ليتس بيتزا ← نظامكالطلبات ومؤشر الصفحة التالية
  5. نظامك ← ليتس بيتزاوصلني، ورقمي له كذاPOST /partner/v1/orders/{id}/ack
  6. نظامك ← ليتس بيتزاقبول ثم تحضير ثم جاهزPOST /partner/v1/orders/{id}/status

حلقة السحب#

  1. اطلب الطلبات بالمؤشر المحفوظ لديك (أول مرة بلا مؤشر).
  2. احفظ كل طلب في نظامك داخل معاملة واحدة مع المؤشر الجديد.
  3. أكد استلام كل طلب. الطلب الذي لم يُؤكد يعود في السحب التالي.
  4. إذا كانت nextCursor غير null فاسحب فوراً، وإلا فانتظر بضع ثوانٍ.
Node.js
let cursor = await store.loadCursor();
for (;;) {
  const res = await fetch(`${process.env.LP_BASE_URL}/partner/v1/orders${cursor ? `?cursor=${cursor}` : ''}`, {
    headers: { Authorization: `Bearer ${process.env.LP_API_KEY}` },
  });
  if (res.status === 429) { await sleep(Number(res.headers.get('retry-after') ?? 5) * 1000); continue; }
  const page = await res.json();
  for (const item of page.items) {
    await store.saveOrder(item.order);       // idempotent on item.order.id
    await ack(item.order.id);                // POST /partner/v1/orders/{id}/ack
  }
  if (page.nextCursor) { cursor = page.nextCursor; await store.saveCursor(cursor); continue; }
  await sleep(5000);
}

تأكيد الاستلام#

التأكيد يعني أن الطلب صار في نظامك. أرسل رقمك له إن وُجد ليظهر لموظفي الفرع. إذا لم يُؤكد الطلب خلال settings.orders.ackMinutes دقيقة يُنبَّه الفرع ليتعامل معه من لوحتنا.

شكل الطلب#

كل عنصر في الصفحة يحمل order (الطلب نفسه)، وstate (بانتظار التأكيد أو مؤكد أو مغلق)، وموعد التأكيد ackDueAt، ورقمك له بعد التأكيد. الشكل الكامل في النماذج.

وهذا order لطلب حقيقي التسعير من فرع التخصصي: مارقريتا كبيرة عدد 2 مع صلصة طماطم، وعلبتا كولا، توصيل، ودفع نقدي عند الباب. المبالغ بالهللة.

Order
{
  "id": "7f3a2c10-5b8e-4d21-9c47-1a2b3c4d5e01",
  "number": "261119-0041",
  "status": "placed",
  "channel": "app",
  "branchId": "28",
  "fulfilment": "delivery",
  "paymentMethod": "cash_on_delivery",
  "catalogVersion": "taker-2026-10-06.5d01b76bc1",
  "lines": [
    {
      "lineIndex": 0,
      "line": {
        "productId": "649",
        "qty": 2,
        "selections": [
          {
            "groupId": "1362",
            "optionId": "11836",
            "qty": 1
          }
        ],
        "source": {
          "experience": "classic"
        }
      },
      "unitPrice": 4200,
      "lineTotal": 8400,
      "snapshot": {
        "names": {
          "ar": "مارقريتا",
          "en": "Margherita Pizza"
        },
        "options": [
          {
            "groupId": "1362",
            "optionId": "11836",
            "names": {
              "ar": "صلصة طماطم",
              "en": "Tomato Sauce"
            },
            "qty": 1,
            "price": 0
          }
        ]
      }
    },
    {
      "lineIndex": 1,
      "line": {
        "productId": "740",
        "qty": 2,
        "selections": [],
        "source": {
          "experience": "classic"
        }
      },
      "unitPrice": 600,
      "lineTotal": 1200,
      "snapshot": {
        "names": {
          "ar": "كولا",
          "en": "Coca Cola Can"
        },
        "options": []
      }
    }
  ],
  "subtotal": 9600,
  "discounts": [],
  "discountTotal": 0,
  "deliveryFee": 1800,
  "total": 11400,
  "vat": {
    "rateBps": 1500,
    "amount": 1487,
    "includesDeliveryFee": true
  },
  "cutlery": false,
  "ifUnavailable": "call",
  "delivery": {
    "address": "حي المعذر الشمالي، شارع الأمير سلطان، عمارة 14",
    "details": "الدور الثاني، شقة 5، بجوار الصيدلية",
    "location": {
      "lat": 24.6921,
      "lng": 46.6853
    },
    "contactName": "عبدالله",
    "contactPhone": "+966500000000"
  },
  "createdAt": "2026-11-19T19:30:12+03:00",
  "history": [
    {
      "from": null,
      "to": "placed",
      "at": "2026-11-19T19:30:12+03:00",
      "actor": "customer"
    }
  ]
}

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

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