Risolvi gli errori di connessione JTL

Nota: le etichette in grassetto corrispondono all’interfaccia in italiano. Se l’app è impostata in inglese, compaiono in inglese.

Quando un’autorizzazione JTL non viene completata, l’hub mostra una pagina con un titolo, Cosa è successo e Cosa fare. Seleziona Leggi la guida alla risoluzione dei problemi in quella pagina per aprire la sezione corrispondente qui sotto, oppure cerca il titolo nella tabella. Un tentativo non riuscito non salva nulla e lascia invariata una connessione esistente, quindi puoi sempre selezionare Riprova.

Codice	Titolo sullo schermo	Significato
callback_mismatch	JTL mostra una propria pagina di errore	L’URL di callback nell’app JTL è diverso da quello nell’hub.
invalid_client	JTL non ha accettato le credenziali dell’app	JTL ha rifiutato il client ID o il client secret.
missing_scope	Mancano dei permessi	All’app o all’autorizzazione mancano gli scope richiesti.
cancelled	Connessione annullata	L’accesso non è stato approvato su JTL.
expired	L’autorizzazione è scaduta	Il tentativo è scaduto o si è concluso in un altro browser.
account_mismatch	È stato usato un altro account	Per il ricollegamento è stato usato un altro account JTL.
not_activated	L’account JTL non è ancora pronto	L’account non ha mai effettuato l’accesso al portale FFN o non è un account commerciante.
permission_lost	Non hai più accesso	Hai perso il permesso Connessioni durante l’autorizzazione.
reconnect_required	Da ricollegare, sulla scheda dell’account	JTL non accetta più l’autorizzazione salvata.
unavailable	JTL non è raggiungibile al momento	Non è stato possibile raggiungere JTL o la rete.
failed	Impossibile completare la connessione, oppure Non è stato possibile confermare la connessione	Un errore imprevisto, oppure non è stato possibile confermare il risultato.

La barra degli indirizzi del browser mostra anche il codice ricevuto dall’hub, dopo outcome=.

Informazioni per il supporto

Se contatti il supporto, includi questi dati. Nessuno di essi è riservato:

• l’ora del tentativo, con il tuo fuso orario
• il nome del workspace
• l’ambiente: Produzione o Sandbox
• il client ID della tua app JTL
• l’URL di callback mostrato nella finestra Collega JTL Fulfillment Network
• il titolo mostrato sullo schermo oppure il codice dopo outcome= nella barra degli indirizzi

Non inviare mai il client secret, la tua password JTL o i token. Se alleghi uno screenshot, assicurati che non ne mostri nessuno.

L’URL di callback non corrisponde

Codice: callback_mismatch

Cosa vedi: JTL mostra un errore al posto della pagina di accesso o di consenso, spesso con un riferimento al redirect URI. Non torni all’hub. A seconda di dove JTL controlla l’indirizzo, l’hub potrebbe invece mostrare JTL non ha accettato le credenziali dell’app.

Causa probabile: Il redirect URI salvato nell’app JTL non corrisponde esattamente all’URL di callback mostrato nella finestra Collega JTL Fulfillment Network. Le differenze tipiche sono una barra finale mancante o in più, http al posto di https, spazi o un indirizzo copiato da un’altra fonte.

Cosa fare:

1. In Balta Labs, apri Impostazioni → Connessioni, seleziona Add account e scegli JTL FFN. In Prima di continuare, seleziona Copia accanto all’URL di callback.
2. Apri l’app su kundencenter.jtl-software.de/oauth, sostituisci il suo redirect URI con quello copiato e salva.
3. Torna all’hub e seleziona di nuovo Continua su JTL. Non ricaricare la pagina di errore di JTL.

Per il supporto: i dati indicati sopra e il testo dell’errore di JTL.

JTL rifiuta il client ID o il secret

Codice: invalid_client

Cosa vedi: L’hub mostra JTL non ha accettato le credenziali dell’app. JTL potrebbe anche mostrare un errore relativo al client prima che tu possa accedere.

Causa probabile: Il client ID o il client secret non corrisponde a un’app su JTL. Potrebbe essere errato, incompleto o circondato da spazi, oppure appartenere a un’altra app; l’app potrebbe anche essere stata eliminata o il suo secret sostituito. Un redirect URI che non corrisponde esattamente all’URL di callback può avere lo stesso effetto.

Cosa fare:

1. Apri l’app su kundencenter.jtl-software.de/oauth e copia di nuovo il suo client ID e il client secret.
2. Controlla che il suo redirect URI corrisponda esattamente all’URL di callback nell’hub.
3. Per una nuova connessione, apri Impostazioni → Connessioni → Add account → JTL FFN. Per una connessione esistente, seleziona Ricollega sulla sua scheda.
4. Inserisci entrambi i valori e seleziona Continua su JTL, oppure Ricollega con JTL per una connessione esistente.
5. Se JTL li rifiuta ancora, crea una nuova app e usa i suoi valori.

Per il supporto: i dati indicati sopra. Controlla che il client ID che invii corrisponda a quello presente nel JTL Customer Center.

Mancano gli scope richiesti

Codice: missing_scope

Cosa vedi: Dopo che hai approvato l’accesso, l’hub mostra Mancano dei permessi. Su un account esistente, Test può terminare con Controllo non riuscito per lo stesso motivo.

Causa probabile: L’app JTL non include sia ffn.merchant.read sia ffn.merchant.write, per esempio perché è stato scelto un modello con i soli scope per fulfiller. È anche possibile che JTL abbia concesso meno accessi di quelli richiesti.

Cosa fare:

1. Apri l’app su kundencenter.jtl-software.de/oauth.
2. Seleziona entrambi gli scope. Se non puoi modificarli, crea una nuova app con entrambi gli scope.
3. Nell’hub, seleziona Riprova oppure Ricollega su una connessione esistente. Se hai creato una nuova app, inserisci il nuovo client ID e il nuovo secret.
4. Su JTL, approva tutti i permessi richiesti.

Per il supporto: i dati indicati sopra e gli scope che JTL elenca per l’app.

L’autorizzazione è stata annullata

Codice: cancelled

Cosa vedi: L’hub mostra Connessione annullata. Non è cambiato nulla.

Causa probabile: L’accesso è stato rifiutato nella pagina di consenso di JTL, oppure JTL ti ha riportato all’hub senza concedere l’accesso.

Cosa fare:

1. Seleziona Riprova.
2. Accedi su JTL e approva l’accesso.
3. Se non hai rifiutato e il problema si ripete, contatta il supporto.

Per il supporto: i dati indicati sopra e cosa hai selezionato nella pagina di JTL.

L’autorizzazione è scaduta

Codice: expired

Cosa vedi: L’hub mostra L’autorizzazione è scaduta.

Causa probabile: Ogni tentativo è valido per 10 minuti e solo nel browser in cui è iniziato. È successo uno di questi casi:

• Tra Continua su JTL e il tuo ritorno all’hub sono passati più di 10 minuti.
• L’accesso è stato completato in un browser, in un profilo del browser o su un dispositivo diverso da quello in cui era iniziato, oppure il browser ha bloccato il cookie che l’hub usa per il tentativo.
• Una pagina di JTL è stata ricaricata o riaperta dalla cronologia del browser, quindi un tentativo già usato è arrivato una seconda volta.
• JTL non ha più accettato il proprio codice di autorizzazione monouso.
• Durante un ricollegamento, l’account è stato rimosso dal workspace.

Cosa fare:

1. Seleziona Riprova nello stesso browser.
2. Completa l’accesso su JTL entro 10 minuti. Non copiare l’indirizzo di JTL in un altro browser.
3. Se il problema continua, consenti i cookie per Balta Labs o prova un altro browser.

Per il supporto: i dati indicati sopra, il tuo browser e la durata approssimativa dell’accesso.

È stato usato un altro account JTL

Codice: account_mismatch

Cosa vedi: Durante un ricollegamento, l’hub mostra È stato usato un altro account. Non è cambiato nulla.

Causa probabile: Hai effettuato l’accesso su JTL con un account diverso da quello collegato, per esempio con le credenziali di un collega, un account sandbox o un altro account commerciante. È anche possibile che nel browser fosse già attivo un accesso a JTL con un altro account.

Cosa fare:

1. Seleziona Modifica sulla scheda dell’account per vedere quale Account JTL usa la connessione.
2. Esci da JTL. In alternativa, apri una finestra di navigazione privata e accedi lì a Balta Labs.
3. Seleziona Ricollega e accedi con l’account JTL originale.
4. Per usare invece l’altro account JTL, aggiungilo come nuova connessione. Poi sceglilo come Account del fornitore delle tue sedi in Logistica → Configurazione.

Per il supporto: i dati indicati sopra, l’Account JTL mostrato in Modifica e il nome dell’account JTL con cui hai effettuato l’accesso.

L’account JTL non è attivato

Codice: not_activated

Cosa vedi: Dopo che hai approvato l’accesso, l’hub mostra L’account JTL non è ancora pronto. Su un account esistente, Test può terminare con Controllo non riuscito e un messaggio secondo cui JTL FFN non conosce ancora l’account.

Causa probabile: L’API di JTL risponde not found finché l’account non ha effettuato almeno un accesso al portale FFN. È anche possibile che all’account manchi il ruolo Merchant, per esempio perché si tratta di un account fulfiller. Anche l’ambiente può essere la causa: un account di produzione deve accedere al portale di produzione, un account sandbox al portale sandbox.

Cosa fare:

1. Con lo stesso account JTL, accedi una volta a fulfillment.jtl-software.com per la produzione o a fulfillment-sandbox.jtl-software.com per la sandbox e completa la configurazione del commerciante.
2. Controlla che l’account abbia il ruolo Merchant. In caso di dubbi, chiedi al proprietario dell’account o a JTL.
3. Controlla che l’Ambiente scelto nell’hub corrisponda a quel portale.
4. Seleziona Riprova.

Per il supporto: i dati indicati sopra e se riesci ad accedere al portale FFN corrispondente.

Non hai più il permesso necessario

Codice: permission_lost

Cosa vedi: Hai approvato l’accesso su JTL, ma l’hub mostra Non hai più accesso e non ha salvato nulla.

Causa probabile: Mentre eri su JTL, il tuo permesso Connessioni in questo workspace è stato rimosso, il tuo ruolo è cambiato o hai lasciato il workspace. L’hub ricontrolla il permesso prima di salvare.

Cosa fare:

1. Chiedi a un proprietario del workspace di assegnarti il permesso Connessioni in Impostazioni → Team.
2. Seleziona Riprova oppure chiedi a un collega con quel permesso di collegare l’account.

Per il supporto: i dati indicati sopra e il tuo ruolo nel workspace.

L’account deve essere ricollegato

Codice: reconnect_required

Cosa vedi: La scheda dell’account mostra Da ricollegare e Modifica spiega che JTL non accetta più l’autorizzazione salvata. Le operazioni logistiche per questo account non riescono finché non lo ricolleghi.

Causa probabile: JTL ha rifiutato di rinnovare l’accesso. Succede quando l’accesso è stato revocato su JTL, quando l’app è stata eliminata o il suo secret è stato sostituito, oppure quando l’autorizzazione salvata non è più valida.

Cosa fare:

1. Se su JTL hai sostituito il secret o creato una nuova app, tieni pronti il nuovo client ID e il nuovo secret.
2. Apri Impostazioni → Connessioni e seleziona Ricollega sulla scheda dell’account.
3. Lascia vuoti Client ID e Client secret per mantenere le credenziali dell’app salvate oppure inserisci i nuovi valori.
4. Seleziona Ricollega con JTL e accedi con lo stesso account JTL.
5. Seleziona Test. Quando la scheda mostra Funzionante, apri Logistica → Operazioni e riprova gli elementi in Non riusciti. Per riprovare serve il permesso Operazioni logistica.

Per il supporto: i dati indicati sopra, quando lo stato è comparso per la prima volta e se l’app è stata modificata su JTL.

JTL o la rete non sono disponibili

Codice: unavailable

Cosa vedi: L’hub mostra JTL non è raggiungibile al momento. Su un account esistente, Test può terminare con Controllo non riuscito e un messaggio simile.

Causa probabile: Il servizio di JTL non funziona o è in manutenzione, oppure la connessione tra l’hub e JTL è andata in timeout.

Cosa fare:

1. Attendi qualche minuto. Non è cambiato nulla, quindi puoi riprovare senza rischi.
2. Seleziona Riprova oppure Test su un account esistente.
3. Se il problema dura più di un’ora, controlla se riesci ad aprire il portale FFN, poi contatta il supporto.

Per il supporto: i dati indicati sopra e da quanto tempo dura il problema.

Un altro errore ha interrotto la connessione

Codice: failed

Cosa vedi: L’hub mostra Impossibile completare la connessione. Questa sezione riguarda anche Non è stato possibile confermare la connessione, che compare quando JTL ha segnalato un esito positivo ma l’account non è elencato nel workspace che hai aperto.

Causa probabile: JTL ha restituito una risposta imprevista, per esempio senza i dati dell’account, oppure si è verificato un errore imprevisto durante il salvataggio. Se l’hub non ha potuto confermare la connessione, l’account potrebbe appartenere a un workspace che non puoi aprire con questo accesso, oppure non è stato possibile caricare l’elenco delle connessioni.

Cosa fare:

1. Se la schermata offre Controlla di nuovo, selezionalo.
2. Apri Impostazioni → Connessioni nel workspace in cui hai iniziato e controlla se l’account è elencato.
3. Se non lo è, seleziona Riprova una volta.
4. Se non riesce di nuovo, contatta il supporto.

Per il supporto: i dati indicati sopra, con l’ora esatta di ogni tentativo, così che il supporto possa trovarli.

Messaggi nella finestra Collega JTL Fulfillment Network

Alcuni problemi compaiono prima che tu lasci l’hub:

• Le connessioni JTL non sono ancora disponibili su questo server. Balta Labs non può fornire un URL di callback. Contatta il supporto.
• Impossibile caricare le impostazioni JTL. Seleziona Riprova. Se il problema continua, contatta il supporto.
• Impossibile avviare l’autorizzazione. Sotto compare il motivo, per esempio che mancano il client ID e il client secret. Una nuova connessione richiede entrambi; quando ricolleghi un account, i campi vuoti mantengono le credenziali dell’app salvate.
• Un ricollegamento resta nell’ambiente dell’account. Durante un ricollegamento non puoi passare dalla produzione alla sandbox o viceversa. Per l’altro ambiente, aggiungi una nuova connessione.