Partnerdokumentation

Booking Experts Support-Leitfaden

Installation prüfen, Verbindungsprotokoll lesen und Probleme in 1Check diagnostizieren. Für das Support-Team von Booking Experts, das gemeinsame Kunden betreut.

Zu den Prüfungen

Nutzen Sie diesen Leitfaden als Support-Mitarbeiter von Booking Experts, um einem gemeinsamen Kunden beim Einrichten oder Untersuchen der 1Check-Verbindung zu helfen. Prüfen Sie immer, in welcher Booking-Experts-Administration die App installiert ist: Verbindung, Einstellungen und Protokoll gehören zu dem damit verbundenen 1Check-Standort.

Beschriftungen der Oberfläche: Die Anleitung zitiert die Beschriftungen so, wie die Installationsseite und 1Check sie auf Deutsch anzeigen. Die Screenshots sind auf Englisch; sie stammen aus einer 1Check-Testumgebung und enthalten nur fiktive Daten. Die Namen von Standorten, Administrationen und Zimmern sind je nach Kunde verschieden.

1. Bevor Sie beginnen

  • Der Kunde hat einen 1Check-Standort. Noch kein Kunde? Er wählt auf der Installationsseite Kontaktieren Sie mich.
  • Zugriff auf die richtige Booking-Experts-Administration, mit dem Recht, Apps aus dem App Store zu installieren.
  • Um den Standort selbst zu verbinden, braucht der Kunde ein 1Check-Konto, das die PMS-Verbindung verwalten darf (Kundenreferenz, Benutzername, Passwort). Der 1Check-Administrator des Kunden verfügt darüber.
  • Eine bestätigte, mit dem Kunden abgestimmte und gut erkennbare Testreservierung, um zu prüfen, ob Änderungen in 1Check ankommen. Ändern Sie keine echte Reservierung ohne Zustimmung des Kunden.
  • Es wird kein API-Schlüssel benötigt: Der Zugriff wird in Booking Experts erteilt.

2. App installieren und Standort verbinden

  1. Prüfen Sie, ob die App in der richtigen Booking-Experts-Administration installiert ist.
  2. Der Kunde installiert die App aus dem App Store und akzeptiert die Berechtigungen. Auf der Installationsseite von 1Check gibt er unter Bereits 1Check-Kunde? seine Kundenreferenz, seinen Benutzernamen und sein Passwort ein und klickt auf Meinen Standort verbinden. Ist die Zwei-Faktor-Verifizierung aktiv, gibt er auch den Code ein, und bei mehreren Administrationen wählt er eine aus.
Die Installationsseite von 1Check mit dem Kunden- und dem Interessentenblock
Die vom App Store von Booking Experts geöffnete Installationsseite.
Die Bestätigungsseite: Ihr Standort ist mit Booking Experts verbunden
Die Bestätigung, sobald der Standort verbunden ist.

Erwartetes Ergebnis

Die Seite zeigt Ihr Standort ist mit Booking Experts verbunden (oder Dieser Standort ist bereits verbunden).

Wenn es nicht funktioniert
Was der Kunde siehtWas zu tun ist
Vielen Dank für die Installation von 1CheckDie Installation ist registriert, aber der Standort konnte nicht automatisch verbunden werden (zum Beispiel, weil er noch nicht für Booking Experts eingerichtet ist). Der 1Check-Support schließt die Verbindung ab und kontaktiert den Kunden. Sonst ist nichts zu tun.
Kundenreferenz, Benutzername oder Passwort ist falsch. Ihr Passwort ist abgelaufen. Mit diesem Konto kann der Standort nicht verbunden werden.Prüfen Sie sie auf der Anmeldeseite von 1Check, ändern Sie das abgelaufene Passwort, oder bitten Sie den 1Check-Administrator, sich stattdessen anzumelden.
Dieser Code ist falsch oder abgelaufen. Der Bestätigungscode konnte nicht gesendet werden. Zu viele Versuche.Prüfen Sie den Code, oder melden Sie sich erneut an, um einen neuen zu erhalten. Warten Sie einige Minuten, bevor Sie es erneut versuchen.
Diese Seite ist abgelaufen. Die Installation wurde nicht abgeschlossen. Ein Fehler ist aufgetreten.Die Seite ist etwa 45 Minuten gültig. Beginnen Sie erneut im App Store. Tritt es wieder auf, kontaktieren Sie den 1Check-Support.

3. Die erste Reservierung prüfen

  1. Ändern Sie die Testreservierung in Booking Experts, zum Beispiel das Abreisedatum.
  2. Suchen Sie die Änderung in 1Check im Verbindungsprotokoll (siehe Das Verbindungsprotokoll lesen).

Erwartetes Ergebnis

Innerhalb einer Minute erscheint im Protokoll eine Zeile Aufenthaltsliste (Webhook) oder eine Zeile für das Ereignis, mit dem Status Fertig.

4. Das Verbindungsprotokoll lesen

Öffnen Sie in 1Check Konfiguration → Protokolle → Verbindungen. Jede Zeile ist ein Austausch mit Booking Experts: Öffnen Sie sie, um ihre Anfrage, ihre Nutzdaten und gegebenenfalls den Fehler zu sehen. Wählen Sie zuerst den Zeitraum (zum Beispiel Heute) und filtern Sie dann nach Richtung (Vom PMS empfangen: Benachrichtigungen von Booking Experts; An das PMS gesendet: von 1Check abgeschlossene Aufgaben; Aus dem PMS gelesen: Abfragen durch 1Check), Typ oder Status. Ein Filter bietet nur die Werte an, die im angezeigten Zeitraum vorkommen.

StatusWas zu prüfen ist
Bearbeitung ausstehendDer Austausch ist eingegangen, aber noch nicht verarbeitet: Das ist noch kein Ergebnis. Bleibt die Zeile so, leiten Sie sie an 1Check weiter.
Fertig1Check hat den Austausch verarbeitet. Prüfen Sie die erwartete Reservierung oder Einheit in 1Check.
FehlerÖffnen Sie die Zeile, um den Fehler zu lesen. Bei 401 oder 403 hat Booking Experts den Zugriff verweigert (siehe Zugriff wiederherstellen oder App deinstallieren). Andernfalls leiten Sie die Zeile an 1Check weiter (siehe Angaben für den 1Check-Support).
Was der Titel jeder Zeile bedeutet
Titel der ZeileBedeutung
Aufenthaltsliste (Webhook), BuchungsaktualisierungBooking Experts hat 1Check eine Änderung einer Reservierung gemeldet, und 1Check hat sie übernommen.
Check-In, Check-outEin Gast wurde in Booking Experts ein- oder ausgecheckt.
VerlegungEin Wechsel in ein anderes Zimmer oder eine Änderung der Daten.
Status-UpdateEin Zeitraum (Wartung, Eigentümer oder Aufenthalt) wurde erstellt, geändert oder gelöscht.
Status, AufenthaltslisteAbfragen durch 1Check: Zeiträume und Aufgaben, sowie Reservierungen.
Das Verbindungsprotokoll in 1Check, gefiltert auf den Austausch mit Booking Experts
Das Verbindungsprotokoll in 1Check.
Eine geöffnete Zeile des Protokolls mit der von Booking Experts empfangenen Benachrichtigung
Eine geöffnete Zeile: die Benachrichtigung von Booking Experts, wie 1Check sie gespeichert hat.

Erwartetes Ergebnis

Eine funktionierende Verbindung zeigt eine Zeile für jede Änderung in Booking Experts und jede Nacht eine Zeile Aufenthaltsliste (Aus dem PMS gelesen), alle Fertig, und keine Zeile mit dem Status Fehler.

5. Synchronisierte Daten und Übertragungszeiten

  • Reservierungen. Bestätigte Reservierungen und ihre Änderungen, Zimmerwechsel, Check-ins, Check-outs und Stornierungen kommen innerhalb von Sekunden in 1Check an. Reservierungsentwürfe und Optionsbuchungen werden nicht übertragen.
  • Nichtverfügbarkeit. Ein Wartungszeitraum setzt die Einheit in 1Check auf Außer Verkauf, ein Eigentümerzeitraum auf Außer Betrieb. Der Status wird aufgehoben, wenn der Zeitraum endet oder gelöscht wird. Ein in 1Check von Hand gesetzter Status wird nie von Booking Experts aufgehoben.
  • Reinigung (optional). Der 1Check-Ansprechpartner aktiviert sie und wählt die zu verfolgende Aufgabenliste von Booking Experts. Eine Reinigungsaufgabe setzt das Zimmer in 1Check auf die Reinigungsliste; wird das Zimmer in 1Check als sauber markiert, wird seine Aufgabe in Booking Experts abgeschlossen. Eine Aufgabe mit späterem Datum bleibt offen.

Reservierungen werden weiterhin in Booking Experts verwaltet. Das Einzige, was 1Check zurückschreibt, ist der Abschluss von Reinigungsaufgaben.

WasWann
Änderungen an ReservierungenInnerhalb von Sekunden, über die Benachrichtigungen von Booking Experts (Webhooks)
Nächtliche Prüfung der ReservierungenJede Nacht, für Anreisen bis 6 Monate im Voraus
Wartungs- und EigentümerzeiträumeInnerhalb von Sekunden, über Webhooks
ReinigungsaufgabenInnerhalb von Sekunden, über Webhooks
Zimmer in 1Check als sauber markiertSeine Reinigungsaufgabe wird innerhalb von Sekunden in Booking Experts abgeschlossen

6. Zugriff wiederherstellen oder App deinstallieren

Verweigert Booking Experts den Zugriff von 1Check (Zeilen mit dem Status Fehler mit 401 oder 403, oder nach einer Deinstallation), installieren Sie die App erneut aus dem App Store, in derselben Administration. Die Verbindung mit dem 1Check-Standort bleibt erhalten und der Zugriff wird erneuert.

Erwartetes Ergebnis

Die Installationsseite zeigt Dieser Standort ist bereits verbunden, und die nächsten Zeilen des Verbindungsprotokolls stehen auf Fertig.

Deinstallieren Sie die App nur, um die Verbindung bewusst zu beenden. 1Check bemerkt eine entzogene Berechtigung bei der nächsten Erneuerung seines Zugriffs, innerhalb einer Woche, und benachrichtigt dann seinen Support. Die Einstellungen des Standorts bleiben erhalten: Eine erneute Installation der App stellt die Verbindung wieder her.

Schnelldiagnose nach Symptom

SymptomErste PrüfungZuständig
Eine Reservierung erscheint nicht in 1CheckIst die Verbindung aktiv? Das Verbindungsprotokoll zeigt aktuelle Zeilen Fertig und keine mit dem Status Fehler (siehe Das Verbindungsprotokoll lesen). Ist die App in der richtigen Administration installiert? Ist die Reservierung bestätigt? Reservierungsentwürfe und Optionsbuchungen werden nicht an 1Check gesendet. Gibt es zum Zeitpunkt der Änderung eine Zeile im Protokoll?Kunde, dann Booking Experts
Eine Einheit bleibt in 1Check außer VerkaufBesteht der Wartungs- oder Eigentümerzeitraum noch in Booking Experts? Ein in 1Check von Hand gesetzter Status wird nie von Booking Experts aufgehoben.Kunde
Eine Reinigungsaufgabe wird nicht abgeschlossenIst die Synchronisation der Reinigungsaufgaben aktiv, mit der richtigen Aufgabenliste? Ist die Aufgabe heute oder früher fällig? Eine Aufgabe mit späterem Datum bleibt offen.1Check
Ein Zimmer kommt nicht auf die ReinigungslisteIst die Aufgabe in der gewählten Liste, offen und heute oder früher fällig? Ist das Zimmer in 1Check sauber oder kontrolliert?Kunde, dann 1Check
Zeilen mit dem Status Fehler mit 401 oder 403, oder in 1Check kommt nichts mehr anBooking Experts hat den Zugriff verweigert, oder die App wurde deinstalliert. Installieren Sie die App erneut (siehe Zugriff wiederherstellen oder App deinstallieren).Kunde, dann 1Check

Angaben für den 1Check-Support

  • Der Name des Kunden und die Booking-Experts-Administration.
  • Was erwartet wurde und was passiert ist, mit Datum, Uhrzeit und Zeitzone, sowie der Bildschirm, auf dem es passiert ist.
  • Die letzte erfolgreiche Prüfung, zum Beispiel die letzte Zeile Fertig im Protokoll.
  • Die betroffene Reservierung oder Einheit (ihre Nummer, nicht die Daten des Gastes).
  • Die Zeile(n) des Verbindungsprotokolls: Titel, Richtung, Status und Uhrzeit.

Booking Experts prüft die Administration, die Installation und die Reservierung an der Quelle. 1Check prüft die Verbindung mit dem Standort, den Zugriff, die Einstellungen und die Verarbeitung.

Senden Sie niemals Passwörter, Tokens, API-Schlüssel, die Adresse der Installationsseite (sie enthält einen Einmalcode) oder vollständige Gast- oder Zahlungsdaten.

1Check-Support: support@1check.com · +33 1 78 91 30 05

Die Prüfung abschließen

Die Prüfung ist abgeschlossen, wenn die App in der richtigen Administration installiert ist, der Standort verbunden ist, eine Änderung in Booking Experts im Protokoll als Fertig erscheint und keine Zeile den Status Fehler hat. Notieren Sie, was offen bleibt und wer es weiterverfolgt.