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
- Controleer of de app op de juiste Booking Experts-administratie is geïnstalleerd.
- 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.


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 ziet | Wat te doen |
|---|---|
| Bedankt voor het installeren van 1Check | De 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
- Wijzig de testreservering in Booking Experts, bijvoorbeeld de vertrekdatum.
- 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.
| Status | Wat te controleren |
|---|---|
| Awaiting processing | De uitwisseling is ontvangen maar nog niet verwerkt: dit is nog geen resultaat. Blijft de regel zo staan, geef hem dan door aan 1Check. |
| Finished | 1Check heeft de uitwisseling verwerkt. Controleer de verwachte reservering of eenheid in 1Check. |
| Error | Open 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 regel | Betekenis |
|---|---|
| List of stays (Webhook), Booking update | Booking Experts heeft 1Check een wijziging van een reservering gemeld, en 1Check heeft die verwerkt. |
| Check in, Check out | Een gast is in Booking Experts in- of uitgecheckt. |
| Relocation | Een verplaatsing naar een andere kamer, of een wijziging van de data. |
| Status update | Een periode (onderhoud, eigenaar of verblijf) is aangemaakt, gewijzigd of verwijderd. |
| Statuses, List of stays | Leesacties van 1Check: periodes en taken, en reserveringen. |


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.
| Wat | Wanneer |
|---|---|
| Wijzigingen van reserveringen | Binnen enkele seconden, via de meldingen van Booking Experts (webhooks) |
| Nachtelijke controle van reserveringen | Elke nacht, voor aankomsten tot 6 maanden vooruit |
| Onderhouds- en eigenaarsperiodes | Binnen enkele seconden, via webhooks |
| Schoonmaaktaken | Binnen enkele seconden, via webhooks |
| Kamer in 1Check als schoon gemarkeerd | De 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
| Symptoom | Eerste controle | Wie onderneemt actie |
|---|---|---|
| Een reservering verschijnt niet in 1Check | Is 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 order | Staat 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 afgesloten | Staat 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 schoonmaaklijst | Staat 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 aan | Booking 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.