Saltar al contenido

Puede que la traducción no esté actualizada: la versión en alemán ha cambiado desde entonces. Versión en alemán

Solución de problemas en la migración desde JTL

FAQRevisado por última vez el 21/10/2026

Respuestas a preguntas y mensajes de error habituales en la migración desde JTL-Wawi: conexión, registro de la aplicación, prueba, registro y cierre.

Aquí encontrarás soluciones a los obstáculos más frecuentes en la migración desde JTL-Wawi.

Conexión

jtl-bridge indica «Die Wawi-API … ist nicht erreichbar» (no se puede acceder a la API de Wawi)

jtl-bridge no llega al servidor REST. Comprueba: ¿está en marcha el servidor REST? ¿Son correctos el puerto y el nombre de la base de datos en la dirección? El puerto es el que configuraste en Wawi para el servidor REST (p. ej. 5883 o 5885). Al iniciarse, el programa busca por sí mismo en los puertos 5883 a 5890 y, tras un fallo, vuelve a preguntar. Lo más sencillo es iniciar jtl-bridge directamente en el ordenador en el que funciona tu JTL-Wawi. Si lo inicias en otro PC, el firewall de Windows del servidor debe permitir el puerto.

«Die Wawi-API lehnt den API-Schlüssel ab» (la API de Wawi rechaza la clave API)

La aplicación se eliminó en Wawi o la clave no es correcta. Simplemente vuelve a iniciar jtl-bridge: registrará allverto de nuevo, tú recorres el asistente en Wawi hasta Einrichtung abschließen y la clave nueva sustituye a la anterior. Detalles: Configurar la API REST.

¿Cómo registro allverto en Wawi?

En JTL-Wawi, abre Anwendungsregistrierungen (registros de aplicaciones) → Anwendung registrieren (registrar aplicación) y avanza hasta Registrierung beginnen (iniciar registro). Solo cuando allí aparezca «Es wird auf die Übermittlung einer Registrierungsanfrage … gewartet» (esperando una solicitud de registro), pulsa Enter en la ventana de jtl-bridge: antes, Wawi no acepta ninguna solicitud. Después revisa Anwendungsinformationen, elige un usuario de Wawi en Benutzer, confirma los permisos (solo lectura) en Zugriffsverwaltung y haz clic en Einrichtung abschließen.

¿Dónde encuentro la clave API en Wawi?

En ninguna parte, y es así a propósito. Wawi no muestra ninguna clave ni la genera con solo pulsar un botón. Solo la entrega a una aplicación que la solicita en ese momento. De eso se encarga jtl-bridge, que entrega la clave cifrada a allverto.

«Probar conexión» dice que la prueba la hace jtl-bridge

Tu dirección (p. ej. localhost o 192.168.…) solo es accesible en tu servidor o en la red de tu empresa, no desde internet. Inicia jtl-bridge en el servidor y pega el código de configuración: el resultado aparece en el asistente.

La ventana indica «Login failed» en SQL Server

Se trata del usuario y la contraseña de SQL Server (normalmente sa), no de tu acceso a JTL-Wawi. La ventana vuelve a preguntar tras un fallo: introduce los datos de nuevo. Detalles: Acceso a través de la base de datos de JTL.

«Nur HTTPS ist erlaubt» (solo se permite HTTPS)

Por motivos de seguridad, jtl-bridge solo sube datos a través de https://. Vuelve a copiar el código de configuración desde allverto: contiene la dirección correcta.

«Obtener datos directamente ahora» falla

Solo funciona si tu servidor de Wawi es accesible desde internet y abre el puerto para los servidores de allverto (2.31.70.120, 2.31.74.112, 2.31.72.228). Revisa la dirección con Probar conexión. Con la API de Wawi, además, la clave API tiene que estar guardada (Enviar registro desde allverto). Si tu servidor solo es accesible en tu red, usa jtl-bridge en el equipo donde funciona tu JTL-Wawi.

«Dein REST-Server antwortet nur über HTTPS» (tu servidor REST solo responde por HTTPS)

Tu servidor REST solo acepta conexiones por https://. En el resultado de la prueba, haz clic en Cambiar la dirección a https://. allverto guarda la dirección y vuelve a probar.

allverto pregunta por el certificado

Tu servidor REST usa un certificado creado por ti. allverto muestra la huella (SHA-256), el emisor y la validez. Compara la huella con el certificado de tu servidor y haz clic en Confiar en este certificado. Después, allverto solo se conecta con exactamente ese certificado. Si más tarde allverto indica otro certificado, confírmalo solo si lo renovaste tú.

Datos y prueba

Las cantidades en «Datos encontrados» no coinciden con mi Wawi

Si has indicado una fecha de cambio, solo se tienen en cuenta los documentos hasta ese día. En la vía de la API faltan las suscripciones y las facturas de proveedor si Completar los datos que faltan desde la base de datos está desactivado.

¿Qué significan los resultados del registro?

Para cada registro de datos ves si se ha creado, actualizado, omitido (sin cambios o no compatible) o rechazado, con el motivo. Filtra por resultado y tipo de datos y, si lo necesitas, descarga el registro como CSV.

¿Por qué algunos atributos aparecen como «omitidos»?

La API de Wawi solo entrega los atributos de los artículos como identificador, sin nombre. Con Completar los datos que faltan desde la base de datos, jtl-bridge añade los nombres.

¿Se duplican los datos si migro varias veces?

No. allverto recuerda, para cada registro de JTL, en qué se ha convertido. Los registros sin cambios se omiten y los modificados se actualizan.

¿Por qué las facturas migradas no reciben un número nuevo?

Los documentos llegan 1:1 con su número original de JTL. Por eso migras primero las series de numeración: así, tras la migración, se continúa con el siguiente número libre.

Cierre

¿Puedo volver a actualizar los datos después del cierre?

No. Tras Completar el cambio, el código de configuración deja de ser válido y se borra el almacenamiento intermedio. Por eso, el día del cambio inicia primero una ejecución delta y revisa el registro.

¿Se conservan los registros?

Sí. Los datos migrados, las asignaciones y los registros se conservan también después del cierre.

Temas relacionados