Skip to main content
CasaBlogGuideUn’API di tracciamento può funzionare senza etichette di spedizione? Tracciamento degli ordini 3Pl e dei marketplace?

Un’API di tracciamento può funzionare senza etichette di spedizione? Tracciamento degli ordini 3Pl e dei marketplace?

17TRACK

Sì. Un'API di tracciamento può funzionare anche se la tua azienda non crea le etichette di spedizione, purché un corriere o un partner logistico abbia creato una spedizione tracciabile e tu possa ottenere un numero di tracciamento utilizzabile o un altro identificatore supportato dall'API. Questo è comune quando un fornitore di servizi logistici di terze parti (3PL) o un marketplace gestisce l'evasione degli ordini. La distinzione è tra non acquistare personalmente l'etichetta e non avere alcun identificatore della spedizione: il primo caso è generalmente gestibile; il secondo può lasciare l'API senza nulla da tracciare.

Can a Tracking API Work without Shipping Labels Tracking 3Pl

Per un venditore, un gestore di marketplace o un team di integrazione, il compito pratico consiste nel collegare ogni ordine alla spedizione creata dalla parte che effettua realmente la spedizione. Ciò richiede l'accesso ai dati corretti, non necessariamente il controllo sulla creazione delle etichette.

Di cosa ha bisogno un'API di tracciamento quando non crei l'etichetta

Un'etichetta di spedizione è un modo per produrre un identificatore della spedizione, ma normalmente non è l'input letto da un'API di tracciamento. Le integrazioni di tracciamento generalmente utilizzano i dati della spedizione forniti dopo che un'etichetta è stata creata altrove. Prima di progettare il collegamento, separa tre record che spesso vengono trattati come intercambiabili:

  • ID ordine: identifica un acquisto nel tuo negozio, account del marketplace o sistema di gestione degli ordini. Può includere diversi articoli e diverse spedizioni.
  • ID di evasione o del pacco: identifica un'azione di evasione o un pacco in un sistema 3PL o di marketplace. Il formato e il significato dipendono da quel sistema.
  • Numero di tracciamento del corriere: identifica una spedizione ai fini del tracciamento, a condizione che il corriere e il servizio di tracciamento lo accettino.

Il tuo ID ordine interno ti aiuta a trovare l'ordine cliente corretto. Non funziona automaticamente come numero di tracciamento del corriere. Il modello di integrazione abituale consiste nell'ottenere il numero di tracciamento dal 3PL o dal marketplace, registrare o interrogare quel numero tramite l'API di tracciamento e memorizzare le informazioni sulla spedizione restituite in corrispondenza dell'ordine o del pacco pertinente.

Potrebbe essere necessario anche il nome o il codice del corriere. Alcuni servizi possono tentare di rilevare il corriere, ma questa possibilità deve essere testata e non data per scontata, soprattutto quando gli identificatori si sovrappongono tra più corrieri o un ordine attraversa diverse reti di consegna. Consulta la documentazione dell'API per verificare gli identificatori accettati, le regole di selezione del corriere, i requisiti di registrazione e i campi relativi allo stato prima di procedere con l'implementazione.

Tracciare gli ordini spediti da un 3PL

Quando un 3PL prepara un ordine, acquista l'etichetta e consegna il pacco a un corriere, la tua azienda potrebbe non vedere mai l'etichetta. Hai comunque bisogno dei dettagli della spedizione risultanti da questo processo. Chiedi al 3PL quale sistema o flusso rende disponibili i numeri di tracciamento, le informazioni sul corriere, gli identificatori dei pacchi e il riferimento dell'ordine fornito al momento della richiesta di evasione.

Un flusso 3PL funzionale di solito è il seguente:

  1. Invia l'ordine e un riferimento stabile al 3PL tramite il processo di evasione già esistente.
  2. Ricevi una conferma dell'evasione contenente il numero di tracciamento a livello di pacco e, se disponibile, il corriere.
  3. Associa il pacco all'ordine cliente e agli articoli corretti.
  4. Invia l'identificatore della spedizione supportato alla tua API di tracciamento oppure utilizza il processo di ricerca previsto dall'API.
  5. Registra gli aggiornamenti di tracciamento associandoli al pacco, quindi presenta una visualizzazione a livello di ordine al team operativo o al cliente.

La fase di associazione richiede particolare attenzione. Un singolo ordine può lasciare il magazzino in due cartoni oppure un articolo può essere spedito più tardi rispetto agli altri. In entrambi i casi, nessun singolo stato del pacco descrive accuratamente l'intero ordine. Conserva i record a livello di pacco e ricava da essi qualsiasi messaggio a livello di ordine. Ad esempio, non contrassegnare un ordine come consegnato solo perché è stato consegnato il primo pacco.

Concorda con il 3PL le modalità di trasmissione delle correzioni. Le etichette possono essere annullate, i pacchi possono essere riconfezionati e un numero di tracciamento iniziale può essere sostituito. La tua integrazione deve poter associare la sostituzione allo stesso ordine senza mostrare indefinitamente entrambi i numeri come spedizioni attive.

Tracciare gli ordini del marketplace quando il marketplace controlla la spedizione

L'evasione tramite marketplace presenta una domanda tecnica simile, ma una domanda diversa in termini di accesso. Il marketplace o il suo partner logistico può creare l'etichetta, mentre il venditore può ricevere solo i dettagli di spedizione esposti dal proprio account, dal flusso dell'ordine o da un'integrazione autorizzata. Un'API di tracciamento non può compensare un numero di tracciamento che il marketplace non ti ha reso disponibile.

Inizia identificando il modello di evasione per ogni ordine. Per gli ordini evasi dal venditore, il tuo processo di spedizione o il tuo 3PL può essere la fonte dei dati del pacco. Per gli ordini evasi dal marketplace, il marketplace può essere la fonte delle informazioni sulla spedizione e i campi disponibili per un venditore possono essere diversi. Non presumere che una pagina dell'ordine che mostra lo stato della consegna fornisca anche un numero di tracciamento del corriere adatto alla registrazione con un'API separata.

Se il marketplace fornisce un numero tracciabile, verifica di essere autorizzato a recuperarlo e utilizzarlo nel sistema previsto. Verifica quindi se l'API di tracciamento accetta quell'identificatore e se gli eventi risultanti aggiungono informazioni utili oltre allo stato del marketplace. Se il marketplace espone solo il proprio riferimento dell'ordine o della consegna, verifica l'esistenza di un metodo di ricerca esplicitamente supportato. Non inviare un ID ordine interno del marketplace come se fosse un numero del corriere aspettandoti risultati affidabili.

Mantieni separati lo stato dell'ordine del marketplace e lo stato della spedizione dell'API di tracciamento. Un marketplace può descrivere un ordine come spedito una volta confermata l'evasione, mentre il tracciamento del corriere può ancora non mostrare alcuna scansione di accettazione. Questi record rispondono a domande diverse e possono aggiornarsi in momenti differenti.

Quando il tracciamento senza etichetta non risolve il problema

“Nessuna etichetta creata da noi” non è un ostacolo. Le situazioni seguenti, invece, possono esserlo:

  • Non è stata creata alcuna spedizione: prima che l'evasione generi un identificatore utilizzabile, potrebbe non esserci alcuna spedizione del corriere da interrogare. La sola conferma dell'ordine non dimostra che esista un pacco in transito.
  • L'identificatore non è disponibile per te: un 3PL o un marketplace può conservare il numero senza esporlo tramite il tuo flusso autorizzato. Risolvi il problema di accesso ai dati alla fonte.
  • L'identificatore non è supportato: un numero di riferimento, un codice utilizzabile solo nel marketplace o un formato del corriere non supportato potrebbe non funzionare con l'API selezionata. Verifica gli input accettati nella documentazione e con una spedizione di prova.
  • Il pacco non presenta ancora una nuova scansione: un numero può esistere prima che il corriere registri l'evento di accettazione. Tratta un risultato vuoto o invariato come uno stato da verificare, non come prova automatica che il numero sia invalido.
  • Il tracciamento è limitato o incompleto: il corriere, il servizio o il flusso della spedizione potrebbe non fornire gli eventi richiesti dal tuo caso d'uso rivolto ai clienti. Verifica la qualità effettiva degli eventi utilizzando spedizioni rappresentative.

Questi limiti sono importanti perché un'API non può creare eventi fisici mancanti né concedere l'accesso ai dati degli ordini di un'altra parte. Il suo valore consiste nel recuperare e organizzare le informazioni di tracciamento supportate una volta disponibili l'identificatore necessario e le autorizzazioni.

Come valutare un'API per questo flusso di lavoro

La Tracking API di 17TRACK è un'opzione da valutare quando il tuo team ha bisogno dei dati di tracciamento delle spedizioni nei propri sistemi, anziché di uno strumento per acquistare etichette. La sua documentazione per sviluppatori è il riferimento da utilizzare per verificare i campi di registrazione accettati, i corrieri supportati, la struttura delle risposte, l'autenticazione e gli eventuali metodi disponibili per la consegna degli aggiornamenti nel tuo caso d'uso. Non dedurre il supporto per un particolare 3PL, marketplace o identificatore proprietario dalla semplice esistenza di un'API di tracciamento generale.

Prepara un piccolo set di test prima di selezionare o distribuire qualsiasi provider. Includi un ordine 3PL con un numero del corriere, un ordine marketplace per il quale il tuo account espone un numero, un ordine con più pacchi, un numero creato prima della prima scansione e una spedizione con un evento di consegna successivo. Se le sostituzioni o i passaggi internazionali sono frequenti, includi anche questi casi. Il test deve rispondere a domande operative, non solo verificare se una richiesta restituisce una risposta HTTP corretta:

  • Puoi trasmettere gli identificatori che ricevi realmente senza riscriverli manualmente?
  • Puoi associare in modo affidabile ogni record di tracciamento all'ordine e al pacco corretti?
  • Le descrizioni degli eventi, i timestamp e le informazioni sul corriere sono sufficienti per i messaggi ai clienti e i flussi di assistenza?
  • Come gestirà il tuo sistema gli aggiornamenti duplicati, gli eventi mancanti, le modifiche dei numeri e le richieste non riuscite?
  • L'uso previsto dei dati del marketplace e dei clienti è conforme ai termini di accesso applicabili a tali dati?

Per l'integrazione vera e propria, conserva sia il record della fonte originale sia il record dell'API di tracciamento. Memorizza il riferimento dell'ordine, il riferimento del pacco, il numero di tracciamento inviato, le informazioni sul corriere se disponibili e l'ora di ricezione di ogni aggiornamento. Ciò facilita l'analisi delle discrepanze senza presentare un evento dell'API come se fosse l'intera cronologia dell'evasione. Se l'API offre la possibilità di controllare a intervalli prestabiliti o ricevere aggiornamenti tramite un meccanismo di consegna supportato, scegli in base al comportamento documentato e alla necessità di ricevere aggiornamenti tempestivi; nessuno dei due approcci elimina la necessità di gestire gli errori.

La decisione pratica

Utilizza un'API di tracciamento senza creare etichette quando un'altra parte spedisce il pacco e ti fornisce un identificatore della spedizione supportato e autorizzato all'uso. Per prima cosa, assicurati un flusso affidabile di dati sui pacchi dal 3PL o dal marketplace. Poi testa gli identificatori e gli eventi di tracciamento rispetto all'API e alla tua logica di associazione degli ordini. Se disponi solo di un ID ordine o di uno stato del marketplace, risolvi questa lacuna nei dati di origine prima di investire in un'integrazione di tracciamento del corriere.

FAQ

Posso tracciare un ordine utilizzando solo il numero dell'ordine del mio negozio?

Di solito no, tramite un'API di tracciamento del corriere. Il numero dell'ordine del negozio identifica l'acquisto nel tuo sistema. In genere ti serve il relativo identificatore della spedizione, a meno che il servizio specifico non supporti esplicitamente la ricerca tramite il tuo tipo di riferimento dell'ordine.

Ho bisogno dell'autorizzazione del 3PL per utilizzare i suoi numeri di tracciamento?

Conferma il tuo accesso contrattuale e tecnico ai dati della spedizione. Un 3PL può già restituire i numeri di tracciamento come parte del proprio flusso di evasione, ma l'integrazione deve utilizzare un canale autorizzato e gestire adeguatamente i dati dei clienti.

Perché l'API non mostra movimenti dopo che il 3PL ha inviato un numero?

Il numero potrebbe essere stato creato prima della prima scansione registrata dal corriere. Verifica se l'identificatore e il corriere sono corretti, se l'etichetta originale è stata sostituita e se una query successiva produce eventi. Non equiparare “nessuna scansione ancora” a “non spedito” senza controllare il record di evasione.

Cosa succede se un ordine del marketplace viene spedito in più pacchi?

Traccia separatamente ogni identificatore di pacco disponibile e associa tutti i pacchi allo stesso ordine. Mantieni distinto lo stato dell'ordine rivolto al cliente dallo stato dei singoli pacchi, affinché la consegna di un solo pacco non faccia apparire completato l'intero ordine.

Fonti

  • 17TRACK Tracking API — informazioni sul prodotto per valutare l'integrazione del tracciamento delle spedizioni.
  • 17TRACK API Documentation — riferimento tecnico per verificare gli input accettati e il comportamento dell'integrazione.