Saltar a contenido

Errores de Conexión

Esta sección describe los errores más comunes de conexión con SAGE 50 API y sus soluciones.

Diagnóstico de Conexión

Paso 1: Verificar SAGE 50

Primero, asegúrese de que SAGE 50 está correctamente instalado:

  1. Abra SAGE 50
  2. Verifique que funciona correctamente
  3. Vaya a Herramientas > Opciones > API
  4. Confirme que el servidor API está habilitado

Paso 2: Probar Conexión desde xls2sage50

  1. Abra xls2sage50
  2. Vaya a Configuración > Conexión SAGE 50
  3. Haga clic en "Probar Conexión"
  4. Anote el mensaje de error exacto

Errores Comunes

Error: "Conexión rechazada"

Connection refused

Síntomas: - Mensaje: "No se puede conectar al servidor" - Error: [Errno 61] Connection refused - Código de error: 10061

Causas posibles: 1. SAGE 50 no está ejecutándose 2. El servidor API no está habilitado en SAGE 50 3. El puerto configurado es incorrecto

Soluciones:

1. Verificar que SAGE 50 está abierto: 

# Verificar proceso de SAGE 50
tasklist | findstr /i "sage"

2. Habilitar servidor API en SAGE 50: 1. Abra SAGE 50 2. Vaya a Herramientas > Opciones 3. Busque la sección API o Conectividad 4. Marque "Habilitar servidor API" 5. Reinicie SAGE 50

3. Verificar el puerto: 

# Verificar qué escucha en el puerto 16500
netstat -ano | findstr :16500

Error: "Timeout de conexión"

Connection timeout

Síntomas: - La aplicación se queda esperando - Mensaje: "Tiempo de espera agotado" - Error: [Errno 10060] Connection timed out

Causas posibles: 1. Firewall bloqueando la conexión 2. SAGE 50 está ocupado 3. Timeout configurado muy corto 4. Latencia de red excesiva

Soluciones:

1. Configurar el firewall: - Abra Firewall de Windows Defender - Reglas de entrada > Nueva regla - Puerto > TCP > 16500 - Permitir la conexión - Perfiles: Dominio, Privado, Público - Nombre: SAGE 50 API

2. Aumentar el timeout: 

# En config.ini
[API]
API_TIMEOUT = 60

3. Verificar latencia de red: 

# Hacer ping al servidor (si es remoto)
ping sage50-server

# La latencia debe ser menor a 100ms

Error: "Puerto en uso"

Address already in use

Síntomas: - Mensaje: "El puerto ya está en uso" - Error: [Errno 10048] Address already in use

Causas posibles: 1. Otra instancia de SAGE 50 está ejecutándose 2. Otra aplicación está usando el puerto 16500

Soluciones:

1. Verificar qué usa el puerto: 

netstat -ano | findstr :16500

2. Terminar el proceso si es necesario: 

taskkill /PID <numero_de_proceso> /F

3. Cambiar el puerto: 

# En config.ini de xls2sage50
[API]
API_PORT = 16501

# Y configurar el mismo en SAGE 50

Error: "Host no alcanzable"

Host unreachable

Síntomas: - Mensaje: "No se puede resolver el nombre del host" - Error: [Errno 11001] getaddrinfo failed

Causas posibles: 1. El nombre del servidor es incorrecto 2. Problemas de DNS 3. El servidor está apagado

Soluciones:

1. Verificar el nombre del host: 

# En config.ini
[API]
API_HOST = 192.168.1.100  # Usar IP en lugar de nombre

2. Hacer ping al servidor: 

ping nombre-servidor
ping 192.168.1.100

3. Verificar la conexión de red: - Cables conectados - Wi-Fi funcionando - VPN conectada (si aplica)

Error: "Certificado no válido"

SSL certificate error

Síntomas: - Mensaje: "Error de certificado SSL" - Error relacionado con HTTPS/TLS

Causas posibles: 1. El certificado de SAGE 50 ha expirado 2. El certificado es auto-firmado 3. El nombre del certificado no coincide con el host

Soluciones:

1. Deshabilitar verificación de SSL (solo para desarrollo): 

# En config.ini - NO usar en produccion
[API]
SSL_VERIFY = false

2. Instalar el certificado: - Obtener el certificado del servidor SAGE 50 - Instalar en "Entidades de certificación raíz de confianza" - Reiniciar xls2sage50

Solución Paso a Paso

Siga estos pasos en orden para resolver problemas de conexión:

1. Verificar Requisitos Básicos

# 1. Verificar que SAGE 50 está instalado
dir "C:\Program Files (x86)\Sage\Sage 50"

# 2. Verificar que SAGE 50 se puede ejecutar
"C:\Program Files (x86)\Sage\Sage 50\sage50.exe"

# 3. Verificar versión de SAGE 50 (debe ser 2020+)
# (Revisar en Ayuda > Acerca de)

2. Verificar Configuración de API en SAGE 50

  1. Abra SAGE 50
  2. Herramientas > Opciones
  3. Busque la sección API
  4. Verifique:
  5. Servidor API habilitado
  6. Puerto configurado (normalmente 16500)
  7. Sin límite de conexiones

3. Configurar Firewall

# Abrir firewall con regla para SAGE 50
netsh advfirewall firewall add rule name="SAGE 50 API" dir=in action=allow protocol=TCP localport=16500

4. Verificar Conexión desde xls2sage50

# Ejecutar test de conexión
python xls2sage50.py test-connection

# O usando la interfaz gráfica
# Configuración > Conexión SAGE 50 > Probar Conexión

5. Revisar Logs

Si todo lo anterior falla, revise los logs:

%USERPROFILE%\Documents\xls2sage50\logs\xls2sage50.log

Busque errores con "connection", "API" o "SAGE".

Problemas de Red Específicos

Conexión Remota

Si SAGE 50 está en un servidor remoto:

  1. Verificar VPN:
  2. La VPN debe estar conectada

  3. El servidor debe ser alcanzable

  4. Verificar latencia: 

    ping servidor-sage50
# La latencia debe ser < 100ms

  5. Configurar timeout más largo: 

    [API]
API_TIMEOUT = 60

Conexión por VPN

Si usa VPN para conectar:

  1. Verificar que la VPN está conectada: 

    ipconfig
# Buscar el adaptador de VPN

  2. Usar IP en lugar de nombre: 

    [API]
API_HOST = 10.0.0.50  # IP del servidor en VPN

  3. Configurar hosts file (si es necesario): 

    # C:\Windows\System32\drivers\etc\hosts
10.0.0.50  sage50-server

Herramientas de Diagnóstico

Telnet

Para probar si el puerto es accesible:

telnet localhost 16500

Si la conexión tiene éxito, verá una pantalla negra (o el banner de SAGE 50).

PowerShell Test-NetConnection

Test-NetConnection -ComputerName localhost -Port 16500

Salida esperada: 

ComputerName     : localhost
RemoteAddress    : 127.0.0.1
RemotePort       : 16500
TcpTestSucceeded  : True

Contactar Soporte

Si después de intentar todas estas soluciones el problema persiste:

  1. Exporte el informe de diagnóstico:
  2. Abra xls2sage50
  3. Ayuda > Diagnóstico

  4. Generar Informe

  5. Recolecte información:

  6. Versión de xls2sage50
  7. Versión de SAGE 50
  8. Mensaje de error exacto

  9. Captura de pantalla del error

  10. Contacte soporte:

  11. Email: soporte@alcalic.com
  12. Incluya todos los datos recolectados

!!! tip "Información Necesaria**

Al contactar soporte, incluya siempre: versión de SAGE 50, versión de xls2sage50, mensaje de error exacto y el archivo de diagnóstico.

Próximo Paso

!!! question "¿Problema Resuelto?**

Si el problema no está listado aquí, consulte [Problemas Comunes](comunes.md) para más soluciones.