Hogyan használják a visszaküldési platformok a Shipment Tracking API-t a visszaküldött szállítmányok nyomon követésére
A visszaküldési platformok szállítmánykövetési API-t használnak annak érdekében, hogy egy jóváhagyott visszaküldést összekapcsoljanak a hozzá tartozó fizikai szállítmánnyal. A platform rögzíti a visszaküldött küldemény fuvarozóját és nyomkövetési azonosítóját, lekéri a nyomkövetési eseményeket, majd ezeket az eseményeket használja a folyamat megjelenítésére vagy operatív felülvizsgálat kezdeményezésére. Az API láthatóságot biztosít a szállítmány felett; magáért a visszaküldési kérelemért, a szabályzati döntésekért, a raktári ellenőrzésért és a visszatérítési folyamatért továbbra is a visszaküldési platform felel.

Egy visszaküldési műveleti vagy termékcsapat számára nem egyszerűen az a hasznos kérdés, hogy egy API képes-e megjeleníteni egy nyomkövetési állapotot. Az a kérdés, hogy az integráció megbízhatóan azonosítja-e a megfelelő visszaküldött küldeményt, helyesen értelmezi-e a kapott eseményeket, és megakadályozza-e, hogy egy nyomkövetési frissítés téves ügyfélüzenetet vagy visszatérítési műveletet indítson el.
Hol illeszkedik a nyomkövetés a visszaküldési folyamatba?
A visszaküldés üzleti nyilvántartásként kezdődik: az ügyfél kéri egy termék visszaküldését, a kereskedő pedig eldönti, mit hagy jóvá. A nyomkövetési rekord másról szól: egy csomag mozgásáról. A két rekord összekapcsolása lehetővé teszi, hogy a visszaküldési platform olyan kérdésekre válaszoljon, mint például hogy az ügyfél átadta-e a csomagot, a csomag a visszaküldési célállomás felé halad-e, illetve jelentettek-e kézbesítési eseményt.
Ennek a kapcsolatnak egyértelműnek kell lennie. Egy rendelés több terméket is tartalmazhat, egy ügyfél ugyanahhoz a rendeléshez több visszaküldést is indíthat, és egy visszaküldés több csomagot is magában foglalhat. Az eredeti kimenő küldemény nyomkövetési számát nem szabad összetéveszteni a visszaküldés nyomkövetési számával. A gyakorlatias adatmodell külön azonosítókat tart fenn a rendeléshez, a visszaküldési engedélyhez, a visszaküldött csomaghoz, a fuvarozóhoz és a nyomkövetési rekordhoz, majd tárolja a közöttük fennálló kapcsolatokat.
A nyomkövetésnek egyértelmű korlátai is vannak. A fuvarozó kézbesítési eseménye jelezheti, hogy egy csomag elért egy címet vagy létesítményt. Nem bizonyítja azonban, hogy a raktár megkapta a várt terméket, hogy a termék átment az ellenőrzésen, vagy hogy visszatérítés jár. Ezekhez a döntésekhez saját bizonyítékokra és szabályokra van szükség.
Az integráció folyamata az engedélyezéstől az átvételig
1. A visszaküldési rekord létrehozása a csomag követése előtt
A visszaküldési platform először rögzíti a kérelmet, az érintett termékeket, az engedélyezett célállomást és a megengedett megoldást. Ha a visszaküldés a kereskedő által kiállított címkét használja, a platform összekapcsolhatja a címke nyomkövetési azonosítóját a visszaküldött csomaggal. Ha az ügyfél önállóan intézi a szállítást, a platformnak szüksége lehet egy olyan megoldásra, amely a megfigyelés megkezdése előtt begyűjti és ellenőrzi a fuvarozót és a nyomkövetési számot.
Ez az első pont, ahol az adatminőség hatással van a láthatóságra. Egy megbízható csomag–visszaküldés kapcsolat nélküli nyomkövetési szám tökéletesen pontos fuvarozói frissítést eredményezhet, csak éppen rossz visszaküldéshez kapcsolva. A csapatoknak azt is el kell dönteniük, hogyan kezelik a javított nyomkövetési számokat, a cserecímkéket és azokat az ügyfeleket, akik ugyanazt az azonosítót kétszer küldik be.
2. A küldemény regisztrálása vagy lekérése
A platform elküldi a választott nyomkövetési szolgáltató által megkövetelt információkat egy küldeményrekord létrehozásához vagy lekéréséhez. A pontos kérési mezők és a sorrend a szolgáltató dokumentációjától függnek. Legalább arra van szükség, hogy az implementáció megbízhatóan összekapcsolja a szolgáltató küldeményhivatkozását a saját visszaküldött csomagrekordjával. Ha fuvarozó-azonosításra van szükség, a platformnak meg kell erősítenie, hogyan kezelik a nem egyértelmű vagy nem támogatott fuvarozói adatokat, és nem szabad azt feltételeznie, hogy önmagában a nyomkövetési szám elegendő.
Őrizze meg a szolgáltató válaszát, az integrációs hibákat és azt a dátumot, amikor a platform megkezdte a megfigyelést. Az elfogadott kérelem nem feltétlenül bizonyítja, hogy a fuvarozó már beolvasta a csomagot. Az első szkennelés előtt az ügyfél felé megjelenített állapotnak azt kell jeleznie, hogy a nyomkövetés függőben van, nem pedig azt, hogy a visszaküldés úton van.
3. A frissítések fogadása az eredeti esemény elvesztése nélkül
Az API-tól függően a frissítések webhookon keresztül érkezhetnek, lekérdezéssel kérhetők le, vagy más dokumentált módszert használhatnak. Az integrációnak meg kell őriznie a szolgáltató nyers eseményadatait a visszaküldési platformon megjelenített egyszerűsített állapot mellett. Hasznos mezők lehetnek az esemény leírása, az esemény időpontja, a megadott helyszín, a fuvarozói hivatkozás és az időpont, amikor a platform megkapta a frissítést.
Ez a két időpont különböző kérdésekre válaszol. Az esemény időbélyege azt mutatja, mikor történtnek jelentették az adott tevékenységet; a fogadási időbélyeg pedig azt, mikor szerzett róla tudomást a visszaküldési platform. Késések, ismételt kézbesítések és sorrenden kívül érkező üzenetek nélkül a visszaküldés egyébként úgy tűnhet, mintha visszafelé haladna. Ha a szolgáltató eseményazonosítókat biztosít, használja őket a duplikációk kiszűrésére. Ha nem biztosít ilyeneket, határozzon meg óvatos deduplikációs módszert, és tesztelje valós integrációs mintákkal.
4. A nyomkövetési események visszaküldési állapotokká alakítása
A fuvarozói eseményleírások nem jelentenek visszaküldési szabályzatot. A visszaküldési platform általában kisebb számú operatív állapotba rendezi őket, például átadásra vár, úton van, kézbesítés jelentve vagy felülvizsgálat szükséges. A leképezésnek az ismeretlen eseményeket is kezelnie kell, ahelyett hogy minden fel nem ismert frissítést csendben előrehaladásként értelmezne.
Például az első fuvarozói szkennelés elegendő lehet annak közlésére az ügyféllel, hogy a csomag láthatóan úton van. Nem feltétlenül elegendő azonban egy visszatérítési dátum megígéréséhez. A kézbesítési esemény segíthet a raktárnak egy egyező csomag prioritásos feldolgozásában, de a visszatérítési szabály továbbra is megkövetelheti a fizikai átvételt és az ellenőrzést. A csapatoknak ezeket a különbségeket még azelőtt be kell építeniük a munkafolyamatba, hogy az állapotokat automatizált műveletekhez kapcsolnák.
5. A folyamat lezárása raktári bizonyítékokkal
Amikor egy csomag megérkezik, a raktár vagy a visszaküldési létesítmény beolvashat egy belső vonalkódot, összepárosíthatja a csomagot a visszaküldési engedéllyel, ellenőrizheti a tartalmát, majd rögzítheti az eredményt. Ezek visszaküldés-kezelési események, nem pedig fuvarozói nyomkövetési események. Ha a két rendszer össze van kapcsolva, a platform hasznosabb folyamatot jeleníthet meg: a küldemény mozgása, a fuvarozó által jelentett kézbesítés, a létesítmény által átvett csomag és a lezárt elbírálás.
Ez a sorrend a kivételek megoldását is segíti. Ha a nyomkövetés kézbesítést jelez, de nem jelenik meg raktári átvétel, a kezelő megvizsgálhatja a célállomást, a fuvarozói eseményt, a létesítmény átvételi sorát és a csomagazonosítót, mielőtt ügyfél felé tett állítást fogalmazna meg. Ha a raktár használható nyomkövetési előzmények nélküli csomagot kap, a fizikai átvétel akkor is rögzíthető; a hiányzó nyomkövetési adat nem törölheti a független raktári bizonyítékot.
Mit tud és mit nem tud közölni a tracking API a platformmal?
A szállítmánykövetési API elérhetővé teheti a fuvarozó által jelentett mozgást egy másik alkalmazás számára, a szolgáltató dokumentált lefedettségétől, az események elérhetőségétől és az integráció működésétől függően. Önmagában azonban nem tudja ellenőrizni a visszaküldés tartalmát, és nem tudja eldönteni, hogy teljesültek-e a kereskedő szabályzatának feltételei. Előfordulhat az is, hogy az első fuvarozói szkennelés előtt nincs jelenthető frissítés.
Ez a különbség fontos az automatizálás megtervezésekor. Az állapotokat meghatározott felhasználási célú jelzésekként kell kezelni, nem pedig felcserélhető bizonyítékként. Egy fuvarozói átadási esemény előrehaladási értesítést indíthat el. Egy kézbesítési esemény raktári utánkövetési feladatot hozhat létre. A megerősített raktári átvétel a visszaküldést az ellenőrzés felé mozdíthatja. A visszatérítésről vagy cseréről szóló döntésnek azonban a kereskedő tényleges szabályait és az azok által megkövetelt bizonyítékokat kell követnie.
Az ügyfélnek szóló nyelvezetnek ugyanezt a határt kell tükröznie. A „A fuvarozó jelentése szerint a visszaküldése kézbesítve lett” pontosabb, mint a „Jóváhagytuk a visszatérítését”, ha még nem történt ellenőrzés. Hasonlóképpen, a „Várjuk az első fuvarozói frissítést” informatívabb, mint egy magyarázat nélküli üres nyomkövetési oldal.
Tervezési ellenőrzések a megelőzhető visszaküldési nyomkövetési hibák elkerüléséhez
- Párosítás csomagszinten. Tesztelje a részleges visszaküldéseket, az egy engedélyhez tartozó több csomagot, a cserecímkéket és az egy rendeléshez kapcsolódó ismételt visszaküldéseket. Minden csomagnak egyértelműen kapcsolódnia kell a saját nyomkövetési rekordjához.
- Az állapotok elsőbbségének meghatározása. Döntse el, mi történjen, ha egy régebbi, úton lévő esemény egy kézbesítési esemény után érkezik meg. Őrizze meg az eseménytörténetet anélkül, hogy automatikusan visszaminősítené a megjelenített visszaküldési állapotot.
- A szolgáltatói hibák és a fuvarozói csend elkülönítése. A hitelesítési hiba, az elutasított kérelem vagy a sikertelen webhook-feldolgozás integrációs probléma. Az, hogy még nem történt szkennelés, más állapot, és másképpen kell kommunikálni.
- Felkészülés a duplikációkra és újrapróbálkozásokra. A kézbesítési frissítés ismétlődhet. Tegye az eseményfogadást biztonságosan újrapróbálhatóvá, és kerülje ugyanazon ügyfélértesítés elküldését vagy ugyanazon feladat kétszeri létrehozását.
- Az ügyfél- és szállítmányadatok védelme. Korlátozza a hozzáférést a nyomkövetési hitelesítő adatokhoz, csak a munkafolyamathoz szükséges adatokat őrizze meg, és indulás előtt tekintse át a szolgáltató dokumentált hitelesítési és biztonsági követelményeit.
- Manuális útvonal fenntartása. Egyes visszaküldések hiányos, késedelmes vagy nem egyező nyomkövetési adatokkal rendelkeznek. A kezelőknek lehetőséget kell biztosítani a visszaküldési rekord vizsgálatára és javítására anélkül, hogy fuvarozói eseményeket találnának ki.
Ezek az ellenőrzések akkor a leghasznosabbak, ha konkrét eseteken, nem pedig egyetlen sikeres küldeményen tesztelik őket. Egy kisebb tesztkészletnek tartalmaznia kell az első szkennelés hiányát, a hibás nyomkövetési számot, a duplikált eseményt, a sorrenden kívül érkező eseményt, a raktári átvétel nélküli kézbesítési jelentést és az egyező kézbesítési jelentés nélküli raktári átvételt. Minden esethez meg kell határozni a várt ügyfélüzenetet és a kezelői műveletet.
Az API kiválasztása és a munkamegosztás meghatározása
Kezdje azokkal a visszaküldési útvonalakkal és fuvarozókkal, amelyeket a vállalkozás ténylegesen használ. Ezután a szolgáltató aktuális dokumentációjában ellenőrizze, hogyan működik a küldeményregisztráció, mely azonosítók kötelezőek, hogyan érkeznek a frissítések, milyen eseményadatok érhetők el, valamint hogyan kezelik a hibákat és az újrapróbálkozásokat. A releváns fuvarozókat és visszaküldési útvonalakat közvetlenül erősítse meg, ne egy általános fuvarozói lefedettségi állításból következtesse ki őket. Teszteljen reprezentatív küldeményekkel, mielőtt a leképezett állapotokra támaszkodna az ügyfélkommunikációban vagy az automatizálásban.
A 17TRACK közzétesz egy Tracking API áttekintést és API-dokumentációt; a 17RETURNS termékoldal a munkafolyamat visszaküldés-kezelési oldalával foglalkozik. Ezek releváns kiindulópontok egy olyan csapat számára, amely a visszaküldési folyamat mellett a nyomkövetési láthatóságot is értékeli. A két termékterület megléte nem tekinthető bizonyítéknak arra, hogy egy adott integráció, fuvarozó, esemény vagy automatizált visszatérítési szabály elérhető. Ellenőrizze a pontos munkafolyamatot az aktuális dokumentációban, és szükség esetén a szolgáltatónál is.
Beszerzés vagy proof of concept esetén kérje meg a visszaküldési szabályzatért és a raktári műveletekért felelős csapatot, hogy a mérnöki csapattal együtt vizsgálja felül az állapotok leképezését. A mérnöki csapat megerősítheti, hogy az API használható eseményeket szolgáltat-e; az operatív csapat pedig azt, hogy ezek az események indokolják-e a javasolt műveletet. A sikeres integráció segíti a munkatársakat és az ügyfeleket a csomag követésében, miközben az engedélyezést, az átvételt, az ellenőrzést és a döntést külön lépésként kezeli.
GYIK
A visszaküldéshez más nyomkövetési szám szükséges, mint az eredeti rendeléshez?
A platformnak külön kimenő és visszaküldési szállítmányrekordokat kell fenntartania. A visszaküldés jellemzően külön küldeményként halad, ezért a nyomkövetési azonosítót a visszaküldött csomaghoz kell kapcsolni, nem pedig automatikusan az eredeti rendelés kimenő azonosítójaként kezelni. A ténylegesen elérhető azonosítók a visszaküldés szállítási módjától függenek.
Megerősítheti egy tracking API, hogy visszatérítést kell kiadni?
Nem. Egyetlen nyomkövetési esemény sem erősíti meg önmagában, hogy a visszaküldött termék megfelel a kereskedő visszatérítési feltételeinek. A platform a fuvarozói eseményeket felhasználhatja egy munkafolyamat bemeneteként, de a visszatérítésre való jogosultság függhet az engedélyezéstől, a fizikai átvételtől, az ellenőrzéstől és a kereskedő szabályzatától is.
Mi történik, ha a nyomkövetés kézbesítést jelez, de a raktár nem találja a csomagot?
Tartsa külön a fuvarozó által jelentett kézbesítési eseményt és a raktári átvételi rekordot. Ellenőrizze a jelentett célállomást és az esemény részleteit, majd vizsgálja meg a létesítmény átvételi és párosítási folyamatát. Ne alakítsa át csendben a fuvarozói kézbesítést megerősített raktári átvétellé.
Szükségesek webhookok a visszaküldött küldemények követéséhez?
Nem feltétlenül. A frissítési módszer a választott szolgáltatótól és annak dokumentált lehetőségeitől függ. Ha webhookok állnak rendelkezésre, tervezzen a hitelesítéssel, az újrapróbálkozásokkal, a duplikált kézbesítésekkel és a feldolgozási hibákkal. Ha lekérdezést használ, válasszon a visszaküldési munkafolyamathoz és a szolgáltató követelményeihez illő időközt és leállítási szabályt.
Mikor láthatja az ügyfél az első nyomkövetési frissítést?
Ez attól függ, mikor jelent a fuvarozó eseményt, és mikor kapja meg azt az integráció. A címke létrehozása vagy a küldemény regisztrálása megelőzheti a fuvarozói szkennelést. Jelenítse meg egyértelműen ezt a különbséget, hogy az ügyfelek ne értelmezzék a függőben lévő első frissítést megerősített mozgásként.


