Foutcodes

Fouten komen in drie vormen: authenticatiefouten als HTTP 401, fouten in de bedrijfslogica binnen een HTTP 200 met success: false, en fouten bij het doorsturen van een boeking in BookingPushRS.Error. Op deze pagina staan alle codes.

Authenticatiefouten#

HTTP	Antwoord	Oorzaak
401	`{"success": false, "error": "Authentication required"}`	Token ontbreekt of is onbekend, of het `Bearer`-formaat klopt niet.
200	`message: partner_is_not_found`	Login: sleutelpaar komt niet overeen.
200	`message: hotel_is_not_found`	Login: geen hotel gevonden voor `hotelSeoUrl`.
200	`message: hotel_permission_is_not_found`	Login: de partner is niet geautoriseerd voor het hotel.

message-codes#

Tekstcodes in snake_case, die samen met success: false worden teruggegeven.

message	Endpoint	Beschrijving
`hotel_id_is_not_found`	De meeste	`hotelID` is niet meegestuurd.
`start_date_is_not_found` / `end_date_is_not_found`	Beschikbaarheid	Datumparameter ontbreekt.
`online_cupon_is_not_found`	Kortingscode	Code onbekend, inactief, verlopen of niet beschikbaar.
`mail_host_is_not_found`	E-mailinstellingen	Geen SMTP ingesteld voor het online kanaal.
`hotel_company_info_could_not_found`	Gegevens virtuele POS	Geen betaalprovider ingesteld voor het hotel.
`bank_info_is_not_found`	Betaling (type 3)	Geen bankrekening ingeschakeld voor online verkoop.
`required_input_info_not_submitted`	Betaling (type 10)	Er ontbreekt een verplicht veld; `errors[]` geeft aan welke.
`country_info_sent_incorrectly`	Betaling (type 10)	`countryID` staat niet in de landenlijst.
`there_is_missing_info_in_the_shopping_cart`	Betaling (type 10)	Een item in de winkelmand mist `id`, `name`, `piece` of `price`; `errors[]` wijst het aan.

Foutcodes van de kamerlijst#

De kamerlijst (POST /external/online/roomType) geeft een numerieke errorCode en een leesbare errorMessage terug. De melding wordt vertaald volgens de parameter language; baseer je code op errorCode.

errorCode	Betekenis	Wat te doen
`10001`	Hotel niet gevonden	Controleer `hotelID`.
`10002`	Ontbrekende parameter (`hotelID`, `startDate`, `endDate`, `adultCount`)	Stuur de verplichte velden mee.
`10003`	Hotel gesloten voor online verkoop	Het hotel moet het online kanaal inschakelen in het beheerpaneel.
`10004`	Geen kamertype opengesteld voor kanalen	Het hotel moet kamertypen openstellen voor online verkoop.
`10022`	Ongeldige parameters	Incheckdatum vandaag of later, uitcheckdatum na de incheckdatum, maximaal 30 nachten, 1–40 volwassenen, 0–10 kinderen.
`20001`	Onvoldoende beschikbaarheid voor volwassenen	Stel andere datums of een andere bezetting voor.
`20002`	Onvoldoende beschikbaarheid voor kinderen	Er zijn geen kamers met capaciteit voor kinderen meer.
`20003` / `20004`	Onvoldoende beschikbaarheid voor volwassenen en kinderen	De totale capaciteit is niet genoeg voor de aanvraag.

Is er wel beschikbaarheid maar kan een bepaald kamertype niet worden verkocht, dan is de roomCount daarvan 0 en staat de reden in roomRestrictionMessage: closed_to_checkin, closed_to_checkout, passive_sales, minimum_stay, maximum_stay, closed_to_arrival, price_not_found.

Fouten bij het doorsturen van boekingen#

In plaats van Success: true bevat BookingPushRS een veld Error:

Antwoord · 200 (fout)

{
    "BookingPushRS": {
        "Error": "Could not register.",
        "BookingConfirmNumbers": [
            {
                "confirmTime": 1755500000,
                "bookingID": 0,
                "bookingType": "Book",
                "HMS_ID": null
            }
        ]
    }
}

Error	Code	Oorzaak
No available data could be found.	01	Lege body of JSON kon niet worden verwerkt; `Bookings[0].hotelID` ontbreekt.
Hotel registration not found on HMS.	02	Het hotel is niet gekoppeld aan het online kanaal, of het kanaal is inactief.
Could not register.	—	Fout bij het opslaan (ongeldige ID van kamer- of verzorgingstype, inconsistente datums).
Failed to parse information.	—	De structuur mist verwachte velden.

Advies voor opnieuw proberen#

401: log nog één keer in en probeer het verzoek opnieuw.
500 en netwerkfouten: maximaal 3 pogingen, na 1 s, 2 s en 4 s. Gebruik bij het opnieuw doorsturen van een boeking dezelfde ID; een Book met een bestaande code werkt het record bij in plaats van een dubbele boeking aan te maken.
success: false: niet opnieuw proberen; corrigeer de parameter of bied de gast een alternatief aan.
Voeg aan supporttickets het volledige verzoek (met gemaskeerde geheimen en kaartgegevens), het antwoord en het tijdstip toe.

Laatst bijgewerkt: 21 september 2026Fout gevonden? Laat het ons weten