> ## 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.

# Sipariş Akışı

> Son restoran siparişlerini raporlama, muhasebe veya teslimat sistemlerine aktarın.

Sipariş akışı, API anahtar çalışma alanına ilişkin son siparişleri döndürür.

Planlanmış dışa aktarmalar, basit raporlama senkronizasyonları ve muhasebe entegrasyonları için bunu kullanın.

## REST Talebi

```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"
```

## Sorgu Parametreleri

| Parametre | Tip   | Notlar                                                                 |
| --------- | ----- | ---------------------------------------------------------------------- |
| `apiKey`  | sicim | REST rotası için gereklidir.                                           |
| `date`    | sicim | İsteğe bağlı başlangıç ​​tarihi. Çalışma alanı saat dilimini kullanır. |
| `endDate` | sicim | İsteğe bağlı bitiş tarihi. Tarih aralıkları 5 günü aşamaz.             |

## İzinler

API anahtar rolünün ihtiyaçları:

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

## Cevap

```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"
    }
  ]
}
```

## Sınırlar

* Feed, istek başına en fazla 50 siparişi döndürür.
* Tarih aralıkları 5 günü aşamaz.
* REST rotası hız sınırlıdır. `429` alırsanız yeniden denemeden önce bekleyin.

## İyi Senkronizasyon Modeli

1. Feed'i bir programa göre çalıştırın.
2. Son başarılı tarih aralığını sisteminizde saklayın.
3. Küçük bir tarih aralığı çekin.
4. Siparişleri `id` ile artırın.
5. Mutabakat için ödeme kimliklerini saklayın.

Tarih pencerelerini seçerken çalışma alanı saat dilimini kullanın.