Support
Wenden Sie sich bei allem, was Ihre Integration blockiert, an unser Entwicklerteam. Sehen Sie am besten zuerst auf der Seite Fehlercodes des jeweiligen Produkts nach; dort werden die meisten Fragen beantwortet.
Technische Fragen, Fehlermeldungen, Anfragen für Partnerschlüssel und Testhotels. Antwort innerhalb eines Werktags.
Telefon
Werktags 09:00–18:00 Uhr (GMT+3). Bei Störungen, die die Produktionsumgebung betreffen.
Partnerschlüssel
Für den Zugriff benötigen Sie ein von HMS eingerichtetes Partnerkonto. Senden Sie uns Ihre Unternehmensdaten und die Hotels, die Sie integrieren möchten, per E-Mail; Sie erhalten dann apiKey, apiSecret und eine Hotel-ID für die Testumgebung.
Geben Sie bei einer Problemmeldung Folgendes an
- Produkt und Endpunkt (z. B. Online Booking ·
POST /external/online/roomType) - Den vollständigen Request-Body und die Antwort, mit maskiertem
apiSecret, Token und Kartendaten - Den Zeitpunkt der Anfrage (mit Zeitzone) und die
hotelID - Was Sie erwartet haben und ob sich das Problem reproduzieren lässt
Häufig gestellte Fragen
Was benötige ich, um die API zu nutzen?
Ein von HMS eingerichtetes Partnerkonto (apiKey / apiSecret) und eine Berechtigung für das Hotel, das Sie integrieren. Das betreffende Modul (z. B. der Online-Buchungskanal) muss auf Hotelseite aktiv sein.
Gibt es eine Testumgebung?
Ja. Die Beispiele in dieser Dokumentation verwenden die Testumgebung (test.hms.gen.tr); für die Entwicklung erhalten Sie dort einen Hoteldatensatz und einen Partnerschlüssel. Die Adresse und die Schlüssel für die Produktionsumgebung werden nach Freigabe der Integration vergeben.
Ich erhalte den Status 401.
Das Token fehlt, ist abgelaufen, hat kein Bearer-Präfix oder gehört zu einem anderen Hotel. Melden Sie sich erneut an und wiederholen Sie die Anfrage. Liefert die Anmeldung success: false, prüfen Sie message: falsches Schlüsselpaar oder keine Berechtigung für das Hotel.
Die Zimmerliste ist leer oder roomCount ist 0.
Der Online-Kanal des Hotels ist geschlossen (errorCode 10003), kein Zimmertyp ist zum Verkauf freigegeben (10004) oder es gelten Datums- bzw. Belegungseinschränkungen. Bei Zimmern mit roomCount 0 nennt roomRestrictionMessage den Grund (Mindestaufenthalt, für Anreise geschlossen, kein Preis definiert).
Ich habe eine Buchung übermittelt, sie erscheint aber nicht im Panel.
Prüfen Sie, ob BookingPushRS ein Error enthält. Hotel registration not found on HMS. bedeutet, dass das Hotel nicht mit dem Online-Kanal verbunden ist; Could not register. deutet meist auf eine ungültige roomTypeID / ratePlanID oder inkonsistente Datumsangaben hin.
Wann werden die APIs der anderen Module veröffentlicht?
Die Dokumentationen für Restaurant-POS, Spa, KI, TV und Telefonanlage werden nach und nach ergänzt. Veröffentlichungstermine werden in den Versionshinweisen angekündigt; schreiben Sie uns, wenn Sie Vorabzugang zu einem bestimmten Modul wünschen.