Skip to main content
AcasăBlogGhiduriCum folosesc platformele de retur un API de urmărire a expedierilor pentru a urmări expedierile de retur

Cum folosesc platformele de retur un API de urmărire a expedierilor pentru a urmări expedierile de retur

17TRACK

Platformele de gestionare a retururilor folosesc un API de urmărire a expedierilor pentru a conecta un retur aprobat la expedierea sa fizică. Platforma înregistrează transportatorul și identificatorul de urmărire al expediției de retur, preia evenimentele de urmărire și folosește aceste evenimente pentru a afișa progresul sau pentru a solicita o verificare operațională. API-ul oferă vizibilitate asupra expedierii; platforma de retururi rămâne responsabilă de solicitarea returului, deciziile privind politica, inspecția în depozit și fluxul de rambursare.

Cum folosesc platformele de retururi un API de urmărire a expedierilor

Pentru o echipă de operațiuni sau de produs responsabilă de retururi, întrebarea utilă nu este pur și simplu dacă un API poate afișa un statut de urmărire. Întrebarea este dacă integrarea poate identifica în mod fiabil expedierea de retur corectă, interpreta evenimentele primite și împiedica declanșarea unui mesaj greșit către client sau a unei acțiuni greșite de rambursare în urma unei actualizări de urmărire.

Unde se încadrează urmărirea într-un retur

Un retur începe ca o înregistrare comercială: un client solicită trimiterea unui articol înapoi, iar comerciantul decide ce să autorizeze. O înregistrare de urmărire descrie un lucru diferit: deplasarea unui colet. Conectarea celor două înregistrări permite unei platforme de retururi să răspundă la întrebări precum dacă clientul pare să fi predat coletul, dacă acesta se deplasează către destinația de retur și dacă a fost raportat un eveniment de livrare.

Această conexiune trebuie să fie explicită. O comandă poate conține mai multe articole, un client poate face mai multe retururi pentru aceeași comandă, iar un retur poate implica mai multe colete. Numărul de urmărire al expedierii inițiale nu trebuie confundat cu numărul de urmărire al returului. Un model practic de date păstrează identificatori separați pentru comandă, autorizația de retur, coletul de retur, transportator și înregistrarea de urmărire, apoi stochează relațiile dintre acestea.

Urmărirea are, de asemenea, o limită clară. Un eveniment de livrare raportat de transportator poate indica faptul că un colet a ajuns la o adresă sau la o unitate. Nu confirmă faptul că depozitul a primit articolul așteptat, că articolul a trecut inspecția sau că este datorată o rambursare. Aceste decizii necesită propriile dovezi și reguli.

Fluxul integrării, de la autorizare la primire

1. Creați înregistrarea returului înainte de a urmări coletul

Platforma de retururi înregistrează mai întâi solicitarea, articolele implicate, destinația autorizată și soluția permisă. Dacă returul folosește o etichetă emisă de comerciant, platforma poate asocia identificatorul de urmărire al etichetei cu coletul de retur. Dacă clientul organizează expedierea independent, platforma poate avea nevoie de o modalitate de a colecta și valida transportatorul și numărul de urmărire înainte de începerea monitorizării.

Acesta este primul punct în care calitatea datelor afectează vizibilitatea. Un număr de urmărire fără o asociere fiabilă între colet și retur poate produce o actualizare perfect exactă a transportatorului pentru returul greșit. Echipele ar trebui, de asemenea, să decidă cum vor gestiona numerele de urmărire corectate, etichetele înlocuite și clienții care trimit de două ori același identificator.

2. Înregistrați sau căutați expedierea

Platforma trimite informațiile necesare furnizorului de urmărire ales pentru a crea sau prelua o înregistrare a expedierii. Câmpurile exacte ale solicitării și succesiunea acestora depind de documentația furnizorului. Cel puțin, implementarea are nevoie de o metodă sigură pentru a asocia referința expedierii furnizorului cu propria înregistrare a coletului de retur. Atunci când este necesară identificarea transportatorului, platforma ar trebui să confirme modul în care sunt tratate detaliile ambigue sau nesuportate ale transportatorului, în loc să presupună că este suficient doar numărul de urmărire.

Păstrați răspunsul furnizorului, erorile integrării și data la care platforma a început monitorizarea. O solicitare acceptată nu reprezintă neapărat dovada că un transportator a scanat coletul. Înainte de prima scanare, starea afișată clientului poate trebui să indice că urmărirea este în așteptare, nu că returul este în tranzit.

3. Preluați actualizările fără a pierde evenimentul original

În funcție de API, actualizările pot sosi printr-un webhook, pot fi preluate prin interogare periodică sau pot utiliza o altă metodă documentată. Integrarea ar trebui să păstreze informațiile brute despre eveniment furnizate de furnizor împreună cu orice statut simplificat afișat în platforma de retururi. Câmpurile utile pot include descrierea evenimentului, ora evenimentului, locația atunci când este furnizată, referința transportatorului și ora la care platforma a primit actualizarea.

Aceste două momente răspund la întrebări diferite. Marca temporală a evenimentului descrie momentul în care se raportează că a avut loc o activitate; marca temporală a primirii arată când platforma de retururi a aflat despre aceasta. Întârzierile, livrările repetate și mesajele primite în ordine greșită pot face altfel ca un retur să pară că se deplasează înapoi. Dacă furnizorul oferă identificatori de evenimente, folosiți-i pentru eliminarea duplicatelor. Dacă nu oferă, definiți o metodă prudentă de eliminare a duplicatelor și testați-o cu exemple reale de integrare.

4. Traduceți evenimentele de urmărire în stări ale returului

Descrierile evenimentelor transportatorului nu reprezintă politica de retur. Platforma de retururi le mapează de obicei într-un set mai restrâns de stări operaționale, precum predare în așteptare, în tranzit, livrare raportată sau necesită verificare. Maparea ar trebui să țină cont de evenimentele necunoscute, în loc să trateze în tăcere fiecare actualizare nerecunoscută ca progres.

De exemplu, prima scanare a transportatorului poate fi suficientă pentru a-i spune clientului că pachetul său pare să fie în drum spre destinație. Este posibil să nu fie suficientă pentru a promite o dată a rambursării. Un eveniment de livrare poate ajuta depozitul să acorde prioritate unui colet corespunzător, însă o regulă de rambursare poate necesita în continuare primirea fizică și inspecția. Echipele ar trebui să introducă aceste diferențe în fluxul de lucru înainte de a conecta stările la acțiuni automatizate.

5. Închideți bucla cu dovezi din depozit

Odată ce un colet ajunge, depozitul sau unitatea de retur poate scana un cod de bare intern, poate asocia coletul cu o autorizație de retur, îi poate inspecta conținutul și poate înregistra rezultatul. Acestea sunt evenimente de gestionare a retururilor, nu evenimente de urmărire ale transportatorului. Atunci când ambele sisteme sunt conectate, platforma poate afișa o secvență mai utilă: deplasarea expedierii, livrarea raportată de transportator, coletul primit de unitate și procesarea finalizată.

Această secvență ajută, de asemenea, la soluționarea excepțiilor. Dacă urmărirea raportează livrarea, dar nu apare nicio primire în depozit, un operator poate verifica destinația, evenimentul transportatorului, coada de recepție a unității și identificatorul coletului înainte de a face o afirmație către client. Dacă depozitul primește un colet fără un istoric de urmărire utilizabil, primirea fizică poate fi totuși înregistrată; datele de urmărire lipsă nu ar trebui să șteargă dovezile independente ale depozitului.

Ce poate și ce nu poate comunica platformei un API de urmărire

Un API de urmărire a expedierilor poate face disponibilă unei alte aplicații deplasarea raportată de transportator, în funcție de acoperirea documentată a furnizorului, disponibilitatea evenimentelor și comportamentul integrării. Nu poate verifica singur conținutul unui retur și nu poate decide dacă politica unui comerciant a fost îndeplinită. De asemenea, este posibil să nu aibă nicio actualizare de raportat înainte de prima scanare a transportatorului.

Această diferență este importantă la proiectarea automatizării. Stările ar trebui tratate ca semnale cu utilizări definite, nu ca dovezi interschimbabile. Un eveniment de predare către transportator poate declanșa o notificare privind progresul. Un eveniment de livrare poate crea o sarcină de urmărire pentru depozit. O primire confirmată în depozit poate muta returul către inspecție. Decizia de rambursare sau schimb ar trebui să urmeze regulile reale ale comerciantului și dovezile necesare conform acestor reguli.

Limbajul destinat clienților ar trebui să reflecte aceeași limită. „Transportatorul raportează că returul dvs. a fost livrat” este mai precis decât „V-am aprobat rambursarea” atunci când nu a avut loc nicio inspecție. În mod similar, „Așteptăm prima actualizare a transportatorului” este mai informativ decât o pagină de urmărire goală și neexplicată.

Verificări de proiectare care previn erorile evitabile de urmărire a retururilor

  • Asociați la nivel de colet. Testați retururile împărțite, mai multe colete pentru o singură autorizație, etichetele înlocuite și retururile repetate pentru aceeași comandă. Fiecare colet are nevoie de o asociere neambiguă cu propria înregistrare de urmărire.
  • Definiți prioritatea stărilor. Decideți ce se întâmplă dacă un eveniment mai vechi „în tranzit” sosește după un eveniment de livrare. Păstrați istoricul evenimentelor fără a retrograda automat starea afișată a returului.
  • Separați erorile furnizorului de lipsa de răspuns a transportatorului. O eroare de autentificare, o solicitare respinsă sau procesarea eșuată a unui webhook reprezintă o problemă de integrare. Lipsa unei scanări este încă o condiție diferită și ar trebui comunicată diferit.
  • Planificați duplicatele și reîncercările. Actualizarea livrării se poate repeta. Faceți ingestia evenimentelor sigură pentru reîncercare și evitați trimiterea aceleiași notificări către client sau crearea aceleiași sarcini de două ori.
  • Protejați datele clienților și ale expedierilor. Restricționați accesul la datele de autentificare pentru urmărire, păstrați doar datele necesare fluxului de lucru și analizați cerințele documentate ale furnizorului privind autentificarea și securitatea înainte de lansare.
  • Păstrați o cale manuală. Unele retururi vor avea informații de urmărire incomplete, întârziate sau necorespunzătoare. Operatorii au nevoie de o modalitate de a investiga și corecta înregistrarea returului fără a inventa evenimente ale transportatorului.

Aceste verificări sunt cele mai utile atunci când sunt testate pe scenarii concrete, nu pe baza unei singure expedieri reușite. Un set mic de teste ar trebui să includă lipsa primei scanări, un număr de urmărire incorect, un eveniment duplicat, un eveniment primit în ordine greșită, un raport de livrare fără primire în depozit și o primire în depozit fără un raport de livrare corespunzător. Mesajul așteptat pentru client și acțiunea operatorului ar trebui specificate pentru fiecare caz.

Alegerea API-ului și definirea împărțirii responsabilităților

Începeți cu rutele de retur și transportatorii utilizați efectiv de companie. Apoi verificați în documentația actuală a furnizorului cum funcționează înregistrarea expedierilor, ce identificatori sunt necesari, cum sunt livrate actualizările, ce date despre evenimente sunt expuse și cum sunt gestionate erorile și reîncercările. Confirmați direct transportatorii relevanți și rutele de retur, în loc să îi deduceți dintr-o afirmație generală despre acoperirea transportatorilor. Testați cu expedieri reprezentative înainte de a vă baza pe stări mapate pentru comunicarea cu clienții sau automatizare.

17TRACK publică o prezentare generală a Tracking API și documentația API; pagina sa de produs 17RETURNS abordează partea de gestionare a retururilor din fluxul de lucru. Acestea sunt puncte de pornire relevante pentru o echipă care evaluează vizibilitatea urmăririi împreună cu un proces de retururi. Existența ambelor categorii de produse nu trebuie considerată o dovadă că o anumită integrare, un transportator, un eveniment sau o regulă de rambursare automatizată este disponibilă. Verificați fluxul exact în documentația actuală și, atunci când este necesar, împreună cu furnizorul.

Pentru achiziții sau o dovadă de concept, solicitați echipei responsabile de politica de retururi și operațiunile depozitului să analizeze maparea stărilor împreună cu echipa de inginerie. Ingineria poate confirma dacă API-ul furnizează evenimente utilizabile; operațiunile pot confirma dacă acele evenimente justifică acțiunea propusă. O integrare reușită este una care ajută personalul și clienții să urmărească coletul, păstrând în același timp autorizarea, primirea, inspecția și soluționarea ca pași distincti.

Întrebări frecvente

Are un retur nevoie de un număr de urmărire diferit de cel al comenzii inițiale?

Platforma ar trebui să păstreze înregistrări separate pentru expedierea inițială și expedierea de retur. Un retur călătorește de obicei ca o expediere separată, astfel încât identificatorul său de urmărire trebuie asociat coletului de retur, nu presupus ca fiind identificatorul expedierii inițiale a comenzii. Identificatorii disponibili depind de modul în care este expediat returul.

Poate un API de urmărire confirma că trebuie emisă o rambursare?

Nu. Niciun eveniment de urmărire nu confirmă singur că articolul returnat îndeplinește condițiile de rambursare ale comerciantului. Platforma poate utiliza evenimentele transportatorului ca intrări într-un flux de lucru, însă eligibilitatea pentru rambursare poate depinde și de autorizare, primirea fizică, inspecție și politica comerciantului.

Ce se întâmplă dacă urmărirea indică livrarea, dar depozitul nu poate găsi coletul?

Păstrați separat evenimentul de livrare raportat de transportator și înregistrarea primirii în depozit. Verificați destinația raportată și detaliile evenimentului, apoi investigați procesul de recepție și asociere al unității. Nu transformați în tăcere livrarea transportatorului în primire confirmată în depozit.

Sunt webhook-urile necesare pentru urmărirea expedierilor de retur?

Nu neapărat. Metoda de actualizare depinde de furnizorul ales și de opțiunile documentate ale acestuia. Dacă sunt disponibile webhook-uri, planificați autentificarea, reîncercările, livrările duplicate și erorile de procesare. Dacă se utilizează interogarea periodică, alegeți un interval și o regulă de oprire care să se potrivească fluxului de retururi și cerințelor furnizorului.

Când ar trebui să vadă clientul prima actualizare de urmărire?

Acest lucru depinde de momentul în care transportatorul raportează un eveniment și de momentul în care integrarea îl primește. Crearea unei etichete sau înregistrarea unei expedieri poate avea loc înainte de scanarea transportatorului. Afișați clar această diferență, astfel încât clienții să nu interpreteze o primă actualizare în așteptare ca pe o deplasare confirmată.

Surse