Buchungsstrecke veröffentlichen und auf der Website einbinden

Worum es geht

Solange eine Buchungsstrecke ein Entwurf ist, kann niemand von aussen buchen. Mit Veröffentlichen wird sie unter ihrer eigenen Adresse erreichbar – ohne Website, sofort verschickbar. Auf Ihrer Website binden Sie dieselbe Strecke als Link, als Baustein in Inhalte oder über die Schnittstelle ein. Verfügbarkeit, Reservierung, Formular und Bestätigung kommen immer von der Strecke.

Voraussetzungen

• Recht Buchungsstrecken verwalten.
• Die Strecke hat im Reiter Verfügbarkeit mindestens ein Zeitfenster.
• Ist die Bestätigung eingeschaltet, stehen im Reiter Bestätigungen Betreff und Text der Bestätigung auf Deutsch.
• Für die Einbindung über die Schnittstelle: Recht Termine-Einstellungen verwalten.

Veröffentlichen

1. Öffnen Sie die Strecke unter Buchungsstrecken und wechseln Sie in den Reiter Veröffentlichung.
2. Klicken Sie oben auf Veröffentlichen.
3. Der Hinweis wechselt auf „Diese Strecke ist öffentlich erreichbar.“ Im Kopf der Strecke steht der Zustand Veröffentlicht.

Die Adresse steht im Kopf jeder Strecke und lautet ihre-organisation.scorebase.ch/termine/b/<kennung>, zum Beispiel …/termine/b/erstberatung.

Zurückziehen nimmt das Angebot zurück, nicht das Vereinbarte: Bestehende Buchungen bleiben bestehen. Wer die Adresse danach aufruft, sieht eine Fehlerseite „nicht gefunden“.

Sichtbarkeit, Freigabe und Sprachen

Im Abschnitt Sichtbarkeit stellen Sie ein – und speichern mit Speichern oben rechts:

Feld	Bedeutung
Buchbar ab	Ab diesem Datum werden Zeiten angeboten. Leer heisst: sofort.
Buchbar bis	Bis zu diesem Datum werden Zeiten angeboten. Leer heisst: unbefristet.
Freigabe nötig	Nein, gilt sofort oder Ja, jemand bestätigt. Mit Freigabe steht jede neue Buchung in den Eingängen als wartend, bis jemand sie freigibt.
Sprachen	In welchen der acht Sprachen die Buchungsseite angeboten wird. Deutsch ist immer dabei, weil jede Nachricht darauf zurückfällt.

Wichtig: Auch bei Freigabe nötig sieht der Gast nach dem Buchen „Termin bestätigt“ und bekommt sofort die Bestätigungsnachricht; beim Freigeben geht sie ein zweites Mal hinaus. Formulieren Sie die Bestätigung einer solchen Strecke deshalb als Eingangsbestätigung, etwa „Wir haben Ihre Anfrage erhalten und bestätigen den Termin in Kürze.“

Kanäle: wo die Strecke erscheint

Unter Wo diese Strecke erscheint schalten Sie die Kanäle ein, über die Sie die Strecke anbieten: Eigene Adresse, Eigene Website, Fremde Website und Nur intern. Die Auswahl erscheint in der Liste der Buchungsstrecken in der Spalte Veröffentlicht.

Die Kanäle sind eine Kennzeichnung, keine Sperre: Eine veröffentlichte Strecke ist unter ihrer Adresse erreichbar. Soll eine Strecke nicht öffentlich buchbar sein, veröffentlichen Sie sie nicht – Buchungen von Hand erfassen Sie trotzdem in den Eingängen.

Was der Gast auf der Buchungsseite sieht

Die Buchungsseite trägt oben den Namen Ihrer Organisation, den Namen der Strecke mit Dauer und Ort und rechts die Sprachwahl. Gebucht wird in drei Schritten:

1. Zeit wählen: Ein Monatskalender zeigt die Tage mit freien Zeiten. Nach einem Klick auf den Tag erscheinen die Startzeiten. Unter Nicht wählbar steht, warum eine Zeit fehlt: belegt, zu kurzfristig oder ausgebucht. Alle Zeiten gelten in der Zeitzone der Strecke, und die Seite sagt das.
2. Angaben: Sobald der Gast eine Zeit wählt, ist sein Platz reserviert – die Seite nennt, bis wann. Er füllt Vorname, Name, E-Mail, Telefon, Ihre eigenen Felder und das Anliegen aus, setzt den Einwilligungshaken und klickt auf Verbindlich buchen.
3. Bestätigung: Die Seite zeigt Termin bestätigt mit Buchungsnummer, Datum, Zeit, Ort und der zuständigen Person. Mit Zum Kalender hinzufügen lädt der Gast den Termin als Kalenderdatei herunter. Die Bestätigung geht an die angegebene E-Mail-Adresse.

Ist eine Zeit inzwischen vergeben, meldet die Seite „Diese Zeit ist inzwischen vergeben.“ und der Gast wählt eine andere. Eine abgelaufene Reservierung muss er neu wählen.

Auf der eigenen Website einbinden

Es gibt drei Wege. Welcher passt, hängt davon ab, wie Ihre Website gebaut ist.

Weg	Für wen	Aufwand
Link auf die Adresse	Jede Website	Keiner – ein Knopf oder Link auf …/termine/b/<kennung>
Baustein Buchungskalender	Websites, die mit Scorebase Inhalte gebaut sind	Baustein einsetzen, Kennung eintragen
Eigene Gestaltung über die Schnittstelle	Websites mit eigener Programmierung	Zugang anlegen, Anbindung durch Ihre Webagentur

Link auf die Adresse

Der einfachste Weg: Setzen Sie auf Ihrer Website einen Knopf wie „Termin buchen“, der auf die Adresse der Strecke zeigt. Die Buchungsseite passt sich an Telefon und Computer an.

Baustein Buchungskalender in Inhalte

In der App Inhalte gibt es den Baustein Buchungskalender. Tragen Sie dort unter Strecke (Kennung) die Kennung der Strecke ein – dieselbe wie in der Adresse. Weitere Felder sind Zeitraum in Tagen, Zusatzartikel anbieten und Grund einer Sperre nennen. Die freien Zeiten holt der Baustein bei jedem Aufruf neu, damit nie eine vergebene Zeit angeboten wird. Siehe Inhalte im Überblick und Shop und Buchungen im Frontend.

Hinweis: Im Reiter Veröffentlichung steht dieser Baustein unter dem Namen „Buchungsstrecke“, und der Abschnitt In eine eigene Website einbauen ist dort noch mit Schloss gekennzeichnet. Kennung und Adresse, die er zeigt, gelten trotzdem.

Eigene Gestaltung über die Schnittstelle

Baut Ihre Webagentur die Buchung selbst, holt sie freie Zeiten und bucht über die Schnittstelle der App Termine. Dafür braucht sie einen Zugang:

1. Öffnen Sie Einstellungen → Schnittstelle und klicken Sie auf Zugang anlegen.
2. Beschreiben Sie unter Wofür dieser Zugang da ist, wer ihn nutzt, etwa „Website Muster AG“.
3. Wählen Sie unter Rechte Nur lesen (nur freie Zeiten) oder Lesen und buchen.
4. Klicken Sie auf Erzeugen und kopieren Sie den Schlüssel sofort. Er wird nur dieses eine Mal angezeigt – danach sehen Sie nur noch die letzten vier Zeichen.
5. Geben Sie den Schlüssel auf sicherem Weg an Ihre Webagentur weiter.

Der Schlüssel gehört auf den Server der Website, nie in den Browser: Er öffnet den Schreibzugriff auf Ihre Buchungen. Die Schnittstelle bietet diese Vorgänge an (Adresse jeweils https://ihre-organisation.scorebase.ch/termine/api/public/…, Schlüssel als Authorization: Bearer …):

Vorgang	Wofür	Nötige Rechte des Zugangs
strecke	Angaben und Formularfelder der Strecke lesen	Nur lesen
zeiten	Freie Zeiten eines Zeitraums lesen	Nur lesen
reservieren	Einen Platz für die Reservierungsfrist halten	Lesen und buchen
buchen	Aus der Reservierung eine Buchung machen; ist etwas sofort fällig, wird die Zahlung eröffnet	Lesen und buchen
zahlung, zahlung-pruefen	Eine Zahlung eröffnen und prüfen, ob das Geld angekommen ist	Lesen und buchen

Für jeden Zugang gelten die Grenzen, die unter Grenzen auf derselben Seite stehen: Anfragen je Minute, längster Zeitraum einer Abfrage in Tagen und Zeilen je Antwort.

Mit neu erzeugen ersetzen Sie einen Schlüssel; der alte ist sofort ungültig, ohne Schonfrist. Klären Sie vorher, wer den neuen einträgt – sonst steht die Buchung auf der Website so lange still. Mit entfernen nehmen Sie einen Zugang ausser Betrieb; er steht danach als entfernt in der Liste. Die Spalte Zuletzt benutzt zeigt, ob ein Zugang überhaupt noch verwendet wird.

Erlaubte Herkünfte

Unter Erlaubte Herkünfte im Reiter Veröffentlichung legen Sie fest, welche fremden Websites die Buchung dieser Strecke direkt aus dem Browser aufrufen dürfen. Tragen Sie nur Schema und Adresse ein, zum Beispiel https://beispiel.ch – ohne Pfad wie /termine. Erlaubt ist nur https. Leer heisst: keine fremde Seite, nur die eigene Adresse. Ein Stern für „alle“ ist nicht möglich.

Ereignis-Meldungen an ein Fremdsystem

Unter Einstellungen → Schnittstelle → Ereignis-Meldungen lassen Sie ein anderes System automatisch benachrichtigen:

1. Klicken Sie auf Meldung anlegen.
2. Tragen Sie die Zieladresse ein (nur https, kein Ziel im eigenen Netz).
3. Wählen Sie die Ereignisse und klicken Sie auf Speichern.

Die App schickt dann bei jedem gewählten Ereignis eine signierte Nachricht an diese Adresse – ohne Namen oder E-Mail des Gastes, nur Buchungsnummer, Strecke und Zeitraum. Derzeit gehen Meldungen bei Buchung erstellt (Buchung über die Buchungsseite oder die Schnittstelle) und bei Wartelisten-Angebot (jemand trägt sich auf der Buchungsseite in die Warteliste ein) hinaus. Schlägt die Zustellung wiederholt fehl, wird die Meldung stillgelegt und die Verwaltung benachrichtigt; mit erneut senden stossen Sie eine Zustellung neu an.

Tipps

• Veröffentlichen Sie zuerst und buchen Sie selbst einmal über die Adresse. So sehen Sie genau, was Ihre Gäste sehen – und welche Nachricht ankommt.
• Setzen Sie Buchbar ab und Buchbar bis für Angebote mit Saison, statt die Strecke von Hand zu veröffentlichen und zurückzuziehen.
• Tragen Sie Ihre Website unter Erlaubte Herkünfte ein, bevor die Webagentur mit dem Einbau beginnt.

Wenn etwas nicht klappt

Symptom	Ursache	Lösung
„Zum Veröffentlichen fehlen Zeitfenster oder der deutsche Bestätigungstext.“	Kein Zeitfenster, oder Betreff bzw. Text der Bestätigung auf Deutsch fehlt.	Reiter Verfügbarkeit bzw. Bestätigungen ergänzen.
Die Adresse zeigt eine Fehlerseite „nicht gefunden“ (404).	Die Strecke ist nicht veröffentlicht, stillgelegt oder die Kennung ist falsch geschrieben.	Zustand im Kopf der Strecke prüfen und Kennung vergleichen.
Die Seite zeigt keinen einzigen freien Tag.	Keine Zeitfenster im gezeigten Monat, alles belegt, oder Buchbar ab liegt in der Zukunft.	Vorschau im Reiter Verfügbarkeit prüfen.
„Eine Herkunft ist nur Schema und Adresse …“	Die Herkunft enthält einen Pfad, beginnt mit http: oder enthält einen Stern.	Nur https://ihre-website.ch eintragen.
Die Website erhält „unauthorized“.	Schlüssel falsch kopiert, entfernt oder inzwischen neu erzeugt.	Zugang prüfen, bei Bedarf neu erzeugen und auf der Website eintragen.
Die Website erhält „geltungsbereich“ beim Buchen.	Der Zugang hat nur Nur lesen.	Zugang mit Lesen und buchen anlegen.