Partnerdocumentatie

Booking Experts Supporthandleiding

Controleer de installatie, lees het interconnectielogboek en zoek de oorzaak van een probleem in 1Check. Voor het supportteam van Booking Experts dat gezamenlijke klanten helpt.

Naar de controles

Gebruik deze handleiding als supportspecialist van Booking Experts die een gezamenlijke klant helpt de 1Check-koppeling in te stellen of te onderzoeken. Controleer altijd op welke Booking Experts-administratie de app is geïnstalleerd: de koppeling, de instellingen en het logboek horen bij de 1Check-site die eraan gekoppeld is.

Labels van de interface: de labels van de installatiepagina staan hier in het Nederlands. 1Check heeft geen Nederlandse interface: de labels van 1Check staan hier in het Engels, zoals op de schermafbeeldingen. De schermafbeeldingen komen uit een testomgeving van 1Check en bevatten alleen fictieve gegevens. De namen van sites, administraties en kamers verschillen per klant.

1. Voordat u begint

  • De klant heeft een 1Check-site. Nog geen klant? Dan kiest de klant Neem contact met mij op op de installatiepagina.
  • Toegang tot de juiste Booking Experts-administratie, met het recht om apps uit de App Store te installeren.
  • Om de site zelf te koppelen, heeft de klant een 1Check-account nodig dat de PMS-koppeling mag beheren (klantreferentie, gebruikersnaam, wachtwoord). De 1Check-beheerder van de klant heeft er een.
  • Een bevestigde testreservering, afgesproken met de klant en goed herkenbaar, om te controleren of wijzigingen in 1Check aankomen. Wijzig geen echte reservering zonder toestemming van de klant.
  • Er is geen API-sleutel nodig: de toegang wordt vanuit Booking Experts verleend.

2. De app installeren en de site koppelen

  1. Controleer of de app op de juiste Booking Experts-administratie is geïnstalleerd.
  2. De klant installeert de app vanuit de App Store en accepteert de machtigingen. Op de installatiepagina van 1Check, onder Al klant bij 1Check?, vult de klant de klantreferentie, gebruikersnaam en wachtwoord in en klikt op Mijn site koppelen. De klant vult ook de code in als verificatie in twee stappen aan staat, en kiest de administratie als er meerdere zijn.
De installatiepagina van 1Check, met het klant- en het prospectblok
De installatiepagina die de App Store van Booking Experts opent.
De bevestigingspagina: uw site is gekoppeld aan Booking Experts
De bevestiging zodra de site gekoppeld is.

Verwacht resultaat

De pagina toont Uw site is gekoppeld aan Booking Experts (of Deze site is al gekoppeld).

Als het niet werkt
Wat de klant zietWat te doen
Bedankt voor het installeren van 1CheckDe installatie is geregistreerd, maar de site kon niet automatisch worden gekoppeld (bijvoorbeeld omdat hij nog niet voor Booking Experts is ingesteld). De support van 1Check rondt de koppeling af en neemt contact op met de klant. Verder niets te doen.
Onjuiste klantreferentie, gebruikersnaam of wachtwoord. Uw wachtwoord is verlopen. Met dit account kunt u de site niet koppelen.Controleer ze op de inlogpagina van 1Check, wijzig het verlopen wachtwoord, of vraag de 1Check-beheerder om in te loggen.
Deze code is onjuist of verlopen. De verificatiecode kon niet worden verstuurd. Te veel pogingen.Controleer de code, of log opnieuw in om een nieuwe te ontvangen. Wacht enkele minuten voordat u het opnieuw probeert.
Deze pagina is verlopen. De installatie is niet voltooid. Er is iets misgegaan.De pagina is ongeveer 45 minuten geldig. Begin opnieuw vanuit de App Store. Gebeurt het nog eens, neem dan contact op met de support van 1Check.

3. De eerste reservering controleren

  1. Wijzig de testreservering in Booking Experts, bijvoorbeeld de vertrekdatum.
  2. Zoek de wijziging in 1Check op in het interconnectielogboek (zie Het interconnectielogboek lezen).

Verwacht resultaat

Binnen een minuut verschijnt in het logboek een regel List of stays (Webhook), of een regel voor de gebeurtenis, met de status Finished.

4. Het interconnectielogboek lezen

Open in 1Check Configuration → Logs → Interconnections. Elke regel is één uitwisseling met Booking Experts: open hem om de Request, de Payload en de eventuele fout te zien. Kies eerst de periode (bijvoorbeeld Today) en filter daarna op Direction (Received from the PMS: meldingen van Booking Experts; Sent to the PMS: door 1Check afgesloten taken; Read from the PMS: leesacties van 1Check), Kind of Status. Een filter biedt alleen de waarden aan die in de getoonde periode voorkomen.

StatusWat te controleren
Awaiting processingDe uitwisseling is ontvangen maar nog niet verwerkt: dit is nog geen resultaat. Blijft de regel zo staan, geef hem dan door aan 1Check.
Finished1Check heeft de uitwisseling verwerkt. Controleer de verwachte reservering of eenheid in 1Check.
ErrorOpen de regel om de fout te lezen. Bij 401 of 403 heeft Booking Experts de toegang geweigerd (zie Toegang herstellen of de app verwijderen). Geef de regel anders door aan 1Check (zie Gegevens om door te geven aan 1Check).
Wat de titel van elke regel betekent
Titel van de regelBetekenis
List of stays (Webhook), Booking updateBooking Experts heeft 1Check een wijziging van een reservering gemeld, en 1Check heeft die verwerkt.
Check in, Check outEen gast is in Booking Experts in- of uitgecheckt.
RelocationEen verplaatsing naar een andere kamer, of een wijziging van de data.
Status updateEen periode (onderhoud, eigenaar of verblijf) is aangemaakt, gewijzigd of verwijderd.
Statuses, List of staysLeesacties van 1Check: periodes en taken, en reserveringen.
Het interconnectielogboek in 1Check, gefilterd op uitwisselingen met Booking Experts
Het interconnectielogboek in 1Check.
Een geopende regel van het logboek, met de melding die van Booking Experts is ontvangen
Een geopende regel: de melding van Booking Experts, zoals 1Check haar heeft opgeslagen.

Verwacht resultaat

Een goed werkende koppeling toont een regel voor elke wijziging in Booking Experts en elke nacht een regel List of stays (Read from the PMS), allemaal Finished, en geen enkele regel in Error.

5. Gesynchroniseerde gegevens en doorlooptijden

  • Reserveringen. Bevestigde reserveringen, en hun wijzigingen, verplaatsingen, check-ins, check-outs en annuleringen, komen binnen enkele seconden in 1Check aan. Concept- en optiereserveringen worden niet verstuurd.
  • Onbeschikbaarheid. Een onderhoudsperiode zet de eenheid in 1Check op Out of order, een eigenaarsperiode zet haar op Out of service. De status vervalt wanneer de periode eindigt of wordt verwijderd. Een status die in 1Check met de hand is gezet, wordt nooit door Booking Experts opgeheven.
  • Schoonmaak (optioneel). De 1Check-contactpersoon zet dit aan en kiest de takenlijst van Booking Experts die gevolgd moet worden. Een schoonmaaktaak zet de kamer op de schoonmaaklijst in 1Check; wanneer de kamer in 1Check als schoon wordt gemarkeerd, wordt de taak in Booking Experts afgesloten. Een taak met een latere datum blijft open.

Reserveringen blijven in Booking Experts beheerd. Het enige wat 1Check terugschrijft, is het afsluiten van schoonmaaktaken.

WatWanneer
Wijzigingen van reserveringenBinnen enkele seconden, via de meldingen van Booking Experts (webhooks)
Nachtelijke controle van reserveringenElke nacht, voor aankomsten tot 6 maanden vooruit
Onderhouds- en eigenaarsperiodesBinnen enkele seconden, via webhooks
SchoonmaaktakenBinnen enkele seconden, via webhooks
Kamer in 1Check als schoon gemarkeerdDe schoonmaaktaak wordt binnen enkele seconden in Booking Experts afgesloten

6. Toegang herstellen of de app verwijderen

Wanneer Booking Experts de toegang van 1Check weigert (regels in Error met 401 of 403, of na het verwijderen van de app), installeer de app dan opnieuw vanuit de App Store, op dezelfde administratie. De koppeling met de 1Check-site blijft behouden en de toegang wordt vernieuwd.

Verwacht resultaat

De installatiepagina toont Deze site is al gekoppeld, en de volgende regels van het interconnectielogboek staan op Finished.

Verwijder de app alleen om de koppeling bewust te stoppen. 1Check merkt een ingetrokken machtiging op bij de volgende vernieuwing van zijn toegang, binnen een week, en waarschuwt dan zijn support. De instellingen van de site blijven bewaard: de app opnieuw installeren herstelt de koppeling.

Snelle diagnose per symptoom

SymptoomEerste controleWie onderneemt actie
Een reservering verschijnt niet in 1CheckIs de koppeling actief? Het interconnectielogboek toont recente regels Finished en geen enkele in Error (zie Het interconnectielogboek lezen). Is de app op de juiste administratie geïnstalleerd? Is de reservering bevestigd? Concept- en optiereserveringen worden niet naar 1Check gestuurd. Staat er een regel in het logboek op het moment van de wijziging?Klant, daarna Booking Experts
Een eenheid blijft in 1Check out of orderStaat de onderhouds- of eigenaarsperiode nog in Booking Experts? Een status die in 1Check met de hand is gezet, wordt nooit door Booking Experts opgeheven.Klant
Een schoonmaaktaak wordt niet afgeslotenStaat de synchronisatie van schoonmaaktaken aan, met de juiste takenlijst? Staat de taak gepland voor vandaag of eerder? Een taak met een latere datum blijft open.1Check
Een kamer komt niet op de schoonmaaklijstStaat de taak in de gekozen lijst, is ze open en gepland voor vandaag of eerder? Is de kamer in 1Check schoon of gecontroleerd?Klant, daarna 1Check
Regels in Error met 401 of 403, of er komt niets meer in 1Check aanBooking Experts heeft de toegang geweigerd, of de app is verwijderd. Installeer de app opnieuw (zie Toegang herstellen of de app verwijderen).Klant, daarna 1Check

Gegevens om door te geven aan 1Check

  • De naam van de klant en de Booking Experts-administratie.
  • Wat er verwacht werd en wat er gebeurde, met datum, tijd en tijdzone, en het scherm waarop het gebeurde.
  • De laatste geslaagde controle, bijvoorbeeld de laatste regel Finished in het logboek.
  • De betrokken reservering of eenheid (het nummer, niet de gegevens van de gast).
  • De regel(s) van het interconnectielogboek: titel, richting, status en tijd.

Booking Experts controleert de administratie, de installatie en de reservering bij de bron. 1Check controleert de koppeling met de site, de toegang, de instellingen en de verwerking.

Stuur nooit wachtwoorden, tokens, API-sleutels, het adres van de installatiepagina (het bevat een eenmalige code) of volledige gegevens van gasten of betalingen.

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

De controle afronden

De controle is klaar wanneer de app op de juiste administratie is geïnstalleerd, de site gekoppeld is, een wijziging in Booking Experts in het logboek als Finished verschijnt en geen enkele regel in Error staat. Noteer wat nog openstaat en wie het opvolgt.