Skip to main content
CasaBlogGuideCome mappare gli eventi sconosciuti del corriere agli stati interni della spedizione: regole di fallback e code di revisione

Come mappare gli eventi sconosciuti del corriere agli stati interni della spedizione: regole di fallback e code di revisione

17TRACK

Gli eventi del corriere sconosciuti non devono essere forzati in uno stato preciso della spedizione. Un design più sicuro associa prima ogni evento a uno stato interno ampio, conserva il messaggio originale del corriere, assegna un livello di affidabilità e invia i casi ambigui o operativamente importanti a una coda di revisione. Questo approccio mantiene comprensibile il tracciamento rivolto ai clienti senza nascondere l'incertezza ai team operativi.

Come associare gli eventi sconosciuti dei corrieri agli stati interni della spedizione

L'obiettivo pratico non è creare un dizionario universale per ogni corriere. I messaggi dei corrieri variano in base alla lingua, al servizio, alla tratta di trasporto e al formato dei dati. L'obiettivo è costruire un sistema di fallback controllato che rimanga utile quando compare un nuovo codice, una nuova formulazione o una nuova sequenza di eventi.

Cosa deve ottenere una mappa degli stati interni

Un evento del corriere è un'osservazione. Uno stato interno della spedizione è un'interpretazione utilizzata da un cliente, un operatore dell'assistenza, un team di magazzino o un flusso di automazione. Questi due livelli devono rimanere separati.

Ad esempio, un corriere può comunicare «informazioni sulla spedizione ricevute», «accettata presso la struttura di origine», «in transito» o «tentata consegna». La tua applicazione potrebbe aver bisogno di un insieme più ristretto di stati, come Etichetta creata, In transito, In consegna, Eccezione, Consegnata e Restituita. Il livello di mappatura traduce l'osservazione esterna in uno stato interno conservando sufficienti dettagli per una revisione successiva.

Un sistema di mappatura solido dovrebbe soddisfare cinque requisiti:

  • Conservare i dati sorgente: memorizzare, quando disponibili, il codice dell'evento originale, la descrizione, il timestamp, la posizione, il corriere e il servizio.
  • Usare stati interni stabili: mantenere il ciclo di vita rivolto ai clienti sufficientemente ridotto da essere comprensibile e coerente tra i diversi corrieri.
  • Separare lo stato dal motivo: «Eccezione» è uno stato; «problema di indirizzo», «blocco doganale» e «disservizio meteorologico» sono motivi.
  • Rappresentare l'incertezza: una classificazione con bassa affidabilità non dovrebbe apparire identica a una consegna confermata.
  • Supportare la revisione umana: gli eventi ambigui devono essere visibili a un responsabile invece di scomparire in una categoria predefinita.

Inizia con un modello controllato degli stati interni

Prima di scrivere le regole di fallback, definisci gli stati interni sui quali i sistemi a valle possono fare affidamento. Un tipico ciclo di vita di un pacco può includere:

Stato internoSignificatoUtilizzo operativo tipico
Etichetta creataI dati della spedizione esistono, ma il possesso fisico da parte del corriere non è confermato.Impostare le aspettative del cliente e rilevare i passaggi rimasti bloccati.
AccettataIl corriere o una struttura di origine ha registrato la ricezione.Confermare che la spedizione è entrata nella rete.
In transitoLa spedizione si sta spostando attraverso la rete o tra strutture.Fornire un'indicazione generale dell'avanzamento.
Dogana o regolamentazioneLa spedizione è sottoposta a una procedura di frontiera, doganale o regolamentare.Attivare i flussi di lavoro relativi ai documenti o alla conformità.
In consegnaIl corriere indica che è in corso un tentativo di consegna dell'ultimo miglio.Inviare notifiche nel giorno della consegna.
EccezioneUn'interruzione o una condizione richiede attenzione o può ritardare l'avanzamento.Dare priorità alla revisione da parte dell'assistenza e delle operazioni.
ConsegnataIl corriere ha segnalato un evento di consegna.Chiudere i flussi di consegna o avviare i processi successivi alla consegna.
RestituitaLa spedizione sta per essere restituita o ha completato il movimento di rientro.Avviare i flussi di reso, rimborso o nuova spedizione.

Questi stati sono esempi, non una tassonomia universale obbligatoria. Il modello corretto dipende dalle automazioni che utilizzano lo stato. Se un sistema di magazzino necessita di uno stato separato «Ricevuta presso la struttura di destinazione», aggiungilo. Se ai clienti servono solo cinque stati generali, mantieni il livello rivolto ai clienti più semplice di quello operativo.

Utilizza una strategia di mappatura a più livelli

La mappatura dovrebbe avvenire per livelli, partendo dagli elementi più affidabili fino al fallback più debole. Non iniziare con la corrispondenza di parole chiave quando è disponibile un codice specifico del corriere o una categoria di evento documentata.

Livello 1: regole specifiche del corriere

Crea regole esplicite per i codici e le combinazioni di eventi dei corrieri conosciuti. Una regola può utilizzare il corriere, il codice dell'evento, la descrizione normalizzata, il tipo di posizione e il timestamp dell'evento. Ad esempio, un codice specifico del corriere per «consegnata» dovrebbe essere associato a Consegnata solo quando l'evento è un'effettiva conferma di consegna, non una semplice stima.

Le regole specifiche del corriere devono essere sottoposte a versionamento. I corrieri possono aggiungere codici, modificare le formulazioni o usare descrizioni diverse tra i servizi. Conserva per ogni regola la data di entrata in vigore, il responsabile, il riferimento alla fonte e gli esempi di test.

Livello 2: categorie di eventi normalizzate

Quando i codici esatti non sono disponibili, normalizza i dati degli eventi in categorie come pre-spedizione, accettazione, movimento, dogana, tentativo di consegna, completamento della consegna, reso ed eccezione. La normalizzazione riduce la dipendenza dalla formulazione del corriere mantenendo disponibile il messaggio originale.

Non dedurre più di quanto l'evento dimostri. «Arrivato presso la struttura» supporta un'interpretazione di arrivo presso la struttura o di transito. Non dimostra necessariamente che il pacco sia partito, abbia raggiunto il Paese di destinazione o sarà consegnato in una data specifica.

Livello 3: regole conservative basate su parole chiave e frasi

Le regole basate sulle parole chiave possono offrire copertura per descrizioni sconosciute, ma devono essere ristrette e ordinate in base al rischio. Termini come «consegnato», «firmato» o «consegnato al destinatario» possono supportare una classificazione Consegnata quando compaiono in un chiaro contesto di completamento. Termini come «tentato», «impossibile», «trattenuto», «ritardo» o «indirizzo» dovrebbero generalmente portare a Eccezione o a uno stato di revisione, invece che a uno stato di consegna riuscita.

Usa gruppi di frasi invece di parole isolate. La parola «restituito» in una nota può descrivere una scansione precedente, mentre «reso al mittente avviato» descrive un processo di restituzione attivo. Contano il contesto, l'ordine degli eventi e l'evento più recente.

Livello 4: fallback consapevole dello stato

Se un evento non può essere classificato con sufficiente affidabilità, usa lo stato confermato precedente della spedizione e il rischio operativo del nuovo evento. Un evento sconosciuto dopo Accettata può rimanere In transito. Un evento sconosciuto dopo In consegna non dovrebbe essere automaticamente riportato a In transito se potrebbe indicare un tentativo fallito o un'eccezione di consegna.

Il fallback consapevole dello stato non deve mai sostituire uno stato terminale senza prove solide. Un evento vago dopo Consegnata dovrebbe normalmente essere conservato come nota successiva alla consegna o inviato alla revisione, invece di riaprire la spedizione come In transito.

Definisci regole di fallback per gli eventi sconosciuti

Una politica di fallback dovrebbe essere scritta come logica decisionale esplicita. Le seguenti regole sono un punto di partenza pratico:

  1. Conserva prima l'evento grezzo. Salva il payload prima della normalizzazione, così le modifiche future alle regole potranno rielaborare gli eventi storici.
  2. Preferisci prove esplicite di completamento. Non associare un evento sconosciuto a Consegnata a meno che il testo, il codice o la categoria fornita dal corriere indichi chiaramente il completamento.
  3. Usa In transito come fallback di movimento, non come impostazione predefinita universale. Applicalo quando l'evento indica movimento, arrivo, partenza, trasferimento o elaborazione nella rete senza una chiara eccezione.
  4. Escala le parole che indicano rischio. I termini che indicano danno, perdita, rifiuto, problemi di indirizzo, intervento doganale o mancata consegna dovrebbero essere associati a Eccezione o a una categoria operativa specializzata.
  5. Non trattare le stime come scansioni. Una data di consegna prevista o un movimento pianificato non dimostrano che la spedizione abbia raggiunto una struttura o sia entrata nella consegna dell'ultimo miglio.
  6. Rispetta l'ordine degli eventi. Un evento arrivato in ritardo può avere un timestamp precedente. Ordina in base all'ora dell'evento del corriere quando è affidabile, conservando l'ora di acquisizione per finalità di audit.
  7. Previeni la regressione degli stati terminali. Consegnata e Restituita non devono essere sovrascritte da un evento sconosciuto più debole senza un motivo sottoponibile a revisione.
  8. Invia le mappature a bassa affidabilità alla revisione. Un fallback può comunque aggiornare uno stato interno generale, ma l'evento deve rimanere visibile per il controllo qualità quando l'affidabilità è bassa.

Costruisci code di revisione basate sul rischio aziendale

Una singola coda di «eventi sconosciuti» diventa rapidamente ingestibile. Separa le code in base all'azione richiesta. Un team di assistenza potrebbe dover contattare un acquirente, mentre un team operativo del corriere potrebbe dover analizzare un problema dei dati.

CodaAttivatore tipicoResponsabile suggerito
Revisione della classificazioneNuovo codice, descrizione poco chiara o corrispondenza di frasi con bassa affidabilità.Team dei dati di tracciamento o di ingegneria.
Rischio di consegnaPossibile tentativo fallito, danno, perdita, rifiuto o problema di indirizzo.Operazioni clienti o assistenza.
Dogana e conformitàBlocco alla frontiera, richiesta di documentazione, dazi o ispezione regolamentare.Team di conformità commerciale o logistica.
Qualità dei datiTimestamp mancanti, posizioni non valide, eventi duplicati o stati in conflitto.Team di integrazione o qualità dei dati.

Ogni coda necessita di un responsabile, una priorità, un obiettivo di livello di servizio, opzioni di risoluzione e una traccia di audit. Un revisore dovrebbe poter visualizzare l'evento grezzo, i campi normalizzati, gli eventi precedenti, la regola di mappatura corrente, il punteggio di affidabilità e gli eventi simili già risolti. La decisione del revisore dovrebbe aggiornare la libreria delle regole solo dopo la convalida; altrimenti, una singola decisione errata potrebbe propagarsi a molte spedizioni.

Usa l'affidabilità senza fingere che sia certezza

Un punteggio di affidabilità è utile quando riflette la qualità delle prove invece di limitarsi a produrre un numero. Considera segnali separati come:

  • Corrispondenza esatta con un codice del corriere verificato
  • Corrispondenza con una categoria di evento documentata
  • Coerenza tra codice e descrizione
  • Coerenza con lo stato precedente della spedizione
  • Presenza di un timestamp e di una posizione dell'evento affidabili
  • Possibilità che l'evento attivi un'azione per il cliente, finanziaria o di conformità

Una mappatura ad alta affidabilità può essere sicura per le notifiche automatiche ai clienti. Una mappatura con affidabilità media può aggiornare la visibilità interna ma richiedere un campionamento. Una mappatura a bassa affidabilità può rimanere uno stato generale entrando al contempo in una coda di revisione. Le soglie devono essere testate sugli eventi storici e adattate al rischio, non scelte perché una determinata percentuale sembra precisa.

Progetta il record dell'evento per la rielaborazione

Un record dell'evento dovrebbe conservare sia i campi sorgente sia quelli derivati. Tra i campi utili figurano nome del corriere, numero di tracciamento, servizio, codice dell'evento sorgente, descrizione originale, descrizione tradotta se applicabile, ora dell'evento, ora di acquisizione, fuso orario, posizione, riferimento al payload grezzo, stato interno, codice del motivo, ID della regola di mappatura, fascia di affidabilità, stato della revisione e decisione del revisore.

Mantieni le regole di mappatura fuori dal codice dell'applicazione quando possibile, oppure rendile almeno sottoposte a versionamento e testabili in modo indipendente. Quando aggiungi una nuova regola, rielabora eventi storici rappresentativi prima di distribuirla ampiamente. Testa i normali avanzamenti, gli eventi ritardati, le scansioni duplicate, gli eventi fuori ordine, le descrizioni multilingue e i conflitti tra stati terminali.

Un sistema di tracciamento multi-corriere può fornire i dati necessari per questo flusso di lavoro, ma la qualità della tassonomia interna e del processo di revisione determina comunque quanto i dati vengano utilizzati in sicurezza. La documentazione dell'API di tracciamento di 17TRACK descrive un approccio basato su API per ricevere e utilizzare le informazioni di tracciamento dei corrieri; prima dell'implementazione, i team devono confermare i campi e il comportamento degli eventi pertinenti alla propria integrazione.

Misura il sistema di mappatura dopo il lancio

Monitora più della percentuale di eventi classificati automaticamente. Tra le metriche utili figurano la quota di eventi inviati alla revisione, il tempo necessario per risolvere nuovi tipi di evento, il ripetersi dello stesso codice sconosciuto, le assegnazioni errate degli stati terminali, i contatti dei clienti dopo aggiornamenti fuorvianti e la proporzione di eventi revisionati che porta a una nuova regola riutilizzabile.

Esamina separatamente i falsi positivi e i falsi negativi. Associare un'eccezione a In transito può nascondere un problema operativo. Associare un movimento normale a un'eccezione può generare preoccupazione inutile nel cliente. L'equilibrio accettabile degli errori dipende dall'azione aziendale associata a ciascuno stato.

Una sequenza pratica di implementazione

  1. Inventaria gli stati interni e le automazioni che dipendono da essi.
  2. Raccogli eventi rappresentativi da ogni corriere e servizio attivo.
  3. Costruisci regole esplicite per i codici verificati e gli eventi ad alto rischio.
  4. Aggiungi categorie normalizzate e una corrispondenza conservativa delle frasi.
  5. Definisci fasce di affidabilità e code di revisione separate.
  6. Testa l'ordine degli eventi, i duplicati, gli stati terminali e i testi multilingue.
  7. Avvia il sistema con monitoraggio e un percorso di approvazione umana per i nuovi modelli.
  8. Esamina regolarmente i casi risolti e pubblica solo modifiche alle regole convalidate.

Il miglior sistema di fallback è volutamente semplice: effettua classificazioni generali sicure, mantiene intatte le prove grezze, evita di inventare precisione e offre alle persone un percorso chiaro per correggere i risultati incerti. Questo equilibrio protegge le comunicazioni con i clienti consentendo al livello di mappatura di migliorare man mano che vengono esaminati nuovi eventi dei corrieri.

Domande frequenti

Ogni evento sconosciuto del corriere dovrebbe essere associato a In transito?

No. In transito è un fallback ragionevole solo quando l'evento suggerisce un movimento o un'elaborazione continuativa nella rete e non indica un problema di consegna, un reso, una questione doganale o un esito terminale. Un evento sconosciuto con termini di rischio dovrebbe essere inviato a Eccezione o alla revisione.

Quando un evento sconosciuto dovrebbe essere associato a Consegnata?

Solo quando il codice del corriere, la descrizione o la categoria strutturata fornisce una prova chiara del completamento della consegna. Una stima di consegna, l'arrivo presso una struttura locale o la preparazione alla consegna non equivalgono a un evento di consegna completato.

Gli eventi con bassa affidabilità devono essere nascosti ai clienti?

Non necessariamente. Uno stato generale può essere comunque utile se non è fuorviante. Ad esempio, un evento di movimento incerto può supportare la visualizzazione generale «In transito», mentre l'evento originale entra in una coda di revisione interna. Evita di mostrare una spiegazione precisa che i dati non supportano.

Come può un team impedire che le code di revisione crescano indefinitamente?

Assegna la responsabilità, stabilisci le priorità in base al rischio per il cliente e operativo, raggruppa i modelli di eventi duplicati e fissa obiettivi di revisione. Gli analisti dovrebbero poter trasformare una risoluzione convalidata in una regola sottoposta a versionamento. Tieni traccia degli eventi sconosciuti ricorrenti affinché il lavoro di integrazione si concentri sui modelli con volume o impatto aziendale significativo.

Cosa dovrebbe accadere quando un evento tardivo è in conflitto con lo stato più recente?

Confronta il timestamp dell'evento del corriere con l'ora di acquisizione e conserva entrambi. Applica le regole di ordinamento basate sull'ora affidabile dell'evento, ma non riaprire automaticamente lo stato terminale di una spedizione. I conflitti che coinvolgono Consegnata, Restituita o un'eccezione grave devono essere conservati per la revisione insieme alla cronologia completa degli eventi.

Fonti