¿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.
¿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 el formato YYYY-MM-DD.txt en tu SFTP. Si gestionas varios hoteles con el mismo SFTP, deberás de 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).