← gwada.app

Dokumentation

Anmelden

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

ParameterBedeutung
statusOptional. open, ordered, closed — kommagetrennt. Ohne Filter: alle.
supplierIdOptional. Nur dieser Lieferant.
idOptional. Genau eine Bestellung, sonst 404 not_found.
limit1–100, Standard 50. Bei id ignoriert.
offsetStandard 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.

Weiterlesen