واجهة الطلبات

قائمة الطلبات

GET /api/v1/orders

معاملات الاستعلام

المعامل	النوع	الافتراضي	الوصف
limit	integer	50	عدد العناصر في الصفحة (1-200)
cursor	string	—	طابع زمني ISO للتصفح
status	string	—	تصفية حسب الحالة
source	string	—	تصفية حسب المصدر (pos أو online)
since	string	—	الطلبات المنشأة بعد هذا التاريخ بتنسيق ISO فقط

الاستجابة

{
  "data": [
    {
      "id": "order-uuid-1",
      "source": "online",
      "status": "pending",
      "payment_status": "paid",
      "payment_method": "card",
      "customer_name": "Ahmed Mohamed",
      "customer_phone": "+218912345678",
      "subtotal": 75.00,
      "discount": 5.00,
      "delivery_fee": 10.00,
      "total": 80.00,
      "items": [
        {
          "product_name": "Premium Arabic Coffee",
          "variant_name": "250g",
          "quantity": 3,
          "unit_price": 25.00,
          "total": 75.00
        }
      ],
      "last_modified": "2026-04-20T14:35:00Z"
    }
  ]
}

جلب طلب واحد

GET /api/v1/orders/:id

التصدير بالجملة

GET /api/v1/orders/export

نفس تنسيق NDJSON المستخدم في تصدير المنتجات.

حالات الطلب

الحالة	الوصف
pending	طلب جديد في انتظار المعالجة
processing	قيد التحضير
preparing	مطعم/طعام: قيد الطبخ
ready	جاهز للاستلام/التوصيل
shipped	تم الشحن إلى العميل
delivered	تم تأكيد التوصيل
completed	مكتمل بالكامل
cancelled	ملغي
refunded	مسترجع

حالات الدفع

الحالة	الوصف
pending	في انتظار الدفع
paid	تم تأكيد الدفع
failed	فشل الدفع
expired	انتهت مهلة الدفع