Supporto
Contatta il nostro team di sviluppo per qualsiasi problema che blocca la tua integrazione. Ti consigliamo di consultare prima la pagina Codici di errore del prodotto: lì trovi la risposta alla maggior parte delle domande.
Domande tecniche, segnalazioni di bug, richieste di chiavi partner e hotel di test. Risposta entro un giorno lavorativo.
Telefono
Dal lunedì al venerdì, 09:00–18:00 (GMT+3). Per interruzioni che interessano l’ambiente di produzione.
Chiave partner
L’accesso richiede un account partner rilasciato da HMS. Inviaci via e-mail i dati della tua azienda e gli hotel che integrerai: riceverai apiKey, apiSecret e un ID hotel per l’ambiente di test.
Quando segnali un problema, includi
- Prodotto ed endpoint (ad es. Online Booking ·
POST /external/online/roomType) - Il corpo completo della richiesta e la risposta, con
apiSecret, token e dati delle carte mascherati - Quando è stata inviata la richiesta (con il fuso orario) e l’
hotelID - Cosa ti aspettavi e se il problema è riproducibile
Domande frequenti
Cosa serve per usare l’API?
Un account partner rilasciato da HMS (apiKey / apiSecret) e l’autorizzazione per l’hotel che integri. Sul lato hotel deve essere attivo il modulo corrispondente (ad es. il canale di prenotazione online).
Esiste un ambiente di test?
Sì. Gli esempi di questa documentazione usano l’ambiente di test (test.hms.gen.tr); per lo sviluppo vengono forniti un hotel e una chiave partner dedicati. L’indirizzo e le chiavi di produzione vengono rilasciati dopo l’approvazione dell’integrazione.
Ricevo un 401.
Il token manca, è scaduto, non ha il prefisso Bearer o appartiene a un altro hotel. Ripeti il login e riprova. Se il login restituisce success: false, controlla message: coppia di chiavi errata o nessuna autorizzazione per l’hotel.
L’elenco camere è vuoto o roomCount è 0.
Il canale online dell’hotel è chiuso (errorCode 10003), nessuna tipologia di camera è aperta alla vendita (10004) oppure si applicano restrizioni di data o di occupazione. Per le camere con roomCount 0, roomRestrictionMessage indica il motivo (soggiorno minimo, chiusura all’arrivo, nessuna tariffa definita).
Ho inviato una prenotazione, ma non compare nel pannello.
Controlla se in BookingPushRS è presente un Error. Hotel registration not found on HMS. significa che l’hotel non è collegato al canale online; Could not register. di solito indica un roomTypeID / ratePlanID non valido o date incoerenti.
Quando verranno pubblicate le API degli altri moduli?
La documentazione di POS Ristorante, Spa, AI, TV e Centralino viene aggiunta progressivamente. Le date di pubblicazione vengono annunciate nelle note di rilascio; scrivici se ti serve l’accesso anticipato a un modulo specifico.