¿Por qué es Necesario Configurar el File Export de Opera?
Para enviar los datos de los huéspedes a través del portal de SES Hospedajes, Civitfun primero debe recopilar la información. Dado que Opera encripta ciertos datos y no podemos acceder a ellos vía API, es necesario configurar la creación diaria de file exports que se almacenarán en tu SFTP. De este modo, Civitfun, al tener acceso a tu SFTP, podrá acceder a los datos y enviarlos a SES Hospedajes.
Actualmente con el soporte de Opera se puede construir un File Export en .xml que es lo recomendado. Si preferís trabajar con un File Export en .txt, Civitfun también lo acepta. Aquí vamos a detallar cómo se puede generar un .txt compatible con la herramienta de Registro de Viajeros
¿Qué Campos y en que Orden debo de Añadir en el File Export?
A continuación, se detallan los 27 campos que deben incluirse en el file export (teniendo en cuenta el espacio para el campo uno o dos). Es fundamental que los campos sigan el orden especificado, y que cada línea del archivo corresponda a un huésped (puedes encontrar un ejemplo al final del artículo).
El file export debe generarse diariamente para cada hotel y guardarse con un formato que coincida con la configuración que se haya realizado en el apartado Registro de Viajero. Si gestionas varios hoteles con el mismo SFTP, recomendamos crear un directorio separado para cada uno.
En cuanto a los datos de los huéspedes añadidos en los campos "Tipo de Documento", "Sexo", "Tipo de Pago" y "Relación de Parentesco entre los Viajeros", deberás de utilizar los códigos específicos detallados más adelante en este artículo.
| Real Decreto 933/2021 | Nombre del dato | Campo en Opera |
|---|---|---|
| Numero de documento de identidad (Completar solo NATIONAL_ID_NUMBER o FOREIGN_ID_NUMBER, dejar el otro campo vacío) | numeroDocumento | NATIONAL_ID_NUMBER (NIF) |
| Numero de documento de identidad (Completar solo NATIONAL_ID_NUMBER o FOREIGN_ID_NUMBER, dejar el otro campo vacío) | numeroDocumento | FOREIGN_ID_NUMBER (NIE, PAS u OTRO) |
| Tipo de documento (DNI, pasaporte, TIE) | tipoDocumento | ID_TYPE |
| - | - | ID_DATE: Fecha expedición |
| Primer apellido | apellido1 | PATERNAL_SURNAME |
| Segundo apellido | apellido2 | MATERNAL_SURNAME |
| Nombre | nombre | FIRST_NAME |
| Sexo | sexo | GENDER |
| Fecha de nacimiento | fechaNacimiento | BIRTH_DATE |
| Nacionalidad | nacionalidad | NATIONALITY_DESC |
| Fecha y hora de entrada | fechaEntrada | ARRIVAL |
| Número de referencia | referencia | CONFIRMATION_NO |
| Fecha y hora de salida | fechaSalida | DEPARTURE |
| Número de viajeros | numPersonas | NUM_PERSONAS |
| Tipo de pago | pago > tipoPago | PAYMENT_METHOD |
| - | - | ROL: TI (titular) y VI (viajero acompañante) |
| Dirección completa | direccion > direccion | ADDRESS |
| Localidad | direccion > nombreMunicipio | CITY |
| Localidad | direccion > codigoPostal | ZIP_CODE |
| - | - | STATE: Provincia |
| Nacionalidad | direccion > pais | COUNTRY |
| Teléfono fijo (Solo es obligatorio uno de ellos: fijo, móvil o correo electrónico) | telefono | PHONE |
| Teléfono móvil (Solo es obligatorio uno de ellos: fijo, móvil o correo electrónico) | telefono2 | MOBILE |
| Correo electrónico (Solo es obligatorio uno de ellos: fijo, móvil o correo electrónico) | correo | |
| Fecha (contrato) | fechaContrato | UDF o valor calculado (fecha de inserción/creación de la reserva) |
| Relación de parentesco entre los viajeros (en el caso de que alguno sea menor de edad) | parentesco | UDF nuevo (lo debe indicar un huésped adulto) |
| Número de soporte del documento (Obligatorio si el tipo de documento es NIF o NIE) | soporteDocumento | UDF nuevo |
| Identificación del medio de pago (Opcional) | - | UDF nuevo |
| Titular del medio de pago (Opcional) | - | UDF nuevo |
| Fecha de caducidad de la tarjeta (Opcional) | - | UDF nuevo |
| Fecha del pago (Opcional) | - | UDF nuevo |
Códigos Tipo de Documento
| Descripción | Código |
|---|---|
| Número de Identificación Fiscal | NIF |
| Número de Identidad de Extranjero | NIE |
| Número de pasaporte | PAS |
| Otro | OTRO |
Códigos Sexo
| Descripción | Código |
|---|---|
| Hombre | H |
| Mujer | M |
| Otro | O |
Códigos Tipo de Pago
| Descripción | Código |
|---|---|
| Efectivo | EFECT |
| Tarjeta de crédito | TARJT |
| Plataforma de pago | PLATF |
| Transferencia | TRANS |
| Pago por móvil | MOVIL |
| Tarjeta de regalo | TREG |
| Pago en destino | DESTI |
| Otros medios de pagos | OTRO |
Códigos Relación de Parentesco entre los Viajeros
| Descripción | Código |
|---|---|
| Abuelo/a | AB |
| Bisabuelo/a | BA |
| Bisnieto/a | BN |
| Cuñado/a | CD |
| Cónyuge | CY |
| Hijo/a | HJ |
| Hermano/a | HR |
| Nieto/a | NI |
| Padre o madre | PM |
| Sobrino/a | SB |
| Suegro/a | SG |
| Tío/a | TI |
| Yerno o nuera | YN |
| Tutor/a | TU |
| Otro | OT |
¿A qué Hora se debe Generar el File Export?
Desde Civitfun enviamos los datos a SES Hospedajes a las cuatro de la madrugada (04:00), por lo que es fundamental que el archivo esté disponible en el SFTP a esa hora. Recomendamos programar la creación del file export de Opera a la una de la madrugada (01:00) para asegurar su correcto envío.
Ejemplo de File Export
A continuación se muestra un ejemplo de los datos de un huésped en el file export. El archivo tiene 27 campos, sigue el orden indicado y cada línea corresponde a un huésped (en la captura por falta de espacio se ve como dos líneas, es solo una línea en el archivo real).