Ana içeriğe atla
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.

SDK Talep

const feed = await plato.v1.orders.externalOrderFeed.query({
  apiKey: process.env.PLATO_API_KEY!,
  date: "2026-06-17",
  endDate: "2026-06-19",
});

REST Talebi

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

Sorgu Parametreleri

ParametreTipNotlar
apiKeysicimREST rotası için gereklidir.
datesicimİsteğe bağlı başlangıç ​​tarihi. Çalışma alanı saat dilimini kullanır.
endDatesicimİsteğe bağlı bitiş tarihi. Tarih aralıkları 5 günü aşamaz.

İzinler

API anahtar rolünün ihtiyaçları:
restaurant:order:read

Cevap

{
  "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.