Skip to main content
CasaBlogGuideCome i magazzini oltreoceano possono utilizzare le API di tracciamento per monitorare le consegne locali

Come i magazzini oltreoceano possono utilizzare le API di tracciamento per monitorare le consegne locali

17TRACK

I magazzini d'oltremare possono utilizzare le API di tracking per monitorare le consegne locali collegando ogni pacco in uscita al corriere e al numero di tracking, importando gli eventi di tracking nel sistema di gestione del magazzino o degli ordini e trasformando le eccezioni di consegna in attività assegnate. La configurazione più utile distingue la creazione dell'etichetta dall'accettazione da parte del corriere, conserva la cronologia della spedizione e indica ai team operativi quali pacchi richiedono un intervento, non semplicemente quali pacchi hanno un nuovo stato.

Come i magazzini d'oltremare possono utilizzare le API di tracking per monitorare le consegne locali

Questa guida si concentra sui magazzini che detengono inventario al di fuori del mercato di origine del commerciante e spediscono gli ordini ai clienti nel mercato di destinazione. Per questi team, il tracking delle spedizioni internazionali deve collegare i registri di spedizione del magazzino al percorso di consegna del corriere locale. Questo collegamento aiuta i responsabili del magazzino, i coordinatori dei trasporti e i team di assistenza ai commercianti a lavorare sullo stesso record di spedizione.

Definire dove termina la visibilità del magazzino e inizia quella del corriere

Un sistema di gestione del magazzino può registrare che un ordine è stato prelevato, imballato, etichettato e collocato in un'area di spedizione. Questi registri, da soli, non dimostrano che il corriere abbia accettato il pacco. Un'API di tracking aggiunge gli eventi segnalati dal corriere, ma non può sostituire un registro di consegna del magazzino né creare una scansione fisica che non è mai avvenuta.

Mantieni separati tre traguardi: pronto per il ritiro, consegnato secondo i registri del magazzino e accettato secondo gli eventi di tracking del corriere. Questa separazione facilita l'analisi dei pacchi che risultano spediti internamente ma non mostrano alcun movimento del corriere.

Ad esempio, se un pacco compare in un manifesto di ritiro ma non presenta alcun evento di accettazione, il passo successivo consiste nel controllare i registri di carico e contattare il corriere incaricato del ritiro. È prematuro classificare il pacco come smarrito. Se il corriere ha già segnalato un tentativo di consegna non riuscito, l'azione appropriata è diversa: analizzare il motivo e coordinare il passaggio successivo con il commerciante o con il contatto autorizzato del destinatario.

Creare il record della spedizione prima di collegare l'API

La base è una relazione affidabile tra l'ordine del cliente, il pacco fisico e l'identificativo di tracking del corriere. Non utilizzare il numero d'ordine come sostituto dell'identificativo del pacco. Un ordine può lasciare il magazzino in più pacchi e una spedizione sostitutiva necessita di un proprio record.

RecordCampi consigliatiFinalità operativa
Identità della spedizioneID interno della spedizione, ID ordine, ID pacco, account del commercianteMantenere separate le spedizioni suddivise e i diversi clienti.
Identità del corriereIdentificativo del corriere, numero di tracking, servizio se notoInviare la richiesta di tracking corretta e indirizzare le verifiche.
Consegna al magazzinoMagazzino, ora di spedizione, riferimento del ritiro, riferimento del manifestoConfrontare le prove della spedizione fisica con gli eventi del corriere.
Cronologia del trackingEvento originale, stato mappato, ora dell'evento, ora di ricezione, località quando fornitaConservare le prove e distinguere i tempi degli eventi dai ritardi di comunicazione.
Flusso di lavoro delle eccezioniTipo di problema, responsabile, prossima azione, scadenza della revisione, risoluzioneTrasformare le informazioni di tracking in attività attribuibili.

Salva i numeri di tracking come testo per preservarne la formattazione. Quando il magazzino conosce già il corriere dalla generazione dell'etichetta, trasmetti tale identità tramite l'integrazione invece di affidarti esclusivamente al riconoscimento del numero. Conserva inoltre le relazioni tra pacchi originali, sostitutivi, di reso e di consegna successiva senza sovrascrivere le rispettive cronologie.

Scegliere un'integrazione adatta alla combinazione di corrieri del magazzino

Un magazzino può integrarsi direttamente con i propri corrieri oppure utilizzare un'API di tracking multi-corriere. L'integrazione diretta può essere pratica per un'operazione stabile che utilizza un numero ridotto di corrieri, soprattutto quando sono necessari dati specifici del corriere. Un'API multi-corriere merita di essere valutata quando il magazzino ha bisogno di un'interfaccia di tracking condivisa tra diverse reti di consegna.

La Tracking API di 17TRACK è un'opzione pertinente per questo modello di integrazione. Utilizza la documentazione API ufficiale per valutare come la registrazione delle spedizioni, il recupero del tracking e gli aggiornamenti del tracking si inserirebbero nel tuo sistema. Conferma le combinazioni esatte di corriere e servizio utilizzate da ciascun magazzino, invece di considerare la disponibilità generale del corriere come prova che ogni evento richiesto verrà restituito.

Valuta il collegamento rispetto ai requisiti operativi effettivi:

  • Il tuo sistema può registrare in modo affidabile i pacchi generati durante i picchi di spedizione?
  • Quali eventi vengono restituiti per i servizi di consegna locali che acquisti realmente?
  • Come vengono gestite le richieste non riuscite, le registrazioni duplicate e gli identificativi dei corrieri non validi?
  • Come vengono distribuiti o recuperati gli aggiornamenti e come possono essere riconciliati quelli mancanti?
  • Quali limiti di utilizzo, condizioni di conservazione, controlli di sicurezza e condizioni commerciali si applicano al tuo account?

Non si deve presumere che un collegamento di tracking includa l'acquisto di etichette, la correzione degli indirizzi, la riprogrammazione della consegna o l'invio di richieste di rimborso. Considerali flussi di lavoro separati, salvo conferma esplicita nella documentazione del prodotto pertinente.

Collegare la spedizione, gli aggiornamenti del tracking e la gestione delle eccezioni

1. Registrare i pacchi in una fase di spedizione controllata

Scegli un attivatore di registrazione coerente, come la conferma dell'etichetta o la conferma della spedizione. La registrazione al momento della creazione dell'etichetta può rendere visibili i pacchi che restano non ritirati, ma richiede anche la gestione delle etichette annullate. Registrare solo dopo la spedizione riduce le registrazioni inutilizzate, ma può nascondere l'intervallo tra la creazione dell'etichetta e la consegna fisica.

Qualunque attivatore tu scelga, salva il risultato della registrazione associandolo al pacco. Le registrazioni non riuscite devono entrare in una coda di ritentativo o correzione, invece di scomparire nei log dell'applicazione. Utilizza un identificativo interno stabile per impedire che elaborazioni ripetute creino record aziendali duplicati.

2. Ricevere gli aggiornamenti senza rendere il dashboard la fonte autorevole

A seconda delle opzioni documentate dell'API, gli aggiornamenti possono essere recuperati tramite richieste o ricevuti tramite notifiche webhook. Un webhook è un messaggio inviato al tuo sistema quando il provider dispone di un aggiornamento; il polling significa che il tuo sistema richiede le informazioni.

Per le implementazioni basate su webhook, convalida i messaggi in entrata utilizzando il metodo di verifica documentato dal provider. Salva in modo permanente i messaggi accettati prima di confermarne la ricezione, quindi elaborali in modo asincrono. Progetta il sistema per gestire messaggi duplicati ed eventi che arrivano fuori sequenza. Segui i requisiti documentati per le risposte e i nuovi tentativi, invece di presumere che ogni provider si comporti allo stesso modo.

Per il polling, assegna la priorità alle spedizioni attive e alle eccezioni irrisolte rispettando i limiti di utilizzo applicabili. Ove supportato, utilizza richieste di riconciliazione per controllare le spedizioni la cui cronologia degli aggiornamenti appare incompleta. Registra separatamente gli errori di acquisizione dalle eccezioni di consegna del corriere: una connessione interrotta non dimostra che un pacco abbia smesso di muoversi.

3. Normalizzare gli stati preservando le prove originali

Crea un piccolo insieme di categorie operative, come in attesa di accettazione, in transito, in consegna, tentata consegna, consegnato e movimento di reso. Queste sono categorie di magazzino suggerite, non una garanzia che ogni corriere fornisca eventi corrispondenti.

Conserva la descrizione originale insieme alla categoria mappata. “Disponibile per il ritiro” non deve diventare silenziosamente “consegnato” e “reso avviato” non deve diventare “ricevuto nuovamente in magazzino”. Consenti uno stato sconosciuto o non mappato affinché gli eventi insoliti restino visibili per la revisione.

Conserva sia il timestamp dell'evento sia l'ora in cui il sistema lo ha ricevuto. Mantieni il fuso orario o l'offset originale quando fornito e utilizza uno standard temporale interno coerente. Un evento ricevuto in ritardo non deve spostare automaticamente una spedizione all'indietro solo perché è stato ricevuto per ultimo; applica regole di sequenza esplicite e conserva la cronologia.

4. Assegnare i responsabili delle azioni alle eccezioni

Un avviso è utile solo quando qualcuno può intervenire. Inoltra le scansioni di accettazione mancanti al team di spedizione del magazzino, i tentativi di consegna che richiedono l'intervento del destinatario al team di assistenza del commerciante e i problemi persistenti di movimento del corriere al coordinatore dei trasporti. Questi sono punti di partenza consigliati; le responsabilità devono riflettere i contratti e il modello operativo del magazzino.

Allega a ogni caso la cronologia del tracking, il riferimento della consegna, l'ultimo evento, le note dell'indagine e l'orario della prossima revisione. Raggruppa gli avvisi ripetuti sotto lo stesso problema aperto, affinché un pacco bloccato non generi una nuova attività dopo ogni sincronizzazione.

Impostare gli avvisi in base alle aspettative del servizio, non a timer arbitrari

Non esiste un intervallo universale dopo il quale un pacco senza una nuova scansione diventa in ritardo o smarrito. Configura le soglie degli avvisi in base al servizio del corriere, al programma di ritiro, ai giorni operativi, alla destinazione e all'impegno del commerciante. Mantieni separata la soglia interna di verifica dalla promessa di consegna comunicata al cliente.

  • Nessuna accettazione dopo la consegna: controlla il registro del ritiro e la conferma del corriere prima di procedere all'escalation.
  • Nessun movimento oltre l'intervallo previsto: esamina l'ultimo evento, le aspettative del servizio e le interruzioni operative note.
  • Tentativo di consegna non riuscito: leggi il motivo prima di decidere se la prossima azione spetta al corriere, al commerciante o al destinatario.
  • Movimento di reso: prepara il flusso di lavoro dei resi, ma non aumentare l'inventario vendibile fino alla ricezione fisica e all'ispezione richiesta.
  • Consegnato ma contestato: apri un'indagine e cerca le prove di consegna disponibili; non considerare il solo stato come risoluzione del reclamo.

Il tracking riflette gli eventi di spedizione segnalati, non la posizione continua del pacco. Mostrare il timestamp dell'ultimo aggiornamento aiuta il personale a comprendere l'attualità delle informazioni senza suggerire una visibilità GPS in tempo reale.

Fornire a ogni team una visualizzazione utilizzabile

I supervisori del magazzino hanno bisogno delle eccezioni dalla spedizione all'accettazione. I coordinatori dei trasporti hanno bisogno di code specifiche per corriere e casi in sospeso da tempo. I team di assistenza ai commercianti hanno bisogno di una cronologia chiara della spedizione e della prossima azione concordata. Un modello di dati condiviso può supportare queste visualizzazioni senza concedere a ogni utente l'accesso alle spedizioni di tutti i commercianti.

Per un magazzino multi-cliente, applica l'accesso a livello di commerciante sul server, non solo tramite i filtri del dashboard. Mantieni le credenziali API fuori dal codice del browser, limita l'accesso alle informazioni del destinatario e definisci regole di conservazione e cancellazione. Evita di inserire dati personali non necessari nei riferimenti di tracking o nei log diagnostici.

Le misurazioni utili includono la percentuale di pacchi spediti registrati con successo per il tracking, la percentuale con eventi di accettazione del corriere, il tempo dalla spedizione all'accettazione, l'età delle eccezioni irrisolte e gli errori di elaborazione dell'integrazione. Definisci ogni denominatore e base temporale. Se misuri la puntualità della consegna, confrontala con una promessa documentata o con un impegno di servizio, non con una durata generica della consegna.

Testare il flusso di lavoro prima di ampliarlo

Inizia con un magazzino, un insieme di corrieri e un gruppo di commercianti chiaramente definiti. Includi sia le consegne ordinarie sia i record problematici: etichette annullate, ordini suddivisi, prime scansioni mancanti, tentativi di consegna non riusciti, notifiche duplicate, eventi fuori sequenza e resi. Utilizza dati di test autorizzati o record storici quando appropriato; non inventare eventi del corriere in produzione.

Concorda i criteri di accettazione prima del lancio. Ogni pacco spedito deve avere un record di registrazione riuscita o un caso di errore assegnato. I messaggi riprodotti non devono generare attività duplicate. Gli eventi di tracking devono rimanere riconducibili alla loro origine e gli utenti non devono vedere i record di un altro commerciante.

Espandi il sistema solo dopo che il personale operativo è in grado di gestire in modo affidabile la coda delle eccezioni e il personale tecnico sa recuperare gli aggiornamenti non riusciti. L'obiettivo pratico non è un dashboard pieno di stati. È un collegamento tracciabile dalla spedizione del magazzino alla consegna del corriere, con una responsabilità chiara ogni volta che quel percorso richiede attenzione.

FAQ

Un'API di tracking può sostituire un sistema di gestione del magazzino?

No. Un'API di tracking fornisce visibilità sulla spedizione. Il sistema del magazzino rimane responsabile di attività come il controllo dell'inventario, il prelievo, l'imballaggio e i registri della spedizione fisica. Collega i due sistemi tramite gli identificativi dei pacchi, affinché gli eventi del corriere aggiungano contesto senza sostituire le prove del magazzino.

Un'API di tracking fornisce la posizione GPS in tempo reale?

Non darlo per scontato. Il tracking dei pacchi consiste comunemente in eventi e posizioni segnalati. La tempistica degli aggiornamenti dipende dal corriere e dall'integrazione. La posizione continua del veicolo o del pacco richiede una funzionalità verificata separatamente.

Cosa deve fare il personale quando un pacco non presenta aggiornamenti di tracking?

Controlla innanzitutto l'esito della registrazione, l'identità del corriere e l'accuratezza del numero di tracking. Quindi confronta l'ultimo evento con le prove della consegna al magazzino e con la tempistica prevista del servizio. Analizza separatamente gli errori di integrazione e le scansioni mancanti del corriere prima di decidere quale team debba procedere all'escalation.

Gli eventi di tracking possono attivare automaticamente rimborsi o aggiornamenti dell'inventario?

Possono informare un flusso di lavoro, ma le azioni con conseguenze richiedono controlli aggiuntivi. Un'eccezione di consegna non stabilisce necessariamente il diritto a un rimborso e il movimento di un reso non dimostra la ricezione fisica in magazzino. Applica le politiche del commerciante, i controlli di autorizzazione e le procedure di ricezione prima di modificare i registri finanziari o di inventario.

Come devono apparire gli ordini suddivisi ai team di assistenza dei commercianti?

Mostra ogni pacco separatamente sotto l'ordine principale. La consegna di un pacco non deve contrassegnare l'intero ordine come completato quando un altro pacco è ancora in transito. Mantieni collegate, ma distinguibili, le spedizioni sostitutive e quelle di reso.

Fonti

  • 17TRACK Tracking API — riferimento ufficiale del prodotto per l'opzione di integrazione della tracking API.
  • 17TRACK API Documentation — riferimento tecnico per convalidare la registrazione, le richieste di tracking, la gestione degli aggiornamenti e i requisiti di implementazione. I flussi operativi e le regole degli avvisi contenuti in questa guida sono raccomandazioni, non garanzie sul comportamento del provider o del corriere.