Skip to main content
CasaBlogGuidePerché i marketplace dell’usato hanno bisogno di un’API per il monitoraggio delle spedizioni?

Perché i marketplace dell’usato hanno bisogno di un’API per il monitoraggio delle spedizioni?

17TRACK

I marketplace dell’usato hanno bisogno di un’API per il tracciamento delle spedizioni quando gli aggiornamenti sulla consegna devono offrire più di un semplice link di tracciamento. Integrando gli eventi della spedizione nei sistemi del marketplace, un’API può aiutare gli acquirenti a seguire gli acquisti, i venditori a dimostrare l’avanzamento della spedizione e i team di supporto a indagare sui problemi di consegna. Il suo massimo valore consiste nel collegare la visibilità della spedizione alle operazioni del marketplace senza considerare i dati di tracciamento come prova dell’identità, delle condizioni o dell’autenticità di un articolo.

Perché i marketplace dell’usato hanno bisogno di un’API per il tracciamento delle spedizioni

Per i product manager, i team di ingegneria e gli operatori dei marketplace, la decisione non consiste semplicemente nel decidere se mostrare la posizione dei pacchi. Si tratta di capire se un record condiviso della spedizione migliorerebbe il modo in cui la piattaforma gestisce la spedizione da parte del venditore, le comunicazioni con l’acquirente, le eccezioni di consegna e le controversie.

Perché le spedizioni dell’usato creano un problema di visibilità diverso

Un marketplace dell’usato può coordinare transazioni tra molti venditori individuali invece di spedire tutto da un magazzino controllato. I venditori possono utilizzare corrieri diversi, acquistare etichette tramite canali differenti e consegnare i pacchi in momenti diversi. Il marketplace deve quindi distinguere ciò che dichiara un venditore da ciò che ha registrato un corriere.

La rivendita modifica anche ciò che accade quando una consegna va storta. Potrebbe non essere disponibile un articolo sostitutivo identico per una determinata giacca usata, un oggetto da collezione o un prodotto ricondizionato. Prima di decidere cosa indagare o come spiegare il passaggio successivo a un acquirente, i team di supporto hanno bisogno di un resoconto chiaro della spedizione.

Consideriamo una transazione esemplificativa: un venditore contrassegna come spedita una fotocamera usata e inserisce un numero di tracciamento. Inizialmente, il corriere mostra solo le informazioni elettroniche sulla spedizione. In seguito compare una scansione di accettazione, seguita da un tentativo di consegna. Questi eventi rappresentano stati operativi diversi. Riassumerli tutti come “spedito” lascia l’acquirente scarsamente informato e offre al supporto poche basi per agire.

Un’API di tracciamento può rendere queste distinzioni disponibili all’interno del marketplace. La piattaforma deve comunque decidere cosa significhi ciascun evento secondo le proprie regole.

Cosa fa e cosa non fa un’API per il tracciamento delle spedizioni

Un’API per il tracciamento delle spedizioni offre un modo programmatico per inviare identificativi di spedizione e recuperare informazioni di tracciamento. A seconda del servizio e dell’integrazione, gli aggiornamenti possono essere ottenuti tramite richieste API, notifiche webhook o una combinazione di entrambe. Un webhook è un messaggio inviato alla tua applicazione quando è disponibile un aggiornamento.

L’output utile non è solo l’ultimo testo di stato del corriere. È una cronologia della spedizione che il marketplace può associare a un ordine, a un venditore, a un acquirente e a un caso di supporto.

  • Esperienza dell’acquirente: mostrare l’avanzamento all’interno della pagina dell’ordine invece di richiedere agli acquirenti di interpretare siti web separati dei corrieri.
  • Operazioni del venditore: distinguere un numero di tracciamento inviato da una spedizione con attività del corriere registrata.
  • Flussi di lavoro del supporto: presentare gli eventi della spedizione insieme ai dettagli della transazione e alle comunicazioni precedenti.
  • Gestione delle eccezioni: indirizzare determinati problemi di consegna a una coda per l’indagine.
  • Report operativi: esaminare i modelli di spedizione e consegna utilizzando traguardi chiaramente definiti.

Queste sono possibili applicazioni, non risultati automatici. Un’integrazione di tracciamento non crea di per sé una politica sulle controversie, non garantisce la consegna, non verifica il contenuto dei pacchi e non fornisce un’assicurazione sulla spedizione. Allo stesso modo, acquistare un’etichetta, organizzare il ritiro, calcolare le spese di spedizione e tracciare un pacco sono funzionalità separate. Non presumere che una singola API le includa tutte.

Cinque flussi di lavoro dei marketplace che traggono vantaggio dai dati di tracciamento condivisi

1. Separare le dichiarazioni del venditore dall’attività del corriere

“Il venditore dice di aver spedito” e “il corriere ha registrato l’accettazione” dovrebbero essere fatti distinti nel record dell’ordine. Un evento di creazione dell’etichetta generalmente non dovrebbe essere presentato come conferma che il corriere sia fisicamente in possesso del pacco.

Conserva separatamente la dichiarazione di spedizione del venditore, l’orario di invio del tracciamento e gli eventuali eventi rilevanti del corriere. Ciò consente al supporto di spiegare l’assenza di una scansione di accettazione senza accusare immediatamente il venditore di non aver spedito. Le scansioni mancanti o ritardate richiedono un’indagine, non una conclusione automatica.

2. Fornire agli acquirenti aggiornamenti utili senza creare false certezze

Gli acquirenti devono sapere cosa è cambiato e se devono agire. Una scansione di accettazione può richiedere solo un discreto aggiornamento della pagina dell’ordine. Un evento di pronto per il ritiro può giustificare una notifica, mentre un tentativo di consegna non riuscito può richiedere una spiegazione più chiara del passaggio successivo.

Le notifiche devono riflettere le informazioni effettivamente ricevute. Non inventare una data di consegna quando non è stata fornita. Se è disponibile una data stimata, indicala come stima e conservane la fonte. Evita di descrivere il tracciamento come costantemente in tempo reale: gli aggiornamenti dipendono dagli eventi del corriere, dalla disponibilità dei dati e dal comportamento di elaborazione dell’integrazione.

3. Organizzare le eccezioni di consegna

Un pacco in attesa di ritiro richiede una risposta diversa da uno che sta tornando al mittente. Invece di inserire ogni spedizione non consegnata in un’unica coda di problemi, definisci code basate su condizioni operative.

  • Nessuna accettazione registrata: verifica le informazioni sulla consegna fornite dal venditore e le indicazioni del corriere.
  • Tentativo di consegna non riuscito: mostra le eventuali istruzioni disponibili per la riconsegna o il ritiro.
  • In attesa di ritiro: informa l’acquirente quando sono disponibili informazioni affidabili sul ritiro.
  • Movimento di reso: indirizza l’ordine al processo di reso o supporto pertinente.
  • Consegnato ma contestato: conserva l’evento di consegna e avvia un’indagine separata.

Imposta soglie di inattività in base al servizio di spedizione e al percorso, quando possibile. Un’unica regola universale sui ritardi può creare avvisi non necessari per i servizi più lenti, trascurando al contempo i problemi di quelli più veloci.

4. Supportare le controversie e le decisioni sui pagamenti

Gli eventi della spedizione possono contribuire alla cronologia di una transazione, ma non dovrebbero diventare l’unica autorità per una decisione finanziaria. Una scansione di consegna non dimostra che nel pacco fosse presente l’articolo corretto o che corrispondesse all’inserzione.

Se gli eventi di consegna alimentano un flusso di lavoro per i pagamenti, utilizza un livello separato di policy. Tale livello dovrebbe tenere conto dei termini pubblicati dal marketplace, dei requisiti applicabili, delle controversie aperte e delle procedure di revisione. Una progettazione sensata consente a un’eccezione di sospendere un’azione automatica invece di costringere il supporto ad annullarla in seguito.

5. Rendere visibili i percorsi di reso

Una spedizione di reso è un nuovo percorso logistico. Associala alla transazione originale, ma assegnale un record di spedizione e una direzione separati. In caso contrario, l’evento di consegna di un reso potrebbe essere scambiato per una consegna all’acquirente.

Il tracciamento del reso può stabilire le tappe del trasporto. Non può stabilire se l’articolo restituito sia quello originale o se le sue condizioni siano cambiate. Queste domande richiedono un processo separato di ispezione o raccolta delle prove.

Un design pratico per l’integrazione

Costruisci l’integrazione intorno alle spedizioni invece di utilizzare un singolo campo di tracciamento nell’ordine. Un ordine può contenere più pacchi e una transazione può successivamente acquisire una spedizione di reso.

  1. Crea un record della spedizione. Associalo all’ordine e al venditore. Memorizza il numero di tracciamento, il corriere quando noto, la direzione del percorso e i timestamp pertinenti.
  2. Controlla i dettagli inviati. Intercetta valori vuoti, problemi evidenti di formattazione e duplicati non intenzionali. Non considerare un numero plausibile come prova di una spedizione autentica.
  3. Registra o recupera il tracciamento. Segui il processo documentato del provider selezionato. Mantieni distinti i risultati non supportati, ambigui e temporaneamente non disponibili.
  4. Ricevi gli aggiornamenti in modo affidabile. Per i webhook, utilizza il meccanismo di autenticazione o verifica supportato dal provider. Quando opportuno, elabora i messaggi accettati tramite una coda persistente.
  5. Conserva gli eventi di origine. Memorizza il testo di stato originale insieme allo stato normalizzato, con controlli di accesso e conservazione.
  6. Applica le regole del marketplace. Genera aggiornamenti per gli acquirenti, attività di supporto e richieste di revisione dal tuo livello di policy.
  7. Riconcilia gli aggiornamenti mancanti. Utilizza i metodi di recupero consentiti e gli avvisi operativi per indagare sulle lacune invece di presumere che ogni notifica arriverà correttamente.

Progetta il sistema per gestire messaggi duplicati ed eventi che arrivano fuori sequenza. Rielaborare lo stesso evento non dovrebbe inviare un’altra notifica all’acquirente né attivare una seconda azione finanziaria. Mantieni separato il timestamp dell’evento dall’orario in cui il sistema lo ha ricevuto: rispondono a domande diverse.

I numeri di tracciamento non devono fungere da credenziali di autorizzazione pubbliche. Limita i record delle spedizioni agli utenti autorizzati, proteggi le credenziali API sul server ed evita di esporre dettagli non necessari sui destinatari nelle notifiche o nei log dell’applicazione.

Come valutare un’API per un marketplace dell’usato

Inizia con spedizioni rappresentative della tua effettiva base di venditori. Un ampio elenco di corrieri è meno informativo della gestione corretta dei servizi, dei percorsi e dei tipi di evento utilizzati dal marketplace.

  • Compatibilità con corrieri e servizi: testa i servizi effettivamente utilizzati dai venditori, compresi i passaggi internazionali pertinenti e i percorsi di reso.
  • Interpretazione degli stati: verifica se la tua applicazione è in grado di distinguere le informazioni elettroniche sulla spedizione, l’accettazione, il transito, i tentativi di consegna, il ritiro, la consegna e i resi quando tali eventi sono disponibili.
  • Dettagli degli eventi: esamina i timestamp, le descrizioni della fonte e il modo in cui vengono rappresentati le correzioni o gli eventi ritardati.
  • Operazioni webhook: verifica nella documentazione le opzioni di autenticazione, il comportamento di consegna, la gestione dei tentativi e le procedure di ripristino.
  • Vincoli dell’integrazione: conferma i limiti delle richieste, i requisiti di registrazione, le risposte di errore e le opzioni di test.
  • Governance dei dati: esamina i controlli di accesso, i termini di conservazione, le responsabilità contrattuali e le informazioni di cui l’integrazione ha effettivamente bisogno.
  • Modello commerciale: conferma cosa è fatturabile, come vengono trattate le richieste ripetute e cosa accade quando l’utilizzo supera la quota concordata.

La pagina dell’API di tracciamento di 17TRACK e la documentazione ufficiale dell’API sono punti di partenza pertinenti per valutare l’offerta API. Utilizza queste risorse per verificare l’integrazione rispetto al campione di spedizioni e ai requisiti tecnici. Conferma la copertura dei servizi, i termini commerciali e i limiti operativi prima di impegnarti; questa guida non stabilisce tali dettagli per uno specifico account o una specifica implementazione.

Per un marketplace personalizzato, valuta l’integrazione API in sé invece di presumere che una pagina di tracciamento per consumatori o un’app per vetrine soddisfi i requisiti backend. La domanda importante è come i dati della spedizione entreranno nel modello degli ordini e attiveranno azioni controllate.

Quando vale la pena implementare un’API

Un’API di tracciamento diventa un investimento più conveniente quando il supporto controlla ripetutamente i siti dei corrieri, gli acquirenti non dispongono di una visualizzazione coerente dell’ordine o gli eventi della spedizione devono attivare flussi di lavoro interni. È particolarmente rilevante quando i controlli manuali del tracciamento stanno diventando una dipendenza operativa.

Un piccolo marketplace con un’attività di spedizione limitata può ragionevolmente iniziare con link di tracciamento convalidati e un processo manuale documentato. Un’API non sostituisce aspettative chiare sulla spedizione da parte dei venditori né una politica sulle controversie praticabile. Automatizzare un processo poco chiaro può semplicemente far sì che decisioni incoerenti vengano prese più velocemente.

Esegui un progetto pilota controllato prima di espandere l’implementazione. Includi una consegna normale, l’assenza di una scansione di accettazione, una consegna non riuscita, un movimento di reso, aggiornamenti duplicati e un caso consegnato ma contestato. Verifica che ciascun caso produca il messaggio previsto per l’acquirente e l’azione di supporto desiderata.

Misura i risultati aziendali oltre alla distribuzione tecnica. Tra le misure utili vi sono i contatti sullo stato della spedizione per ordine spedito, il tempo di gestione delle indagini, la frequenza delle notifiche duplicate e la quota di spedizioni con dati utilizzabili sui traguardi. Definisci ogni misura prima del lancio e confronta gruppi di spedizioni simili. Una risposta API corretta da sola non dimostra una migliore esperienza sul marketplace.

FAQ

Un’API di tracciamento può dimostrare che un venditore ha spedito l’articolo corretto?

No. Il tracciamento descrive il percorso dichiarato del pacco, non il suo contenuto. Un evento di accettazione o consegna può supportare una cronologia della spedizione, ma l’identità e le condizioni dell’articolo richiedono altre prove.

La consegna dovrebbe sbloccare automaticamente il pagamento del venditore?

Solo se tale azione è coerente con le politiche del marketplace e con i requisiti applicabili. Mantieni separata la logica dei pagamenti dall’acquisizione dei dati di tracciamento e prevedi un modo per consentire alle controversie o alle condizioni di revisione di sospendere un’azione altrimenti automatica.

Cosa dovrebbe accadere quando un numero di tracciamento non presenta aggiornamenti?

Mostra che non è disponibile alcun aggiornamento del corriere invece di inventare un avanzamento. Controlla il numero e il corriere, distingui le informazioni elettroniche sull’etichetta dall’accettazione e segui le indicazioni del servizio pertinente prima di classificare la spedizione come smarrita.

I webhook sono sufficienti da soli?

I webhook possono supportare aggiornamenti basati sugli eventi, ma l’applicazione necessita comunque di gestione dei duplicati, monitoraggio e procedure di ripristino. Quando il provider lo consente, le richieste di riconciliazione possono aiutare a indagare sugli aggiornamenti mancanti o incoerenti.

La stessa integrazione può tracciare i resi degli acquirenti?

Potenzialmente sì, se il corriere e il servizio di reso sono supportati. Crea una spedizione di reso separata collegata all’ordine originale e distingui la consegna al venditore dalla consegna all’acquirente.

Fonti

Le risorse ufficiali riportate di seguito forniscono i riferimenti di prodotto e implementazione per la valutazione di 17TRACK discussa sopra. Le raccomandazioni sui flussi di lavoro contenute in questa guida sono indicazioni editoriali, non dichiarazioni sulle politiche di un particolare marketplace né garanzie sui risultati del prodotto.