El programa auxiliar jtl-bridge
jtl-bridge lee JTL-Wawi (base de datos o API REST) en la red de la empresa y sube los datos cifrados a allverto. Comandos, opciones y seguridad.
jtl-bridge es un pequeño programa de línea de comandos para la migración. Se ejecuta en un equipo de la red de tu empresa, allí donde se puede acceder a JTL-Wawi y a su SQL Server, lee los datos y los sube a allverto a través de una conexión cifrada. Así no tienes que exponer a internet ni tu base de datos ni el servidor REST de Wawi.
Cómo obtiene jtl-bridge sus credenciales
Guardas el servidor, el usuario y la contraseña, o la dirección y la clave API, en el asistente de migración. jtl-bridge inicia sesión en allverto con el token de importación y recoge estos datos cifrados. Como alternativa, defines la contraseña y la clave API solo en local (JTL_DB_PASSWORD, JTL_API_KEY).
El token de importación lo generas en el asistente con Generar token de importación. Solo se muestra una vez y es válido 30 días, como máximo hasta que se completa la migración. Con Ampliar 30 días lo prolongas desde hoy; con Nuevo token de importación, el anterior deja de ser válido. Además, el token solo es válido mientras la persona que lo generó o amplió por última vez siga activa y pueda «Realizar la migración desde JTL-Wawi».
Comandos
| Comando | Para qué |
|---|---|
jtl-bridge check --url <allverto-Adresse> --token <Import-Token> | Comprobar la conexión y la estructura de la base de datos, contar cantidades; no sube nada. |
jtl-bridge upload --url <allverto-Adresse> --token <Import-Token> | Leer y subir los datos. |
jtl-bridge register --api-url http://wawi-server:<port>/api/eazybusiness | Registrar allverto como app en Wawi y obtener la clave API (consulta Configurar la API REST). |
El comando upload adecuado con tu dirección lo muestra el asistente en el recuadro Programa auxiliar jtl-bridge, con un botón para copiarlo.
Opciones importantes
| Opción | Significado |
|---|---|
--source db, --source api | Forzar la vía (si no, se usa el origen definido en allverto) |
--fill-from-db | En la vía de la API: completar desde la base de datos lo que la API no entrega |
--until JJJJ-MM-TT | solo documentos hasta ese día (fecha de cambio); formato AAAA-MM-DD |
--entities a,b,c | solo determinados tipos de datos |
--no-pdfs | no obtener los PDF de las facturas |
--db-host, --db-instance, --db-port, --db-name, --db-user, --db-encrypt | Sobrescribir en local los datos de la base de datos |
--api-url | Sobrescribir en local la dirección del servidor REST |
Seguridad
- jtl-bridge solo sube datos por HTTPS y, si no, se interrumpe («Nur HTTPS ist erlaubt (Daten verlassen das Firmennetz).», es decir, solo se permite HTTPS porque los datos salen de la red de la empresa).
- Además de la conexión HTTPS, los datos van cifrados con una clave derivada del token de importación.
- allverto solo guarda una huella del token de importación, nunca el propio token.
- Tras diez tokens no válidos desde la misma dirección, allverto bloquea nuevos intentos durante unos minutos.
- Tras Completar el cambio, el token deja de ser válido y se borran los datos de JTL almacenados temporalmente.
Proceso típico
jtl-bridge check …: ¿está todo bien?jtl-bridge upload …: subir los datos.- En allverto: Asignaciones → Prueba → Migración.
- Antes de la fecha de cambio, vuelve a ejecutar
uploady, en allverto, Iniciar ejecución delta.