Portal para desarrolladoresHMS Software Hotelero

Conecta tu software con los módulos de HMS

Documentación de API independiente para cada módulo del software hotelero: motor de reservas, Wi-Fi para huéspedes, POS de restaurante, spa, TV, PBX y servicios de IA. Las API de Online Booking y Hotspot ya están disponibles; las demás llegarán a continuación.

Autenticación
Token Bearer o encabezado ApiKey
Formato
Respuestas JSON con envoltorio success
Disponible
2 productos · 17 endpoints
Próximamente
5 productos
Solicitud
# Consulta de habitaciones y tarifas
curl "https://test.hms.gen.tr/external/online/roomType" \
  -H "Authorization: Bearer $HMS_TOKEN" \
  -d "hotelID=1000" -d "startDate=2026-08-18" -d "endDate=2026-08-20" \
  -d "adultCount=2"
Respuesta · 200 (recortada)
{
    "success": true,
    "items": [
        {
            "id": 2,
            "name": "Habitación Estándar",
            "roomCount": 5,
            "currency": "TRY",
            "accommodationTypes": [
                {
                    "id": 2,
                    "title": "Alojamiento y desayuno",
                    "prices": {
                        "2-1": {
                            "total": 2,
                            "price": "1930.00",
                            "nonRefundable": ""
                        },
                        "2-0": {
                            "total": 2,
                            "price": "1737.00",
                            "nonRefundable": "[NR]"
                        }
                    }
                }
            ]
        }
    ],
    "count": 1
}

Productos

Cada producto tiene su propia documentación, referencia de API y ejemplos de código. Los que están en preparación se anunciarán en el registro de cambios cuando se publiquen.

Disponible

Online Booking

API del motor de reservas

Conecta el motor de reservas del sitio web del hotel con HMS: lista de habitaciones y tarifas, disponibilidad en calendario, cupones, pago y envío de reservas.

8 recursos · 16 endpointsDocumentación
Disponible

Hotspot

Wi-Fi para huéspedes y registros de la Ley turca n.º 5651

Proporciona al sistema de hotspot la lista de huéspedes alojados: habitación, identidad y horas de check-in y check-out. Sirve para validar el acceso de los huéspedes al Wi-Fi con el número de habitación y para conservar los registros de acceso que exige la Ley turca n.º 5651.

1 recurso · 1 endpointDocumentación
Próximamente

POS de restaurante

Cuentas y cargos a la habitación

Traspaso de las cuentas de restaurante, bar y cafetería al folio de la habitación; sincronización de menú y stock.

Documentación en preparación
Próximamente

Spa

Citas y servicios

Citas de spa y bienestar, catálogo de servicios e integración de cargos a la habitación.

Documentación en preparación
Próximamente

IA

Servicios de asistente y recomendaciones

Acceso a servicios de IA para el asistente del huésped, las recomendaciones de tarifas y los informes.

Documentación en preparación
Próximamente

TV

Sistemas de TV en la habitación

Datos del huésped, folio, mensajes y solicitudes de servicio para la interfaz de TV de la habitación.

Documentación en preparación
Próximamente

PBX

PBX y registros de llamadas

Integración con la centralita telefónica: activación y desactivación de líneas en el check-in/check-out y cargo del importe de las llamadas al folio.

Documentación en preparación

Principios comunes a todos los productos

Cuando hayas integrado un módulo, los demás te resultarán familiares.

Clave vinculada al hotel

En Online Booking, el apiKey/apiSecret emitido por HMS se canjea por un token Bearer vinculado al hotel y válido durante 7 días. Las integraciones locales, como Hotspot, usan una clave generada en el propio panel del hotel, que se envía en el encabezado ApiKey en cada solicitud.

Autenticación

Envoltorio success

Las respuestas son JSON e incluyen el indicador success. Los errores de reglas de negocio se devuelven con HTTP 200 y message o errorCode; los errores de autenticación son 401.

Solicitudes y respuestas

Ejemplos que funcionan

Para cada endpoint se generan ejemplos en cURL, Node.js y PHP; cópialos, añade tu clave y ejecútalos.

Referencia de la API
  • Sitio
    Compatibilidad con 22 idiomas
    NuevoNuevo
  • Hotspot
    Publicada la documentación de la API de Hotspot
    NuevoNuevo
  • Online Booking
    Publicada la documentación de la API de Online Booking
    NuevoNuevoNuevo

¿Necesitas ayuda?

Nuestro equipo de desarrollo responde en un día hábil.

Incluye el cuerpo de la solicitud (con los secretos y los datos de tarjeta enmascarados), la respuesta y la hora. Usa la misma dirección para solicitar claves de partner, hoteles de prueba y acceso anticipado.