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

# Flux de commandes

> Intégrez les commandes récentes des restaurants dans les systèmes de reporting, de comptabilité ou de livraison.

Le flux de commandes renvoie les commandes récentes pour l’espace de travail clé API.

Utilisez-le pour les exportations planifiées, les synchronisations de rapports légères et les intégrations comptables.

## Demande REST

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

## Paramètres de requête

| Paramètre | Taper  | Remarques                                                                     |
| --------- | ------ | ----------------------------------------------------------------------------- |
| `apiKey`  | chaîne | Requis pour la route REST.                                                    |
| `date`    | chaîne | Date de début facultative. Utilise le fuseau horaire de l’espace de travail.  |
| `endDate` | chaîne | Date de fin facultative. Les plages de dates ne peuvent pas dépasser 5 jours. |

## Autorisations

Le rôle clé API doit :

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

## Réponse

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

## Limites

* Le flux renvoie jusqu'à 50 commandes par demande.
* Les plages de dates ne peuvent pas dépasser 5 jours.
* L'itinéraire REST est à tarif limité. Si vous recevez `429`, attendez avant de réessayer.

## Bon modèle de synchronisation

1. Exécutez le flux selon un calendrier.
2. Stockez la dernière plage de dates réussie dans votre système.
3. Tirez une petite plage de dates.
4. Insérer les commandes par `id`.
5. Conservez les identifiants de paiement pour le rapprochement.

Utilisez le fuseau horaire de l’espace de travail lors du choix des fenêtres de date.