Vai al contenuto

La traduzione potrebbe non essere aggiornata: nel frattempo la versione tedesca è cambiata. Versione tedesca

Risoluzione dei problemi nella migrazione da JTL

FAQUltima verifica il 21/10/2026

Risposte a domande frequenti e messaggi di errore tipici durante la migrazione da JTL-Wawi – connessione, registrazione dell'applicazione, 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? Porta e nome del database nell'indirizzo sono corretti? La porta è quella che hai impostato in Wawi per il server REST (ad es. 5883 o 5885). All'avvio il programma la cerca da solo sulle porte da 5883 a 5890 e, dopo un errore, chiede di nuovo. La cosa più semplice è avviare jtl-bridge direttamente sul computer su cui gira la tua JTL-Wawi. Se lo avvii su un altro PC, il firewall di Windows del server deve consentire la porta.

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

L'applicazione è stata rimossa nella Wawi oppure la chiave non è corretta. Avvia semplicemente di nuovo jtl-bridge: registrerà di nuovo allverto, tu completi la procedura guidata in Wawi fino a Einrichtung abschließen (completa la configurazione) e la nuova chiave sostituisce quella vecchia. Dettagli: Configurare l'API REST.

Come registro allverto in Wawi?

In JTL-Wawi apri Anwendungsregistrierungen (registrazioni delle applicazioni) → Anwendung registrieren (registra applicazione) e prosegui fino a Registrierung beginnen (avvia registrazione). Solo quando lì compare «Es wird auf die Übermittlung einer Registrierungsanfrage … gewartet» premi Invio nella finestra di jtl-bridge – prima la Wawi non accetta alcuna richiesta. Poi controlla Anwendungsinformationen, scegli un utente Wawi in Benutzer, conferma i diritti (sola lettura) in Zugriffsverwaltung e fai clic su Einrichtung abschließen.

Dove trovo la chiave API in Wawi?

Da nessuna parte – ed è voluto. La Wawi non mostra alcuna chiave e non ne crea una con un clic. La rilascia solo a un'applicazione che sta facendo richiesta in quel momento. Se ne occupa jtl-bridge, che consegna la chiave cifrata ad allverto.

«Verifica connessione» dice che il test lo fa jtl-bridge

Il tuo indirizzo (ad es. localhost o 192.168.…) è raggiungibile solo sul tuo server o nella tua rete aziendale, non da internet. Avvia jtl-bridge sul server e incolla il codice di configurazione – il risultato compare nella procedura guidata.

La finestra segnala «Login failed» per il SQL Server

Si intendono utente e password di SQL Server (di solito sa), non il tuo accesso a JTL-Wawi. Dopo un errore la finestra chiede di nuovo – inseriscili semplicemente ancora una volta. Dettagli: Accesso tramite il database JTL.

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

Per motivi di sicurezza jtl-bridge carica solo tramite https://. Copia di nuovo il codice di configurazione da allverto – contiene l'indirizzo corretto.

«Recupera dati direttamente ora» non riesce

Funziona solo se il tuo server Wawi è raggiungibile da internet e apre la porta per i server di allverto (2.31.70.120, 2.31.74.112, 2.31.72.228). Controlla l'indirizzo con Verifica connessione. Con l'API Wawi deve inoltre essere salvata la chiave API (Invia registrazione da allverto). Se il tuo server è raggiungibile solo nella tua rete, usa jtl-bridge sul computer su cui gira la tua JTL-Wawi.

«Dein REST-Server antwortet nur über HTTPS» (il tuo server REST risponde solo tramite HTTPS)

Il tuo server REST accetta solo connessioni tramite https://. Nel risultato del test fai clic su Cambia l’indirizzo in https://. allverto salva l'indirizzo e verifica di nuovo.

allverto chiede di confermare il certificato

Il tuo server REST usa un certificato creato da te. allverto mostra l'impronta (SHA-256), l'emittente e la validità. Confronta l'impronta con il certificato sul tuo server e fai clic su Fidati di questo certificato. Dopo, allverto si collega solo con esattamente questo certificato. Se in seguito allverto segnala un altro certificato, confermalo solo se l'hai rinnovato tu.

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 Integrare i dati mancanti dal database è disattivato.

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 Integrare i dati mancanti dal database 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 codice di configurazione 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