Collega i fornitori logistici

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

I fornitori logistici, detti anche 3PL, ricevono le tue spedizioni e ti restituiscono informazioni su tracciamento, prodotti e scorte. Aggiungi questi account in Impostazioni → Connessioni, dove compaiono sotto Fornitori logistici.

Collegare un account non avvia mai l’invio delle spedizioni. L’invio avviene per singola sede in Logistica → Configurazione e solo per i flussi di lavoro che imposti su Attivo.

Fornitore	Cosa inserisci	Guida
JTL FFN	La tua app JTL, poi un accesso su JTL	Collega JTL all’hub
Magware	URL API, codice owner e chiave API	Magware
Mintsoft	Chiave API	Mintsoft
Logisoft (Asendia)	Riferimento cliente e token API; deposito SFTP facoltativo per le fatture	Logisoft (Asendia)

Prima di iniziare

• Prepara i dati di connessione del fornitore. Se necessario, richiedili al fornitore.
• Inserisci chiavi API, token e chiavi private solo nel modulo dell’hub. Balta Labs li salva cifrati e non li mostra mai più. Non inviarli mai via email o chat.
• Ti serve il permesso Connessioni nel workspace.

Aggiungi un account

1. Apri Impostazioni → Connessioni. Sotto Fornitori logistici, seleziona Aggiungi fornitore. Add account in cima alla pagina elenca gli stessi fornitori.
2. Scegli il fornitore.
3. Inserisci facoltativamente un Nome connessione, poi compila i campi descritti più avanti.
4. Seleziona Salva account.
5. Seleziona Test sulla scheda dell’account. Correggi i valori finché la scheda non mostra Funzionante.
6. Seleziona Dettagli per vedere Account, Cosa può fare l’hub e gli Elenchi di riferimento tra cui scegli quando configuri le sedi.

Per modificare un account in seguito, seleziona Modifica sulla sua scheda. Lascia vuoto un campo segreto per mantenere il valore salvato. Se modifichi credenziali o indirizzi, lo stato torna a Non controllato fino al test successivo.

Magware

• URL API: l’indirizzo dell’API Magware indicato dal tuo magazzino, per esempio https://wms.example.com/api/. Deve essere un indirizzo pubblico senza nomi utente, parametri di query o parti #. http:// funziona se il tuo server Magware non offre altro, ma è preferibile https://.
• Codice owner: il tuo codice cliente in Magware.
• Chiave API: la chiave per quel codice owner.

Test legge l’elenco delle scorte e non modifica nulla in Magware. Se l’indirizzo non risponde come l’API Magware, il test lo segnala. Le sedi Magware non richiedono impostazioni del fornitore.

Magware restituisce ogni aggiornamento una sola volta. L’hub legge questo flusso solo con Tracciamento attivo; in modalità ombra non lo interroga.

Mintsoft

• Chiave API: la chiave API Mintsoft del tuo account cliente.

Test elenca i magazzini e i servizi dei corrieri visibili con la chiave e Dettagli li mostra con i relativi ID. Quando aggiungi la sede, inserisci l’ID magazzino Mintsoft, l’ID servizio corriere e l’ID servizio corriere Prime, usato per gli ordini Amazon Prime.

Logisoft (Asendia)

• Riferimento cliente: il tuo numero cliente presso Logisoft.
• Token API: il tuo token API Logisoft.
• Impostazioni avanzate (facoltative): URL WSDL del servizio core (predefinito https://soap.myasendia.it/LogisticService.svc?wsdl), URL WSDL del servizio logistico (predefinito https://soap.myasendia.it/Service.svc?wsdl) e Timeout (secondi) (predefinito 120). Modificale solo se Logisoft ti ha indicato altri indirizzi dei servizi o richiede un timeout più lungo. Gli URL WSDL devono usare https:// e il timeout può essere compreso tra 10 e 300 secondi.

Per caricare le fatture, compila anche il Deposito SFTP (opzionale): Host SFTP (solo il nome host, senza sftp://), Porta SFTP (22 per impostazione predefinita), Utente SFTP e Chiave privata SFTP (l’intera chiave, comprese le righe BEGIN ed END, in formato OpenSSH, PEM o PuTTY). Il deposito SFTP richiede host, utente e chiave privata, oppure nessuno dei tre.

Test verifica il token, elenca i tuoi negozi e raggiunge il servizio logistico. Con il deposito SFTP, accede anche al server e controlla la cartella delle fatture. Al primo test riuscito, l’hub fissa la chiave del server SFTP. La scheda mostra quindi Chiave host SFTP fissata e l’hub comunica solo con un server che ha quella chiave. Se cambi l’host, il test riuscito successivo fissa la chiave del nuovo server. Se un test successivo segnala una chiave diversa per lo stesso host, verifica con Asendia che il cambiamento sia previsto, poi contatta il supporto.

Quando aggiungi la sede, Codice corriere e Codice negozio hanno come valori predefiniti ASENDIA_IT e CUSTOM.

Cosa indica lo stato

Stato	Significato	Cosa fare
Funzionante	L’ultimo test o l’ultima richiesta al fornitore ha funzionato.	Nulla.
Controllo non riuscito	L’ultimo test o l’ultima richiesta ha avuto esito negativo. La scheda mostra il messaggio del fornitore.	Risolvi la causa, per esempio un indirizzo, la rete o un’impostazione, poi seleziona Test.
Da ricollegare	Il fornitore ha rifiutato le credenziali o l’autorizzazione.	Seleziona Modifica e inserisci nuove credenziali, oppure usa Ricollega per un account JTL, poi seleziona Test.
Non controllato	L’account è nuovo oppure le sue credenziali o i suoi indirizzi sono cambiati.	Seleziona Test.

La scheda mostra anche quando l’account è stato controllato l’ultima volta. Lo stato cambia quando selezioni Test e quando l’hub lavora con l’account. Descrive l’account, non le singole spedizioni: controllale in Logistica → Operazioni.

Attivare i flussi di magazzino

In Logistica → Configurazione, aggiungi un account sorgente e una sede che colleghi il suo magazzino a un fornitore. Pianificazioni e attività manuali sono in Sync. Gestisci regole e modalità di automazione dell’account in Automazioni.

Controlla le decisioni in Ombra, poi imposta i flussi necessari su Attivo. I passaggi da o verso Attivo richiedono conferma e vengono registrati. Verifica i risultati in Operazioni, le differenze di stock e le associazioni degli articoli in Inventario. Per sospendere un flusso, scegli Disattivo o Ombra e controlla le attività già in corso in Operazioni.

Per modificare più sedi, seleziona le righe, scegli flusso e modalità, poi Rivedi modifiche. Il risultato indica le sedi non modificate. Ogni account sorgente ha regole, bozze salvate e cronologia di attivazione proprie.