Abschnitt 6 von 8

Formular anbinden

Drei Wege, auf denen eine Reservierung bei Ihnen ankommt. Sie brauchen nur einen – welchen, hängt davon ab, was Sie schon haben. Die fertigen Adressen für Ihr Haus stehen unter Online-Buchung; was nur Ihre Webagentur braucht, steht dort eingeklappt.

1. Der Link

Jedes Haus bekommt eine eigene Adresse. Sie funktioniert ohne Vorbereitung und ohne Website.

https://ihre-adresse/buchen/ihr-haus

Angabe	Was sie bedeutet
`Google`	Unternehmensprofil → Bearbeiten → Links → Reservierungen. Der Buchungsknopf innerhalb der Google-Suche ist etwas anderes — ein Partnerprogramm mit eigener Zertifizierung.
`Instagram`	In die Profilbeschreibung als einziger Link.
`Facebook`	Als Aktionsschaltfläche „Jetzt buchen“.
`Speisekarte`	Als QR-Code. Funktioniert auch für den Gast, der schon am Tisch sitzt und für nächste Woche buchen will.

2. Die Codezeile

Wenn Sie eine Website haben: das Formular erscheint in einem Rahmen an der Stelle, an der Sie das Stück einsetzen. Ohne Kopfzeile und ohne Kasten – es soll nicht nach Fenster im Fenster aussehen.

<iframe src="https://ihre-adresse/buchen/ihr-haus?rahmen=1"
        title="Tisch reservieren"
        style="width:100%;height:900px;border:0"
        loading="lazy"></iframe>

In WordPress fügen Sie es als Block „Individuelles HTML“ ein, in Wix und Jimdo als HTML-Element. Die 900 Pixel Höhe passen für die meisten Seiten; wird es zu knapp, stellen Sie den Wert höher.

3. Die Schnittstelle

Für Häuser mit eigenem Formular oder eigener Agentur. Ein Zugangsschlüssel je Haus, anzulegen unter Online-Buchung im Teil für die Webagentur. Er bestimmt, für welches Restaurant eingeliefert wird – was im Datensatz steht, kann daran nichts ändern.

POST https://ihre-adresse/api/v1/reservierungen
Content-Type: application/json
X-Tafel-Schluessel: tafel_…

{
  "datum":    "2026-08-14",
  "uhrzeit":  "19:30",
  "personen": 4,
  "name":     "Anna Müller",
  "email":    "a@example.de",
  "telefon":  "08282 1234",
  "info":     "Kinderstuhl, wenn möglich am Fenster",
  "standort": "Gasthaus",
  "bereich":  "innen"
}

Angabe	Was sie bedeutet
`datum`	Pflicht. `JJJJ-MM-TT`.
`uhrzeit`	Pflicht. `HH:MM`, 24 Stunden.
`personen`	Pflicht. Ganze Zahl.
`name`	Pflicht — wahlweise `vorname` und `nachname` getrennt.
`email / telefon`	Beide Pflicht. Die Adresse trägt Bestätigung und Erinnerung, die Nummer ist der Weg, Sie am Tag selbst zu erreichen. Nur der Eintrag von Hand kommt ohne aus — wer ohne Reservierung vor Ihnen steht, gibt keine Adresse.
`info`	Freitext des Gastes, unverändert. Er wird gedeutet und bleibt daneben stehen.
`standort`	Nur bei mehreren Standorten nötig. Name wie in der Verwaltung.
`bereich`	Optional. Ohne Angabe entscheidet Tafel.

Was zurückkommt

Angabe	Was sie bedeutet
`201 gebucht`	Tisch steht. Die Nummern stehen in der Antwort — für Ihre Unterlagen, nicht für den Gast.
`201 eingegangen`	Angenommen, noch ohne Tisch. Jemand schaut darauf.
`201 in_klaerung`	Angenommen, es ist etwas zu besprechen.
`201 abgelehnt`	Geschlossen oder außerhalb der Grenzen. Der Grund steht dabei und ist für den Gast formuliert.
`400`	Die Angaben gehen so nicht. Der Grund steht dabei — kein Rätselraten.
`401`	Zugangsschlüssel fehlt oder stimmt nicht.

Ausprobieren, ohne etwas anzulegen

POST /api/v1/platzierung/probe rechnet gegen den echten Stand des Tages und legt nichts an. Damit lassen sich Fälle durchspielen, ohne den Abend mit Testbuchungen vollzustellen.

Grenzen des Online-Wegs

Sie gelten für alle drei Wege – und nur für sie. Von Hand eingetragene Reservierungen sind davon nicht betroffen.

Angabe	Was sie bedeutet	Vorgabe
`Vorlauf`	Wie kurzfristig online noch gebucht werden darf. Darunter verweist die Antwort auf das Telefon.	120 Min
`Horizont`	Wie weit im Voraus. Verhindert Buchungen für einen Sommer, dessen Karte noch niemand kennt.	180 Tage
`Gruppengröße`	Bis zu wie vielen Personen. Darüber ist es eine Absprache und kein Formular.	10 Personen