Skip to main content
CasaBlogGuideStato normalizzato rispetto allo stato originale del corriere: quale dovrebbe utilizzare il tuo sistema?

Stato normalizzato rispetto allo stato originale del corriere: quale dovrebbe utilizzare il tuo sistema?

17TRACK

Usali entrambi, ma assegna loro funzioni diverse: gli stati normalizzati dovrebbero guidare flussi di lavoro, dashboard, avvisi e percorsi rivolti ai clienti, mentre lo stato originale del corriere dovrebbe rimanere disponibile come evento di origine per audit, risoluzione dei problemi e un contesto operativo preciso. Un sistema che conserva solo uno dei due elementi di solito diventa difficile da automatizzare oppure difficile da considerare affidabile.

Stato normalizzato e stato originale del corriere: quale dovrebbe usare il tuo sistema

I corrieri descrivono eventi di spedizione simili in modi diversi. Uno può indicare che un pacco è “In transito”, un altro può usare “In viaggio” e un terzo può fornire una scansione più specifica come “Partito dalla struttura”. Questi messaggi non si adattano sempre perfettamente a un unico ciclo di vita universale. La soluzione pratica non consiste nell’eliminare la formulazione originale, ma nel creare un livello normalizzato controllato e conservare accanto ad esso l’evento del corriere.

Cosa significano gli stati normalizzati e originali

Lo stato originale del corriere è l’evento o l’etichetta di stato ricevuta dal fornitore del trasporto. Può includere un codice, una descrizione, una posizione, un timestamp e altri attributi dell’evento. È vicino al vocabolario operativo del fornitore e può essere altamente specifico.

Uno stato normalizzato è una categoria a livello applicativo creata dal tuo sistema o dal tuo provider di tracciamento. Raggruppa diversi messaggi dei corrieri in un insieme più ristretto di stati aziendali, come:

  • Etichetta creata
  • Ritirato
  • In transito
  • In arrivo
  • In consegna
  • Consegnato
  • Eccezione
  • Disponibile per il ritiro
  • Restituito

La normalizzazione è un livello di classificazione, non una sostituzione dell’evento sottostante. La stessa categoria normalizzata può contenere diversi stati originali e la stessa formulazione può richiedere un’interpretazione diversa in base al corriere, al servizio, al codice dell’evento, alla posizione e alla sequenza degli eventi.

Perché un sistema ha bisogno di stati normalizzati

Gli stati normalizzati sono particolarmente utili quando il software deve prendere decisioni coerenti tra più corrieri. Senza di essi, ogni flusso di lavoro deve comprendere separatamente il vocabolario di ogni corriere. Ciò crea un notevole onere di manutenzione e rende difficili da gestire regole altrimenti semplici.

Automazione coerente

Un team operativo potrebbe voler inviare una notifica di consegna ogni volta che un pacco raggiunge lo stato “in consegna”. Se il flusso di lavoro dipende da una formulazione esatta di un singolo corriere, potrebbe non funzionare quando un altro provider usa un’etichetta diversa. Uno stato normalizzato fornisce alla regola un input stabile.

Lo stesso principio si applica alla gestione delle eccezioni. Un’azienda può indirizzare le spedizioni verso una coda delle eccezioni quando lo stato normalizzato indica un problema di consegna, anche se le cause sottostanti possono includere un indirizzo errato, un tentativo di consegna non riuscito, lo sdoganamento, un’interruzione dovuta alle condizioni meteorologiche o un’indagine del corriere.

Report più chiari

I report tra corrieri richiedono categorie comuni. Metriche come il numero di spedizioni consegnate, in transito e con eccezioni sono difficili da confrontare quando la tassonomia degli eventi di ciascun corriere viene mostrata senza interpretazione.

La normalizzazione aiuta inoltre i team di prodotto e di assistenza a creare dashboard che non cambiano ogni volta che un corriere modifica la propria formulazione. L’evento originale può comunque essere mostrato quando l’utente ha bisogno di dettagli, mentre la vista principale rimane coerente.

Comunicazione più prevedibile con i clienti

I messaggi ai clienti dovrebbero generalmente usare un linguaggio comprensibile, invece di esporre i codici grezzi del corriere. Uno stato normalizzato può supportare un messaggio come “Il tuo pacco è in viaggio”, mentre lo stato originale rimane disponibile nella cronologia del tracking o nella vista dell’assistenza.

Questa separazione aiuta a prevenire due problemi opposti: messaggi troppo tecnici che i clienti non riescono a interpretare e messaggi troppo generici che nascondono un problema di consegna significativo.

Perché lo stato originale non deve essere eliminato

I dati normalizzati sono utili proprio perché semplificano le informazioni. Questa semplificazione rimuove però anche alcuni dettagli. Se l’evento originale viene eliminato, il sistema può perdere informazioni necessarie per spiegare cosa è successo.

Risoluzione dei problemi operativi

Supponiamo che una spedizione venga classificata come “Eccezione”. Questa categoria è utile per l’instradamento, ma non spiega quale debba essere la prossima azione. L’evento originale può rivelare che il pacco attende un indirizzo corretto, è trattenuto per la documentazione doganale oppure è in attesa di ritiro. I team di assistenza e logistica hanno bisogno di questi dettagli per indagare in modo efficiente.

Tracciabilità e gestione delle controversie

Quando un cliente mette in discussione un aggiornamento sulla consegna, un rivenditore potrebbe dover esaminare l’evento ricevuto dal corriere, l’orario di ricezione e il modo in cui il sistema lo ha interpretato. Conservare il payload originale o una sua rappresentazione strutturata crea una registrazione tracciabile della decisione.

Miglioramenti futuri della mappatura

Le tassonomie degli stati evolvono. Il tuo team potrebbe decidere in seguito che “Trattenuto presso la struttura” debba essere trattato diversamente da un’eccezione generale oppure che determinati eventi doganali meritino un flusso di lavoro dedicato. Gli eventi originali storici consentono di rielaborare e migliorare le classificazioni senza chiedere al corriere di reinviare i dati precedenti.

Precisione specifica del corriere

Alcuni eventi originali hanno un significato operativo che una categoria normalizzata ampia non può esprimere. Una spedizione consegnata, un pacco disponibile presso un punto di ritiro e una spedizione restituita al mittente possono essere tutti stati terminali o quasi terminali, ma richiedono azioni diverse da parte del cliente e dell’azienda. Lo stato originale aiuta a preservare questa distinzione.

Il modello di stato a due livelli è la progettazione più solida

Per la maggior parte dei sistemi multi-corriere, la raccomandazione pratica non è “normalizzato contro originale”, ma un modello a due livelli in cui lo stato normalizzato è l’interfaccia aziendale stabile e lo stato originale è la prova alla base di essa.

Livello datiScopo principaleUtenti tipici
Stato normalizzatoFlussi di lavoro, dashboard, avvisi, report e riepiloghi rivolti ai clientiApplicazioni, responsabili operativi, clienti
Stato originaleIndagini, audit, dettagli specifici del corriere e rimappaturaAssistenza, specialisti della logistica, ingegneri
Metadati della mappaturaSpiegano come e quando è stata prodotta la classificazioneIngegneria, compliance, analisi

Un utile record di evento può includere il nome del corriere, il codice dell’evento del corriere, la descrizione originale, lo stato normalizzato, il timestamp dell’evento, il timestamp di acquisizione, la posizione dell’evento, il riferimento al payload di origine, la versione della mappatura e un indicatore di affidabilità o revisione. Lo schema esatto dipende dal sistema, ma il principio è coerente: memorizzare l’interpretazione insieme alle prove.

Come creare un livello di normalizzazione affidabile

Definisci prima il ciclo di vita aziendale

Inizia dalle decisioni che il tuo sistema deve prendere. Una pagina di tracking per i clienti può richiedere un percorso semplice dalla creazione dell’etichetta alla consegna. Una piattaforma operativa può avere bisogno di stati aggiuntivi per dogana, ritiro, consegna non riuscita e reso. Non creare una categoria normalizzata soltanto perché un corriere usa una formulazione particolare. Creala quando la categoria modifica un’azione aziendale o migliora la comprensione.

Separa lo stato dall’evento

Un evento è qualcosa che viene segnalato in un determinato momento. Uno stato è l’interpretazione corrente del sistema riguardo all’avanzamento della spedizione. Ad esempio, “Arrivato presso la struttura di destinazione” è un evento, mentre “In transito” può essere lo stato normalizzato corrente. Conservare entrambi impedisce che un evento successivo sovrascriva la sequenza storica.

Usa i codici quando disponibili, non solo le descrizioni

Le descrizioni testuali possono cambiare a causa della lingua, della formattazione o della presentazione del corriere. Un codice dell’evento del corriere, quando disponibile e documentato, è solitamente un input di mappatura più stabile rispetto alla corrispondenza di una frase. Il testo può rimanere un’opzione di fallback, ma non dovrebbe essere l’unica base per un flusso di lavoro ad alto impatto.

Gestisci gli eventi sconosciuti e ambigui

Un evento nuovo o poco chiaro del corriere non dovrebbe essere inserito forzatamente in una categoria certa. Usa uno stato “sconosciuto”, “classificazione in sospeso” o equivalente quando le prove sono insufficienti. Il sistema può comunque mostrare l’evento originale e continuare a monitorare la spedizione.

È più sicuro che classificare erroneamente un pacco come consegnato, in consegna o in ritardo. Uno stato positivo errato può attivare messaggi imprecisi ai clienti e decisioni operative più difficili da correggere.

Assegna una versione alle regole di mappatura

La logica di mappatura cambia nel tempo. Registra la versione che ha prodotto ogni stato normalizzato, così i team possono spiegare le decisioni storiche e confrontare i risultati dopo un aggiornamento. Se le mappature vengono gestite centralmente, le modifiche dovrebbero essere testate su cronologie di eventi rappresentative di ogni corriere e servizio supportato.

Testa le sequenze, non solo i singoli eventi

Un singolo evento può essere ambiguo se isolato. La sua posizione nella cronologia della spedizione può fornire un contesto importante. Testa sequenze normali, scansioni ripetute, eventi fuori ordine, eventi mancanti, resi, consegne non riuscite e spedizioni che si spostano tra strutture senza scansioni frequenti.

I test dovrebbero includere anche i tentativi ripetuti dei webhook e le notifiche duplicate. Lo stesso evento del corriere può essere ricevuto più di una volta, quindi l’acquisizione dovrebbe essere idempotente e non creare aggiornamenti contraddittori per i clienti.

Quale livello dovrebbe usare ciascun componente del sistema?

  • Pagine di tracking rivolte ai clienti: usa gli stati normalizzati come percorso principale, rendendo disponibile la descrizione originale quando aggiunge dettagli utili.
  • Regole di notifica: usa gli stati normalizzati, ma applica salvaguardie per transizioni sensibili come consegnato, restituito o eccezione.
  • Dashboard operative: usa categorie normalizzate per filtraggio e prioritizzazione, quindi mostra gli eventi originali per le indagini.
  • Analisi: usa gli stati normalizzati per i confronti tra corrieri e conserva i campi originali per l’approfondimento e l’analisi della qualità dei dati.
  • Strumenti di assistenza: mostra entrambi i livelli. Un operatore ha bisogno di un riepilogo leggibile e di sufficienti dettagli del corriere per rispondere a una domanda specifica.
  • Riconciliazione con il corriere: conserva l’evento originale e i timestamp. Il solo valore normalizzato non è una prova sufficiente per la riconciliazione.
  • Consumer dell’API: restituisci entrambi quando possibile. Un campo normalizzato stabile facilita l’integrazione, mentre i campi originali impediscono la perdita di informazioni.

Dove si inserisce un’API di tracking

Quando un’azienda raccoglie eventi di tracking da più fornitori di trasporto, un’API di tracking può fornire un livello di integrazione per recuperare i dati delle spedizioni e creare una logica applicativa coerente. La documentazione ufficiale delle API di 17TRACK descrive un approccio basato su API per integrare le informazioni di tracking, pertinente ai sistemi che necessitano di visibilità multi-corriere anziché di un flusso di stati proveniente da un singolo corriere. Consulta la documentazione prima di progettare il sistema basandoti su uno specifico campo o comportamento.

L’API non dovrebbe essere considerata un motivo per eliminare i dati a livello di corriere. Prima dell’implementazione, verifica quali campi normalizzati, campi originali, codici degli eventi, timestamp e meccanismi di aggiornamento siano effettivamente esposti per i corrieri e i servizi interessati. Una prova di fattibilità dovrebbe testare cronologie reali delle spedizioni, comprese eccezioni e restituzioni, non soltanto consegne riuscite.

Per una piccola attività che utilizza un solo corriere e una revisione manuale, inizialmente può essere sufficiente memorizzare lo stato originale. Per un marketplace, un rivenditore, una piattaforma logistica o un sistema di assistenza clienti che integra diversi corrieri, un livello normalizzato diventa generalmente sempre più prezioso con la crescita dei flussi di lavoro e dei report.

Errori comuni da evitare

  • Sostituire il valore originale: elimina il contesto e rende più difficile un’indagine successiva.
  • Trattare la normalizzazione come uno standard universale: una tassonomia normalizzata è una scelta implementativa, non la prova che tutti i corrieri definiscano gli eventi nello stesso modo.
  • Usare un’unica etichetta per ogni eccezione: la gestione delle eccezioni richiede, quando possibile, una causa, una gravità e il contesto della prossima azione.
  • Presumere che l’evento più recente sia sempre la verità definitiva: possono verificarsi eventi duplicati, ritardati, corretti o fuori ordine.
  • Pubblicare codici interni ai clienti: i codici dei corrieri sono spesso comprensibili agli specialisti ma confondono gli acquirenti.
  • Non monitorare gli eventi non mappati: la qualità della mappatura dovrebbe essere misurata tramite code di eventi sconosciuti, revisioni delle classificazioni e controlli degli errori nei flussi di lavoro.

Una regola decisionale pratica

Se il sistema deve automatizzare un’azione aziendale tra più corrieri, usa uno stato normalizzato. Se una persona potrebbe dover spiegare, contestare, sottoporre ad audit o reinterpretare tale azione, conserva lo stato originale del corriere. Se si applicano entrambe le condizioni, esponi entrambi tramite campi separati e rendi esplicita la relazione.

L’architettura più duratura non è quindi una scelta tra semplicità e dettaglio. È un livello di traduzione controllato: gli eventi originali dei corrieri entrano nel sistema, gli stati normalizzati supportano decisioni coerenti e le prove originali rimangono disponibili per garantire la responsabilità. Questo approccio offre ai team di prodotto un’interfaccia stabile senza impedire ai team operativi e di assistenza di vedere ciò che è realmente accaduto.

FAQ

Lo stato normalizzato dovrebbe sostituire quello originale del corriere?

No. Normalmente dovrebbe essere affiancato allo stato originale. La normalizzazione migliora la coerenza, ma l’evento originale conserva i dettagli specifici del corriere e supporta la risoluzione dei problemi, gli audit e le rimappature future.

Uno stato originale può essere mappato su più di uno stato normalizzato?

Sì, a seconda del contesto. La stessa descrizione può richiedere un trattamento diverso in base al corriere, al codice dell’evento, alla cronologia della spedizione, al tipo di servizio o alla posizione. Le regole di mappatura dovrebbero usare tutti i campi pertinenti anziché basarsi esclusivamente sul testo.

Cosa dovrebbe accadere quando un corriere invia uno stato sconosciuto?

Conserva l’evento originale, contrassegna il valore normalizzato come sconosciuto o in attesa di classificazione e indirizzalo alla revisione se influisce su un flusso di lavoro importante. Non classificare automaticamente un evento ambiguo come consegnato o in ritardo.

Quale stato dovrebbe apparire in una pagina di tracking per i clienti?

Usa uno stato normalizzato chiaro come etichetta principale del percorso. Aggiungi la descrizione originale del corriere quando aiuta a spiegare un ritardo, lo spostamento presso una struttura, un’istruzione per il ritiro o un altro evento specifico.

La normalizzazione è necessaria per un sistema che utilizza un solo corriere?

Non sempre. Un’implementazione ridotta con un solo corriere può iniziare dagli eventi originali, soprattutto se i flussi di lavoro sono semplici. Un livello normalizzato diventa più utile quando l’azienda aggiunge corrieri, automazione, report, notifiche ai clienti o operazioni regionali multiple.

Fonti