📡 Errores comunes en la recogida de datos desde PMS o SFTP

Este artículo recoge los errores más frecuentes que pueden aparecer durante la recogida de datos de viajeros en el módulo de Registro de Viajeros, tanto si utilizas conexión con un PMS como si empleas un fichero de exportación vía SFTP.

Estos errores aparecen en el Panel de Control de Registro de Viajeros

Consulta a continuación el significado de cada error y las acciones recomendadas para resolverlo.

🔗 Índice de errores

1. Archivo no encontrado: Error: get
2. Archivo no encontrado: Fecha incorrecta
3. Archivo no encontrado: Permiso denegado
4. Problemas de conexión SFTP (timeout o refusals)
5. Error de DNS o nombre de host (ENOTFOUND)
6. Fallos de autenticación SFTP
7. No encuentra reservas

❌ Archivo no encontrado

Archivo no encontrado: get: /PRUEBA/TEST_YYYYMMDD.xml/PRUEBA/TEST_YYYYMMDD.xml

Error: get: /PRUEBA/TEST_YYYYMMDD.xml/PRUEBA/TEST_YYYYMMDD.xml

¿Qué significa este error?

Este mensaje indica que un sistema ha intentado acceder (hacer un GET) al archivo TEST_YYYYMMDD.xml ubicado en el directorio /PRUEBA/, pero el archivo no se encuentra disponible en la ruta esperada.

Desglose del mensaje:

• Archivo no encontrado: Error tipo 404 Not Found.

• get: Se intentó hacer una solicitud tipo GET (lectura o descarga).

• /PRUEBA/TEST_YYYYMMDD.xml (x2): Ruta del archivo solicitada y ruta resuelta. A menudo aparece duplicada en el log.

Causas frecuentes:

• El archivo aún no ha sido generado por el sistema de origen (PMS, channel manager, etc.).

• El nombre del archivo es incorrecto (por ejemplo, código de hotel o fecha mal formada).

• El archivo fue eliminado, está incompleto o aún no ha sido subido.

• La carpeta o ruta de búsqueda está mal configurada en el dashboard de Civitfun.

¿Qué hacer?

• Verificar si el archivo existe en el repositorio FTP/SFTP.

• Confirmar que el nombre y formato del archivo coinciden con lo esperado.

• Revisar la configuración de recogida en el dashboard (prefijo, sufijo, ruta y formato).

• Contactar con el proveedor del PMS si el fichero depende de terceros.

• Tras confirmar que el archivo está disponible, usar la opción “Forzar envío” desde el panel.

🚫 Archivo no encontrado: Fecha incorrecta

Error: WRONG DATE: Booking entrance date: 2025-05-17 expected: 2025-06-21.txt

¿Qué significa este error?

El sistema detectó que el archivo contiene más de 10 registros en lo que la fecha de entrada no es correcta y no puede procesarlo.

Desglose del mensaje:

• Wrong date: Se esperaba encontrar un archivo con una fecha específica pero no es así.

• booking entrance date: Indica la fecha que estamos recogiendo y que da el problema

• expected: Indica la fecha que esperábamos recoger.

Causas frecuentes:

• El archivo existe pero contiene registros que superan en 10 los registros erróneos.

• El archivo que se ha subido contiene los registros de otro día.

¿Qué hacer?

• Intenta "Forzar envío" y espera por si se carga el archivo

• Accede al Panel de Configuración del Registro de viajero con un usuario admin

• Verifica el contenido del archivo realizando una validación del fichero

• Si el archivo contiene los datos de otro día; corrige el archivo y vuelve a subirlo. Una vez corregido puedes volver a "forzar envío"

• Si el archivo contiene más de 10 registros erróneos, corrige o elimina esos registros  y vuelve a forzar el envío

🚫 Archivo no encontrado: Permiso denegado

Archivo no encontrado: get: Permission denied/CivitFun/2025-05-17.txt

¿Qué significa este error?

El sistema intentó acceder a un archivo específico dentro del servidor SFTP, pero no tiene los permisos necesarios para leerlo o descargarlo.

Desglose del mensaje:

• Archivo no encontrado: Se esperaba encontrar un archivo pero no fue posible acceder.

• get: Indica que se intentó acceder mediante un método de lectura.

• Permission denied: El usuario configurado no tiene permisos suficientes.

• /CivitFun/2025-05-17.txt: Ruta completa del archivo solicitado.

Causas frecuentes:

• El archivo existe pero los permisos no permiten acceder a él.

• El usuario configurado no tiene permisos de lectura en la carpeta.

• El archivo fue creado por otro usuario con permisos restrictivos.

¿Qué hacer?

• Accede vía cliente SFTP o pide a tu proveedor que confirme los permisos del archivo si lo has hecho con terceros.

• Verifica que el usuario configurado tiene permisos de lectura.

• Si corresponde, reconfigura los permisos y comprueba que las IPs de Civitfun tiene permiso

🕒 Problemas de conexión SFTP (refusals)

Error: connect ECONNREFUSED 123.456.7.89:22

¿Qué significa este error?

Este mensaje indica que el sistema no ha podido establecer una conexión con el servidor SFTP.

Desglose del mensaje:

• connect ECONNREFUSED: El intento de conexión fue rechazado por el servidor.

• 123.456.7.89: Dirección IP del servidor configurado.

• 22: Puerto usado para la conexión (normalmente SFTP).

Causas frecuentes:

• El servidor está apagado, caído o no disponible.

• El puerto configurado no está habilitado o está bloqueado.

• Cortafuegos o reglas de red impiden el acceso.

• La dirección IP es incorrecta.

¿Qué hacer?

• Verifica que el servidor está encendido y activo.

• Confirma que la IP y puerto son los correctos.

• Prueba conectarte desde otra red o usa herramientas como telnet o ping.

• Contacta con el proveedor técnico del servidor

🕒 Problemas de conexión SFTP (timeout)

Error: connect: getConnection: Timed out while waiting for handshake

🧾 ¿Qué significa este error?

Este mensaje indica que el sistema intentó establecer una conexión con el servidor remoto (normalmente un servidor SFTP), pero la fase de "handshake" o apretón de manos inicial no se completó en el tiempo esperado.

Desglose del mensaje

• connect: se intentó abrir una conexión.

• getConnection: indica que la llamada es parte de la función de obtención de conexión.

• Timed out while waiting for handshake: el sistema esperaba completar la llamada con el servidor (fase de intercambio inicial para establecer la conexión segura), pero no recibió respuesta a tiempo.

Causas frecuentes

• El servidor está encendido pero no responde con la rapidez esperada.

• Problemas de red o latencias elevadas entre el cliente (Civitfun) y el servidor de destino.

• El servidor SFTP está saturado o tiene configuraciones de seguridad que retrasan o bloquean el handshake.

• Firewall, proxy o reglas de seguridad están bloqueando la negociación inicial.

• Claves SSH no válidas o no registradas correctamente.

¿Qué hacer?

• Verifica que el servidor esté en línea y disponible desde otra red.

• Comprueba que el puerto de conexión (habitualmente el 22 para SFTP) esté abierto y accesible.

• Si usas clave SSH, asegúrate de que:

  • La clave privada corresponde con la clave pública registrada en el servidor.

  • El usuario tenga permisos de acceso adecuados.

• Consulta con tu proveedor técnico si existen reglas de firewall, proxy o configuraciones avanzadas de seguridad que puedan estar impidiendo el handshake.

• Prueba una conexión manual con herramientas como sftp o FileZilla para confirmar si el error es replicable.

🌐 Error de DNS o nombre de host (ENOTFOUND)

Error: getaddrinfo ENOTFOUND sftp.example.com

¿Qué significa este error?

Este error ocurre cuando el nombre del servidor configurado no se puede traducir a una dirección IP válida.

Desglose del mensaje:

• getaddrinfo: Función que intenta resolver el nombre DNS.

• ENOTFOUND: El dominio no fue encontrado en el sistema de nombres (DNS).

• sftp.example.com: El host que el sistema intenta alcanzar.

Causas frecuentes:

• Error tipográfico en el nombre del servidor.

• El dominio no existe o está mal registrado.

• Fallo temporal en los servidores DNS.

¿Qué hacer?

• Asegúrate de que el host está bien escrito.

• Prueba acceder al dominio desde un navegador o hacer nslookup o ping.

• Consulta con el proveedor si hubo cambios en el dominio o servidores DNS.

🔐 Fallos de autenticación SFTP

Error: All configured authentication methods failed

¿Qué significa este error?

El sistema intentó conectarse al servidor SFTP, pero ninguno de los métodos de autenticación disponibles funcionó correctamente.

Desglose del mensaje:

• All configured authentication methods failed: Fallaron todas las combinaciones usuario/contraseña o clave SSH configuradas.

Causas frecuentes:

• Usuario o contraseña incorrectos.

• Falta de clave SSH válida (o no asociada al usuario).

• El servidor solo acepta un tipo de autenticación distinto al configurado.

¿Qué hacer?

• Verifica con el proveedor las credenciales de acceso.

• Comprueba si el servidor necesita clave SSH, certificado o ambos.

• Si se usa autenticación con clave, asegúrate de haberla subido al servidor.

Error: No bookings found

✅ Recomendación general

Una vez identificado el tipo de error:

• Verifica que el archivo exista y esté accesible
• Revisa la configuración del dashboard
• Utiliza la opción “Forzar envío” si todo está en orden
• Contacta con soporte si el error persiste

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