Come le piattaforme per i resi utilizzano un'API di tracciamento delle spedizioni per tracciare le spedizioni di reso
Le piattaforme per i resi utilizzano un'API di tracciamento delle spedizioni per collegare un reso approvato alla relativa spedizione fisica. La piattaforma registra il corriere e l'identificativo di tracciamento della spedizione di reso, recupera gli eventi di tracciamento e utilizza tali eventi per mostrare l'avanzamento o richiedere una verifica operativa. L'API fornisce visibilità sulla spedizione; la piattaforma per i resi rimane responsabile della richiesta di reso, delle decisioni relative alle politiche, dell'ispezione in magazzino e del flusso di rimborso.

Per un team operativo o di prodotto che gestisce i resi, la domanda utile non è semplicemente se un'API possa visualizzare uno stato di tracciamento. La questione è se l'integrazione sia in grado di identificare in modo affidabile la corretta spedizione di reso, interpretare gli eventi ricevuti e impedire che un aggiornamento del tracciamento attivi il messaggio errato al cliente o un'azione di rimborso non corretta.
Dove si inserisce il tracciamento in un reso
Un reso inizia come una registrazione aziendale: un cliente chiede di restituire un articolo e il commerciante decide cosa autorizzare. Una registrazione di tracciamento descrive un elemento diverso: lo spostamento di un pacco. Collegare le due registrazioni consente a una piattaforma per i resi di rispondere a domande come: il cliente sembra aver consegnato il pacco al corriere? Il pacco si sta dirigendo verso la destinazione del reso? È stato segnalato un evento di consegna?
Questo collegamento deve essere esplicito. Un ordine può contenere diversi articoli, un cliente può effettuare più di un reso per lo stesso ordine e un singolo reso può comprendere più pacchi. Il numero di tracciamento della spedizione originale in uscita non deve essere confuso con il numero di tracciamento del reso. Un modello di dati pratico mantiene identificativi separati per l'ordine, l'autorizzazione al reso, il pacco di reso, il corriere e la registrazione di tracciamento, memorizzando poi le relazioni tra questi elementi.
Anche il tracciamento ha un limite preciso. Un evento di consegna del corriere può indicare che un pacco ha raggiunto un indirizzo o una struttura. Non dimostra però che il magazzino abbia ricevuto l'articolo previsto, che l'articolo abbia superato l'ispezione o che sia dovuto un rimborso. Queste decisioni richiedono prove e regole proprie.
Il flusso dell'integrazione, dall'autorizzazione alla ricezione
1. Creare la registrazione del reso prima di seguire il pacco
La piattaforma per i resi registra innanzitutto la richiesta, gli articoli coinvolti, la destinazione autorizzata e la soluzione consentita. Se il reso utilizza un'etichetta emessa dal commerciante, la piattaforma può associare l'identificativo di tracciamento dell'etichetta al pacco di reso. Se il cliente organizza autonomamente la spedizione, la piattaforma potrebbe dover raccogliere e convalidare il corriere e il numero di tracciamento prima di iniziare il monitoraggio.
Questo è il primo punto in cui la qualità dei dati influisce sulla visibilità. Un numero di tracciamento senza un'associazione affidabile tra pacco e reso può produrre un aggiornamento del corriere perfettamente accurato, ma relativo al reso sbagliato. I team dovrebbero inoltre decidere come gestire numeri di tracciamento corretti, etichette sostitutive e clienti che inviano due volte lo stesso identificativo.
2. Registrare o cercare la spedizione
La piattaforma invia al provider di tracciamento scelto le informazioni necessarie per creare o recuperare una registrazione della spedizione. I campi e la sequenza esatti della richiesta dipendono dalla documentazione del provider. Come minimo, l'implementazione deve offrire un modo affidabile per associare il riferimento della spedizione del provider alla propria registrazione del pacco di reso. Quando è necessaria l'identificazione del corriere, la piattaforma dovrebbe verificare come vengono gestiti i dati ambigui o non supportati, invece di presumere che sia sufficiente il solo numero di tracciamento.
Conserva la risposta del provider, gli errori di integrazione e la data in cui la piattaforma ha iniziato il monitoraggio. Una richiesta accettata non dimostra necessariamente che il corriere abbia scansionato il pacco. Prima della prima scansione, lo stato mostrato al cliente potrebbe dover indicare che il tracciamento è in attesa, anziché che il reso è in transito.
3. Acquisire gli aggiornamenti senza perdere l'evento originale
A seconda dell'API, gli aggiornamenti possono arrivare tramite webhook, essere recuperati mediante polling o utilizzare un altro metodo documentato. L'integrazione dovrebbe conservare le informazioni grezze dell'evento fornite dal provider insieme allo stato semplificato visualizzato nella piattaforma per i resi. Tra i campi utili possono figurare la descrizione dell'evento, l'ora dell'evento, la località quando disponibile, il riferimento del corriere e l'ora in cui la piattaforma ha ricevuto l'aggiornamento.
Questi due orari rispondono a domande diverse. Il timestamp dell'evento descrive quando si presume che un'attività sia avvenuta; il timestamp di ricezione mostra quando la piattaforma per i resi ne è venuta a conoscenza. In caso contrario, ritardi, consegne ripetute e messaggi fuori ordine possono far sembrare che un reso proceda all'indietro. Se il provider offre identificativi degli eventi, utilizzali per la deduplicazione. In caso contrario, definisci un metodo prudente di deduplicazione e testalo con esempi reali di integrazione.
4. Convertire gli eventi di tracciamento in stati del reso
Le descrizioni degli eventi del corriere non costituiscono una politica sui resi. La piattaforma per i resi normalmente li mappa in un insieme più ristretto di stati operativi, come in attesa di consegna al corriere, in transito, consegna segnalata o richiede verifica. La mappatura dovrebbe tenere conto degli eventi sconosciuti, invece di trattare silenziosamente ogni aggiornamento non riconosciuto come un avanzamento.
Ad esempio, la prima scansione del corriere può essere sufficiente per comunicare al cliente che il pacco sembra essere in viaggio. Potrebbe non essere sufficiente per promettere una data di rimborso. Un evento di consegna può aiutare il magazzino a dare priorità al pacco corrispondente, ma una regola di rimborso potrebbe comunque richiedere la ricezione fisica e l'ispezione. I team dovrebbero inserire queste distinzioni nel flusso di lavoro prima di collegare gli stati alle azioni automatizzate.
5. Chiudere il ciclo con le prove del magazzino
Quando un pacco arriva, il magazzino o il centro resi può scansionare un codice a barre interno, associare il pacco a un'autorizzazione al reso, ispezionarne il contenuto e registrare l'esito. Si tratta di eventi di gestione dei resi, non di eventi di tracciamento del corriere. Quando i due sistemi sono collegati, la piattaforma può mostrare una sequenza più utile: movimento della spedizione, consegna segnalata dal corriere, pacco ricevuto dalla struttura ed esito completato.
Questa sequenza aiuta anche a risolvere le eccezioni. Se il tracciamento segnala la consegna ma non compare alcuna ricezione in magazzino, un operatore può verificare la destinazione, l'evento del corriere, la coda di accettazione della struttura e l'identificativo del pacco prima di formulare una comunicazione al cliente. Se il magazzino riceve un pacco senza uno storico di tracciamento utilizzabile, la ricezione fisica può comunque essere registrata; la mancanza di dati di tracciamento non dovrebbe cancellare le prove indipendenti del magazzino.
Cosa può e non può comunicare alla piattaforma un'API di tracciamento
Un'API di tracciamento delle spedizioni può rendere disponibili a un'altra applicazione i movimenti segnalati dal corriere, in base alla copertura documentata dal provider, alla disponibilità degli eventi e al comportamento dell'integrazione. Da sola non può verificare il contenuto di un reso né decidere se la politica del commerciante sia stata rispettata. Inoltre, potrebbe non avere alcun aggiornamento da segnalare prima della prima scansione del corriere.
La distinzione è importante quando si progetta l'automazione. Gli stati dovrebbero essere trattati come segnali con utilizzi definiti, non come prove intercambiabili. Un evento di consegna al corriere potrebbe attivare una notifica di avanzamento. Un evento di consegna potrebbe creare un'attività di follow-up per il magazzino. Una ricezione confermata dal magazzino potrebbe far avanzare il reso verso l'ispezione. La decisione relativa al rimborso o al cambio dovrebbe seguire le regole effettive del commerciante e le prove richieste da tali regole.
Il linguaggio rivolto al cliente dovrebbe riflettere lo stesso limite. «Il corriere segnala che il tuo reso è stato consegnato» è più preciso di «Abbiamo approvato il tuo rimborso» quando non è stata effettuata alcuna ispezione. Allo stesso modo, «Stiamo aspettando il primo aggiornamento del corriere» è più informativo di una pagina di tracciamento vuota e priva di spiegazioni.
Controlli di progettazione per prevenire errori evitabili nel tracciamento dei resi
- Associare a livello di pacco. Testa resi suddivisi, più pacchi per una sola autorizzazione, etichette sostitutive e resi ripetuti per uno stesso ordine. Ogni pacco deve avere un'associazione non ambigua con la propria registrazione di tracciamento.
- Definire la precedenza degli stati. Decidi cosa accade se un evento più vecchio «in transito» arriva dopo un evento di consegna. Conserva lo storico degli eventi senza declassare automaticamente lo stato del reso visualizzato.
- Separare gli errori del provider dal silenzio del corriere. Un errore di autenticazione, una richiesta rifiutata o un'elaborazione del webhook non riuscita sono problemi di integrazione. L'assenza di una scansione è una condizione diversa e deve essere comunicata in modo differente.
- Prevedere duplicati e tentativi. Un aggiornamento della consegna può essere ripetuto. Rendi l'acquisizione degli eventi sicura in caso di nuovo tentativo ed evita di inviare due volte la stessa notifica al cliente o di creare due volte la stessa attività.
- Proteggere i dati del cliente e della spedizione. Limita l'accesso alle credenziali di tracciamento, conserva solo i dati necessari al flusso di lavoro e verifica i requisiti documentati dal provider in materia di autenticazione e sicurezza prima del lancio.
- Mantenere un percorso manuale. Alcuni resi avranno informazioni di tracciamento incomplete, tardive o non corrispondenti. Gli operatori devono poter esaminare e correggere la registrazione del reso senza inventare eventi del corriere.
Questi controlli sono più utili quando vengono testati su scenari concreti, anziché su una sola spedizione completata con successo. Un piccolo set di test dovrebbe includere l'assenza della prima scansione, un numero di tracciamento errato, un evento duplicato, un evento fuori ordine, una consegna segnalata senza ricezione in magazzino e una ricezione in magazzino senza un rapporto di consegna corrispondente. Per ogni caso dovrebbero essere specificati il messaggio previsto per il cliente e l'azione dell'operatore.
Scegliere l'API e definire la divisione del lavoro
Inizia dalle tratte di reso e dai corrieri effettivamente utilizzati dall'azienda. Verifica quindi nella documentazione aggiornata del provider come funziona la registrazione delle spedizioni, quali identificativi sono necessari, come vengono consegnati gli aggiornamenti, quali dati degli eventi sono esposti e come vengono gestiti errori e nuovi tentativi. Conferma direttamente i corrieri e le tratte di reso pertinenti, invece di dedurli da una dichiarazione generale sulla copertura dei corrieri. Esegui test con spedizioni rappresentative prima di affidarti agli stati mappati per le comunicazioni ai clienti o per l'automazione.
17TRACK pubblica una panoramica dell'API di tracciamento e la documentazione dell'API; la sua pagina del prodotto 17RETURNS riguarda l'aspetto della gestione dei resi. Sono punti di partenza pertinenti per un team che valuti la visibilità del tracciamento insieme a un processo di gestione dei resi. L'esistenza di entrambe le aree di prodotto non deve essere considerata una prova che siano disponibili una determinata integrazione, un corriere, un evento o una regola di rimborso automatizzata. Verifica il flusso esatto nella documentazione aggiornata e, quando necessario, con il provider.
Per un approvvigionamento o una prova di concetto, chiedi al team responsabile delle politiche sui resi e delle operazioni di magazzino di esaminare la mappatura degli stati insieme al reparto tecnico. Il reparto tecnico può confermare se l'API fornisce eventi utilizzabili; il reparto operativo può confermare se tali eventi giustificano l'azione proposta. Un'integrazione riuscita aiuta il personale e i clienti a seguire il pacco, mantenendo però autorizzazione, ricezione, ispezione e risoluzione come fasi distinte.
FAQ
Un reso deve avere un numero di tracciamento diverso da quello dell'ordine originale?
La piattaforma dovrebbe mantenere registrazioni separate per la spedizione in uscita e quella di reso. Un reso viaggia generalmente come spedizione separata, quindi il relativo identificativo di tracciamento deve essere associato al pacco di reso e non considerato automaticamente l'identificativo della spedizione in uscita dell'ordine originale. Gli identificativi esatti disponibili dipendono dalle modalità di spedizione del reso.
Un'API di tracciamento può confermare che debba essere emesso un rimborso?
No. Nessun singolo evento di tracciamento conferma che l'articolo restituito soddisfi le condizioni di rimborso del commerciante. La piattaforma può utilizzare gli eventi del corriere come input di un flusso di lavoro, ma l'idoneità al rimborso può dipendere anche dall'autorizzazione, dalla ricezione fisica, dall'ispezione e dalla politica del commerciante.
Cosa succede se il tracciamento mostra la consegna ma il magazzino non riesce a trovare il pacco?
Mantieni separati l'evento di consegna segnalato dal corriere e la registrazione della ricezione in magazzino. Verifica la destinazione segnalata e i dettagli dell'evento, quindi esamina il processo di accettazione e abbinamento della struttura. Non convertire silenziosamente la consegna del corriere in una ricezione confermata dal magazzino.
I webhook sono necessari per tracciare le spedizioni di reso?
Non necessariamente. Il metodo di aggiornamento dipende dal provider scelto e dalle opzioni documentate. Se i webhook sono disponibili, prevedi autenticazione, nuovi tentativi, consegne duplicate e errori di elaborazione. Se viene utilizzato il polling, scegli un intervallo e una regola di interruzione adeguati al flusso di lavoro del reso e ai requisiti del provider.
Quando dovrebbe visualizzare il primo aggiornamento di tracciamento un cliente?
Dipende da quando il corriere segnala un evento e da quando l'integrazione lo riceve. La creazione di un'etichetta o la registrazione di una spedizione può avvenire prima della scansione del corriere. Mostra chiaramente questa distinzione, così i clienti non interpreteranno un primo aggiornamento in sospeso come un movimento confermato.


