book2eat Supplier API

Listet die Standorte, für die der authentifizierte API-User freigeschaltet ist — damit lässt sich vorab prüfen, ob die eigene locationClientUid korrekt mit book2eat verknüpft ist, bevor ein Speiseplan gesendet wird. linked: false bedeutet, dass der Standort zwar freigeschaltet, aber noch keiner locationClientUid zugeordnet ist — in dem Fall bitte tech2solutions kontaktieren. active spiegelt das bestehende Aktiv-Flag der Einrichtung in book2eat: ist eine Einrichtung hier false, schlägt POST/PUT mit 422 UNKNOWN_LOCATION fehl, auch wenn linked: true ist — book2eat findet die deaktivierte Einrichtung über locationClientUid dann nicht mehr.

[
  {
    "canteen_ID": 271,
    "canteenName": "Kindergarten Obersulz",
    "locationClientUid": "130669",
    "locationId": "642",
    "active": true,
    "linked": true
  }
]

Listet die für diesen Standort in book2eat gepflegten Menülinien-Mappings (menuLines[].id → book2eat-Menütyp inkl. aktuellem Preis/USt.) — damit lässt sich vorab prüfen, ob eine ADAM-Menülinie korrekt verknüpft ist, bevor ein Speiseplan gesendet wird. Fehlt eine extLineId hier, liefert POST/PUT für genau diese Linie später 422 UNKNOWN_MENU_LINE — in dem Fall bitte tech2solutions kontaktieren, damit die Zuordnung ergänzt wird.

[
  {
    "extLineId": "4056",
    "lineName": "Tagessuppe",
    "typ_ID": 1,
    "name": "Suppe",
    "standard_price": "3.50",
    "vat": "10.00"
  },
  {
    "extLineId": "4057",
    "lineName": "Hauptspeise",
    "typ_ID": 2,
    "name": "Hauptgericht",
    "standard_price": "8.90",
    "vat": "10.00"
  }
]

Legt einen Wochenspeiseplan an. Die Speiseplan-ID (id) sowie alle menuItem-IDs sind die IDs des sendenden Systems und bleiben in allen weiteren Requests die Referenz. Da es sich um einen neuen Speiseplan handelt, existieren noch keine Bestellungen dazu — es wird keine Benachrichtigung verschickt.

{
  "id": "717304",
  "locationId": "642",
  "locationName": "Kindergarten Obersulz",
  "locationClientUid": "130669",
  "week": "17",
  "year": "2026",
  "startDate": "2026-04-20",
  "endDate": "2026-04-26",
  "orderDeadline": "2026-04-06 23:59:59",
  "menuLines": [
    {
      "id": "4056",
      "name": "Tagessuppe",
      "minOrderQuantity": "0",
      "menuItems": [
        {
          "id": "15323144",
          "name": "Klare Hühnersuppe mit Reibteig",
          "date": "2026-04-20",
          "isExtraMenu": false,
          "allergens": ["A", "C"],
          "additives": [],
          "attributes": ["enthält Gluten"],
          "nutritionValues": { "kJ": 203, "kcal": 49 }
        }
      ]
    }
  ]
}

{ "id": "717304", "status": "created", "itemsImported": 10 }

Existiert die Speiseplan-ID bereits, antwortet die API mit 409 Conflict — Änderungen laufen über PUT.

Liefert den aktuell in book2eat hinterlegten Stand des Speiseplans {id} — Name, Datum, Allergene und Deadlines je menuItem, so wie sie aktuell gespeichert sind (nicht zwingend identisch mit dem ursprünglich gesendeten Payload, falls es zwischenzeitlich Änderungen gab). additives, attributes und nutritionValues werden von book2eat nicht gespeichert und sind daher hier nicht enthalten.

{
  "id": "717304",
  "locationClientUid": "130669",
  "week": 17,
  "year": 2026,
  "startDate": "2026-04-20",
  "endDate": "2026-04-26",
  "menuLines": [
    {
      "id": "4056",
      "name": "Tagessuppe",
      "menuItems": [
        {
          "id": 15323144,
          "name": "Klare Hühnersuppe mit Reibteig",
          "date": "2026-04-20",
          "allergens": ["A", "C"],
          "orderDeadline": "2026-04-06 23:59:59",
          "cancelDeadline": "2026-04-13 23:59:59",
          "orderDeadlinePassed": true,
          "cancelDeadlinePassed": true,
          "final": true
        }
      ]
    }
  ]
}

Liefert die Bestellzahlen je menuItem für den Speiseplan {id}. Einträge ohne Bestellungen werden mit quantity: 0 ausgegeben. final zeigt an, ob die Zahl schon endgültig ist — also sowohl orderDeadline als auch cancelDeadline bereits verstrichen sind und sich die Bestellzahl nicht mehr ändern kann.

[
  {
    "id": 15323144,
    "date": "2026-04-20",
    "quantity": 15,
    "orderDeadline": "2026-04-06 23:59:59",
    "cancelDeadline": "2026-04-13 23:59:59",
    "orderDeadlinePassed": true,
    "cancelDeadlinePassed": true,
    "final": true
  }
]

Liefert Bestellzahlen kantinenweit über mehrere Speisepläne hinweg — wahlweise für eine ganze Woche oder einen freien Datumsbereich, ohne dass die einzelne Speiseplan-ID bekannt sein muss. Erfordert locationClientUid sowie entweder week+year oder from+to (YYYY-MM-DD) als Query-Parameter. planId im Ergebnis verweist auf die zugehörige Speiseplan-ID.

curl -u benutzername:passwort \
  "https://supplier-api.book2eat.eu/v1/menus/quantities?locationClientUid=130669&week=17&year=2026"

curl -u benutzername:passwort \
  "https://supplier-api.book2eat.eu/v1/menus/quantities?locationClientUid=130669&from=2026-04-20&to=2026-04-26"

[
  {
    "id": 15323144,
    "planId": "717304",
    "date": "2026-04-20",
    "quantity": 15,
    "orderDeadline": "2026-04-06 23:59:59",
    "cancelDeadline": "2026-04-13 23:59:59",
    "orderDeadlinePassed": true,
    "cancelDeadlinePassed": true,
    "final": true
  }
]

Ersetzt den Speiseplan durch den mitgeschickten Body (gleiche Struktur wie POST). Neue Einträge werden angelegt, bestehende (gleiche menuItem-ID) aktualisiert. Einträge, die im Body fehlen, werden entfernt — vorhandene Bestellungen dazu werden storniert. menuItems, die bereits final sind (siehe oben), bleiben unangetastet — weder Änderung noch Entfernung — und zählen in der Antwort als protected. Der restliche Speiseplan wird ganz normal verarbeitet.

{ "id": "717304", "status": "replaced", "created": 1, "updated": 8, "removed": 1, "protected": 0, "cancelledOrders": 12 }

Detailänderung eines einzelnen Speiseplaneintrags — z. B. Komponententausch oder geändertes Bestellende. Erlaubte Felder: name, date, allergens, orderDeadline, cancelDeadline, price (optional). Nur mitgeschickte Felder werden geändert. Besteller mit einer aktiven Bestellung für diesen Eintrag werden automatisch von book2eat per E-Mail benachrichtigt. Ist das Item bereits final, antwortet die API mit 409 ITEM_LOCKED.

{
  "name": "Kürbiscremesuppe mit Kernöl",
  "allergens": ["G"],
  "orderDeadline": "2026-04-08 23:59:59"
}

{ "id": "15323144", "status": "updated" }

Löscht den kompletten Speiseplan. Alle offenen Bestellungen werden storniert. Bereits finale menuItems (siehe oben) werden dabei übersprungen statt gelöscht/storniert und zählen in der Antwort als protected.

{ "id": "717304", "deleted": true, "items": 9, "protected": 1, "cancelledOrders": 33 }

Löscht einen einzelnen Speiseplaneintrag inklusive Storno der zugehörigen Bestellungen. Besteller mit einer aktiven Bestellung für diesen Eintrag werden automatisch von book2eat per E-Mail benachrichtigt. Ist das Item bereits final, antwortet die API mit 409 ITEM_LOCKED.

{ "id": "15323144", "deleted": true, "cancelledOrders": 4 }

Ohne Authentifizierung erreichbar, für Monitoring.

{ "status": "ok", "db": "ok", "time": "2026-07-14T09:00:00.000Z" }