API fuer Kassensysteme & Partner

Partner-Planung

FoodBestellen.de POS-Integrations-API

FoodBestellen.de bereitet einen oeffentlichen Integrationsstandard fuer Kassensysteme, Restaurant-Software und technische Partner vor. Die API ist als partnerorientierte Schnittstelle geplant und richtet sich an Anbieter, die Restaurantbestellungen sicher, mandantensauber und DSGVO-bewusst verarbeiten muessen.

Die erste Pilotintegration wurde mit WinOrder praktisch erprobt. Weitere Integrationen werden erst nach klarer technischer Freigabe und dokumentierter Schnittstellenstabilitaet oeffentlich erweitert.

Fuer wen ist die API gedacht?

Integrationsmodelle

• Polling API als verpflichtende Kompatibilitaetsbasis fuer v1.
• Webhook-Modell als optionale moderne Erweiterung fuer geeignete Partner.
• Realtime per WebSocket oder SSE erst in einer spaeteren API-Version, nicht in v1.

Was kann die API spaeter unterstuetzen?

• Neue Bestellungen abrufen.
• Bestellungen bestaetigen und den Empfang quittieren.
• Zubereitungszeit oder ETA an FoodBestellen.de uebermitteln.
• Status wie angenommen oder in Vorbereitung aktualisieren.
• Ablehnen oder stornieren erst nach klarer fachlicher Freigabe und dokumentierter Semantik.
• Menueabruf spaeter optional, wenn ein strukturierter Bedarf pro Partner nachgewiesen ist.

Sicherheit

Der Zugriff ist nicht oeffentlich. Jede Integration arbeitet spaeter mit restaurant-spezifischen Zugangsdaten und darf nur auf freigegebene Restaurantmandanten zugreifen. Gemeinsame Tenant-Zugriffe zwischen Restaurants sind ausgeschlossen.

Antworten und Statusdaten werden so geplant, dass nur betriebsnotwendige Informationen uebertragen werden. Personenbezogene Daten werden auf einen DSGVO-bewussten operativen Mindestumfang begrenzt.

Order Polling & Status Update im Ueberblick

Die v1-Roadmap sieht eine klare Basistrennung vor: Bestellungen werden aktiv abgeholt, anschliessend quittiert und danach ueber einen eigenen Statuspfad aktualisiert. So bleiben Freigabe, Wiederholungen und spaetere Partnerdiagnose sauber nachvollziehbar.

Beispiel JSON

Das folgende Beispiel verwendet ausschliesslich Demodaten und zeigt nur die geplante Richtung des Payload-Standards.

{
  "api_version": "v1",
  "restaurant_code": "demo-restaurant",
  "restaurant_name": "Demo Restaurant",
  "order_id": 120045,
  "order_number": "FB-DEMO-2026-1001",
  "created_at": "2026-06-14T18:00:00+00:00",
  "requested_time": "asap",
  "scheduled_fulfillment_time": null,
  "fulfillment_type": "delivery",
  "customer": {
    "name": "Max Beispiel",
    "phone": "+49 170 0000000"
  },
  "delivery_address": {
    "street": "Beispielstrasse 12",
    "postal_code": "40213",
    "city": "Duesseldorf"
  },
  "payment": {
    "method": "cash",
    "status": "unpaid",
    "label": "Barzahlung"
  },
  "items": [
    {
      "item_id": 501,
      "sku": "DEMO-501",
      "name": "Crunchy Roll",
      "quantity": 2,
      "unit_price": "8.90",
      "total_price": "17.80",
      "variants": [
        {
          "group": "Groesse",
          "label": "8 Stk"
        }
      ],
      "option_groups": [
        {
          "group": "Extras",
          "options": [
            {
              "label": "Extra Wasabi",
              "price": "0.50"
            }
          ]
        }
      ],
      "item_notes": "Bitte getrennt verpacken"
    }
  ],
  "order_notes": "Bitte an der Rezeption klingeln",
  "totals": {
    "subtotal": "17.80",
    "delivery_fee": "2.50",
    "discount": "0.00",
    "grand_total": "20.30"
  }
}

Fehlercodes im Ueberblick

• 200 / 202: Anfrage technisch angenommen oder erfolgreich verarbeitet.
• 400 / 422: Payload unvollstaendig oder fachlich ungueltig.
• 401 / 403: Zugriff nicht autorisiert oder nicht fuer dieses Restaurant freigegeben.
• 404 / 409: Auftrag nicht gefunden oder Konflikt durch bereits verarbeitete Zustellung.
• 429 / 503: Rate-Limit oder temporaere technische Ueberlastung.

Status

Die API befindet sich aktuell in Partner-Planung und Pilotvorbereitung. WinOrder ist die erste praktisch validierte Pilotintegration. Weitere Anbieter werden erst nach definierter Registry-, Dokumentations- und Freigabelogik aufgenommen.

Kassensystem integrieren

Wenn Sie ein Kassensystem, eine Restaurant-Software oder eine individuelle Integrationsloesung anbinden moechten, nutzen Sie den bestehenden Kontaktweg. FoodBestellen.de prueft neue Partnerfaelle derzeit einzeln und restaurantbezogen.

Roadmap fuer /api/docs/ und /api/sandbox/

• /api/ bleibt die oeffentliche Partner-Uebersicht.
• /api/docs/ soll spaeter versionierte Endpunktdokumentation, Beispiele und Fehlercodes enthalten.
• /api/sandbox/ ist als spaetere Testumgebung fuer Partner geplant, aber noch nicht freigegeben.