Saltar al contenido principal

⚙️ Configuración del File Export de Opera en .xml

Lorena Figueroa
  • Actualización

¿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. ES para España)
  • Código ISO 3 (ej. ESP para España)
📅 Importante: Asegúrate de utilizar uno de estos estándares reconocidos internacionalmente para garantizar una correcta validación.


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
📅 Importante: Es fundamental respetar el número de dígitos exigido por cada cuerpo policial para evitar errores de validación en los envíos de datos.

Si tienes dudas sobre cómo obtener o verificar estos códigos, te recomendamos consultar las tablas oficiales del INE

Fechas

Deben presentarse en el formato permitido por ISO-8601

Qué es:
ISO-8601 es el estándar internacional para representar fechas y horas de forma no ambigua y legible por máquinas

Formato recomendado (fecha):
YYYY-MM-DD → Año-Mes-Día con ceros a la izquierda.

  • Ej.: 2025-03-07 (7 de marzo de 2025)

Fecha y hora (si aplica):
YYYY-MM-DDThh:mm:ss con separador T

  • Ej. sin zona: 2025-03-07T14:35:00

  • Ej. UTC (Zulu): 2025-03-07T14:35:00Z

  • Ej. con zona local: 2025-03-07T14:35:00+01:00

Reglas clave:

  • Siempre 4 dígitos para el año, 2 para mes y día (ceros obligatorios).

  • Separadores guion en la fecha (-) y dos puntos en la hora (:).

  • Hora en formato 24h.

  • Si se incluye zona horaria: usar Z (UTC) o desplazamiento ±hh:mm.

Lo que NO debe enviarse:

  • 07/03/2025, 07-03-25, 03/07/25 (ambiguo o corto)

  • Nombres de mes: 7 Mar 2025

  • Horas sin T: 2025-03-07 14:35:00 (preferir T)

Conversión rápida (España):

  • De dd/mm/yyyy → yyyy-mm-dd

    • 07/03/2025 → 2025-03-07

Buenas prácticas para SES/Registro de Viajeros:

  • Usar solo YYYY-MM-DD si el campo es de fecha.

  • Si el sistema exige fecha y hora, incluir zona (Z o ±hh:mm) para evitar discrepancias.

  • Validar longitud y patrón antes de enviar (p. ej., regex fecha: ^\d{4}-\d{2}-\d{2}$).

Ejemplos válidos para envío:

  • Fecha de entrada: 2025-11-14

  • Fecha de salida: 2025-11-17

  • Sello de generación (UTC): 2025-11-14T05:11:45Z

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

A continuación se muestra un ejemplo de File Export de una reserva para un único huésped. Los datos son ejemplos. 
 

 

¡Espero que este artículo sea de utilidad! Si necesitas más información contacta con support@civitfun.com , estaremos encantado de ayudar. 😊✍️
 

Artículos relacionados