Vai al contenuto

Risoluzione dei problemi nella migrazione da JTL

FAQUltima verifica il 15/10/2026

Risposte a domande frequenti e messaggi di errore tipici durante la migrazione da JTL-Wawi – connessione, registrazione dell'app, prova, protocollo e conclusione.

Qui trovi le soluzioni agli ostacoli più frequenti nella migrazione da JTL-Wawi.

Connessione

jtl-bridge segnala «Die Wawi-API … ist nicht erreichbar» (l'API Wawi non è raggiungibile)

jtl-bridge non raggiunge il server REST. Verifica: il server REST è in esecuzione? Nome del computer, porta e nome del database nell'indirizzo (http://wawi-server:<port>/api/eazybusiness) sono corretti? Il firewall del computer della Wawi consente la porta nella rete interna? jtl-bridge gira davvero nella stessa rete?

«Die Wawi-API lehnt den API-Schlüssel ab» (l'API Wawi rifiuta la chiave API)

La chiave è stata copiata male oppure la registrazione dell'app è stata rimossa nella Wawi. Avvia di nuovo jtl-bridge register, conferma nella Wawi e inserisci la nuova chiave in allverto. Dettagli: Configurare l'API REST.

Non trovo la registrazione dell'app nella Wawi

Secondo la nostra documentazione, in Wawi 2.2 la voce si chiama Admin → App-Registrierung (registrazione app). In altre versioni può chiamarsi diversamente – cerca nel menu Admin «App» o «API». La richiesta compare solo dopo che jtl-bridge register l'ha inviata.

«Nur HTTPS ist erlaubt» (è consentito solo HTTPS)

Per motivi di sicurezza jtl-bridge carica solo tramite https://. Controlla l'indirizzo di allverto nel comando.

«Recupera dati direttamente» non funziona

Funziona solo se la tua API Wawi è raggiungibile da internet – cosa che di solito non avviene (e non è nemmeno necessaria). Usa jtl-bridge nella rete aziendale.

Dati e prova

Le quantità in «Dati trovati» non corrispondono alla mia Wawi

Se hai inserito una data di passaggio, vengono considerati solo i documenti fino a quel giorno. Con il canale API mancano abbonamenti e fatture passive se hai avviato jtl-bridge senza --fill-from-db.

Cosa significano gli esiti nel protocollo?

Per ogni record vedi se è stato creato, aggiornato, saltato (invariato o non supportato) o rifiutato – con il motivo. Filtra per esito e tipo di dati e, se serve, scarica il protocollo come CSV.

Perché alcuni attributi risultano «saltati»?

L'API Wawi fornisce gli attributi degli articoli solo come identificativo senza nome. Con --fill-from-db e il database configurato, jtl-bridge integra i nomi.

I dati vengono creati due volte se trasferisco più volte?

No. allverto ricorda per ogni record JTL cosa ne è stato fatto. I record invariati vengono saltati, quelli modificati aggiornati.

Perché le fatture trasferite non consumano un nuovo numero?

I documenti arrivano 1:1 da JTL con il loro numero originale. Per questo trasferisci prima le serie numeriche – così dopo la migrazione si prosegue con il numero libero successivo.

Conclusione

Posso aggiornare ancora dopo la conclusione?

No. Dopo Completa il passaggio il token di importazione non è più valido e la memoria temporanea è cancellata. Per questo, alla data di passaggio, avvia prima un'esecuzione delta e controlla il protocollo.

I protocolli vengono conservati?

Sì. Dati trasferiti, assegnazioni e protocolli restano anche dopo la conclusione.

Argomenti correlati