Skip to main content
AcasăBlogGhiduriCum folosesc furnizorii 3Pl și de fulfillment un API de urmărire a expedițiilor în cadrul conturilor clienților

Cum folosesc furnizorii 3Pl și de fulfillment un API de urmărire a expedițiilor în cadrul conturilor clienților

17TRACK

Furnizorii 3PL și de fulfillment folosesc un API de urmărire a expedițiilor pentru a colecta actualizări ale transportatorilor pentru expediții aparținând mai multor clienți, apoi direcționează fiecare actualizare către contul, comanda, echipa de asistență și vizualizarea de raportare corecte ale clientului. API-ul furnizează datele de urmărire; propriul sistem al furnizorului trebuie să mențină proprietatea clientului, să controleze accesul, să gestioneze excepțiile și să decidă ce poate vedea fiecare client și cumpărător.

Cum folosesc furnizorii 3PL și de fulfillment un API de urmărire a expedițiilor

Această distincție este importantă atunci când aceeași operațiune de depozit deservește mai mulți comercianți. Un număr de urmărire nu este, de unul singur, un identificator al contului clientului. Pentru a oferi vizibilitate fiabilă între conturi, furnizorul de fulfillment are nevoie de o evidență a proprietarului fiecărei expediții și de un proces repetabil pentru transformarea actualizărilor transportatorului în informații specifice clientului.

Fluxul de bază: înregistrare, primire, direcționare, acțiune

Responsabilul acțiunii este de obicei echipa de operațiuni sau de inginerie a furnizorului 3PL. Aceasta integrează serviciul de urmărire o singură dată, apoi folosește sistemul de gestionare a depozitului, sistemul de gestionare a comenzilor sau stratul de integrare pentru a conecta înregistrările de urmărire la clienții individuali. Un flux practic are patru etape:

  1. Înregistrați expediția. Când este creată o etichetă sau un colet este predat transportatorului, furnizorul stochează numărul de urmărire, informațiile transportatorului atunci când sunt disponibile, ID-ul contului clientului, referința comenzii și orice ID intern al expediției. Acesta trimite detaliile de urmărire către integrarea sa de urmărire folosind metoda documentată de furnizor.
  2. Primiți actualizări. Integrarea obține informații noi de urmărire prin metodele acceptate efectiv de API. În funcție de serviciu și configurație, acestea pot include solicitări pentru starea curentă, notificări privind modificările sau ambele.
  3. Direcționați și interpretați. Furnizorul asociază înregistrarea de urmărire returnată cu ID-ul intern al expediției și cu contul clientului. Stochează mesajul transportatorului și îl mapează la un set limitat de stări operaționale, fără a elimina detaliile utile.
  4. Acționați. Clientul corect poate vedea progresul, serviciul de asistență poate răspunde unei solicitări, iar echipa de operațiuni poate investiga o excepție. Actualizările destinate cumpărătorilor trebuie să utilizeze canalele și regulile de comunicare aprobate de client.

Decizia esențială de proiectare apare înainte de prima solicitare API: fiecare expediție trebuie să aibă un proprietar clar în evidențele furnizorului 3PL. Fără această legătură, un răspuns de urmărire poate fi corect din punct de vedere tehnic, dar inutil sau vizibil comerciantului greșit.

Păstrați proprietatea clientului separată de identitatea urmăririi

Un model de date pentru mai mulți clienți trebuie să distingă un cont client, o comandă, o expediție internă, un transportator și un identificator de urmărire. Acestea sunt corelate, dar nu sunt interschimbabile. O comandă poate genera mai multe colete; un colet poate avea un număr de urmărire înainte să apară scanări relevante ale transportatorului; iar un client poate folosi transportatori diferiți pentru comenzi diferite.

De exemplu, dacă un depozit expediază două colete pentru comanda unui comerciant, pagina comenzii poate necesita două cronologii separate ale expedițiilor. Dacă un colet întâmpină o excepție de livrare, furnizorul 3PL trebuie să identifice coletul afectat, nu să marcheze întreaga comandă ca imposibil de livrat. Un ID intern al expediției oferă un punct stabil de asociere pentru aceste înregistrări, chiar și atunci când referințele comenzilor vizibile clienților nu sunt unice între clienți.

Stocați ID-ul contului clientului împreună cu înregistrarea expediției și impuneți verificări de acces când înregistrarea este creată, recuperată, exportată sau trimisă către un alt sistem. Nu vă bazați pe numărul de urmărire ca singură cheie de autorizare. Numerele de urmărire sunt identificatori operaționali, nu acreditări, iar un tablou de bord comun nu trebuie să expună comenzile unui comerciant doar pentru că un utilizator cunoaște un număr.

Transformați mesajele transportatorului în stări utile pentru client

Descrierile evenimentelor transportatorilor diferă. Un furnizor 3PL poate dori un set comun de etichete — precum etichetă creată, în tranzit, în curs de livrare, livrat și excepție — pentru tablouri de bord și cozi de excepții. Această mapare este o decizie a aplicației, nu un înlocuitor pentru evenimentul original. Păstrați starea sursă, ora evenimentului atunci când este furnizată, identitatea transportatorului și locația atunci când sunt disponibile, astfel încât un agent de asistență să poată înțelege ce s-a întâmplat efectiv.

Nu tratați fiecare mesaj nou ca pe un progres. Actualizările pot ajunge cu întârziere, pot descrie scanări anterioare sau pot repeta un eveniment deja primit. Pentru fiecare actualizare primită, integrarea trebuie să verifice dacă aceasta aparține unei expediții cunoscute, dacă este duplicată și dacă ora evenimentului modifică cronologia. Cel mai recent mesaj primit nu este neapărat cel mai recent eveniment produs.

În mod similar, „livrat” nu trebuie transformat într-o afirmație că destinatarul intenționat a acceptat personal coletul. Semnificația unei scanări de livrare depinde de detaliile evenimentului transportatorului și de orice informații disponibile privind dovada livrării pentru acea expediție. Interfața destinată clientului trebuie să afișeze dovezile pe care le deține, fără să deducă mai mult decât susțin datele.

Proiectați gestionarea excepțiilor în jurul persoanei care poate rezolva problema

Urmărirea devine valoroasă operațional atunci când schimbă ceea ce face echipa în continuare. O excepție de livrare poate necesita o notificare către client, o solicitare către transportator, verificarea adresei sau nicio acțiune imediată în timp ce este așteptată o scanare ulterioară. Răspunsul corect depinde de eveniment și de responsabilitățile stabilite între furnizorul 3PL și clientul său.

Stabiliți regulile de responsabilitate pentru cazurile comune înainte de a crea alerte. De exemplu, furnizorul 3PL poate fi responsabil de investigarea unui colet care pare blocat înainte de predare, în timp ce comerciantul gestionează solicitarea unui cumpărător de modificare a adresei de livrare. Acestea sunt exemple de aranjamente posibile, nu reguli universale. Fiecare furnizor trebuie să își documenteze propriile limite de servicii și calea de escaladare.

Ce trebuie verificat la selectarea sau implementarea unui API

Un API de urmărire este potrivit atunci când furnizorul 3PL are nevoie de actualizări ale expedițiilor în propriile sisteme, în loc să le ceară angajaților să verifice separat fiecare transportator. Întrebarea de achiziție nu este doar dacă un API returnează o stare, ci dacă comportamentul său documentat susține mixul real de expediții și fluxul de conturi al furnizorului.

  • Compatibilitatea transportatorilor și a expedițiilor: Verificați transportatorii și serviciile de expediere folosite efectiv de clienți. Confirmați modul în care API-ul identifică un transportator și ce se întâmplă când un număr de urmărire este ambiguu sau nu are încă evenimente.
  • Livrarea actualizărilor: Examinați opțiunile documentate pentru obținerea modificărilor, formatele așteptate ale solicitărilor și răspunsurilor și modul de gestionare a erorilor sau reîncercărilor.
  • Maparea conturilor: Stabiliți dacă furnizorul poate atașa propria referință la o înregistrare de urmărire. Indiferent de funcțiile API, păstrați o mapare internă de la înregistrarea de urmărire la contul clientului și ID-ul expediției.
  • Detaliile datelor: Examinați răspunsurile exemplu pentru evenimente, marcaje temporale, descrieri ale transportatorilor, locații și informații de livrare.
  • Limite operaționale: Verificați autentificarea documentată, limitele de utilizare, răspunsurile de eroare și condițiile comerciale relevante pentru volumul așteptat.
  • Securitate și păstrare: Decideți cine poate accesa istoricul urmăririi, cum sunt protejate acreditările, cât timp sunt păstrate înregistrările și cum primesc sau exportă clienții propriile date.

Pagina API-ului de urmărire 17TRACK și documentația pentru dezvoltatori sunt puncte de pornire relevante pentru un furnizor care evaluează o integrare de urmărire multi-transportator. Prezența lor nu demonstrează că serviciul gestionează permisiunile clienților sau structura conturilor unui furnizor 3PL. Verificați comportamentul actual al API-ului în documentație și într-o integrare de test, apoi implementați proprietatea tenantului și controalele de acces în propria aplicație a furnizorului 3PL, cu excepția cazului în care a fost confirmat un aranjament acceptat în mod specific.

Un pilot restrâns dezvăluie mai mult decât o listă de funcții

Înainte de a conecta fiecare cont de client, rulați un pilot cu un grup intenționat mixt de expediții. Includeți mai mult de un client, transportatorii utilizați efectiv de aceștia, o comandă cu mai multe colete, un număr de urmărire fără scanare inițială și expediții care ajung atât la stări obișnuite de livrare, cât și la stări de excepție. Păstrați datele pilotului separate de comunicările de producție, astfel încât testele să nu trimită mesaje accidentale cumpărătorilor.

Urmăriți fiecare expediție de la înregistrarea din depozit la înregistrarea urmăririi și până la vizualizarea clientului. Puneți întrebări concrete: Contul corect deține înregistrarea? O poate vedea un alt cont printr-un tablou de bord, o căutare, un export sau o notificare? Este o scanare veche plasată corect în cronologia evenimentelor? Ce se întâmplă dacă serviciul de urmărire respinge temporar o solicitare sau nu returnează informații noi? Poate un agent de asistență să identifice în continuare formularea originală a transportatorului?

Cele mai durabile arhitecturi tratează urmărirea ca pe o intrare comună de date, cu controale specifice fiecărui client. API-ul ajută la obținerea informațiilor despre expediții; furnizorul 3PL rămâne responsabil de asocierea acestor informații cu comenzile, protejarea limitelor conturilor și transformarea lor în acțiuni.

Întrebări frecvente

Poate un furnizor 3PL să utilizeze o singură integrare API de urmărire pentru mai mulți clienți?

Este posibil, dacă termenii și modelul tehnic al API-ului permit utilizarea intenționată. Furnizorul 3PL trebuie totuși să identifice clientul căruia îi aparține fiecare expediție și să impună această limită în toate sistemele sale. Confirmați cerințele privind conturile, acreditările și aspectele comerciale cu furnizorul API.

Ar trebui conturile clienților să partajeze același tablou de bord de urmărire?

Pot partaja aceeași aplicație de bază, dar fiecare client trebuie să vadă numai expedițiile și informațiile la care este autorizat să aibă acces. Testați izolarea în căutări, exporturi, notificări, instrumente de asistență și răspunsuri API, nu doar pe pagina principală a tabloului de bord.

Ce se întâmplă dacă un număr de urmărire nu returnează imediat actualizări?

Păstrați expediția asociată comenzii și contului clientului, afișați o stare de așteptare corectă și urmați instrucțiunile documentate ale API-ului pentru o nouă verificare. O etichetă poate exista înainte să apară activitatea transportatorului; absența unei scanări nu trebuie prezentată automat ca un colet pierdut.

Este suficient un API de urmărire pentru a trimite actualizări de livrare cu branding?

Nu. Datele de urmărire pot furniza evenimentul care declanșează o actualizare, dar furnizorul 3PL sau comerciantul trebuie să decidă și cine o trimite, ce branding al clientului se aplică, ce destinatari sunt autorizați și ce trebuie să spună mesajul. Aceste reguli de comunicare și de cont sunt externe evenimentului de urmărire.

Care este primul control care trebuie creat pentru implementarea în mai multe conturi?

Creați și testați legătura dintre fiecare ID intern al expediției și contul clientului proprietar. Aplicați verificarea proprietății oriunde datele de urmărire pot fi vizualizate sau distribuite. Aceasta este baza pentru raportare fiabilă, fluxuri de asistență și izolarea conturilor.

Surse