Skip to main content
CasaBlogGuideCome i brand di e-commerce in abbonamento possono monitorare le spedizioni ricorrenti con un'API di tracciamento

Come i brand di e-commerce in abbonamento possono monitorare le spedizioni ricorrenti con un'API di tracciamento

17TRACK

Per monitorare le spedizioni ricorrenti con un'API di tracciamento, crea un record di spedizione per ogni pacco fisico, collegalo all'ordine di evasione relativo a quel ciclo dell'abbonamento e registra il numero di tracciamento quando il tuo magazzino o il partner logistico te lo fornisce. Usa gli aggiornamenti di tracciamento dell'API per mostrare ai clienti dove si trova il pacco e segnalare al tuo team le eccezioni di consegna. Mantieni l'ID dell'abbonamento come collegamento tra i cicli, non come identificativo di un pacco.

Come i brand di ecommerce in abbonamento possono monitorare le spedizioni ricorrenti con un'API

Monitora il pacco, non l'abbonamento

Un abbonamento indica ciò che un cliente è programmato a ricevere nel tempo. Un ordine di evasione indica ciò che deve essere spedito per un singolo ciclo. Un numero di tracciamento riguarda un pacco specifico. Mantenere separati questi record impedisce che una spedizione in ritardo di un ciclo venga visualizzata nella pagina di tracciamento del ciclo successivo.

Ad esempio, supponiamo che la confezione dell'abbonamento di maggio venga suddivisa in due pacchi e che la confezione di giugno venga spedita mentre uno dei pacchi di maggio è ancora in transito. Il cliente dovrebbe vedere due pacchi sotto l'ordine di maggio e un pacco separato sotto l'ordine di giugno. L'aggiornamento tardivo di maggio dovrebbe modificare solo il pacco di maggio. Se invii una sostituzione, crea un nuovo record di spedizione e collegalo all'originale, in modo che l'assistenza possa capire perché esistono entrambi.

  • Abbonamento: Memorizza l'ID dell'abbonamento affinché l'assistenza possa trovare la cronologia delle spedizioni del cliente.
  • Ciclo e ordine: Registra l'identificativo del ciclo o la data di evasione programmata, l'ID dell'ordine e tutti gli ID di evasione necessari per associare i pacchi all'ordine corretto. Non dedurre il ciclo dalla data di arrivo di un evento di tracciamento.
  • Spedizione: Assegna a ogni pacco un ID interno di spedizione. Memorizza il corriere e il numero di tracciamento, il riferimento di evasione pertinente e qualsiasi ID di registrazione del tracciamento restituito dal provider. Tieni le etichette annullate e i numeri di tracciamento sostituiti fuori dalla vista attiva del cliente, ma conserva la cronologia per l'assistenza.

Nella pagina dell'ordine, mostra l'avanzamento a livello di pacco insieme a qualsiasi riepilogo dell'ordine. Se un pacco è stato consegnato e un altro è in transito, indicalo chiaramente. Mostra l'intero ordine come consegnato solo quando sono arrivati tutti i pacchi necessari per completarlo, tenendo conto delle spedizioni annullate e delle sostituzioni.

Collega l'evasione all'API di tracciamento

  1. Registra a partire da un evento di evasione. Attiva la registrazione quando un sistema di evasione, un magazzino o un partner logistico di terze parti invia il corriere e il numero di tracciamento. Un pagamento di rinnovo è troppo anticipato: l'ordine potrebbe essere ancora in attesa di spedizione e potrebbe non esistere alcun numero di tracciamento.
  2. Salva la spedizione prima di chiamare l'API. Persiste il record interno della spedizione e accoda la richiesta di registrazione. Se lo stesso messaggio di evasione arriva due volte, riutilizza quel record invece di creare un altro pacco. Se la chiamata API va in timeout, verifica se la richiesta originale è andata a buon fine prima di riprovare, quando il provider offre un modo per farlo.
  3. Associa gli aggiornamenti al pacco registrato. Usa l'identificativo di registrazione del provider se viene restituito negli aggiornamenti. In caso contrario, effettua l'associazione usando gli identificativi specificati dalla relativa documentazione e convalida il risultato rispetto ai tuoi record di spedizione. Se un aggiornamento potrebbe appartenere a più di un record, invialo per la revisione invece di applicarlo all'ordine più recente.
  4. Separa la creazione dell'etichetta dal movimento del corriere. Un numero di tracciamento può esistere prima che il corriere registri di aver preso in carico il pacco. Usa un messaggio come “In preparazione per il ritiro da parte del corriere” quando disponi solo di un'etichetta. Riserva “In transito” alle informazioni del corriere che lo supportano.

17TRACK Tracking API è una delle opzioni per questa configurazione. La sua documentazione per sviluppatori è il riferimento per registrare i numeri di tracciamento e ricevere gli aggiornamenti. Usa questi aggiornamenti per mantenere il record del pacco nel tuo sistema; gestisci l'assegnazione al ciclo, il completamento dell'ordine e le regole di notifica al cliente nella tua applicazione ecommerce. Prima del lancio, esegui test con pacchi provenienti dai tuoi effettivi percorsi dei corrieri e partner logistici, invece di affidarti soltanto a un elenco di corrieri.

Rendi sicuro l'elaborazione ripetuta degli aggiornamenti

Quando il provider offre webhook, usali per ricevere gli aggiornamenti senza interrogare continuamente ogni pacco. Un webhook è una richiesta HTTP che il provider invia alla tua applicazione. Segui i requisiti di verifica del provider, salva in modo persistente i payload accettati e conferma le richieste secondo le regole di risposta documentate. Esegui le attività più lente, come l'aggiornamento delle viste degli ordini o l'invio di email, al di fuori del gestore della richiesta.

Progetta il flusso di elaborazione in modo che un aggiornamento ripetuto non produca effetti aggiuntivi. Se il provider fornisce ID evento stabili, usali per riconoscere le ripetizioni. Se invia snapshot del tracciamento invece di singoli eventi, confronta lo stato in arrivo e la cronologia delle scansioni con i dati già disponibili prima di agire. Deduplica separatamente i messaggi ai clienti: una notifica di consegna già inviata non dovrebbe essere inviata di nuovo solo perché gli stessi dati di spedizione sono stati elaborati due volte.

Mantieni separato il momento in cui è avvenuta una scansione da quello in cui la tua applicazione l'ha ricevuta. Una scansione “in transito” arrivata in ritardo può appartenere alla cronologia del pacco senza sostituire uno stato di consegna più recente. Tuttavia, non presumere che ogni modifica legittima faccia avanzare un pacco. Una correzione del corriere o un aggiornamento di restituzione al mittente potrebbe dover modificare ciò che visualizzi. Se i nuovi dati sono in conflitto con lo stato memorizzato e non puoi determinare quale sia corretto, inserisci la spedizione in una coda di revisione.

Esegui controlli periodici sulle spedizioni aperte che potrebbero richiedere attenzione: registrazioni ancora in sospeso, pacchi senza una prima scansione dopo un passaggio previsto e spedizioni il cui tracciamento non presenta aggiornamenti. Quando l'API supporta una ricerca o un aggiornamento, usali selettivamente entro i limiti del provider. Verifica il modello tra corrieri e magazzini prima di procedere con un'escalation. Se gli aggiornamenti si interrompono contemporaneamente per molte spedizioni non correlate, analizza l'integrazione prima di aprire singoli casi di consegna.

Trasforma i dati di tracciamento in messaggi utili per i clienti

I clienti raramente hanno bisogno di un'email per ogni scansione. Inizia con messaggi legati a qualcosa che devono sapere o fare: il pacco è entrato nella rete del corriere, un tentativo di consegna richiede un'azione oppure il corriere segnala la consegna. Mostra il riferimento dell'ordine e la confezione o il ciclo pertinente, affinché gli abbonati possano capire a quale spedizione si riferisce il messaggio. Per un ordine suddiviso, identifica il pacco e chiarisci se il resto dell'ordine è ancora in arrivo.

  • Etichetta creata, nessuna scansione: Verifica il passaggio previsto rispetto ai record del magazzino. Se la finestra di passaggio è trascorsa, chiedi al reparto evasione di confermare se il pacco ha lasciato la struttura prima di comunicare al cliente che è in ritardo durante il transito.
  • Il tracciamento non avanza: Usa soglie che riflettano il percorso e il servizio, invece di un unico timer per ogni pacco. Per le spedizioni transfrontaliere, esamina l'ultimo evento del corriere prima di decidere se contattare il cliente o procedere con un'escalation.
  • Tentativo non riuscito o ritiro richiesto: Indica al cliente quale azione è necessaria se il corriere fornisce istruzioni chiare. Se l'evento è vago, indirizza il caso all'assistenza invece di ipotizzare una data di riconsegna o un luogo di ritiro.
  • Contrassegnato come consegnato ma non ricevuto: Conserva lo stato segnalato dal corriere e apri un caso di assistenza separato. Il flusso di lavoro dell'assistenza dovrebbe distinguere una segnalazione del cliente da una correzione del corriere.

Fornisci al personale dell'assistenza una vista unica del ciclo, dell'ordine, della cronologia dei pacchi e dei messaggi già inviati. Per ogni eccezione, assegna un responsabile e un'azione successiva. Il reparto evasione può verificare un passaggio mancante, la logistica può seguire un'eccezione del corriere e l'assistenza può gestire la comunicazione con il cliente. Uno stato di tracciamento descrive il pacco; non decide se spetta una sostituzione o un rimborso.

Testa la sovrapposizione prima del lancio

Inizia con un partner di evasione e un insieme di spedizioni che rifletta il modo in cui effettivamente distribuisce gli ordini. Includi un ciclo con più pacchi, un'etichetta annullata, una sostituzione e una spedizione precedente ancora aperta quando viene spedito il ciclo successivo. Quindi riproduci deliberatamente un webhook duplicato e consegna un evento precedente dopo uno più recente. Controlla il record del pacco, la pagina dell'ordine del cliente, la vista dell'assistenza e il registro delle notifiche. Un test che verifica solo una risposta API riuscita può non rilevare l'errore più costoso: aggiornare l'ordine sbagliato o inviare un messaggio al cliente sbagliato.

Monitora gli errori di registrazione, la percentuale di pacchi idonei registrati correttamente, le prime scansioni più tarde del previsto e gli aggiornamenti non associati. Se monitori la latenza degli aggiornamenti, distingui il tempo tra un evento del corriere e la sua ricezione dal tempo impiegato dal tuo sistema per elaborarlo. Questo ti aiuta a decidere se analizzare il feed del corriere, il tuo endpoint webhook o una coda all'interno dell'applicazione.

Estendi il sistema ad altri percorsi quando puoi rispondere a tre domande per qualsiasi pacco: a quale ciclo appartiene? Qual è l'ultimo aggiornamento comunicato dal corriere? Chi interviene se l'aggiornamento manca o è errato? Se una risposta non è chiara, correggi la mappatura dei record o il flusso di gestione delle eccezioni prima di aggiungere altre regole di notifica.

Domande frequenti

Un'API di tracciamento può indicare ai clienti quando verrà spedita la prossima confezione del loro abbonamento?

Usa il calendario dell'abbonamento e il sistema di evasione per la prossima data di spedizione prevista. Un'API di tracciamento serve per un pacco specifico una volta disponibili le informazioni di tracciamento. Una data di spedizione prevista, una stima di consegna del corriere e una consegna confermata sono fatti diversi e devono essere etichettati separatamente.

Cosa succede se il magazzino sostituisce un numero di tracciamento dopo l'invio di un'email?

Contrassegna la vecchia etichetta come sostituita e collega il nuovo numero di tracciamento allo stesso ordine. Se l'email rimanda a una pagina di tracciamento a livello di ordine, aggiorna la pagina affinché il cliente possa trovare il pacco attivo senza aver bisogno del link originale del corriere. Invia una correzione quando la modifica riguarda informazioni su cui il cliente deve agire.

Cosa succede se un partner di evasione invia numeri di tracciamento senza codici del corriere?

Chiedi al partner un campo corriere coerente o una mappatura dei codici dei suoi servizi di spedizione. Se la tua API offre il rilevamento del corriere, verifica come funziona con le etichette del partner prima di affidarti a esso. Invia le corrispondenze ambigue alla revisione invece di scegliere un corriere basandoti solo sul numero di tracciamento.

Gli abbonamenti sospesi o saltati richiedono record di tracciamento?

Non è necessario alcun record del pacco per un ciclo che non viene mai spedito. Se una spedizione precedente è ancora aperta, continua a monitorarla anche quando l'abbonamento è sospeso, saltato o annullato. Lo stato dell'abbonamento controlla le evasioni future; non indica cosa sia successo a un pacco che ha già lasciato il magazzino.

Fonti

  • 17TRACK Tracking API — panoramica del prodotto per integrare il tracciamento dei pacchi nei sistemi aziendali.
  • Documentazione di 17TRACK Tracking API — riferimento di implementazione per registrare i numeri di tracciamento e ricevere i dati di tracciamento.
  • Documentazione webhook di Stripe — riferimento per pratiche generali relative ai webhook, come la gestione di eventi duplicati e l'evitare supposizioni sull'ordine di consegna. Segui le regole del tuo provider di tracciamento per la verifica e le conferme.