Come le piattaforme per i resi possono utilizzare le API di tracciamento delle spedizioni per resi e cambi
Le piattaforme per i resi possono utilizzare le API di tracciamento delle spedizioni per collegare i flussi di lavoro relativi a resi e cambi con gli eventi dei pacchi in tempo reale. L'API può aiutare una piattaforma a identificare quando viene creata un'etichetta di reso, monitorare il percorso attraverso la rete del corriere, rilevare eventi di consegna o eccezioni e attivare la fase operativa successiva. Il risultato è un processo di reso più facile da comprendere per i clienti e più semplice da gestire per i commercianti.

Il tracciamento non sostituisce le regole sui resi, l'ispezione in magazzino, i rimborsi o i controlli dell'inventario. Fornisce i dati sulla spedizione che consentono a questi processi di funzionare con tempistiche migliori e meno controlli manuali.
Perché la visibilità della spedizione è importante nei resi
Una spedizione in uscita ha generalmente un obiettivo principale: consegnare un ordine all'acquirente. Un reso o un cambio può avere diversi esiti. Il pacco può essere consegnato a un magazzino, ricevuto da un centro di elaborazione di terze parti, reindirizzato, ritardato o contrassegnato come consegnato prima che il commerciante abbia completato un'ispezione. I clienti devono inoltre sapere se l'articolo restituito è in movimento, mentre i team di assistenza devono rispondere alle domande senza affidarsi ai siti web dei corrieri o a ricerche manuali del tracciamento.
Un'API di tracciamento offre a una piattaforma per i resi un modo strutturato per recuperare e normalizzare le informazioni sulle spedizioni dai corrieri. A seconda dell'API e dei dati disponibili del corriere, queste informazioni possono includere un numero di tracciamento, lo stato della spedizione, i timestamp degli eventi, i dettagli sulla posizione, le informazioni sulla consegna stimata e i messaggi relativi alle eccezioni. I campi esatti e la frequenza degli aggiornamenti devono essere verificati nella documentazione del provider selezionato, invece di essere dati per scontati.
Per un flusso di lavoro dei resi ecommerce, il valore pratico non consiste semplicemente nel visualizzare un numero di tracciamento. Consiste nell'utilizzare gli eventi della spedizione come input per decisioni, messaggi ai clienti, gestione dei casi e coordinamento del magazzino.
I principali eventi di tracciamento in un flusso di lavoro di reso o cambio
Una piattaforma per i resi dovrebbe associare gli eventi dei corrieri ai propri stati operativi. La terminologia dei corrieri non è sempre coerente, quindi un'integrazione dovrebbe utilizzare un modello di stato normalizzato, conservando al contempo l'evento originale del corriere per finalità di audit e assistenza.
| Evento della spedizione | Possibile azione della piattaforma | Valore per il cliente |
|---|---|---|
| Etichetta creata | Aprire il record di tracciamento e associarlo all'autorizzazione del reso. | Mostra che le istruzioni per il reso sono state emesse, senza implicare che il pacco sia già in movimento. |
| Corriere accettato o prima scansione | Avviare il conteggio del tempo di transito e ridurre l'incertezza sul fatto che il pacco sia entrato nella rete. | Conferma che il corriere ha ricevuto il pacco. |
| In transito | Aggiornare la sequenza temporale del reso e identificare le spedizioni bloccate. | Fornisce informazioni sull'avanzamento senza richiedere un contatto con l'assistenza. |
| Eccezione o ritardo | Creare un avviso, adeguare le aspettative o indirizzare il caso all'assistenza. | Spiega perché il reso potrebbe non arrivare secondo le aspettative iniziali. |
| Consegnato | Avvisare il team ricevente e avviare il flusso di lavoro di ispezione o cambio. | Conferma l'arrivo alla destinazione indicata, chiarendo al contempo che l'ispezione potrebbe essere ancora in sospeso. |
Queste mappature devono rimanere separate dalla decisione finale del commerciante in merito al rimborso. Un evento di consegna indica che il corriere ha segnalato la consegna; da solo non dimostra che sia stato restituito l'articolo corretto, che l'articolo non sia danneggiato o che il reso soddisfi la politica del commerciante.
Come collegare un'API di tracciamento alle operazioni sui resi
1. Creare un record della spedizione di reso
Quando un reso viene approvato, la piattaforma per i resi dovrebbe creare un record che colleghi l'autorizzazione del reso all'ordine originale, al cliente, all'articolo, alla destinazione e all'identificativo della spedizione. Se è coinvolto un cambio, il record dovrebbe identificare anche l'ordine sostitutivo o l'azione di evasione. Questa relazione impedisce che un evento di tracciamento venga trattato come un aggiornamento isolato del pacco.
La piattaforma dovrebbe distinguere tra la spedizione originale in uscita e la spedizione di reso. Potrebbero utilizzare corrieri, livelli di servizio, numeri di tracciamento e destinazioni di consegna diversi. Un semplice modello di dati può includere un ID ordine, un ID reso, un ID cambio quando applicabile, il corriere, il numero di tracciamento, la direzione, lo stato normalizzato corrente, l'ora dell'ultimo evento e l'evento originale del corriere.
2. Inviare il numero di tracciamento all'API
L'integrazione invia il corriere e il numero di tracciamento al servizio di tracciamento, in base ai requisiti del provider relativi ad autenticazione, richieste e identificazione del corriere. Se il sistema non riesce a identificare il corriere in modo affidabile, dovrebbe utilizzare un metodo di rilevamento approvato oppure richiedere il corriere all'utente o al commerciante. Una mappatura errata del corriere può produrre risultati ritardati o imprecisi.
In questa fase, la piattaforma dovrebbe registrare quando è stata creata la richiesta di tracciamento e se l'API ha accettato, rifiutato o non ha ancora potuto identificare la spedizione. Una richiesta accettata da un'API non equivale a una scansione del corriere. Questi stati non dovrebbero essere combinati nell'interfaccia utente.
3. Ricevere aggiornamenti tramite polling o webhook
I provider di tracciamento supportano comunemente uno o più metodi per ottenere gli eventi successivi. Una piattaforma può eseguire il polling degli aggiornamenti, ricevere notifiche push o utilizzare una combinazione di entrambi, a seconda della documentazione del provider e della latenza richiesta. La documentazione dell'API 17TRACK è il luogo appropriato per verificare il modello di integrazione attuale, i modelli di richiesta supportati e i requisiti di implementazione.
Qualunque sia il metodo utilizzato, la piattaforma dovrebbe rendere gli aggiornamenti idempotenti. Lo stesso evento può essere ricevuto più di una volta, arrivare fuori ordine o essere modificato da un corriere. Memorizzare l'identificativo dell'evento quando disponibile, confrontare i timestamp degli eventi e conservare una cronologia invece di sovrascrivere ogni stato precedente.
4. Normalizzare gli eventi in stati aziendali
Gli stati dei corrieri sono progettati per le operazioni di trasporto, non necessariamente per le decisioni sui resi. Una piattaforma per i resi può mapparli in stati come etichetta emessa, in attesa di consegna al corriere, in transito, in ritardo, consegnato, eccezione di consegna e richiesta di verifica. La mappatura dovrebbe preservare l'incertezza. Ad esempio, “consegnato” può spostare un caso in “in attesa di ispezione”, non direttamente in “rimborso approvato”.
Le regole aziendali dovrebbero inoltre tenere conto degli eventi mancanti o contraddittori. Un pacco senza nuove scansioni per diversi giorni può giustificare un avviso interno, ma non dovrebbe essere automaticamente considerato smarrito a meno che la politica del commerciante e la procedura del corriere supportino tale conclusione.
5. Attivare azioni operative e per i clienti
Una volta disponibili gli eventi normalizzati, la piattaforma può applicare le regole. La prima scansione del corriere potrebbe inviare una conferma al cliente. Un'eccezione di consegna potrebbe creare un'attività per l'assistenza. Un evento di consegna potrebbe avvisare un magazzino resi di cercare il pacco. Per i cambi, l'azienda può decidere se rilasciare l'articolo sostitutivo dopo la prima scansione, dopo la consegna o dopo l'ispezione. Tale decisione dipende da rischio, inventario e politica; i dati di tracciamento possono informarla, ma non possono determinarla universalmente.
Le notifiche dovrebbero utilizzare un linguaggio semplice e identificare la fase successiva prevista. Il cliente dovrebbe poter distinguere tra “il corriere ha ricevuto il tuo reso”, “il commerciante ha ispezionato il tuo reso” e “il tuo rimborso è stato emesso”. Si tratta di eventi diversi, gestiti da parti diverse del processo.
Utilizzare i dati di tracciamento per i cambi
I flussi di lavoro dei cambi hanno una dipendenza aggiuntiva: l'articolo sostitutivo potrebbe dover essere spedito prima che l'articolo restituito abbia completato il suo percorso. Una piattaforma per i resi dotata di tracciamento può mantenere due record di spedizione correlati: il reso in entrata e la sostituzione in uscita. Collegarli offre agli operatori dell'assistenza una visione più completa del cambio.
Le regole utili per i cambi possono includere:
- Non descrivere la sostituzione come spedita finché il sistema di evasione non conferma tale stato.
- Mostrare separatamente le sequenze temporali del reso e della sostituzione, anche quando fanno parte dello stesso caso di cambio.
- Avvisare l'assistenza quando il reso è in ritardo ma la sostituzione è già stata consegnata.
- Mantenere separata la decisione sull'idoneità del cliente dallo stato di consegna del corriere.
- Registrare quale evento ha causato un'azione automatizzata, in modo che il team possa verificarla o annullarla.
Questo approccio riduce una fonte comune di confusione: considerare la consegna di una sostituzione come prova del completamento del reso originale. Le due spedizioni possono procedere indipendentemente e richiedere risoluzioni diverse.
Il ruolo di 17TRACK
17TRACK pubblica una Tracking API dedicata alle integrazioni per sviluppatori e offre anche 17RETURNS, un prodotto incentrato sui resi. Questi prodotti devono essere valutati in base al ruolo che il commerciante deve svolgere. Una tracking API è pertinente quando una piattaforma per i resi ha bisogno di dati sulla spedizione all'interno del proprio flusso di lavoro o della propria applicazione. Un prodotto per la gestione dei resi è pertinente quando l'azienda necessita di un processo più ampio per avviare, organizzare e gestire i resi.
I materiali ufficiali di 17TRACK devono essere utilizzati per verificare il comportamento attuale dell'API, i corrieri supportati, i dettagli dell'integrazione, i requisiti di autenticazione e le eventuali limitazioni specifiche del prodotto prima dell'implementazione. La pagina del prodotto 17RETURNS e la pagina di 17RETURNS su Shopify forniscono il contesto del prodotto, mentre la documentazione dell'API è la fonte più appropriata per le decisioni sull'integrazione tecnica. Un commerciante che gestisce già una piattaforma personalizzata per i resi può utilizzare l'API come livello dati; un commerciante che cerca un flusso di lavoro gestito per i resi dovrebbe valutare il prodotto per i resi in sé, invece di presumere che una API da sola fornisca tali funzioni.
Controlli di implementazione prima del lancio
Una prova di concetto dovrebbe utilizzare scenari di reso reali, non soltanto un esempio riuscito di spedizione in transito. Testare almeno un reso nazionale, un reso transfrontaliero se pertinente per l'azienda, una spedizione ritardata, un'eccezione di consegna, un pacco consegnato, un aggiornamento duplicato e un numero di tracciamento che non può essere identificato immediatamente.
Il team di implementazione dovrebbe confermare quanto segue:
- Quali corrieri e servizi sono necessari per le rotte di reso del commerciante e come vengono identificati tali corrieri.
- Quali eventi sono disponibili per ciascun corriere pertinente e se il livello di dettaglio degli eventi varia in base alla destinazione.
- Con quale frequenza vengono aggiornati i dati e come la piattaforma gestisce gli errori dell'API, i limiti di frequenza e le interruzioni temporanee.
- Come vengono archiviati e riconciliati gli eventi duplicati, tardivi, mancanti o fuori ordine.
- Quali azioni sono automatiche e quali richiedono una revisione umana.
- Come vengono tradotte, personalizzate, sospese e sottoposte ad audit le notifiche ai clienti.
- Come vengono protette, conservate e rimosse le informazioni personali e i dati sulla spedizione secondo i requisiti del commerciante.
- Come il sistema distingue la consegna del corriere dalla ricezione in magazzino, dall'ispezione, dall'approvazione, dal rimborso e dall'evasione del cambio.
La responsabilità operativa è importante quanto la connettività tecnica. I team logistici devono definire il significato degli eventi, i team di assistenza devono definire i messaggi rivolti ai clienti, i team finanziari devono definire i controlli sui rimborsi e i team di magazzino devono definire cosa accade dopo la consegna. Senza queste decisioni, anche una connessione API tecnicamente riuscita può creare automazioni fuorvianti.
Un quadro decisionale pratico
Utilizza una shipment tracking API quando il processo di reso dipende da eventi tempestivi del corriere, l'azienda deve collegare più sistemi o clienti e operatori dell'assistenza necessitano di una visione condivisa dell'avanzamento del pacco. Valuta una piattaforma di gestione dei resi quando il problema più ampio include la configurazione delle policy, l'autorizzazione dei resi, i flussi delle etichette, la comunicazione con i clienti, la gestione dell'inventario e la reportistica. In alcune attività, i due livelli lavorano insieme: il sistema dei resi gestisce il caso, mentre il servizio di tracciamento fornisce gli eventi normalizzati della spedizione.
Il design più efficace considera il tracciamento come una prova all'interno di una macchina a stati più ampia. Indica ciò che il corriere ha segnalato, quando lo ha segnalato e a quale spedizione appartiene. Le regole aziendali decidono quindi cosa dovrebbe accadere dopo. Questa separazione rende i resi e i cambi più trasparenti senza promettere un livello di certezza che i dati del corriere non possono fornire.
FAQ
Un'API di tracciamento può confermare che un rimborso è dovuto?
No. Può segnalare eventi della spedizione come accettazione, movimento, eccezione o consegna quando tali eventi sono disponibili. L'idoneità al rimborso dipende generalmente anche dalla politica sui resi, dalle condizioni dell'articolo, dall'ispezione, dai controlli antifrode e dall'approvazione del commerciante.
Un reso consegnato dovrebbe attivare automaticamente un rimborso?
Non necessariamente. La consegna significa che il corriere ha segnalato che il pacco ha raggiunto la destinazione. Il commerciante potrebbe dover verificare l'articolo, la quantità, le condizioni e l'autorizzazione del reso prima di approvare un rimborso.
Per il tracciamento dei resi è meglio utilizzare il polling o la consegna tramite webhook?
Nessuno dei due metodi è universalmente migliore. La scelta dipende dai metodi supportati dal provider, dalla velocità di aggiornamento richiesta, dall'impegno di implementazione e dalla tolleranza per le notifiche ritardate. Alcune piattaforme utilizzano aggiornamenti push con una riconciliazione periodica per intercettare gli eventi persi.
Come dovrebbe una piattaforma per i cambi tracciare due spedizioni?
Memorizzare il reso in entrata e la sostituzione in uscita come record di spedizione separati, collegati allo stesso caso di cambio. Visualizzare i relativi stati in modo indipendente e definire regole che impediscano di confondere lo stato di una spedizione con il completamento dell'altra.
Cosa dovrebbe essere testato prima di collegare un'API di tracciamento?
Testare il tracciamento riuscito, le scansioni ritardate, le eccezioni, gli eventi duplicati, le informazioni errate o sconosciute sul corriere, i casi transfrontalieri quando pertinenti e le interruzioni dell'API. Testare inoltre i messaggi per i clienti e i percorsi di revisione umana che seguono ogni evento.


