¿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 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.
Formato requerido para campos específicos
Algunos campos requieren ser enviados en formatos específicos para poder ser correctamente procesados por las autoridades correspondientes. A continuación se detallan los requisitos según cada dato:
Nacionalidad-
Código ISO 2 (ej.
ESpara España) -
Código ISO 3 (ej.
ESPpara España)
Código de Municipio
Campo técnico:Aunque visualmente puedas ver el nombre del municipio, en el envío real solo se transmite el código del municipio.
Formato requerido según destinatario:
- SES y Ertzaintza: Código INE de 5 dígitos
- Mossos d’Esquadra: Código INE de 6 dígitos
Si tienes dudas sobre cómo obtener o verificar estos códigos, te recomendamos consultar las tablas oficiales del INE
Definición de columnas del informe
| COLUMNA | CAMPO EN OPERA |
|---|---|
| CodigoEstablecimiento | Property code |
| Referencia | confirmation number |
| Fechacontrato | reservation insert date |
| Fechaentrada | reservation begin date |
| fechasalida | reservation end date |
| numpersonas | persons |
| numHabitaciones | room qty |
| internet | always true |
| rol | direct guest: VI, Indirect guest: TI |
| nombre | reservation guest name |
| apellido1 | last name |
| apellido2 | Keyword for maternal last name |
| tipodocumento | id type |
| NumeroDocumento | id number |
| SoporteDocumento | Id number for support type |
| FechaNacimiento | Birthday date |
| Nacionalidad | Nationality |
| Sexo | Gender |
| Direccion | Address1 |
| Tefelono | Phone Number for Phone |
| Telefono2 | Phone number for Mobile |
| Correo | Email address |
| Parentesco | relationship |
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 iniciamos los envíos a SES Hospedajes a las tres de la madrugada (03: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. Si el archivo no está disponible a esa hora. Puedes "forzar envío" cuando lo hayais subido
Ejemplo de File Export en XML
¡Espero que este artículo sea de utilidad! Si necesitas más información contacta con support@civitfun.com , estaremos encantado de ayudar. 😊✍️