Skip to main content
KezdőlapBlogÚtmutatókHogyan használhatják a raktározási és rendelésteljesítési szolgáltatók a szállítmánykövetési API-kat

Hogyan használhatják a raktározási és rendelésteljesítési szolgáltatók a szállítmánykövetési API-kat

17TRACK

A raktározási és teljesítési szolgáltatók szállítmánykövetési API-k segítségével kapcsolhatják össze a fuvarozói eseményeket raktári, rendeléskezelési és ügyfélszolgálati folyamataikkal. A gyakorlati érték nem merül ki egy követési szám megjelenítésében. Egy jól megtervezett integráció a fuvarozói frissítéseket hasznos operatív jelzésekké alakítja: a rendelés feladása után nyomon követhető, a kivételek a megfelelő csapathoz irányíthatók, az ügyfelek egyértelműbb kézbesítési információkat kaphatnak, a teljesítési folyamat pedig egységes szállítmányadatok alapján értékelhető.

Hogyan használhatják a raktározási és teljesítési szolgáltatók a szállítmánykövetési API-kat

Egy raktár vagy harmadik félként működő logisztikai szolgáltató számára a legjobb megközelítés, ha a követést megosztott adatszolgáltatásként kezeli, nem pedig önálló, ügyfelek által használt oldalként. Az API-nak össze kell gyűjtenie a szállítmányeseményeket, normalizálnia kell a több fuvarozótól származó információkat, meg kell őriznie az eredeti fuvarozói adatokat, és a megfelelő állapotot elérhetővé kell tennie a raktári dolgozók, kereskedők, támogatási csapatok és címzettek számára.

17TRACK API — Egyszerűsítse a globális csomagkövetést több mint 3500 fuvarozó szállítmányfrissítéseivel. Learn More →

Miért fontosak a követési adatok a rendelés feladása után?

A raktári folyamat nem ér véget akkor, amikor a csomag elhagyja az épületet. Az átadást követően a szolgáltatónak továbbra is választ kell adnia az alábbi operatív kérdésekre:

  • Átvette-e a fuvarozó a szállítmányt?
  • Továbbhaladt-e az első szkennelés után?
  • Késik, visszatartják, visszaküldték, vagy valamilyen intézkedésre vár?
  • Mely rendelések igényelnek ügyfélszolgálati figyelmet?
  • Okoznak-e bizonyos fuvarozók, szolgáltatások, célállomások vagy teljesítési helyszínek ismétlődő kivételeket?

Kapcsolt követési folyamat nélkül a csapatok fuvarozói portálokra, táblázatokra, manuális keresésekre vagy következetlen állapotüzenetekre támaszkodhatnak. Ez megnehezíti annak megkülönböztetését, hogy egy szkennelések közötti normál szünetről vagy valóban beavatkozást igénylő szállítmányról van-e szó. Az API nem szünteti meg az operatív döntéshozatal szükségességét, de elérhetővé teheti a releváns információkat azokban a rendszerekben, ahol a döntések megszületnek.

A követési API gyakori felhasználási esetei a teljesítésben

1. Automatikus láthatóság a feladás után

A teljesítési szolgáltató elküldheti a követési számokat és a fuvarozói adatokat egy követési API-nak, amikor a rendelést feladottként jelölik. A visszakapott szállítmányinformáció ezután összekapcsolható a rendeléssel, a csomaggal, az ügyféllel és a teljesítési hellyel a szolgáltató belső rendszereiben. Így egységes, feladás utáni nyilvántartás jön létre anélkül, hogy a munkatársaknak manuálisan kellene ellenőrizniük minden fuvarozó webhelyét.

Az integrációnak támogatnia kell a többcsomagos rendeléseket. Egy ügyfélrendeléshez több követési szám is tartozhat, és az egyes csomagok eltérő sebességgel haladhatnak. Az adatmodellnek ezért a rendelés és a szállítmány közötti kapcsolatot kell támogatnia, nem pedig abból kell kiindulnia, hogy egy rendeléshez mindig egyetlen csomag tartozik.

2. Kivételkezelés

A normál mozgási események hasznosak, de a kivételes események általában nagyobb operatív értéket teremtenek. Ilyenek lehetnek például a kézbesítési kísérletek, a címhez kapcsolódó problémák, a vámkezelési visszatartások, a feladónak történő visszaküldések vagy az új szkennelés nélküli hosszabb időszakok. A pontos címkék és jelentések a fuvarozótól és a szolgáltatástól függnek, ezért a teljesítési csapatoknak gondosan kell leképezniük az állapotokat, és nem szabad minden ismeretlen eseményt hibaként kezelniük.

Egy praktikus folyamat a kivételkategóriákat különböző felelősökhöz rendelheti. Az ügyfélszolgálat kezelheti a címzettet érintő kézbesítési problémát. A raktár kivizsgálhatja a hibás címet vagy a feladási eltérést. A szállítási vagy ügyfélkapcsolati csapat felülvizsgálhatja az ismétlődő fuvarozói problémát. A követési API biztosítja az eseményt; a teljesítési szolgáltatónak azonban továbbra is szabályokat kell meghatároznia a felelősségről, az eszkalációról és a megoldásról.

3. Ügyfél- és kereskedői értesítések

A követési adatok támogathatják az e-mailes, SMS-es, portálon megjelenő vagy márkázott rendelésállapot-értesítéseket. Az üzenetnek érdemi állapotváltozáson, nem pedig minden nyers szkennelésen kell alapulnia. Minden alacsony szintű eseményről értesítést küldeni zajt kelthet, különösen akkor, ha a fuvarozók rövid időn belül több frissítést generálnak.

Az e-kereskedelmi kereskedőket kiszolgáló szolgáltatónak a belső és külső nyelvezetet is el kell különítenie. Egy belső esemény, például egy fuvarozói kivételkód, hasznos lehet egy operációs szakembernek, de zavaró lehet a vásárló számára. A rendszer megőrizheti az eredeti eseményt az ellenőrizhetőség érdekében, miközben egyértelműbb, ügyfeleknek szóló magyarázatot jelenít meg.

4. Proaktív támogatási folyamatok

A támogatási csapatoknak gyakran szükségük van a szállítmány adataira, mielőtt válaszolnak az ügyfélnek. Egy követési integráció a legutóbbi eseményt, az esemény időpontját, a fuvarozót, a szolgáltatást és a követési hivatkozást a rendelési rekord mellett helyezheti el. Ez csökkenti a rendszerek közötti keresés szükségességét, és segít az ügyintézőknek elkerülni az elavult vagy túlzottan magabiztos kézbesítési magyarázatokat.

A folyamatnak bizonyítási határt is tartalmaznia kell. A követési adatok megmutathatják, mit jelentett a fuvarozó, de nem mindig bizonyítják egy csomag fizikai helyét két szkennelés között, és nem garantálják a jövőbeli kézbesítési időpontot. Az ügyfeleknek szóló nyelvezetnek tükröznie kell ezt a különbséget.

5. Operatív jelentéskészítés

Idővel a normalizált követési események jelentéseket támogathatnak az első szkennelésekről, a mozgási időközökről, a kézbesítési kivételekről, a visszaküldésekről és a megoldatlan szállítmányokról. Ezek a jelentések akkor hasznosabbak, ha a szolgáltató megőrzi a releváns dimenziókat, például a fuvarozót, a szolgáltatást, a célrégiót, a raktárt, a kereskedőt és a feladás dátumát.

A jelentéskészítés nem alakíthatja a hiányos követési adatokat hamis pontossággá. Egyes szállítmányoknál késhetnek a szkennelések, korlátozott lehet az események részletessége, vagy fuvarozóspecifikus lehet az állapotkezelés. A jó irányítópult jelzi az adatok hatókörét és frissességét, és lehetővé teszi a felhasználók számára az alapul szolgáló szállítmányrekord megtekintését.

Gyakorlati architektúra a teljesítési folyamatok követéséhez

A követési API-integráció általában a teljesítési szolgáltató operatív rendszerei és a fuvarozói adatréteg között helyezkedik el. A pontos architektúra a szolgáltató meglévő technológiájától függ, de az alábbi összetevőket érdemes kifejezetten megtervezni:

  1. Szállítmányok fogadása: a csomag létrehozásakor vagy átadásakor rögzíteni kell a követési számot, a fuvarozót, a szolgáltatást, a rendelésazonosítót, a kereskedőazonosítót, a célállomást és a feladás időbélyegét.
  2. Fuvarozó azonosítása: megbízható fuvarozói kódot vagy leképezési folyamatot kell használni. Nem szabad feltételezni, hogy a követési szám mintája mindig elegendő, különösen akkor, ha a kereskedők regionális szolgáltatásokat, konszolidátorokat vagy nemzetközi átadásokat használnak.
  3. API-kérések kezelése: ellenőrizni kell a bemeneteket, védeni kell a hitelesítő adatokat, kezelni kell az időtúllépéseket, rögzíteni kell a kérésazonosítókat, és meg kell határozni az újrapróbálkozás szabályait. Az újrapróbálkozások nem hozhatnak létre duplikált rekordokat és nem generálhatnak szükségtelen forgalmat.
  4. Eseménynormalizálás: a fuvarozóspecifikus eseményeket ellenőrzött belső szókészletbe kell leképezni, miközben meg kell őrizni az eredeti állapotot, leírást, időbélyeget és forrást.
  5. Állapotkezelés: az aktuális szállítmányállapotot és az eseménytörténetet külön kell tárolni. Az aktuális állapot gyors operatív nézeteket támogat, az előzmények pedig az auditálást és a vizsgálatot.
  6. Kézbesítési csatornák: meg kell határozni, mely rendszerek kapják meg a frissítéseket, például a raktárkezelő rendszer, a rendeléskezelő rendszer, a kereskedői portál, a helpdesk, az analitikai platform vagy az értesítési szolgáltatás.
  7. Megfigyelés: mérni kell az API-hibákat, a késedelmes frissítéseket, a nem párosított fuvarozókat, a duplikált eseményeket, az elavult szállítmányokat és a feldolgozási késleltetést.

A szolgáltatóknak a kiválasztott API aktuális dokumentációjában meg kell erősíteniük a releváns végpontok működését, a támogatott fuvarozókat, a hitelesítési módot, a korlátozásokat, az állapotdefiníciókat és az értesítési lehetőségeket. A hivatalos 17TRACK Tracking API oldal és a fejlesztői dokumentáció megfelelő kiindulópont annak értékeléséhez, hogyan illeszthető egy többfuvarozós követési szolgáltatás ebbe az architektúrába.

Lekérdezés, webhookok vagy kombinált modell?

Az integrációs módszer a frissességre és a rendszer kialakítására egyaránt hatással van. Lekérdezés esetén a szolgáltató ütemezett időközönként frissítést kér az API-tól. Ez könnyen értelmezhető, de az ütemezésnek figyelembe kell vennie a szállítmányok mennyiségét, a fuvarozói aktivitást, az API-korlátokat és a szállítmány üzleti jelentőségét.

Eseményértesítések vagy webhookok használatakor a szolgáltató akkor kap frissítést, amikor a követési szolgáltatás változást jelez. Ez csökkentheti a szükségtelen kéréseket, de a fogadó rendszert fel kell készíteni a duplikált kézbesítésre, a sorrenden kívül érkező eseményekre, az ideiglenes hibákra, valamint az újrajátszási és helyreállítási eljárásokra. A webhookot nem szabad annak bizonyítékaként kezelni, hogy a szolgáltató adatbázisa véglegesen feldolgozta az eseményt, amíg az üzenetet nem ellenőrizték és nem tárolták.

Számos teljesítési környezet kombinált modellt használ. Az események időszerű frissítéseket támogathatnak, miközben az ütemezett egyeztetés ellenőrzi a kimaradt üzeneteket vagy azokat a szállítmányokat, amelyek egy várt időintervallumon belül nem változtak. A megfelelő választás az API dokumentált képességeitől, valamint a szolgáltató késleltetéssel és operatív összetettséggel szembeni toleranciájától függ.

A fuvarozói állapotok biztonságos normalizálása

Az állapotnormalizálás az egyik legfontosabb tervezési döntés. Egy egyszerű belső taxonómia tartalmazhatja a beérkezett információt, az úton lévő, kézbesítés alatt álló, kézbesített, kivételes és visszaküldéshez kapcsolódó állapotokat. Ennek a taxonómiának elég általánosnak kell maradnia ahhoz, hogy különböző fuvarozóknál is működjön, ugyanakkor elég konkrétnak kell lennie a hasznos műveletek kiváltásához.

A normalizálás során nem szabad elvetni a fuvarozóspecifikus részleteket. Az általános „kivétel” címke segíthet az ügy továbbításában, de az eredeti eseményleírásra és kódra szükség lehet az ügyfélszolgálat, a kárigények, a vámvizsgálat vagy a fuvarozói eszkaláció során. A normalizált állapotot és a forráseseményt egyaránt tárolni kell.

Az idő kezelése szintén fontos. Meg kell őrizni az esemény időbélyegét, az időzónát vagy eltolást, ha rendelkezésre áll, valamint azt az időpontot, amikor a teljesítési platform megkapta a frissítést. Ezek különböző értékek. Összekeverésük félrevezető jelentéseket eredményezhet a kézbesítési sebességről vagy a frissítési késleltetésről.

API-megfigyelési ellenőrzőlista raktári üzemeltetők számára

A megfigyelésnek többre kell kiterjednie annál, hogy elérhető-e az API-végpont. A teljesítési szolgáltató az alábbi ellenőrzéseket használhatja:

  • Hitelesítés: riasztás lejárt, visszavont vagy hibásan konfigurált hitelesítő adatok esetén.
  • Kérések sikeressége: a hibaarány követése végpont, fuvarozó, fiók és időszak szerint.
  • Adatfrissesség: azon szállítmányok azonosítása, amelyek utolsó frissítése régebbi az adott szolgáltatás operatív küszöbértékénél.
  • Lefedettség: azon követési számok felismerése, amelyek nem párosíthatók fuvarozóhoz vagy rendeléshez.
  • Feldolgozás: a várólista méretének, a duplikált eseményeknek, a sikertelen átalakításoknak és az adatbázis-írási hibáknak a figyelése.
  • Üzleti hatás: a technikai incidensek összekapcsolása a késedelmes értesítésekkel, a megoldatlan kivételekkel vagy a támogatási munkaterheléssel.

A riasztási küszöbértékeket a szolgáltató vállalásaihoz és a szállítmánytípusokhoz kell igazítani. Egy rövid késés elfogadható lehet egy alacsony prioritású belföldi csomagnál, de elfogadhatatlan lehet egy időérzékeny nemzetközi rendelés esetén. Az egységesen rögzített küszöbértékek túl sok riasztást vagy kihagyott problémákat eredményezhetnek.

Biztonság, adatvédelem és adatkezelés

A követési integrációk rendelésazonosítókat, címzetti információkat, címeket és operatív adatokat tárhatnak fel. A hozzáférést azokra a rendszerekre és munkatársakra kell korlátozni, akiknek szükségük van rá. A hitelesítő adatokat biztonságosan kell tárolni, a szolgáltató biztonsági szabályzatának megfelelően rotálni kell, és ki kell zárni a naplókból és a forráskódból.

A szolgáltatónak megőrzési szabályokat is meg kell határoznia. Az eseménytörténet értékes lehet a támogatás és az egyeztetés során, de minden mező korlátlan ideig történő megőrzése szükségtelen adatvédelmi és irányítási kockázatot jelenthet. Dokumentálni kell, milyen adatokat tárolnak, hol tárolják őket, ki férhet hozzájuk, valamint hogyan távolítják el vagy anonimizálják a rekordokat, amikor ez megfelelő.

Fokozatos megvalósítási terv

A fokozatos bevezetés általában jobb eredményeket hoz, mint az összes fuvarozó, raktár és értesítési csatorna egyidejű összekapcsolása.

  1. Üzleti eredmény meghatározása: egy konkrét problémával kell kezdeni, például a manuális követési keresések csökkentésével vagy a kézbesítési kivételek irányításával.
  2. Reprezentatív szállítmánykészlet kiválasztása: bele kell venni a szolgáltató fontos fuvarozóit, szolgáltatásait, célállomásait és többcsomagos eseteit.
  3. Adatmodell kialakítása: az irányítópultok létrehozása előtt meg kell határozni az azonosítókat, az állapotleképezéseket, az időbélyegeket, az eseménytörténetet és a felelősségi szabályokat.
  4. Hibaesetek tesztelése: tesztelni kell az érvénytelen követési számokat, a késedelmes szkenneléseket, a duplikált eseményeket, a fuvarozóváltásokat, az API-időtúllépéseket és a részleges szállítmányrekordokat.
  5. Validálás az operációval: meg kell kérdezni a raktári, támogatási, kereskedői és technológiai csapatokat, hogy a visszakapott információk támogatják-e a valós döntéseket.
  6. Óvatos bővítés: a kezdeti integráció megbízható megfigyelését és egyeztetését követően kell új fuvarozókat és folyamatokat hozzáadni.

A nemzetközi kereskedőket, többfuvarozós e-kereskedelmi műveleteket vagy összetett teljesítési hálózatokat kiszolgáló szolgáltatók számára a fő kiválasztási szempont az operatív illeszkedés legyen. A követési API akkor hasznos, ha adatai összekapcsolhatók a szolgáltató meglévő azonosítóival, folyamataival és eszkalációs rendszerével. A rendelkezésre álló funkciók száma kevésbé fontos, mint az, hogy az integráció megbízható információt biztosítson ott, ahol a munkatársaknak és az ügyfeleknek szükségük van rá.

GYIK

Mi az a szállítmánykövetési API?

A szállítmánykövetési API olyan szoftveres felület, amely lehetővé teszi, hogy egy rendszer programozott módon küldjön szállítmányadatokat és kérjen le követési információkat. A teljesítési szolgáltató ezzel összekapcsolhatja a fuvarozói eseményeket a raktári, rendelési, támogatási, értesítési és jelentéskészítési folyamatokkal.

Támogathat egyetlen API több fuvarozót?

Egyes követési szolgáltatásokat több fuvarozó elérésére terveztek, de a támogatott fuvarozókat, szolgáltatásokat, adatmezőket és integrációs feltételeket a szolgáltató aktuális dokumentációjában kell megerősíteni. A lefedettséget a teljesítési vállalkozás által ténylegesen használt fuvarozókkal és útvonalakkal kell tesztelni.

Lekérdezést vagy webhookokat használjanak a teljesítési szolgáltatók?

A válasz az API dokumentált lehetőségeitől és a szolgáltató frissességi követelményeitől függ. A webhookok eseményvezérelt feldolgozást támogathatnak, míg a lekérdezés ütemezett ellenőrzéseket biztosíthat. Kombinált megközelítés lehet megfelelő, ha a szolgáltatónak időszerű frissítésekre és a kimaradt események egyeztetésére is szüksége van.

Hogyan kell leképezni a fuvarozói állapotokat?

A forráseseményeket ellenőrzött belső szókészletbe kell leképezni, de meg kell őrizni az eredeti fuvarozói állapotot, leírást, kódot és időbélyeget. Ez megőrzi a vizsgálathoz szükséges részleteket, miközben lehetővé teszi az egységes irányítást, irányítópultokat és ügyfélkommunikációt.

Mit kell tesztelni az indulás előtt?

Tesztelni kell az érvényes és érvénytelen követési számokat, az egy rendeléshez tartozó több csomagot, a késedelmes szkenneléseket, a duplikált frissítéseket, a kivételeket, a visszaküldéseket, a fuvarozói eltéréseket, a hitelesítési hibákat, az időtúllépéseket és a rendszerkimaradás utáni helyreállítást. Azt is meg kell erősíteni, hogy az ügyfeleknek szóló üzenetek nem ígérnek többet annál, mint amit a követési adatok alátámasztanak.

Források