Integración con Timón Hotel
Conoce cómo conectar fácilmente tu cuenta de Timón Hotel con Civitfun y aprovechar al máximo los productos que esta integración ofrece.
En esta guía, encontrarás los pasos necesarios para realizar la conexión, además de información sobre los productos de Civitfun disponibles a través de esta integración, incluyendo los requisitos y posibles limitaciones.
Productos disponibles con Timón Hotel
A continuación, encontrarás una tabla con los productos disponibles a través de la integración entre Timón Hotel y Civitfun. En ella se indica si cada producto está disponible o no para su uso con la conexión entre ambas plataformas.
Check-in | T-Paperless | Upselling | Cross-Selling | Protección de pagos | Apertura de puertas | Guestlink | Registro de Viajeros | Check-out | |
Timón Hotel | ✅ | ✅ | ❌ | ❌ | ✅ | ✅ | ✅ | ❌ | ❌ |
Conexión con Timón Hotel
Existen diferentes especificaciones y características que intervienen en el flujo de check-in, dependiendo del PMS. A continuación, se abordan los aspectos relacionados con la gestión de reservas y la información del huésped con el PMS Timón Hotel.
-
Búsqueda de reserva
La búsqueda de reservas es el primer paso que permite a los huéspedes iniciar el proceso de cualquiera de nuestros servicios, incluido el check-in. En esta sección, se detallan los métodos y criterios utilizados para poder localizar reservas en Timón Hotel. También se explica si Timón Hotel admite la gestión de multi-reservas y, en caso afirmativo, se describe cómo se presentarán las subreservas a los huéspedes.
-
Campos requeridos para la búsqueda
En el formulario de búsqueda de reserva se indican los campos que los huéspedes deben completar para buscar su reserva. Por defecto, se activa el "formulario de búsqueda estándar", pero en el caso de que tu hotel esté muy tour operado, puedes optar por activar el "formulario de búsqueda específico" para resolver potenciales inconsistencias con los localizadores.
-
✅Formulario de búsqueda estándar
El formulario de búsqueda estándar es el formulario de búsqueda que se activa por defecto. Al huésped se le indicará que debe de añadir los siguientes datos:
- Localizador: Localizador de la reserva
- Fecha de entrada: Fecha de entrada de la reserva
-
✅Formulario de búsqueda estándar
-
Campos requeridos para la búsqueda
-
-
-
✅Formulario de búsqueda específico
En el caso de que tu hotel esté muy tour operado, puedes solicitar la activación del formulario de búsqueda específico con el fin de evitar inconsistencia con los localizadores. Al huésped se le indicará que debe añadir los siguientes datos:
- Nombre y apellido del titular: Nombre y apellido de la persona que ha realizado la reserva
- Fecha de entrada: Fecha de entrada de la reserva
- Fecha de salida: Fecha de salida de la reserva
Para solicitar la activación del formulario de búsqueda específico escribe un correo a onboarding@civitfun.com indicándolo.
-
✅Formulario de búsqueda específico
-
-
-
✅Gestión de multi-reservas
Las multi-reservas permiten a los huéspedes reservar múltiples habitaciones o estancias en una sola transacción. Timón Hotel admite la gestión de estas multi-reservas. A continuación se detalla cómo se indicarán las subreservas a los huéspedes en la interfaz de Civitfun.
En la interfaz de Civitfun, cada subreserva se mostrará al huésped con nombres genéricos como "room 1", "room 2", etc., ya que Timón Hotel no proporciona en su API detalles de cada sub-reserva.
-
✅Gestión de multi-reservas
-
Formulario de Check-in
El formulario de Check-in recopila los datos que deben proporcionar los huéspedes.
-
✅Formulario estático
El formulario estático es un conjunto fijo de datos que se solicitan a todos los huéspedes por igual.
-
✅Formulario estático
-
-
❌Formulario dinámico
El formulario dinámico adapta los datos que se solicitan según el perfil del huésped. Dependiendo de si el cliente es titular, adulto o niño, así como si es un viajero doméstico o no doméstico, el formulario se adaptará solicitando los datos necesarios para su perfil.
En el caso de Timón Hotel, esta funcionalidad no está disponible; por lo tanto, deberás utilizar el formulario estático.
-
❌Formulario dinámico
-
Envío de información del huésped a PMS
Esta sección aborda los campos del formulario de check-in de Civitfun que son permitidos y no permitidos por Timón Hotel. Además, se detalla el proceso de envío de archivos generados durante el check-in a Timón Hotel, asegurando que toda la información se gestione correctamente.
-
Campos del formulario de check-in permitidos y no permitidos por Timón Hotel
A continuación se detallan de los campos del formulario de check-in de Civitfun que campos son permitidos por Timón Hotel y cuales no.
Campo en Civitfun Campo en Timón Hotel Permitido por Timón Hotel Tipo de documento tipo_documento ✅ Número de documento documento ✅ País del documento ❌ ❌ Nacionalidad pais_nacimiento ✅ Nombre nombre ✅ Apellido apellido ✅ Segundo apellido ❌ ❌ Fecha de nacimiento fecha_nacimiento ✅ Sexo (M/F) sexo ✅ Fecha de expedición ❌ ❌ Fecha de caducidad ❌ ❌ Correo electrónico email ✅ Teléfono telefono ✅ Código postal de residencia código_postal ✅ Dirección de residencia calle ✅ Ciudad de residencia poblacion ✅ Provincia de residencia province ✅ Estado de residencia ❌ ❌ País de residencia pais_residencia ✅ País de nacimiento ❌ ❌ Alergias ❌ ❌ Alergias no comunes ❌ ❌ Estado civil ❌ ❌ Ocupación ❌ ❌ Problemas de mobilidad ❌ ❌ Matrícula del vehículo ❌ ❌ Primera vez hospedado ❌ ❌ Tasa medioambiental ❌ ❌ Acpetación del cargo por seguro hotelero ❌ ❌ Hora de llegada ❌ ❌ Número de vuelo de llegada ❌ ❌ Hora de llegada del vuelo ❌ ❌ Hora de salida ❌ ❌ Número de vuelo de salida ❌ ❌ Hora de salida del vuelo ❌ ❌ Cómo conoció a la propiedad ❌ ❌ Comentario del huésped ❌ ❌ Número de soporte del documento ❌ ❌ Teléfono fijo ❌ ❌ Relación de parentesco ❌ ❌ Tipo de pago ❌ ❌ País de emisión del documento ❌ ❌ Provincia de emisión del documento ❌ ❌ Ciudad de emisión del documento ❌ ❌ Motivo de la estancia ❌ ❌ Una vez que un huésped complete el check-in, sus datos serán enviados a Timón Hotel. A continuación, se muestra un ejemplo de cómo se visualizarían los datos de un check-in con los campos estándar habilitados en Civitfun dentro de Timón Hotel:
-
Campos del formulario de check-in permitidos y no permitidos por Timón Hotel
-
-
Envío de archivos permitidos por Timón Hotel
A continuación se detallan de los archivos que se generan en el proceso de check-in de Civitfun que archivos son permitidos por Timón Hotel y cuales no.
Archivo en Civitfun Permitido por Timón Hotel Parte de entrada ✅ Contrato ✅ Firma ❌
-
Envío de archivos permitidos por Timón Hotel
-
Cambio de estado de la reserva
Al realizar el check-in de una reserva, se cambia el estado de la misma en PMS. Existen dos opciones de estado para este proceso: soft check-in y hard check-in. Sin embargo, en el caso de Timón Hotel, solo se permite el soft check-in.
-
✅Soft check-in
Al realizar el proceso de check-in en los hoteles conectados a Timón Hotel, se efectúa un soft check-in que modifica el estado de la reserva a preCheckin. En el caso de Timón Hotel, se indica una “S” en el campo preCheckin, lo que confirma que la reserva está en estado de pre-check-in. A continuación, se muestra el campo que aparecerá completado con la letra "S":
-
✅Soft check-in
Especificaciones del flujo de T-Paperless
Las especificaciones y características mencionadas en el apartado de check-in se aplican igualmente en el producto T-paperless. En cuanto a las particularidades de T-paperless, la aplicación podrá ser utilizada tanto en un formato paperless como en modalidades push y auto check-in, adaptándose a las necesidades de cada hotel.
-
✅T-Paperless
Con T-paperless, el recepcionista tendrá la capacidad de consultar el listado de reservas del día, visualizando los nombres y apellidos de los titulares de cada reserva. Al acceder a una reserva específica, se podrá visualizar toda la información del huésped que ya se encuentre almacenada en Timón Hotel, facilitando así la gestión eficiente de los datos y agilizando el proceso de atención al cliente.
-
✅Push
En caso de que el recepcionista prefiera no buscar la reserva en la lista, tendrá la opción de lanzar directamente un Push desde el aplicativo de Civitfun o a través del PMS. Al hacerlo, se abrirá automáticamente la reserva del huésped, mostrando todos los datos almacenados en Timón Hotel, lo que facilita un acceso rápido y eficiente a la información necesaria.
-
✅Push desde aplicativo Civitfun
A través de https://paperless-push.civitfun.com/login el hotelero podrá lanzar un push a la tablet abriendo automáticamente la reserva con los datos almacenados en Timón Hotel.
-
✅Push desde aplicativo Civitfun
-
-
❌Push desde Timón Hotel
Actualmente, el push desde Timón Hotel no está disponible.
-
❌Push desde Timón Hotel
-
✅Auto check-in
En el caso de una recepción desatendida, el huésped podrá realizar el auto check-in de la misma manera que lo haría a través de check-in online, pero en este caso utilizando la tablet disponible en la recepción del hotel. Sin embargo, en este caso, los campos no se autocompletarán con los datos previamente almacenados en el PMS Timón Hotel.
❌Upselling
Actualmente, el producto de Upselling de Civitfun no está disponible para hoteles que operan con el PMS de Timón Hotel.
❌Cross-Selling
Actualmente, el producto de Cross-Selling de Civitfun no está disponible para hoteles que operan con el PMS de Timón Hotel.
✅Protección de pagos
Configuración
Los parámetros requeridos por el PMS son fundamentales para asegurar un intercambio efectivo y preciso de los datos relacionados con los cargos de la reserva entre Civitfun y el PMS. A continuación, se detalla el parámetro que debe configurarse específicamente para el PMS Timón Hotel.
- Códigos para los pagos (diario_anticipo y tesoreria_modo_anticipio en Timon Hotel): Tiene que seguir el siguiente patrón, diario_anticipo=X,tesoreria_modo_anticipo=Y.
Los parámetros diario_anticipio y tesoreria_modo_anticipo se puede obtener desde el dashboard de Timón Hotel, tal y como se muestra a continuación.
- diario_anticipo:
- tesoreria_modo_anticipo:
Una vez que tengas el parámetro, ingresa al apartado "PMS" dentro del dashboard de Civitfun:
Al seleccionarlo, se mostrará un formulario donde deberás ingresar el parámetro obtenido (diario_anticipo=X,tesoreria_modo_anticipo=Y) en Códigos para los pagos:
Especificaciones del flujo de Protección de pagos
Existen diferentes especificaciones y características que intervienen en el flujo de pagos, dependiendo del PMS. A continuación, se abordan los aspectos relacionados con el procesamiento del pago y la tokenización de la tarjeta con el PMS Timón Hotel.
-
Procesamiento del pago
Mediante el producto Protección de Pagos de Civitfun, es posible gestionar tanto los cargos de la reserva como las tasas asociadas. Para ello, obtenemos los cargos y las tasas pendientes de pago directamente desde el PMS de Timón Hotel y, posteriormente, registramos los pagos realizados en el sistema. Es fundamental que las tasas estén correctamente incluidas en el PMS de Timón Hotel para integrarlas en el flujo de pago.
Si no es posible incluir las tasas en tu PMS, puedes añadirlas a la base de datos de Civitfun para que se reflejen en el proceso de pago. Para solicitar esta gestión, envía un correo a onboarding@civitfun.com con los detalles.-
Obtención de los cargos y tasas pendientes de pago desde Timón Hotel
Con el fin de mostrar al huésped los cargos y tasas pendientes de pago de su reserva en el flujo de pago, Civitfun realiza una consulta a Timón Hotel para obtener los importes pendientes.
Para ello, ejecutamos la llamada "Resumen de Cargos", buscando por el "reservaId". El PMS nos devuelve un desglose detallado de los importes, como el ejemplo que se presenta a continuación, que es el que mostramos al huésped:
[ { "Fecha_Actualizacion": "22-03-2023 11:36:56", "Pendiente_Facturar_Alojamiento": "0,00", "Pendiente_Facturar_Extras": "0,00", "Pendiente_Facturar_TasaTuristica": "0,00", "Facturado_Alojamiento": "0,00", "Facturado_Extras": "0,00", "Facturado_TasaTuristica": "0,00", "Facturado_Total": "0,00", "Cobrado_Alojamiento": "0,00", "Cobrado_Extras": "0,00", "Cobrado_TasaTuristica": "0,00", "Cobrado_Total": "0,00", "Pendiente_Alojamiento": "0,00", "Pendiente_Extras": "0,00", "Pendiente_TasaTuristica": "0,00", "Pendiente_Total": "0,00", "Total_Anticipos": "0,00", "Total_AnticiposAplicados": "0,00", "Total_AnticiposPendientes": "0,00", "Total_Pendiente": "0,00" } ]
-
Obtención de los cargos y tasas pendientes de pago desde Timón Hotel
-
-
Registro del pago en Timón Hotel
Una vez que el huésped ha realizado el pago, Civitfun envía los datos de vuelta a Timón Hotel para registrar la transacción. Para ello, ejecutamos la llamada "Introducir Entrega a Cuenta", proporcionando los siguientes datos: "reserva_id", "importe", "diario_anticipo", "tesoreria_modo_anticipo" y "descripcion", los cuales se registran en la reserva en Timón Hotel.
-
Registro del pago en Timón Hotel
-
❌Tokenización de la tarjeta
En el caso de Timón Hotel, esta funcionalidad no está disponible; por lo tanto, la tarjeta tokenizada no se enviará al PMS a través de la API.
✅Apertura de puerta
El producto de Apertura de Puertas de Civitfun está disponible para hoteles que utilizan el PMS de Timón Hotel. Para este producto, no se requiere cumplir con requisitos específicos del PMS de Timón Hotel.
✅Guestlink
Especificaciones del flujo de Guestlink
Para el envío de correos electrónicos a los huéspedes a través del producto Guestlink de Civitfun, es necesario cumplir con las siguientes especificaciones:
-
Email (email en Timon Hotel): El titular de la reserva debe tener indicada una dirección de correo electrónico. En caso de no proporcionarse una dirección de correo electrónico, no será posible realizar el envío.
-
Idioma (pais_nacionalidad en Timón Hotel): El titular de la reserva debe tener indicado el país de nacionalidad. Esta información es esencial para enviar el correo en el idioma correspondiente a la nacionalidad del huésped. Si no se especifica el país, el correo electrónico se enviará en el idioma predeterminado de Civitfun, que es el inglés.
❌Registro de viajeros
Actualmente, el producto de Registro de Viajeros de Civitfun no está disponible para hoteles que operan con el PMS de Timón Hotel.
❌Check-out
Actualmente, el producto de Check-out de Civitfun no está disponible para hoteles que operan con el PMS de Timón Hotel.