Fehlercodes

Fehler treten in drei Formen auf: Authentifizierungsfehler als HTTP 401, Fehler aus Geschäftsregeln innerhalb einer HTTP-200-Antwort mit success: false und Fehler bei der Buchungsübermittlung in BookingPushRS.Error. Diese Seite listet alle Codes auf.

Authentifizierungsfehler#

HTTP	Antwort	Ursache
401	`{"success": false, "error": "Authentication required"}`	Token fehlt, ist unbekannt oder das `Bearer`-Format ist fehlerhaft.
200	`message: partner_is_not_found`	Anmeldung: Schlüsselpaar stimmt nicht überein.
200	`message: hotel_is_not_found`	Anmeldung: kein Hotel zu `hotelSeoUrl`.
200	`message: hotel_permission_is_not_found`	Anmeldung: Der Partner ist für das Hotel nicht berechtigt.

message-Codes#

Textcodes in snake_case, die zusammen mit success: false zurückgegeben werden.

message	Endpunkt	Beschreibung
`hotel_id_is_not_found`	Die meisten	`hotelID` wurde nicht gesendet.
`start_date_is_not_found` / `end_date_is_not_found`	Verfügbarkeit	Datumsparameter fehlt.
`online_cupon_is_not_found`	Gutschein	Code unbekannt, inaktiv, abgelaufen oder nicht verfügbar.
`mail_host_is_not_found`	E-Mail-Einstellungen	Für den Online-Kanal ist kein SMTP konfiguriert.
`hotel_company_info_could_not_found`	Daten des virtuellen POS-Terminals	Für das Hotel ist kein Zahlungsanbieter konfiguriert.
`bank_info_is_not_found`	Zahlung (Typ 3)	Kein Bankkonto für den Online-Verkauf aktiviert.
`required_input_info_not_submitted`	Zahlung (Typ 10)	Ein Pflichtfeld fehlt; `errors[]` nennt die betroffenen Felder.
`country_info_sent_incorrectly`	Zahlung (Typ 10)	`countryID` ist nicht in der Länderliste enthalten.
`there_is_missing_info_in_the_shopping_cart`	Zahlung (Typ 10)	Einem Warenkorbelement fehlt `id`, `name`, `piece` oder `price`; `errors[]` verweist darauf.

Fehlercodes der Zimmerliste#

Die Zimmerliste (POST /external/online/roomType) gibt einen numerischen errorCode und eine lesbare errorMessage zurück. Die Meldung wird entsprechend dem Parameter language übersetzt; werten Sie in Ihrem Code errorCode aus.

errorCode	Bedeutung	Was tun
`10001`	Hotel nicht gefunden	`hotelID` prüfen.
`10002`	Parameter fehlt (`hotelID`, `startDate`, `endDate`, `adultCount`)	Die Pflichtfelder senden.
`10003`	Hotel für den Online-Verkauf geschlossen	Das Hotel muss den Online-Kanal im Panel aktivieren.
`10004`	Kein Zimmertyp für Kanäle freigegeben	Das Hotel muss Zimmertypen für den Online-Verkauf freigeben.
`10022`	Ungültige Parameter	Anreise heute oder später, Abreise nach der Anreise, höchstens 30 Nächte, 1–40 Erwachsene, 0–10 Kinder.
`20001`	Nicht genügend Verfügbarkeit für Erwachsene	Andere Daten oder eine andere Belegung vorschlagen.
`20002`	Nicht genügend Verfügbarkeit für Kinder	Keine Zimmer mit Kinderkapazität mehr frei.
`20003` / `20004`	Nicht genügend Verfügbarkeit für Erwachsene und Kinder	Die Gesamtkapazität reicht für die Anfrage nicht aus.

Besteht zwar Verfügbarkeit, kann aber ein bestimmter Zimmertyp nicht verkauft werden, ist dessen roomCount 0 und der Grund steht in roomRestrictionMessage: closed_to_checkin, closed_to_checkout, passive_sales, minimum_stay, maximum_stay, closed_to_arrival, price_not_found.

Fehler bei der Buchungsübermittlung#

Statt Success: true enthält BookingPushRS ein Feld Error:

Antwort · 200 (Fehler)

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

Error	Code	Ursache
No available data could be found.	01	Leerer Body oder JSON nicht auswertbar; `Bookings[0].hotelID` fehlt.
Hotel registration not found on HMS.	02	Das Hotel ist nicht mit dem Online-Kanal verbunden oder der Kanal ist inaktiv.
Could not register.	—	Fehler beim Speichern (ungültige Zimmertyp- oder Verpflegungsart-ID, inkonsistente Datumsangaben).
Failed to parse information.	—	Der Struktur fehlen erwartete Felder.

Hinweise zu Wiederholungsversuchen#

401: einmal neu anmelden und die Anfrage wiederholen.
500 und Netzwerkfehler: bis zu 3 Versuche nach 1 s, 2 s und 4 s. Verwenden Sie bei der Wiederholung einer Buchungsübermittlung dieselbe ID; ein Book mit einem bereits vorhandenen Code aktualisiert den Datensatz, statt ein Duplikat anzulegen.
success: false: nicht wiederholen; korrigieren Sie den Parameter oder bieten Sie dem Gast eine Alternative an.
Fügen Sie Support-Tickets die vollständige Anfrage (geheime Schlüssel und Kartendaten maskiert), die Antwort und den Zeitpunkt bei.

Zuletzt aktualisiert: 21. September 2026Fehler gefunden? Schreiben Sie uns