Bestellungen
Einkaufsbestellungen mit Positionen, Artikelnummer und Lieferstatus — für Lieferantenprogramme und andere Server.
Liest die Bestellungen des Restaurants, das am API-Schlüssel hängt. Modul-ID im Schlüssel: purchase_orders. Das Modul ist beim Anlegen eines Schlüssels nicht vorausgewählt.
Anders als Speisekarte oder News muss das Restaurant dafür nicht veröffentlicht sein. Protokoll und Mitarbeiternamen sind nicht in der Antwort.
Methoden: GET, OPTIONS · Endpunkt: GET /api/v1/purchase-orders
Endpunkt
curl -s "https://gwada.app/api/v1/purchase-orders?status=ordered" \ -H "Authorization: Bearer gwada_sk_live_…" \ -H "Accept: application/json"
Query
| Parameter | Bedeutung |
|---|---|
| status | Optional. open, ordered, closed — kommagetrennt. Ohne Filter: alle. |
| supplierId | Optional. Nur dieser Lieferant. |
| id | Optional. Genau eine Bestellung, sonst 404 not_found. |
| limit | 1–100, Standard 50. Bei id ignoriert. |
| offset | Standard 0, höchstens 10000. |
Antwort (Auszug)
{
"data": {
"orders": [
{
"id": "po-1",
"supplierId": "sup-1",
"supplierName": "Großmarkt",
"status": "ordered",
"createdAt": "2026-09-18T08:00:00.000Z",
"statusUpdatedAt": "2026-09-18T09:12:00.000Z",
"deliveryDate": "2026-09-19",
"lines": [
{
"id": "line-1",
"ingredientId": "ing-1",
"articleNumber": "4711",
"name": "Tomaten",
"brand": "Hof Müller",
"quantity": 5,
"unit": "kg",
"deliveryStatus": null,
"deliveredQuantity": null,
"deliveredAt": null,
"deliveryNote": null
}
]
}
],
"limit": 50,
"offset": 0,
"total": 1
}
}Hinweise
- status ordered = an den Lieferanten gegeben, open = noch Entwurf, closed = abgeschlossen
- deliveryStatus: delivered, not_delivered, partial oder null
- Bestehende Schlüssel bekommen das Modul nicht von selbst — neuen Key anlegen und Bestellungen anhaken
- Schreiben (Status oder Lieferung zurückmelden) gibt es hier nicht
Fehler
Auth- und Limit-Fehler sind einheitlich — siehe Rate Limits & Fehler. Typisch: 401 invalid_api_key, 403 module_not_enabled, 403 restaurant_not_published, 404 not_found, 429 rate_limit_exceeded.