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 locationId korrekt mit book2eat verknüpft ist, bevor ein Speiseplan gesendet wird. linked: false bedeutet, dass der Standort zwar freigeschaltet, aber noch keiner locationId 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 locationId dann nicht mehr.

[
  {
    "canteen_ID": 271,
    "canteenName": "Kindergarten Obersulz",
    "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.

Die Liste zeigt außerdem, wie book2eat die jeweilige Linie behandelt: ob ein mitgeschickter Preis überhaupt übernommen wird und ob die Linie Bestandteil eines Gesamtmenüs ist. Damit lässt sich ein unerwarteter Preis im Bestellsystem hier nachvollziehen, ohne nachfragen zu müssen.

[
  {
    "extLineId": "4056",
    "lineName": "Tagessuppe",
    "typ_ID": 1,
    "name": "Suppe",
    "standard_price": "0.00",
    "vat": 10,
    "component_price_mode": "menu_only",
    "component_quantity_mode": "sum_of_menus",
    "part_of_typ_IDs": [2, 3],
    "supplier_price_use": true,
    "supplier_price_is_net": true
  },
  {
    "extLineId": "4057",
    "lineName": "Hauptspeise",
    "typ_ID": 2,
    "name": "Hauptgericht",
    "standard_price": "8.90",
    "vat": 10,
    "component_price_mode": "sum",
    "component_quantity_mode": "sum_of_menus",
    "part_of_typ_IDs": [],
    "supplier_price_use": true,
    "supplier_price_is_net": true
  },
  {
    "extLineId": "4058",
    "lineName": "Alternativmenü",
    "typ_ID": 3,
    "name": "Alternativmenü",
    "standard_price": "8.90",
    "vat": 10,
    "component_price_mode": "sum",
    "component_quantity_mode": "sum_of_menus",
    "part_of_typ_IDs": [],
    "supplier_price_use": true,
    "supplier_price_is_net": true
  }
]

Im Beispiel ist die Tagessuppe Bestandteil beider Menüs (part_of_typ_IDs: [2, 3]): Sie wird nicht einzeln bestellt, kostet nichts extra, und als Bestellmenge wird ihr die Summe aus Hauptspeise und Alternativmenü gemeldet.

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",
  "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"],
          "price": 3.50,
          "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; der Preis ist ebenfalls nicht Teil der Antwort.

{
  "id": "717304",
  "locationId": "642",
  "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. Für Bestandteile eines Gesamtmenüs wird die Summe der zugeordneten Menüs desselben Tages gemeldet (bzw. bei component_quantity_mode: own_orders die eigenen Bestellungen der Linie). 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 locationId 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?locationId=642&week=17&year=2026"

curl -u benutzername:passwort \
  "https://supplier-api.book2eat.eu/v1/menus/quantities?locationId=642&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 }

Fügt einem bestehenden Speiseplan ein einzelnes neues menuItem hinzu — Alternative zu PUT auf den ganzen Plan, wenn nur ein einzelner Eintrag dazukommt (z. B. nachträglich ergänztes Angebot für einen Tag), statt den kompletten Speiseplan erneut zu senden.

Pflichtfelder: menuLineId (die bestehende Menülinie, der das Item zugeordnet wird — muss für den Standort bereits über ein Menülinien-Mapping verknüpft sein), id, name, date (muss innerhalb der Speiseplanwoche liegen). Optional: menuLineName, isExtraMenu, allergens, additives, attributes, orderDeadline, cancelDeadline, price (nur bei freigeschalteter Preisübernahme), nutritionValues. Wie bei POST /v1/menus muss die menuItem-ID global eindeutig sein — sonst 409 ITEM_ID_EXISTS.

{
  "menuLineId": "2120",
  "menuLineName": "Tagessuppe",
  "id": "15323199",
  "name": "Kürbiscremesuppe mit Kernöl",
  "date": "2026-04-25",
  "allergens": ["G"],
  "orderDeadline": "2026-04-11 23:59:59"
}

{ "id": "15323199", "status": "created" }

Detailänderung eines einzelnen Speiseplaneintrags — z. B. Komponententausch oder geändertes Bestellende. Erlaubte Felder: name, date, allergens, orderDeadline, cancelDeadline, price (optional, nur bei freigeschalteter Preisübernahme). Nur mitgeschickte Felder werden geändert — fehlt price, bleibt der zuletzt gesendete Preis bestehen. 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" }