Vai al contenuto principale

Comprendere gli stati di onboarding nella rete Visibility

C
Scritto da Camilla Grundahl Kjeldsen

La visibilità in tempo reale è un percorso, non un interruttore. Per ottenere dati di tracking di alta qualità, i carrier devono completare l’onboarding. Questa guida spiega cosa significa ogni stato, dove monitorare i progressi e cosa fare per portare un carrier a “Onboarded”.

Questa guida copre entrambi i ruoli:

  • Subscriber (Shipper/LSP): gestisce la carrier network e monitora l’onboarding.

  • Provider (Carrier): completa la registrazione e collega una visibility source.

Nel Visibility Control Center, la visibilità è possibile solo quando un carrier è Onboarded. Conoscere questi stati ti aiuta a chiudere i gap di tracking prima che impattino le spedizioni.


Dove monitorare il progresso

Puoi monitorare lo stato in tempo reale dell’intera rete in un unico posto:

  1. Apri Visibility dalla pagina principale di Transporeon.

  2. Nel pannello di navigazione a sinistra, clicca l’icona Globo per aprire il Visibility Control Center.

  3. Seleziona il tab Carrier Network.

Vedrai lo stato di onboarding di ogni carrier nella colonna Status.


Stati e azioni

La maggior parte dei carrier segue questa progressione tipica:

Status

Cosa significa

Azione Provider (Carrier)

Azione Subscriber (Shipper/LSP)

Not invited

Il carrier è nella tua lista ma non ha un invite attivo.

Nessuna azione per ora.

Invita per avviare l’onboarding o Delete se non è più nel tuo network.

Invited

Un invite è stato inviato ma non è ancora stato accettato.

Accetta l’invite via email o tramite link condiviso.

Follow up. Puoi Resend per sollecitare o Withdraw se inviato per errore.

Registered

Il carrier è in Transporeon ma non ha aperto “Visibility”.

Accedi al modulo Visibility.

Chiedi di cliccare l’icona Visibility per attivare il prompt di connessione.

Visibility source pending (badge semplice)

Il carrier è in Visibility ma non ha collegato una sorgente GPS/Telematics. Questo è lo stato predefinito per i carrier che non sono mai stati Onboarded.

Collega una visibility source (GPS, TMS, ecc.).

Follow up. Identifica il tipo di sorgente (GPS vs API).

Onboarded

Primo aggiornamento dati ricevuto.

Mantieni la connessione attiva. Se per 30 giorni non vengono ricevuti dati di tracking, lo stato tornerà a “Visibility source pending” — vedi la sezione sull’avviso di rollback per i dettagli.

Successo. Valida che la sorgente sia quella giusta per le tue esigenze.

Visibility source pending (con icona di avviso)

Il carrier era precedentemente Onboarded, ma per 30 giorni non sono stati ricevuti aggiornamenti di tracking, quindi lo stato è tornato indietro.

Verifica che le tue integrazioni siano in salute — vedi la sezione avviso di rollback sopra. Lo stato si ripristina automaticamente non appena i dati di tracking riprendono a fluire; non è necessario alcun passaggio manuale.

Monitora. Nessun ripristino manuale richiesto — lo stato si aggiorna automaticamente non appena riprendono i dati di tracking del carrier.


Cosa attiva lo stato “Onboarded”?

Un carrier passa a Onboarded non appena avviene un “handshake” tecnico tra la sorgente scelta e la piattaforma.

  • GPS / Telematics (ELD): lo status diventa verde quando riceviamo il primo position update da almeno un veicolo integrato.

    • Se non diventa verde: assicurati che almeno un veicolo stia inviando aggiornamenti di posizione.

  • Interfacce TMS / API: lo status diventa verde quando il primo evento di trasporto (ad esempio “Start” o “Position”) viene inviato con successo alla piattaforma.

    • Se non diventa verde: invia un evento di test e attendi qualche minuto per la sincronizzazione.

  • Shipper/LSP: un carrier appare onboarded non appena la piattaforma riceve un primo aggiornamento dati — sia dalla propria visibility source collegata, sia tramite un altro carrier nella sua rete (network effect).

    • Azione: verifica sempre che la sorgente attiva corrisponda alle tue specifiche esigenze di business.

  • Mobile App: lo status diventa verde quando un driver avvia il primo viaggio con l’app.

    • Se non diventa verde: verifica che un driver abbia effettivamente avviato un viaggio.


Cosa succede se il mio stato “Onboarded” rischia di tornare indietro?

Nota: questa sezione è una bozza tradotta con AI — in attesa di traduzione ufficiale nel Help Center.

Se la piattaforma Visibility non riceve aggiornamenti di tracking dalle sorgenti di un carrier per 30 giorni, il sistema riporta lo stato del carrier da “Onboarded” a “Visibility source pending”. Prima che ciò avvenga, i carrier ricevono un avviso proattivo per verificare il proprio setup o semplicemente lasciare che nuovi dati di tracking arrivino naturalmente.

Flusso di notifica in due fasi

  1. Prima del rollback: I carrier ricevono un’email proattiva e vedono un banner nel proprio account Visibility che indica la data in cui il loro stato di onboarding tornerà indietro se non arriveranno nuovi aggiornamenti di tracking.

  2. Al rollback: Se entro quella data non sono stati ricevuti aggiornamenti, lo stato torna a “Visibility source pending”, il carrier riceve un’email di conferma e nel suo account Visibility appare un banner post-rollback. I clienti vedono il cambio di stato nei loro dashboard.

Cosa devono fare i carrier quando ricevono l’avviso

  • Se gestisci integrazioni GPS/Telematics o API, vai su Vehicle management → Integrations e verifica che sia tutto regolare:

    • Tab Telematics: un errore rosso o il pulsante “Update Credentials” indica che le credenziali devono essere aggiornate. Clicca Update Credentials e inseriscile di nuovo.

    • Tab API Endpoints: controlla gli endpoint segnalati come “All calls failed” o “Inactive over 30 days”. Richiedono l’attenzione del team IT o del provider API.

    • Se entrambi i tab risultano sani, le tue integrazioni funzionano correttamente — probabilmente sei nel caso “nessun trasporto assegnato” e non serve alcuna azione.

  • Se usi la Mobile App, non è necessaria alcuna azione nel tab Integrations. Lo stato verrà ripristinato automaticamente non appena un driver avvierà un nuovo viaggio nell’app.

  • Se sei tracciato tramite la connessione di un altro carrier (network effect), non è necessaria alcuna azione. Lo stato verrà ripristinato automaticamente non appena i dati torneranno a fluire nella rete.

Come viene ripristinato lo stato

Il ripristino è automatico. Non appena riceveremo dati di tracking da una qualsiasi delle tue visibility source, il tuo stato tornerà a “Onboarded” — non è necessario alcun passaggio manuale, e la modifica si rifletterà anche nei dashboard dei tuoi clienti.


💡 Pro Tip: “Network Effect” e validazione della relazione

Poiché Transporeon è una rete globale, molti carrier sono già onboarded e condividono dati con altri clienti. Uno status “verde” significa solo che esiste una connessione tecnica, non necessariamente che la configurazione sia adatta alle tue esigenze.

Best practice: Subscriber e Provider dovrebbero validare la connessione per la loro specifica relazione:

  • Rilevanza della sorgente: un carrier può essere onboarded tramite GPS base per un partner, ma potresti richiedere una connessione TMS/API per dati avanzati.

  • Obiettivo: assicurarsi che “Onboarded” significhi che il carrier è pronto a fornire esattamente i dati richiesti per la tua relazione.


Dove i carrier possono vedere il proprio stato di onboarding per ogni cliente

Nota: questa sezione è una bozza tradotta con AI — in attesa di traduzione ufficiale nel Help Center.

Come carrier, puoi vedere come il tuo account appare a ciascuno dei tuoi clienti — incluso il tuo Onboarding status — dal tab Customers nel tuo Visibility Control Center.

Dove trovarlo

  1. Apri Visibility dalla pagina principale di Transporeon.

  2. Nel pannello di navigazione a sinistra, clicca l’icona Globo per aprire il Visibility Control Center.

  3. Seleziona il tab Customers.

Vedrai una lista di tutti i tuoi clienti e il tuo Onboarding status attuale per ciascuna relazione.

Perché il mio stato di onboarding di solito è uguale per tutti i clienti?

Nella maggior parte dei casi, il tuo Onboarding status sarà identico per ogni cliente in lista. Questo perché riflette il tuo stato globale di onboarding nella Transporeon Visibility Network — indica se la piattaforma sta attualmente ricevendo dati di tracking da una delle tue visibility source, non se la configurazione di un singolo cliente è a posto.

Quindi se il tuo stato mostra “Onboarded” per un cliente, mostrerà tipicamente “Onboarded” per tutti. E se il tuo stato torna a “Visibility source pending” (vedi sezione sull’avviso di rollback sopra), tornerà indietro contemporaneamente per tutti i clienti.

Suggerimento: Usa il tab Customers come unica fonte di verità per capire come il tuo account viene visto attualmente nella tua rete.


Domande frequenti (FAQ)

Subscriber: il mio carrier sa se non è onboarded? Sì. Se il carrier è in stato “Visibility source pending”, compare un banner evidente nella loro app Visibility che li invita a collegare una sorgente. Tieni presente che indica lo stato globale del carrier, non uno stato specifico per un singolo cliente.

Subscriber: perché il mio carrier è bloccato su “Registered”? Di solito significa che il carrier ha un account Transporeon ma non ha “attivato” il profilo Visibility. Deve cliccare una volta l’icona del modulo Visibility.

Subscriber/Provider: perché un carrier “Onboarded” è tornato a “Visibility source pending”? Se il sistema non riceve aggiornamenti di tracking dalle visibility source del carrier per 30 giorni, lo stato torna automaticamente indietro — e si ripristina automaticamente non appena i dati di tracking riprendono a fluire. Vedi Cosa succede se il mio stato “Onboarded” rischia di tornare indietro? sopra per il flusso di notifica completo e la guida alle azioni.

Provider (Carrier): posso collegare più di una sorgente? Sì. Collegare una sorgente non impedisce di collegarne altre.

Subscriber: ho invitato un carrier ma risulta già “Registered”. Perché non è andato direttamente su “Onboarded”? Un carrier può essere “Registered” nell’ecosistema Transporeon senza aver collegato una sorgente Visibility. Deve completare lo step tecnico finale.

Subscriber/Provider: “Onboarded” significa che stanno tracciando un carico in questo momento? No. “Onboarded” significa che la connessione tecnica è attiva e il carrier è pronto a tracciare. Il tracking inizia solo quando un veicolo viene allocato a un trasporto attivo.

Subscriber/Provider: un carrier dice di essere connesso, ma lo status è ancora “Visibility source pending”. Perché? Succede quando la configurazione è completata ma il primo handshake dati non è ancora arrivato. Chiedi di attivare almeno un veicolo, oppure attendi qualche minuto.

Questo status è specifico della mia azienda o dell’intera rete? Questi stati riflettono lo stato globale di onboarding del carrier nella Transporeon Visibility Network. Anche se un carrier è onboarded globalmente, è comunque best practice validare che sorgente e dati soddisfino le tue esigenze.


Learn More


Need more help?

Hai ricevuto la risposta alla tua domanda?