> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plato.ae/llms.txt
> Use this file to discover all available pages before exploring further.

# تغذية الطلبات

> اسحب طلبات المطاعم الأخيرة إلى أنظمة إعداد التقارير أو المحاسبة أو التسليم.

يقوم موجز الطلب بإرجاع الطلبات الأخيرة لمساحة العمل الرئيسية API.

استخدمه لعمليات التصدير المجدولة ومزامنة التقارير خفيفة الوزن وعمليات التكامل المحاسبية.

## طلب الراحة

```text theme={null}
GET /api/v1/orders/external-feed
```

```bash theme={null}
curl "https://api.plato.ae/api/v1/orders/external-feed?apiKey=$PLATO_API_KEY&date=2026-06-17"
```

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

| المعلمة   | يكتب | ملحوظات                                                              |
| --------- | ---- | -------------------------------------------------------------------- |
| `apiKey`  | خيط  | مطلوب لطريق REST.                                                    |
| `date`    | خيط  | تاريخ البدء الاختياري. يستخدم المنطقة الزمنية لمساحة العمل.          |
| `endDate` | خيط  | تاريخ الانتهاء الاختياري. لا يمكن أن تتجاوز النطاقات الزمنية 5 أيام. |

## الأذونات

يحتاج الدور الرئيسي API إلى:

```text theme={null}
restaurant:order:read
```

## إجابة

```json theme={null}
{
  "count": 2,
  "workspaceId": "workspace_123",
  "data": [
    {
      "id": "order_123",
      "referenceNumber": 1042,
      "status": "COMPLETED",
      "subTotal": 120,
      "vatAmount": 6,
      "promoCodeDiscount": 0,
      "discount": 0,
      "totalPriceWithoutDiscount": 126,
      "totalWithoutCharges": 126,
      "totalPrice": 126,
      "chargesDiscountable": [],
      "chargesNonDiscountable": [],
      "payments": [
        {
          "id": "payment_123",
          "type": "SALE",
          "method": "CARD",
          "totalAmount": 126,
          "currency": "AED",
          "status": "PAID",
          "refundMetadata": null
        }
      ],
      "createdAt": "2026-06-17T08:20:00.000Z"
    }
  ]
}
```

## حدود

* تعرض الخلاصة ما يصل إلى 50 طلبًا لكل طلب.
* لا يمكن أن تتجاوز النطاقات الزمنية 5 أيام.
* مسار REST محدود السعر. إذا تلقيت `429`، فانتظر قبل إعادة المحاولة.

## نمط مزامنة جيد

1. قم بتشغيل الخلاصة وفقًا لجدول زمني.
2. قم بتخزين آخر نطاق زمني ناجح في نظامك.
3. اسحب نطاقًا زمنيًا صغيرًا.
4. رفع الطلبات بواسطة `id`.
5. احتفظ بمعرفات الدفع للتسوية.

استخدم المنطقة الزمنية لمساحة العمل عند اختيار نوافذ التاريخ.