Soporte
Contacta con nuestro equipo de desarrollo por cualquier cosa que bloquee tu integración. Te recomendamos revisar primero la página Códigos de error del producto; allí se responden la mayoría de las preguntas.
Correo electrónico
Preguntas técnicas, informes de errores y solicitudes de clave de partner y de hotel de prueba. Respondemos en un día hábil.
Teléfono
De lunes a viernes, 09:00–18:00 (GMT+3). Para incidencias que afecten a producción.
Clave de partner
Para acceder necesitas una cuenta de partner emitida por HMS. Envíanos por correo electrónico los datos de tu empresa y los hoteles que vas a integrar; recibirás un apiKey, un apiSecret y un ID de hotel para el entorno de pruebas.
Al informar de un problema, incluye
- Producto y endpoint (p. ej., Online Booking ·
POST /external/online/roomType) - El cuerpo completo de la solicitud y la respuesta, con
apiSecret, el token y los datos de tarjeta enmascarados - Cuándo se envió la solicitud (con la zona horaria) y el
hotelID - Qué esperabas y si el problema se puede reproducir
Preguntas frecuentes
¿Qué necesito para usar la API?
Una cuenta de partner emitida por HMS (apiKey / apiSecret) y autorización para el hotel que vas a integrar. El módulo correspondiente (p. ej., el canal de reservas online) debe estar activo en el hotel.
¿Hay un entorno de pruebas?
Sí. Los ejemplos de esta documentación usan el entorno de pruebas (test.hms.gen.tr); para el desarrollo se proporcionan un registro de hotel y una clave de partner de ese entorno. La dirección y las claves de producción se entregan cuando se aprueba la integración.
Recibo un 401.
Falta el token, ha caducado, no lleva el prefijo Bearer o pertenece a otro hotel. Vuelve a iniciar sesión e inténtalo de nuevo. Si el inicio de sesión devuelve success: false, revisa message: el par de claves es incorrecto o no hay autorización para el hotel.
La lista de habitaciones está vacía o roomCount es 0.
El canal online del hotel está cerrado (errorCode 10003), no hay ningún tipo de habitación abierto a la venta (10004) o se aplican restricciones de fecha u ocupación. En las habitaciones con roomCount 0, roomRestrictionMessage indica el motivo (estancia mínima, cerrado a la entrada, sin tarifa definida).
Envié una reserva, pero no aparece en el panel.
Comprueba si hay un Error en BookingPushRS. Hotel registration not found on HMS. significa que el hotel no está vinculado al canal online; Could not register. suele indicar un roomTypeID / ratePlanID no válido o fechas incoherentes.
¿Cuándo se publicarán las API de los demás módulos?
La documentación de POS de restaurante, Spa, IA, TV y PBX se va añadiendo por etapas. Las fechas de publicación se anuncian en el registro de cambios; escríbenos si quieres acceso anticipado a un módulo concreto.