Collega JTL all'hub

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

Una connessione JTL Fulfillment Network (JTL FFN) permette all’hub, Balta Labs, di affidare le spedizioni al tuo fulfiller JTL e di recuperare le informazioni su tracciamento, prodotti e scorte. Collegare l’account non invia nulla. Le spedizioni partono solo dopo che hai aggiunto una sede e impostato i suoi flussi di lavoro su Attivo in Logistica → Configurazione.

Prima di iniziare

• Crea un’app JTL e tieni pronti il suo client ID e il client secret. Vedi Crea un’app JTL.
• Usa un account JTL con il ruolo Merchant che abbia già effettuato almeno un accesso al portale FFN.
• Collega weclapp. Ordini e spedizioni provengono da weclapp. Vedi Collega weclapp.
• Ti servono il permesso Connessioni nel workspace e il permesso Logistica per la configurazione.

Autorizza l’account

1. Apri Impostazioni → Connessioni, seleziona Add account e scegli JTL FFN. Puoi anche selezionare Aggiungi fornitore sotto Fornitori logistici.
2. Nella finestra di dialogo Collega JTL Fulfillment Network, controlla in Prima di continuare che l’URL di callback sia quello salvato nella tua app JTL.
3. In Ambiente, scegli Produzione per il tuo account reale o Sandbox per il sistema di test di JTL.
4. Inserisci il Client ID e il Client secret della tua app JTL.
5. Inserisci facoltativamente un Nome connessione. Senza nome, l’hub usa il nome dell’account JTL.
6. Seleziona Continua su JTL.
7. Accedi su JTL con l’account commerciante che vuoi collegare.
8. Controlla l’accesso richiesto e consentilo.
9. JTL ti riporta a Balta Labs, che conferma il risultato.

Completa la procedura senza lunghe pause. Ogni tentativo è valido per 10 minuti e solo nel browser in cui è iniziato. Se scade, ricomincia dal passaggio 1.

Scegli l’account JTL corretto

Balta Labs collega l’account con cui accedi su JTL, che non è necessariamente l’account proprietario dell’app. Se nel browser hai già effettuato l’accesso a JTL, JTL potrebbe riutilizzare quella sessione. Se non è l’account commerciante che vuoi collegare, esci prima da JTL e ricomincia.

Balta Labs mantiene una sola connessione per ogni combinazione di account JTL e ambiente. Se autorizzi un account già collegato, Balta Labs ne aggiorna la connessione invece di aggiungerne un duplicato. Per collegare un altro account commerciante, seleziona di nuovo Add account.

La schermata di conferma

Quando Balta Labs ha salvato e verificato l’account, mostra JTL collegato correttamente! con Account, Connessione e Ambiente. Controlla che l’account sia quello previsto.

Un conto alla rovescia ti porta poi alla configurazione logistica dopo cinque secondi. Seleziona Continua ora per andarci subito oppure Resta qui per fermare il conto alla rovescia. Dopo un ricollegamento, la schermata mostra invece JTL ricollegato correttamente! e ti riporta alla connessione.

Se l’autorizzazione non è stata completata, la schermata mostra un titolo come Mancano dei permessi, seguito da Cosa è successo e Cosa fare. Seleziona Riprova per ricominciare oppure Leggi la guida alla risoluzione dei problemi per aprire la sezione corrispondente di Risolvi gli errori di connessione JTL.

Controlla la connessione

In Impostazioni → Connessioni, l’account compare sotto Fornitori logistici. La sua scheda mostra lo stato e quando è stato controllato l’ultima volta:

• Non controllato: non è stato eseguito alcun test da quando l’account è stato aggiunto o modificato.
• Funzionante: l’ultimo test o l’ultima richiesta a JTL ha funzionato.
• Controllo non riuscito: l’ultimo test o l’ultima richiesta ha avuto esito negativo. La scheda mostra il messaggio di JTL. L’autorizzazione viene mantenuta: elimina la causa e ripeti il test.
• Da ricollegare: JTL non accetta più l’autorizzazione. Ricollega l’account come descritto più avanti.

Seleziona Test per controllare subito l’account. Il test si limita a leggere da JTL. Seleziona Dettagli per vedere Account, Cosa può fare l’hub e gli Elenchi di riferimento di Magazzini e Metodi di spedizione, ciascuno con il suo ID e, nella colonna Operatore logistico, il fulfiller a cui appartiene. La finestra della sede offre le stesse scelte. Modifica mostra l’account JTL, il suo ambiente, il client ID dell’app e quando è stato autorizzato. Lì puoi anche rinominare la connessione.

La scheda ti ricorda inoltre che l’account non viene usato per le spedizioni finché non attivi una sede e contiene il link Apri la configurazione logistica.

Configura la sede

Una sede è un magazzino weclapp gestito da un account di un fornitore logistico. Aggiungine una per ogni magazzino servito da JTL:

1. Apri Logistica → Configurazione. Se la pagina mostra Inizia con weclapp, scegli la tua Connessione weclapp e seleziona Salva e continua.
2. In Sedi, seleziona Aggiungi sede.
3. Inserisci un Nome.
4. In Magazzino weclapp, scegli il magazzino le cui spedizioni sono gestite da JTL oppure inserisci il suo ID.
5. In Account del fornitore, scegli l’account JTL. La finestra carica quindi le scelte dell’account.
6. In Magazzino presso JTL, scegli il magazzino. Così vengono compilati l’ID fulfiller e l’ID magazzino del fulfiller; entrambi restano modificabili. Se la finestra mostra Impossibile caricare le scelte dell’account. Inserisci invece gli ID., inserisci tu entrambi gli ID oppure seleziona Test sulla scheda dell’account per trovarne la causa.
7. In Metodi di spedizione, seleziona Aggiungi corriere per ogni corriere weclapp e scegli il suo ID metodo di spedizione FFN tra i suggerimenti. Includono solo i metodi di spedizione di quel fulfiller e mostrano il nome del metodo sotto l’ID. Una spedizione con un corriere senza associazione viene inviata a JTL con il tipo di spedizione standard e l’hub registra un avviso.
8. Seleziona Salva sede.
9. In Sincronizzazione, seleziona Avvia sincronizzazione se non c’è ancora nulla in sincronizzazione.

In una nuova sede, ogni flusso di lavoro è inizialmente su Spento. Una sede JTL ha questi flussi:

• Spedizione: affida a JTL le spedizioni rilasciate.
• Tracciamento: riscrive i numeri di tracciamento in weclapp.
• Catalogo: invia a JTL articoli, immagini e autorizzazioni dei prodotti.
• Controllo scorte: confronta le scorte di weclapp con JTL.
• Ricevimento merce: annuncia a JTL le consegne in arrivo.

Ogni flusso ha una delle tre modalità:

• Spento: non succede nulla.
• Ombra: l’hub decide e registra cosa farebbe. Non scrive nulla in JTL o in weclapp e non invia notifiche.
• Attivo: l’hub svolge il lavoro.

Configura i flussi in Logistica → Configurazione. Controlla le decisioni in modalità Ombra, quindi attiva i flussi necessari. I passaggi da o verso Attivo richiedono conferma. Vedi Collegare i fornitori logistici per configurazione e monitoraggio.

Ricollega un account

Ricollega l’account quando la scheda mostra Da ricollegare o dopo aver sostituito su JTL il client secret dell’app.

1. Apri Impostazioni → Connessioni e trova l’account sotto Fornitori logistici.
2. Seleziona Ricollega sulla sua scheda.
3. Lascia vuoti Client ID e Client secret per mantenere le credenziali dell’app salvate oppure inserisci quelle nuove.
4. Seleziona Ricollega con JTL.
5. Accedi con lo stesso account JTL di prima e consenti l’accesso.
6. Nella schermata JTL ricollegato correttamente!, controlla l’account. Poi seleziona Test sulla scheda.

Un ricollegamento resta nell’ambiente dell’account. Se accedi con un altro account JTL, l’hub mostra È stato usato un altro account e lascia invariata la connessione. Per collegare un altro account, aggiungilo come nuova connessione.

Come resta valido l’accesso

I token di accesso JTL durano circa 30 minuti. L’hub li rinnova automaticamente e ogni rinnovo sostituisce il refresh token. Non devi fare nulla. Se JTL rifiuta un rinnovo, per esempio perché l’accesso è stato revocato, la scheda mostra Da ricollegare e l’hub non può lavorare con l’account finché non lo ricolleghi. Poi controlla in Logistica → Operazioni gli elementi non riusciti nel frattempo.