Contenido del artículo:
- Opciones disponibles: PMS vs. fichero exportado
- Configuración del SFTP en el dashboard
- Validación de ficheros
- Requisitos técnicos y nomenclatura
- Recomendaciones
- Preguntas frecuentes
Para configurar la fuente de datos:
- Ve a Configuración > Registro de viajeros
💡 Opciones disponibles para el origen de datos
Desde el dashboard puedes elegir entre:
Interfaz PMS
- La información se extrae directamente desde tu sistema de gestión (PMS)
- Configuración automática una vez activado.
Fichero exportado (SFTP)
- Debes subir un fichero en formato .txt o .xml a la carpeta SFTP que configurarás.
- El fichero debe incluir los campos requeridos por la ley.
- La ruta y nombre deben ser reconocidos por el sistema.
🔐 Configuración de un SFTP en el dashboard
Para activar esta opción:
- Ve a Configuración > Registro de viajeros > Tipo de Fuente de datos
- Selecciona "Fichero de exportación"
Configura los campos editables para establecer conexión con el SFTP
Campos requeridos: URL, Puerto, Usuario, Contraseña
Nombre del fichero: puede incluir prefijo, sufijo y la fecha.
Extensiones compatibles: .txt, .xml
Formatos de fecha permitidos:
-
-
- YYYY-MM-DD
- YYYYMMDD
- DD-MM-YYYY
- DDMMYYYY
-
Fecha del fichero: desde el selector de "Seleccione una de las siguientes opciones" puede configurarse como:
-
- La fecha en el nombre del fichero corresponde a la fecha de entrada de las reservas
- La fecha en el nombre del fichero corresponde al día posterior a la entrada de las reservas
- Fichero para validar: introduciendo en este campo el nombre del fichero deseado se puede realizar una validación del fichero.
- Directorio del archivo: Ruta que debemos seguir para encontrar el archivo en el SFTP
💡 Consejo: Si tienes varios hoteles, usa un directorio por hotel.
📣 Nota: La plataforma mostrará una alerta de éxito si la conexión SFTP ha sido validada correctamente.
🔢 Validación de ficheros
El dashboard de Civitfun permite validar el contenido de un fichero antes de enviarlo automáticamente a la autoridad correspondiente. Esto es útil para detectar errores de estructura o campos obligatorios ausentes.
1. Subir un fichero para validar
Introduce el nombre exacto del fichero en el campo correspondiente y pulsa Validar.
Ejemplo:
2. Revisión del contenido y errores
- Visualiza el contenido plano del fichero (.xml o .txt)
- Se mostrará una tabla con errores si faltan campos obligatorios
-
Ejemplo:
Line 1: Field 'paymentMethod' is required but missing Line 11: Field 'idDate' is required but missing
Ejemplo:
3. Corrección y nueva validación
Corrige los errores detectados y repite la validación hasta obtener confirmación de éxito.
📊 Requisitos técnicos y nomenclatura del fichero
-
Formatos aceptados:
.txt,.xml -
Nombre del fichero: debe contener fecha (ej:
viajeros-20250512.txt) - El archivo debe estar disponible antes de las 03:00 horas
Campos obligatorios:
- Número de documento de identidad
- Tipo de documento
- Primer y segundo apellido
- Nombre
- Sexo
- Fecha de nacimiento
- Nacionalidad
- Fecha y hora de entrada y salida
- Número de viajeros
- Tipo de pago y datos del medio (opcional)
- Dirección completa, localidad, CP, provincia, país
- Teléfono fijo/móvil, email
- Fecha de contrato
- Parentesco entre viajeros
- Rol (titular o acompañante)
📅 Programación recomendada
Genera el fichero a la 01:00 para que esté disponible antes de las 03:00 y se envíe automáticamente a SES Hospedajes.
❓ Preguntas frecuentes
¿Puedo cambiar de PMS a fichero (o viceversa)?
Sí, puedes hacerlo desde el dashboard en cualquier momento.
¿El mismo SFTP puede servir para varios hoteles?
Sí, usando carpetas diferentes para cada uno.
¿Qué pasa si el fichero tiene errores?
No se enviará ningún dato. Debes corregirlo y volver a validar.
¡Espero que este artículo sea de utilidad! Si necesitas más información contacta con support@civitfun.com , estaremos encantado de ayudar. 😊✍️