Property Management System o PMS es una aplicación de software utilizada en la industria hotelera para automatizar algunas funciones del hotel, como la reserva de huéspedes, los detalles de los huéspedes, etc.
La serie Grandstream UCM6XXX ha integrado múltiples plataformas PMS (es decir, HSC, Mitel, HMobile) que brindan las siguientes funciones de hospitalidad: cambio de nombre para mostrar, permiso, reenvío de llamadas, DND y más.
La API PMS es compatible para ofrecer acciones de hotel con UCM62xx, UCM6510 y UCM63xx/A a través de la API HTTPS (o HTTP solo para UCM62xx/UCM6510). Grandstream define el formato API y esta guía ayudará a los usuarios a configurar y autenticarse para usar PMSAPI
Esta guía se centrará en la configuración anterior de la API de PMS y para obtener más detalles sobre la nueva API admitida, consulte el siguiente enlace:
CONEXIÓN Y AUTENTICACIÓN
PMSAPI funciona en HTTPS (o HTTP solo para UCM62xx/UCM6510), la sintaxis del formato de URL es la siguiente:
HTTPS://[UCMIP]:[Puerto]/pmsapi?token=[token]&data=[valor]&format=xml
Desde esta URL podemos ver tres parámetros necesarios: Token, Datos y Formato donde:
Por ejemplo:
https://192.168.124.63:8443/pmsapi?token=63E780C3F321D13109C71BF81805476E&format=xml&data=<pms_data_request><checkin><address>1100</address><name>jjkkl</name><extension>1100</extension><datein >20180202</datein><dateout>20180203</dateout></checkin></pms_data_request>
Esto es compatible con UCM63xx/A a partir del firmware 1.0.9.10. Esta guía se centrará en la configuración anterior de la API de PMS.
Autenticación
El PMSAPI necesita dos pasos de autenticación, uno, que se usa para conectarse, y el otro para datos.
Paso 1:
En WebGUI de UCM, vaya a Característica de valor agregado 🡪 Configuración de API 🡪 Configuración de API HTTPS (Anterior) 🡪 Configuración básica , marque la opción Habilitar en Configuración básica, luego Habilite PMSAPI también, los usuarios también pueden cambiar y configurar otros campos como Nombre de usuario y contraseña, por favor verifique la siguiente captura de pantalla.
Paso 2:
En la WebGUI de la UCM, vaya a Función de valor agregado 🡪 PMS 🡪 Configuración básica , elija Módulo PMS como PMSAPI y configure el nombre de usuario y la contraseña, también podemos ir a Estado de la habitación para crear habitaciones o ir a Servicio de despertador, Mini bar, Mucama para configurar también dependiendo de los requisitos de los usuarios. Luego guarde y aplique los cambios.
Conexión
Para autenticar la conexión, debemos usar el nombre de usuario y la contraseña en la página de configuración de la API, para realizar la autenticación Digest.
Token de autenticación
Este token se usa en la URL y se crea con el nombre de usuario y la contraseña configurados en la página de PMS, use md5 para cifrar el nombre de usuario y la contraseña.
Token = MD5 (nombre de usuario + contraseña)
Ejemplo:
Y luego, usando cualquier generador MD5, podemos generar el token de autenticación como se muestra en la figura a continuación
FORMATO DE DATOS
A continuación se muestra el formato de datos de todas las acciones PMSAPI admitidas, esto se puede actualizar en el firmware futuro.
Respuestas
La respuesta de PMSAPI incluye un código y una descripción. Por ejemplo:
Si una acción tiene éxito, recibirá el mensaje de respuesta “[0] ¡ÉXITO!”.
Otros códigos y descripciones se pueden encontrar en la siguiente tabla.
COMANDOS API Y EJEMPLOS
En este capítulo, mostraremos diferentes acciones, así como ejemplos relacionados y una descripción:
Registrarse
La acción de registro se utiliza para notificar la llegada de un invitado, la siguiente tabla muestra los datos y valores que se configurarán.
- Ejemplo
<pms_data_request> <registrar> <dirección> 1100 </dirección> <sala> 1100 </sala> <cuenta> 1100 </cuenta> <primer nombre> Juan </primer nombre> <apellido> Doe </apellido> <idioma> ES </idioma> <código vip> 2 </código vip> <fecha> 2010/01/01 11:00 </fecha> <fecha de salida> 2010/01/07 13:00 </fecha de salida> <crédito > 9999900 </crédito> <cidnúmero > 11001100 < /cidnúmero> <cos> 3 </cos> </registrar> </pms_data_request>
Verificar
La acción de salida se utiliza para notificar la salida de un huésped, la tabla a continuación muestra los datos y valores que se configurarán
- Ejemplo
<pms_data_request> <pago> <dirección> 1100 </dirección> <sala> 1100 </sala> </pago> </pms_data_request>
Actualizar
La acción de actualización se usa para actualizar los datos de un invitado, la siguiente tabla muestra los datos y valores que se configurarán
- Ejemplo
<pms_data_request> <actualizar> <dirección> 1100 </dirección> <sala> 1100 </sala> <cuenta> 1100 </cuenta> <primer nombre> Juan </primer nombre> <apellido> Doe </apellido> <idioma> ES </idioma> <código vip> 2 </código vip> <fecha> 20100101 </fecha> <fecha de salida> 20100107 </fecha de salida> <crédito > 9999900 </crédito> <cidnúmero > 11001100 < /cidnúmero> <cos> 3 </cos> </actualizar> </pms_data_request>
Mover
La acción Mov se utiliza para notificar el cambio de habitación de un huésped, la siguiente tabla muestra los datos y valores que se configurarán.
- Ejemplo
<pms_data_request> <mov> <dirección> 1046 </dirección> <sala> 1046 </sala> <d_dirección > 1100 </d_dirección> <d_habitación > 1100 </d_habitación> </mov> </pms_data_request>
Despertar
La acción de activación se utiliza para notificar al invitado sobre la llamada de activación, la siguiente tabla muestra los datos y valores que se configurarán
- Ejemplo
<pms_data_request> <despertar> <dirección> 1100 </dirección> <sala> 1100 </sala> <w_acción> 1 </w_acción> <w_modo> 1 </w_modo> <w_fecha> 20140101 </w_fecha> </despertar> </pms_data_request>
DISPOSITIVOS SOPORTADOS
La siguiente tabla muestra los dispositivos compatibles con la función API de PMS:
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.