Skip to main content
KezdőlapBlogÚtmutatókHogyan válasszunk brit szállítmánykövetési API-t: fuvarozói lefedettség és integráció

Hogyan válasszunk brit szállítmánykövetési API-t: fuvarozói lefedettség és integráció

17TRACK

Válasszon brit küldeménykövetési API-t az Ön által ténylegesen használt fuvarozók és kézbesítési szolgáltatások tesztelésével, majd ellenőrizze, hogy a követési események megbízhatóan integrálhatók-e a rendszereibe. A hosszú fuvarozói címtár önmagában nem elegendő: a kiválasztott szolgáltatóknak valós küldeményteszteken kell megfelelniük a brit belföldi kézbesítések, a határokon átnyúló átadások, az állapot pontossága, a webhookok kezelése és a teljes üzemeltetési költség tekintetében.

Hogyan válasszunk brit küldeménykövetési API-t a fuvarozói lefedettség alapján

Egy e-kereskedelmi működésért felelős vezető számára az eredmény a megbízható küldeményláthatóság. A mérnöki csapat számára pedig egy olyan integráció, amely kiszámítható marad akkor is, amikor a frissítések késve érkeznek, a követési számok nem egyértelműek, vagy a kézbesítési partnerek változnak. A szolgáltató melletti elköteleződés előtt értékelje mindkét eredményt.

A küldeményösszetétellel kezdjen, ne a szolgáltató fuvarozószámával

A követési API küldeményinformációkat kér le alkalmazásban, rendeléskezelő rendszerben, ügyfélszolgálati eszközben vagy más szoftverben való felhasználásra. Ne feltételezze, hogy a követési integráció címkéket is vásárol, átvételt foglal vagy visszaküldéseket kezel. Ezek külön ellenőrizendő követelmények.

A szolgáltatók áttekintése előtt exportáljon reprezentatív mintát a küldeményeiből, és csoportosítsa őket fuvarozó, szolgáltatás, feladási hely, célállomás és üzleti fontosság szerint. Tartalmazzon sikeresen kézbesített és problémás küldeményeket is. Egy kizárólag egyszerű belföldi kézbesítésekből álló minta keveset árul el a nemzetközi átadásokról vagy a kézbesítési kivételekről.

Készítsen követelménylapot az alábbi mezőkkel:

  • Fuvarozó és szolgáltatás: Jegyezze fel a vállalkozása által ténylegesen használt pontos szolgáltatást, ne csak a fuvarozó márkanevét.
  • Útvonal: Különítse el a brit belföldi, az Egyesült Királyságba érkező és az Egyesült Királyságból induló küldeményeket.
  • Küldeményazonosító: Jegyezze fel, hogy csomagszámot, szállítmányhivatkozást, rendelési hivatkozást vagy több azonosítót kap-e.
  • Szükséges események: Azonosítsa azokat a mérföldköveket, amelyek ügyfélüzeneteket vagy operatív intézkedést váltanak ki.
  • Üzleti felelős: Jelölje ki a felelőst az elakadt küldemények, a sikertelen kézbesítések és a hibás frissítések kivizsgálására.

A kötelező lefedettségi listája a szerződéseitől függően tartalmazhatja a Royal Mail, a Parcelforce Worldwide, az Evri vagy a DPD szolgáltatót. Ezek vizsgálandó példák, nem pedig annak állítása, hogy bármely konkrét API minden, ezen fuvarozók által kínált szolgáltatást támogat.

Mit kell a fuvarozói lefedettségnek a gyakorlatban jelentenie?

A „támogatja ezt a fuvarozót” csak az értékelés kezdete. A hasznos lefedettség azt jelenti, hogy az API lekéri az Ön munkafolyamataihoz szükséges eseményeket az Ön által használt szolgáltatásokhoz és útvonalakhoz. A fuvarozói listát tesztelési okként kezelje, ne az éles használatra való alkalmasság bizonyítékaként.

Ellenőrizze a szolgáltatási és útvonal-szintű lefedettséget

Kérje meg a szolgáltatót, hogy erősítse meg a pontos fuvarozói integrációt, az esetlegesen szükséges fiókazonosító adatokat és a további küldeménymezőket. Állapítsa meg, hogy a követés működik-e az Ön szerződéses szolgáltatásaihoz, illetve szükség van-e irányítószámra vagy célállomás-információra. Ne feltételezze, hogy az egyik szolgáltatáson végzett sikeres teszt egy másik támogatását is bizonyítja.

Saját küldeményeivel ellenőrizze az események teljességét. Hasonlítsa össze az API válaszát a fuvarozó követési oldalával, és jegyezze fel, mikor ellenőrizte mindkettőt. A cél nem feltétlenül a teljesen azonos megfogalmazás, hanem annak megállapítása, hogy az operatív szempontból érdemi információ megmarad-e az integráció során.

A nemzetközi átadásokat külön tesztelje

A határokon átnyúló küldeményeknél egynél több kézbesítési partner is részt vehet. Tesztelje, hogy az integráció megjelenít-e egy későbbi fuvarozót vagy követési számot, amikor ez az információ elérhető. Azt is ellenőrizze, hogy az alkalmazása több követési számot is hozzá tud-e rendelni egy küldeményhez anélkül, hogy ismétlődő ügyfélértesítéseket hozna létre.

Ne feltételezze, hogy egy API olyan eseményeket is képes megjeleníteni, amelyeket az alapul szolgáló kézbesítési hálózat nem tett elérhetővé. A felelősség kijelölése előtt különítse el egymástól az integrációs problémát, a fuvarozói közzétételi késedelmet és a küldemény útjában fennálló valódi hiányosságot.

Ellenőrizze a fuvarozófelismerést és a nem egyértelmű számokat

Ha a szolgáltató automatikus fuvarozófelismerést kínál, tesztelje a nem egyértelműen megadott és a hibásan beírt számokat. Kérdezze meg, megadhat-e explicit fuvarozóazonosítót, és hogyan kezeli a rendszer a bizonytalan egyezést. Egy hihetőnek tűnő eseményeket eredményező hibás egyezés zavaróbb lehet, mint egy egyértelmű érvényesítési hiba.

A nagyobb kockázatú munkafolyamatoknál tárolja a teljesítési rendszer által megadott fuvarozót a követési szám mellett. Az automatikus felismerést ellenőrizendő funkcióként kezelje, ne a küldemény-metaadatok megőrzésének helyettesítőjeként.

Válasszon a közvetlen fuvarozói integrációk és a többfuvarozós API között

A közvetlen fuvarozói integráció megfelelhet egy stabil fuvarozói összetétellel és egy adott fuvarozó adataihoz szorosan kötődő követelményekkel rendelkező vállalkozásnak. Ugyanakkor az Ön csapata felelős marad az egyes különálló kapcsolatok megvalósításáért és karbantartásáért.

A többfuvarozós API-t akkor érdemes értékelni, ha rendszereinek több kézbesítési hálózaton átívelő közös integrációra van szükségük. A közös felület azonban nem jelenti automatikusan azt, hogy minden fuvarozónál azonos az adatok részletessége, a frissítések gyakorisága vagy az események minősége. Ezeket a különbségeket továbbra is tesztelni kell.

A 17TRACK a Tracking API kínálatán keresztül releváns ehhez az értékeléshez. Az integrációs követelmények ellenőrzéséhez használja kiindulópontként a hivatalos API-dokumentációt, majd közvetlenül ellenőrizze fuvarozói és szolgáltatási listáját. Ez egy jelölt, amelyet ugyanazon elfogadási folyamat keretében kell értékelni, nem pedig ok arra, hogy kihagyja a lefedettség vagy a megbízhatóság tesztelését.

Döntési szabály: válassza a többfuvarozós megközelítést, ha a közös integráció jelentősen csökkenti a karbantartási igényt anélkül, hogy elveszítené a szükséges eseményeket. Válassza a közvetlen integrációt, ha egy fuvarozóspecifikus követelmény döntő fontosságú, és a csapata képes azt támogatni. A hibrid megközelítés is megfelelő lehet, de határozza meg, melyik forrás élvez elsőbbséget, ha mindkettő ugyanarról a küldeményről jelent.

Értékelje az eseménymodellt, mielőtt ügyfél-munkafolyamatokat épít

A követési adatok csak akkor válnak hasznossá, ha a szoftver megfelelően értelmezi őket. Kérjen mintaválaszokat normál kézbesítésekről, kivételekről, visszaküldésekről és olyan küldeményekről, amelyekhez még nem érkezett esemény. Tekintse át a gyakori állapotkategóriákat és az elérhető eredeti fuvarozói leírásokat is.

Az általános „kivétel” állapot megfelelő lehet egy irányítópult számára, de az ügyfélszolgálati csapatnak meg kell különböztetnie a címproblémát a sikertelen kézbesítési kísérlettől. Ezzel szemben a nyers fuvarozói üzenet túl következetlen lehet ahhoz, hogy további leképezés nélkül ügyfélkommunikációt indítson.

  • Időbélyegek: Határozza meg, hogy egy mező az esemény időpontját, a lekérés időpontját vagy az értesítés időpontját jelenti-e, és hogyan fejezik ki az időzónákat.
  • Eseményazonosság: Ellenőrizze, hogy az események rendelkeznek-e stabil azonosítókkal, vagy az alkalmazásának kell létrehoznia egy duplikációszűrő kulcsot.
  • Állapotváltozások: Állapítsa meg, hogyan jelennek meg a javítások, a régebbi események és a látszólagos kézbesítés utáni frissítések.
  • Hiányzó információ: Erősítse meg, hogyan jelennek meg az ismeretlen helyek, a hiányzó időbélyegek és a nem elérhető kézbesítési becslések.
  • Nyers részletek: Döntse el, szükséges-e megőrizni az eredeti eseményleírást az ügyfélszolgálat és a kivizsgálás számára.

A „még nincs követési esemény” állapotot tartsa külön a „elveszett” állapottól. Hasonlóképpen ne alakítsa át a kézbesítési becslést garantált kézbesítési dátummá. Az alkalmazásának meg kell őriznie a bizonytalanságot, ahelyett hogy olyan bizonyosságot teremtene, amelyet a forrásadatok nem támasztanak alá.

Tervezzen a webhookhibákra, ne csak a sikeres kérésekre

Ha a kiválasztott API webhookokat kínál, vizsgálja meg, hogyan hitelesíti, ismétli meg és nyugtázza azokat. Ha lekérdezést használ, állapítsa meg a kérési korlátokat és az operatív igényeihez illeszkedő lekérdezési ütemezést. Egyik megközelítés sem szünteti meg a megfigyelés és a helyreállítás szükségességét.

Webhookalapú integrációnál robusztus megoldás a kérés ellenőrzése, a hasznos adatok tartós tárolása vagy sorba állítása, majd a szolgáltató követelményei szerinti nyugtázása. Az ügyfélértesítéseket külön kezelje, hogy egy lassú üzenetküldő szolgáltatás ne akadályozza a beérkező adatok feldolgozását.

A megvalósítás előtt válaszoljon az alábbi kérdésekre:

  • Hogyan ellenőrzi a végpontja, hogy a kérés a szolgáltatótól érkezett?
  • Mi történik, amikor a végpontja időtúllépést jelez vagy hibát ad vissza?
  • Megkettőződhetnek vagy sorrenden kívül érkezhetnek a kézbesítések?
  • Lekérhetők vagy újrajátszhatók a kimaradt frissítések?
  • Hogyan cserélik le a hitelesítő adatokat a szolgáltatás megszakítása nélkül?
  • Mi történik, amikor a helyreállítás során elérik a sebességkorlátokat?

A feldolgozást idempotens módon tervezze meg: ugyanazon frissítés újbóli fogadása ne hozzon létre újabb ügyfélüzenetet vagy ismétlődő ügyfélszolgálati feladatot. A küldemény állapotát tartsa külön az értesítési előzményektől, és rögzítse, hogy az egyes ügyfélnek szóló műveleteket mi váltotta ki.

Tervezzen a regisztrációs hibákra is. Ha egy követési szám hozzáadása sikertelen, tároljon egyértelmű hibaüzenetet, és csak megfelelő esetben próbálkozzon újra. Egy érvénytelen azonosító ismételt újrapróbálása nem helyreállítási stratégia.

Futtasson bizonyítási koncepciót egyértelmű megfelelési feltételekkel

Egy hasznos koncepcióteszt az integrációt az Ön követelményeivel, nem pedig egy kifinomult bemutatóval hasonlítja össze. Tartalmazzon küldeményeket minden fontos fuvarozó-szolgáltatás kombinációból, és szándékosan tesztelje a kedvezőtlen körülményeket.

Tesztelési esetMit kell ellenőrizni?Elfogadási alapelv
Brit belföldi kézbesítésAz események teljessége és a végső állapotA szükséges mérföldkövek a megfelelő rendeléshez érkeznek.
Határokon átnyúló átadásFuvarozóváltások és további azonosítókA rendelkezésre álló átadási információk továbbra is a küldeményhez kapcsolódnak.
Kézbesítési kivételAz állapot jelentése és az eredeti részletekA megfelelő csapat azonosítani tudja a következő intézkedést.
Duplikált vagy régebbi frissítésDuplikációszűrés és az események sorrendjeNem jön létre ismétlődő üzenet vagy helytelen állapot-visszalépés.
Ideiglenes végpontleállásÚjrapróbálkozások és egyeztetésA kimaradt információk tesztelt folyamattal helyreállíthatók.

A teszt előtt határozza meg saját küszöbértékeit. Mérje az események teljességét a meghatározott mérföldkövekhez képest, és rögzítse a fuvarozónál megfigyelt esemény és az API-n keresztüli fogadás közötti késedelmet. Tartsa következetesen a megfigyelési módszereket; egy esemény időbélyege önmagában nem bizonyítja, mikor vált elérhetővé az esemény.

Különítse el a kritikus hibákat a preferenciáktól. A szükséges lefedettség hiánya vagy a működésképtelen helyreállítási folyamat akadályozza meg a bevezetést. Egy kevésbé kényelmes irányítópult azonban nem feltétlenül. Ne engedje, hogy a magas összpontszám elfedje egy kötelező követelmény sikertelenségét.

Hasonlítsa össze a teljes költséget, az adatkezelést és a támogatást

Kérjen árajánlatot a küldeménymennyisége és használati mintája alapján. Tisztázza, mi alapján számláznak: regisztrált követési számok, kérések, aktív küldemények, frissítések vagy más egység alapján. Kérdezze meg, hogyan kezelik a duplikált regisztrációkat, a korábbi lekérdezéseket, a sikertelen beküldéseket és a túllépéseket. Ne feltételezze, hogy két csomag ugyanazt jelenti követett küldemény alatt.

A költségmodellbe foglalja bele a mérnöki karbantartást, a megfigyelést, a kivételkezelést és a migrációs munkát is. Az alacsony előfizetési díj nem feltétlenül jelent alacsony üzemeltetési költséget, ahogyan a magasabb díj sem bizonyítja a jobb követési minőséget.

Az adatkezeléshez dokumentálja, mely mezők hagyják el a rendszereit, és miért. Kerülje olyan ügyféladatok továbbítását, amelyekre az integrációnak nincs szüksége. A biztonsági és adatvédelmi csapatokkal együtt tekintse át a hozzáférés-vezérlést, a megőrzést, a törlést, a tárhelyszolgáltatási megállapodásokat és a szerződéses felelősségeket. Ne következtessen brit adatlokalizációra vagy szabályozási megfelelőségre pusztán abból, hogy egy API brit küldeményeket követ.

A támogatási megállapodásoknak összhangban kell állniuk a hiba üzleti hatásával. Kérdezze meg, hogyan eszkalálható egy fuvarozóspecifikus probléma, milyen diagnosztikai információkra van szüksége a támogatásnak, és mely szolgáltatási vállalások szerződésesek. Egy általános platformrendelkezésreállási vállalás önmagában nem garantálja a minden fuvarozótól érkező események időben történő továbbítását.

Tegye visszafordíthatóvá a bevezetést

Kezdje ellenőrzött küldeménycsoporttal, és hasonlítsa össze az eredményeket, mielőtt engedélyezné az ügyfelek felé irányuló automatizálást. Ahol praktikus, futtassa az új integrációt megfigyelési módban, hogy csapata az üzenetek küldése nélkül ellenőrizhesse az állapotle képezéseket.

Jelöljön ki felelőst a hitelesítő adatokért, a fuvarozói konfigurációért, a riasztásokért és az incidenskezelésért. Őrizzen meg elegendő küldeményazonosítót és feldolgozási előzményt a hibák kivizsgálásához és a későbbi migráció támogatásához. Erősítse meg, hogy csapata exportálni tudja a szükséges rekordokat, ahelyett hogy feltételezné azok hordozhatóságát.

A megfelelő brit küldeménykövetési API az, amely megfelel a kötelező útvonal- és eseményteszteken, illeszkedik az integrációs architektúrájához, és elfogadható üzemeltetési feltételeket kínál. Ezt a döntést küldeményeken alapuló bizonyítékok és helyreállítási tesztek alapján hozza meg, ne pusztán a fuvarozók számadatai vagy a funkciócímkék alapján.

GYIK

Szüksége van egy brit vállalkozásnak brit tárhelyen működő követési API-ra?

Nem automatikusan. A fuvarozói lefedettség, a tárhely helye és a szerződéses adatfeldolgozási megállapodások külön kérdések. Először határozza meg üzleti és adatvédelmi követelményeit, majd ellenőrizze, hogy a szolgáltató megállapodásai megfelelnek-e ezeknek. A brit csomagok követése nem határozza meg, hol dolgozzák fel az adatokat.

Követhetek egy küldeményt kizárólag rendelési számmal?

Ne feltételezze. Előfordulhat, hogy a fuvarozó vagy az API nem ismeri fel a belső rendelésszámot. Rendszerének meg kell őriznie a rendelés és a küldeményazonosítók közötti kapcsolatot, beleértve a több csomagot vagy a helyettesítő küldeményeket is. Erősítse meg az integráció által elfogadott azonosítókat.

A webhookok mindig jobbak a lekérdezésnél?

Nem. A webhookok csökkenthetik az ismételt lekérdezési kéréseket, de megbízható fogadó végpontot és duplikációkezelést igényelnek. A lekérdezés bizonyos munkafolyamatokhoz megfelelőbb lehet, a kérési korlátoktól és az elfogadható késedelmekből adódóan. A választást a dokumentált működésre és a tesztelt helyreállításra alapozza, ne kezelje egyik módszert sem eredendően elegendőként.

Mit tegyek, ha a fuvarozó oldala és az API eltérő információkat jelenít meg?

Rögzítse a követési számot, a fuvarozót, a nyers válaszokat és a megfigyelési időpontokat. Ellenőrizze, hogy a különbség a megfogalmazást, hiányzó eseményeket vagy valóban eltérő küldeményállapotot érint-e. Alkalmazzon meghatározott eszkalációs és egyeztetési folyamatot; ne váltson csendben forrást anélkül, hogy figyelembe venné az ismétlődő értesítéseket vagy az egymásnak ellentmondó állapotle képezéseket.

Források

Az alábbi hivatalos hivatkozások kiindulópontként szolgálnak a 17TRACK jelöltként való értékeléséhez. A fuvarozói szolgáltatások elérhetőségét, az árakat, a biztonsági megállapodásokat és a szerződéses kötelezettségeket a tervezett megvalósításhoz meg kell erősíteni. Az útmutatóban szereplő tesztelési és kiválasztási szempontok szerkesztői ajánlások, nem pedig annak állításai, hogy minden szolgáltató kínálja a leírt képességeket.

  • 17TRACK Tracking API — az útmutatóban tárgyalt API-kínálat hivatalos termékreferenciája.
  • 17TRACK API documentation — hivatalos műszaki referencia az integrációs követelmények megvalósítás előtti ellenőrzéséhez.