Salta al contenuto principale

Panoramica Clienti

La sezione Clienti è la rubrica dei tuoi committenti: le aziende per cui organizzi trasporti, a cui emetti fattura per il servizio di spedizione, e che potrai associare alle commesse per attivare le notifiche automatiche di ritiro e consegna. Da qui aggiungi un nuovo cliente, ne consulti l'anagrafica, decidi quali notifiche operative gli arriveranno via email/SMS/WhatsApp, e — quando vuole collaborare attivamente sulla piattaforma — gli invii l'invito a registrarsi su Truckscanner.

Spedizioniere

Dove vive la sezione

Dal menu di sinistra della piattaforma, sotto il gruppo «Operativo & Trasporti», clicca sulla voce «Clienti» (icona edificio). L'URL diretto della pagina è /company/{idAzienda}/trading-partners.

Il titolo che vedi in alto è «Partner Commerciali» — è la denominazione tecnica della sezione, ma in tutto il resto della piattaforma e in queste guide la chiamiamo semplicemente «Clienti», che è anche la voce di menu.

La tabella dei clienti

La tabella elenca tutti i clienti della tua azienda spedizioniere. Ogni riga è cliccabile: aprirà il drawer di dettaglio sulla destra con tutta l'anagrafica.

Le colonne sempre visibili sono:

  • Nome — la ragione sociale del cliente. È l'unica colonna ordinabile (clicca sull'intestazione per invertire il sort A→Z / Z→A).
  • P.IVA — la partita IVA preceduta dal codice paese (es. IT03031930354).
  • Città — sede legale del cliente, formato Città, Provincia (es. Milano, MI).
  • Referente — nome della persona di contatto in azienda, se inserito.
  • Truckscanner — lo stato del cliente sulla piattaforma:
    • se non è mai stato invitato vedi il bottone «Collabora su Truckscanner» (è la scorciatoia per invitarlo);
    • se è stato invitato e ha completato la registrazione, vedi il badge «Registrato»;
    • se è stato invitato ma non ha ancora accettato, vedi il badge «Invitato» affiancato da tre iconcine: copia link invito, reinvia invito, annulla invito.
  • Stato — badge «Attivo» o «Inattivo», riferito alla riga di rubrica (non alla piattaforma).
  • Azioni — tre icone a fine riga: matita (modifica), spegnimento (disattiva), cestino (elimina).

A destra della barra filtri c'è un'icona di personalizzazione colonne: cliccandola puoi mostrare/nascondere altre colonne opzionali — Telefono, Email, Notifiche Email, Notifiche SMS, Paese, Note, Creato il.

In basso la paginazione: «Risultati 1-N di M», selettore «Righe per pagina» (default 10) e i quattro bottoni di navigazione pagine.

I filtri

Sopra la tabella c'è una barra a due livelli che ti aiuta a restringere la lista.

Stato piattaforma

Le quattro tab in alto sono filtri sullo stato del cliente su Truckscanner. Ogni tab ha accanto un contatore con il numero di clienti corrispondenti:

  • Tutti — mostra l'intera rubrica, indipendentemente dallo stato piattaforma.
  • Registrato — solo clienti che hanno accettato l'invito e sono attivi su Truckscanner.
  • Invitato — solo clienti con un invito pendente non ancora accettato.
  • Non invitato — solo clienti presenti in rubrica ma a cui non hai ancora mandato un invito (sono partner che usi solo per le tue notifiche operative interne).

La tab attiva resta evidenziata e il numero del suo contatore si colora di lime.

Ricerca

Il campo «Ricerca» sotto le tab ti permette di filtrare per nome o P.IVA. Il placeholder è «Cerca per nome o P.IVA…» — appena digiti, la tabella si aggiorna live (non serve premere Invio). Cancellando il testo torna la lista completa.

Mostra inattivi

Il toggle «Mostra inattivi», di default spento, nasconde i clienti disattivati. Attivandolo li includi nella lista (li riconosci dal badge «Inattivo» nella colonna Stato).

I filtri attivi compaiono come chip sotto la barra: cliccando la X di un chip rimuovi quel filtro; quando ne hai due o più, appare il link «Cancella tutti» per ripulire in un click.

Il drawer di dettaglio cliente

Cliccando una riga della tabella si apre sulla destra un pannello che mostra tutta l'anagrafica del cliente. In alto vedi sempre:

  • la ragione sociale in grande,
  • il badge «Attivo» o «Inattivo»,
  • la P.IVA con codice paese (es. IT03031930354),
  • se la P.IVA è italiana o europea e l'abbiamo verificata su VIES, accanto compare anche un piccolo badge verde «VIES» (con tooltip «P.IVA verificata tramite VIES, il sistema ufficiale dell'Unione Europea»). Se invece il VIES dichiara la P.IVA non valida, il badge è rosso.

Il drawer ha tre tab: Anagrafica (dati identificativi e di contatto), Commerciale (dati aziendali, fatturazione elettronica, documenti) e Notifiche (preferenze di canale e storico delle comunicazioni inviate al cliente).

Tab «Anagrafica»

Il tab è organizzato in blocchi:

  • Dati Aziendali — P.IVA, codice fiscale, forma giuridica, codice ATECO + descrizione, stato attività (Attiva / Cessata), data di costituzione.
  • Indirizzi — la Sede legale è evidenziata con etichetta lime. Sotto, eventuali Unità locali (filiali, depositi, magazzini) con indirizzo completo e descrizione opzionale.
  • Referente — nome, telefono cliccabile (apre il dialer del sistema operativo), email cliccabile (apre il client di posta).
  • Note — testo libero che hai inserito sulla scheda cliente, se presente.
  • In fondo, le date di sistema: Creato il e Aggiornato il.

Tab «Commerciale»

Il tab Commerciale raccoglie i dati di ingaggio del cliente: informazioni aziendali pubbliche, dati di fatturazione, contatti e documenti contrattuali.

  • Dati commerciali — fatturato annuo, numero di dipendenti, dimensione azienda (Piccola / Media / Grande). Compaiono solo se l'arricchimento dati ha trovato qualcosa di pubblico; altrimenti vedi il messaggio «Nessun dato commerciale disponibile».
  • Fatturazione elettronica — PEC e Codice SDI, quando disponibili. La PEC è cliccabile per aprire una nuova mail.
  • Contatti aziendali — sito web, telefono e email aziendali (in aggiunta al referente individuale del tab Anagrafica).
  • Documenti — bottone «+ CARICA DOCUMENTO» in alto a destra. Quando non ci sono documenti, l'area mostra il messaggio «Nessun documento caricato — Carica contratti, listini o altri documenti per questo cliente». I tipi supportati sono PDF, Excel e immagini, fino a 20 MB per file. Le tipologie disponibili in upload sono Contratto (PDF), Contratto (Excel), Listino prezzi, Altro.

Tab «Notifiche»

Il tab Notifiche è dove decidi quali canali Truckscanner usa per comunicare con questo cliente quando i suoi mandati si muovono e dove vedi lo storico di tutto quello che gli è stato inviato.

In alto, sempre visibili anche scrollando la lista, ci sono i due toggle delle preferenze di canale:

  • Notifiche Email — Tracking, conferme ritiro/consegna, documenti. Acceso di default.
  • Notifiche SMS / WhatsApp — Avvisi in tempo reale. Acceso di default. Truckscanner prova prima con WhatsApp e fa fallback automatico su SMS se il numero non ha un account WA attivo.

Spegnere uno dei due toggle disabilita quel canale per tutte le commesse future di questo cliente, sia in qualità di mittente sia di destinatario. Il cambio è immediato (non c'è bottone Salva). Il cliente può anche disiscriversi autonomamente cliccando il link «Disiscriviti» in fondo alle email che riceve: in quel caso il toggle Email si spegne automaticamente.

Sotto i toggle si srotola lo storico delle notifiche già inviate, in ordine cronologico dalla più recente. Ogni voce mostra:

  • icona del canale a sinistra (busta per email, fumetto per SMS/WhatsApp);
  • titolo della notifica (es. Ritiro effettuato — LD-ABC123, Merce consegnata — LD-DEF456, Problema segnalato — LD-XYZ789);
  • data e ora dell'invio e il recapito usato (email o numero di telefono);
  • badge di stato a destra:
    • INVIATA (verde) — la notifica è partita correttamente;
    • BLOCCATA (arancione) — Truckscanner ha bloccato l'invio perché il cliente aveva già ricevuto troppe notifiche dello stesso tipo nell'ultima ora (anti-flooding, max 5/h);
    • ERRORE (rosso) — l'invio è fallito; di solito il recapito non è valido o non è raggiungibile;
    • IN CODA (grigio) — l'invio è ancora in elaborazione.

Cliccando una voce dello storico, la riga si espande mostrando il riassunto del messaggio inviato (il body), il canale effettivo (es. «Inviato via WhatsApp»), il riferimento alla commessa quando presente (commessa #123) e — se lo stato è BLOCCATA o ERRORE — un suggerimento operativo come «Invio bloccato: troppe notifiche in 1 ora.» o «Invio non riuscito. Verifica i recapiti del cliente.». Cliccando di nuovo si richiude.

Le azioni di riga

A fine di ogni riga della tabella ci sono tre iconcine, ciascuna con tooltip al passaggio del mouse:

  1. Matita (Modifica) — apre il drawer in modalità modifica: niente tab, ma direttamente i campi Nome cliente *, indirizzo (con autocomplete), nome referente, telefono e email del referente, note. In fondo i bottoni ANNULLA e SALVA. Il toast di conferma è «Cliente aggiornato».
  2. Spegnimento (Disattiva) — disattiva il cliente (resta in archivio ma non comparirà più nei selettori delle commesse). Toast «Cliente disattivato». L'icona è disabilitata se il cliente è già inattivo. Per riattivarlo apri il drawer e usa il bottone RIATTIVA in fondo.
  3. Cestino (Elimina) — apre un dialog di conferma «Elimina cliente — Sei sicuro di voler eliminare il cliente Acme S.r.l.? Questa azione non può essere annullata.» (il nome del cliente è dinamico). Confermando con il bottone rosso ELIMINA, il cliente sparisce definitivamente e ricevi il toast «Cliente "Acme S.r.l." eliminato».

Le stesse tre azioni — più la riattivazione — sono disponibili anche dentro il drawer in modalità visualizzazione, in fondo: MODIFICA (lime), DISATTIVA (o RIATTIVA se inattivo), ELIMINA (rosso).

Aggiungere clienti: nuovo singolo o import in massa

In alto a destra, nell'header della pagina, ci sono i due bottoni di ingresso al sistema:

  • «+ NUOVO» (lime) — apre il dialog «Nuovo cliente» dove puoi cercare il cliente per partita IVA (con verifica VIES e arricchimento dati istituzionali) oppure inserire i dati manualmente. La descrizione del dialog spiega: «Aggiungi un mittente o destinatario alla rubrica. Potrai associarlo alle commesse per le notifiche automatizzate di ritiro e consegna.»
  • «⤴ IMPORTA CSV» (outline) — apre il dialog di import in massa: scarichi un template template_clienti.csv con colonne pre-impostate (ragione sociale, paese IVA, partita IVA, indirizzo, città, provincia, CAP, paese, nome referente, telefono referente, email referente, note), lo riempi e lo carichi.

Per il dettaglio passo-passo dei due flussi vedi le guide dedicate linkate in fondo.

Stato Truckscanner: cliente «in rubrica» vs cliente «collaboratore»

Una distinzione importante che spesso confonde chi inizia: un cliente in rubrica non è automaticamente un collaboratore attivo su Truckscanner.

  • In rubrica — il record cliente esiste solo nella tua azienda spedizioniere. Lo usi per associarlo alle commesse, per ricevere le notifiche operative al posto del cliente finale, per archiviare contratti e listini. Il cliente non sa nulla di Truckscanner: riceve solo comunicazioni email/SMS/WhatsApp dirette quando i suoi mandati si muovono.
  • Collaboratore attivo — quando vuoi che il cliente abbia accesso diretto alla piattaforma per vedere lo stato dei suoi trasporti in tempo reale e darti la sua disponibilità di carico/scarico, lo inviti su Truckscanner cliccando il bottone «Collabora su Truckscanner» sulla sua riga. Riceverà un'email di invito; quando accetta, lo stato della colonna Truckscanner diventa «Registrato» e il cliente vedrà la sua dashboard committente con le sue spedizioni.

Le due cose convivono: ogni cliente è prima «in rubrica», poi opzionalmente diventa anche «collaboratore». L'invito è sempre annullabile e reinviabile dalle iconcine accanto al badge.

Problemi comuni

Vedi anche

  • Aggiungere e invitare un cliente — guida in arrivo
  • Importare i clienti da un file CSV — guida in arrivo
  • Modificare i dati di un cliente esistente — guida in arrivo
  • Per spedizionieri — panoramica