Skip to main content
KezdőlapBlogÚtmutatókHogyan válasszunk szállítmánykövetési API-t a franciaországi kézbesítésekhez

Hogyan válasszunk szállítmánykövetési API-t a franciaországi kézbesítésekhez

17TRACK

Válasszon szállítmánykövetési API-t a franciaországi kézbesítésekhez úgy, hogy saját fuvarozóit, francia kézbesítési folyamatait és határokon átnyúló átadásait teszteli – ne pedig a fuvarozók számáról szóló szalagcímeket hasonlítsa össze. A megfelelő API-nak használható nyomkövetési eseményeket kell visszaadnia, meg kell különböztetnie az átvételi ponton való elérhetőséget a teljesített kézbesítéstől, és illeszkednie kell műszaki, valamint adatvédelmi követelményeihez. Mielőtt elkötelezné magát, futtasson pilotot reprezentatív szállítmányokkal, és állapodjon meg mérhető elfogadási kritériumokban.

Szállítmánykövetési API választása a kézbesítésekhez

Ez az útmutató az e-kereskedelmi operációs csapatoknak, fejlesztőknek és beszerzési vezetőknek szól, akik a szállítmányok láthatóságát online áruházhoz, rendeléskezelő rendszerhez, ügyfélszolgálati platformhoz vagy belső irányítópulthoz kapcsolják. A cél egy megbízható kézbesítési információforrás kiválasztása, nem pusztán egy olyan végponté, amely elfogadja a nyomkövetési számokat.

Kezdje azokkal a kézbesítésekkel, amelyeket vállalkozása ténylegesen teljesít

A „franciaországi lefedettség” túl tág ahhoz, hogy beszerzési követelményként szolgáljon. Egy belföldi, címre kézbesítő vállalkozás igényei eltérnek egy olyan kereskedőétől, amely árut importál Franciaországba, majd átvételi pontokra kézbesíti. A bemutatók vagy árajánlatok kérése előtt határozza meg a szállítmányprofilt.

  • Kézbesítési földrajz: A kontinentális Franciaországot, Korzikát és a francia tengerentúli célállomásokat külön azonosítsa. Kérje a szolgáltatókat, hogy erősítsék meg a releváns szolgáltatásokat, ahelyett hogy feltételezné, hogy egyetlen földrajzi megjelölés minden útvonalat lefed.
  • Kézbesítési mód: Különítse el a házhoz kézbesítést, a személyzettel működő átvételi pontokat, a csomagautomatákat és az egyéb ténylegesen kínált szolgáltatásokat.
  • Fuvarozó és szolgáltatás: Rögzítse az üzemeltető fuvarozót és a szolgáltatás nevét, ne csak azt a szállítási platformot, amelyen keresztül a címkét megvásárolta.
  • Szállítmány iránya: Különböztesse meg a belföldi kézbesítéseket, a beérkező nemzetközi szállítmányokat, a kimenő rendeléseket és a visszaküldéseket.
  • Operatív felhasználás: Döntse el, hogy a követés ügyfélértesítéseket, kivételkezelést, ügyfélszolgálati vizsgálatokat vagy mindhárom területet fogja-e támogatni.

Készítsen fuvarozói mátrixot a közelmúlt rendelései alapján. Vállalkozásától függően ez tartalmazhatja a Colissimo, a Chronopost vagy a Mondial Relay szolgáltatásaihoz kapcsolódó tételeket. Ezek példák, amelyeket saját szállítási nyilvántartásaival kell összevetni, nem pedig annak állításai, hogy bármely adott API minden általuk kínált szolgáltatást támogat.

Adja meg a fuvarozónkénti és szolgáltatásonkénti várható mennyiséget is. Egy olyan szolgáltató, amely megbízhatóan kezeli a legforgalmasabb kézbesítési folyamatát, jobban megfelelhet, mint egy nagyobb globális címtárral rendelkező szolgáltató, amelynek a fő útvonalakon nyújtott támogatása nem bizonyított.

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ót akkor érdemes megfontolni, ha egy fuvarozó bonyolítja a szállítmányok többségét, és csapatának hozzáférésre van szüksége a fuvarozóspecifikus információkhoz. Ekkor is ellenőriznie kell a fiók jogosultságát, a dokumentációt, az események elérhetőségét és az adott fuvarozó integrációs feltételeit.

A többfuvarozós követési API akkor lehet megfontolandó, ha vállalkozása több fuvarozót használ, vagy rendszeresen kezel nemzetközi átadásokat. Lehetséges előnye, hogy csökkenti a csapat által karbantartott integrációk számát, és a különböző követési formátumokat közös felületen jeleníti meg. Hogy ezt valóban eléri-e, az a tesztelt fuvarozóktól és folyamatoktól függ.

Egyik megközelítés sem garantál automatikusan gyorsabb frissítéseket vagy részletesebb eseményeket. A tényleges kimeneteket és karbantartási követelményeket hasonlítsa össze, ahelyett hogy azt feltételezné, hogy a közvetlen hozzáférés mindig gazdagabb, az aggregáció pedig mindig egyszerűbb.

A többfuvarozós rövidlistán a 17TRACK’s Tracking API releváns vizsgálati lehetőség. Használja a hivatalos API-dokumentációt és folytasson műszaki egyeztetést a szükséges fuvarozói szolgáltatások, az integrációs folyamat, az események kézbesítése és a kereskedelmi feltételek ellenőrzésére. A franciaországi kézbesítésekhez való megfelelőségét saját szállítmánymintájával kell megállapítani, nem pedig a fogyasztói követési szolgáltatás elérhetőségéből levezetni.

A szolgáltatási lefedettséget tesztelje, ne csak a fuvarozó felismerését

A nyomkövetési szám sikeres lekérdezése csak az első teszt. Alkalmazásának elegendő információra van szüksége annak megmagyarázásához, hogy mi történt, és a következő művelet támogatásához.

Értékelési területMit kell ellenőrizniMiért fontos
Fuvarozó azonosításaA tényleges számok felismerése és az egyértelműtlen találatok javításának lehetőségeEgy valószínűnek tűnő, de helytelen találat félrevezető eredményeket adhat.
Szolgáltatási lefedettségA megvásárolt pontos belföldi és nemzetközi szolgáltatások eseményeiÖnmagában a fuvarozó neve nem bizonyítja a szolgáltatási szintű lefedettséget.
Átvételi pont eseményeiAz érkezés, az átvételre való elérhetőség és az ügyfél általi átvétel elkülönített kezeléseAz átvételre váró csomag nem válthat ki teljesített kézbesítésről szóló üzenetet.
Nemzetközi átadásokFolytonosság a kiinduló fuvarozó és a célországi kézbesítési hálózat közöttAz ügyfeleknek akkor is láthatóságra van szükségük, amikor a csomag hálózatot vált.
Esemény részletességeEredeti leírások, normalizált állapotok, helyszínek és időbélyegek, ahol elérhetőkAz ügyfélszolgálati csapatoknak a tág állapotmegjelölésen túl kontextusra van szükségük.

Ne tekintse egy hiányzó mezőt az API hibájának bizonyítékaként anélkül, hogy ellenőrizné az alapul szolgáló fuvarozói adatokat. Előfordulhat, hogy egyes információkat a fuvarozó nem tesz közzé, azok a szolgáltatástól függenek, vagy csak bizonyos hozzáférési feltételek mellett érhetők el. Kérje a szolgáltatót, hogy magyarázza el a korlátokat.

Ellenőrizze, hogy a francia kézbesítési események a megfelelő művelethez vezetnek-e

Átvételi pontok és csomagautomaták

Az átvételen alapuló kézbesítéseknél az elérhetőség és a teljesítés két különböző üzleti esemény. Tesztelje, hogy az API megőrzi-e ezt a különbséget, és hogy alkalmazása helyesen képezi-e le. Ha az adatok átvételi utasításokat vagy határidőt tartalmaznak, megjelenítésük előtt ellenőrizze azok forrását és jelentését. Ne számítson ki általános átvételi határidőt feltételezett fuvarozói szabályzat alapján.

Egy hasznos elfogadási teszt egyszerű: amikor egy csomag átvehetővé válik, rendszere az átvételhez adjon útmutatást, ne pedig „kézbesítve Önnek” üzenetet küldjön. Amikor a címzett átveszi, a rendelés idővonalának a végső eseményt kell tükröznie anélkül, hogy az előző értesítést újra elküldené.

Kézbesítési kísérletek és kivételek

Egy általános kivételkategória nagyon eltérő helyzeteket rejthet, például sikertelen kézbesítési kísérletet, címproblémát vagy vámkezeléssel kapcsolatos késedelmet. Az eredeti eseményleírást tegye elérhetővé az ügyfélszolgálati munkatársak számára akkor is, ha az ügyfelek egyszerűsített címkét látnak.

Döntse el, mely események igényelnek beavatkozást. Egy címprobléma ügyfélszolgálati jegyet igényelhet, egy szokásos feldolgozási szkennelés általában nem. Ezeknek a szabályoknak az operatív tervezés részét kell képezniük, nem pedig automatikusan átvenni őket a szolgáltató állapot-taxonomiájából.

Nyelv és idő

Kérdezze meg, hogy az eseményleírások eredeti fuvarozói szövegek, lefordított szövegek vagy szabványosított címkék-e. Áruháza egységes magyar nyelvű megfogalmazást biztosíthat, de nem adhat hozzá olyan bizonyosságot, amelyet a forrásesemény nem tartalmaz.

Őrizze meg az időbélyegek eltolását, és különböztesse meg az esemény bekövetkezésének idejét attól az időponttól, amikor rendszere megkapta azt. Kontinentális Franciaország esetében a helyi idők megjelenítésekor használjon időzóna-tudatos megvalósítást, például az Europe/Paris időzónát, ne pedig rögzített UTC-eltolást. A többi célállomás időzónáját szükség esetén külön kezelje.

Értékelje a frissítések kézbesítését és a helyreállítási viselkedést

A webhookok csökkenthetik az ismételt állapotlekérdezések szükségességét, de egy webhook fogadása nem jelenti azt, hogy az eseményt közvetlenül a fizikai szkennelés után rögzítették. Külön idő telhet el a szkennelés, a fuvarozó általi közzététel, a követési szolgáltató általi lekérés és az alkalmazás általi feldolgozás között.

Kérje a szolgáltatókat, hogy ismertessék ezeket a szakaszokat és a dokumentált szolgáltatási vállalásokat. Ne hasonlítsa össze a „valós idejű követés” állításait közös meghatározás nélkül.

  • Hitelesítés: Hogyan hitelesítik a beérkező értesítéseket, és hogyan cserélik a hitelesítő adatokat?
  • Újrapróbálkozások: Mi történik, ha a végpont időtúllépést vagy hibát ad vissza?
  • Duplikátumok: Érkezhet ugyanaz az esemény többször, és hogyan kell azonosítani?
  • Sorrend: Érkezhetnek korábbi események később, mint a későbbi események?
  • Helyreállítás: Lekérhető a szállítmányelőzmény, illetve visszaállíthatók a frissítések kiesés után?
  • Korlátok: Milyen kérési, regisztrációs, párhuzamossági vagy payloadkorlátok érvényesek?

Úgy tervezze meg integrációját, hogy elviselje az újrapróbálkozásokat és a későn érkező eseményeket. Tartósan tárolja az eseményeket, akadályozza meg a duplikált ügyfélüzeneteket, és ne cseréljen le egy teljesített kézbesítési állapotot régebbi úton lévő eseményre csak azért, mert az később érkezett.

Tesztelje a szállítmányregisztráció hibáit is. Az érvénytelen számnak, a nem támogatott szolgáltatásnak vagy a nem egyértelmű fuvarozói találatnak látható kivételsorba kell kerülnie, nem pedig eltűnnie a követési lefedettségből.

Az éles ügyféladatok elküldése előtt vizsgálja felül az adatvédelmet

A követési adatok személyes adatnak minősülhetnek, ha azonosítható személyhez kapcsolódnak. A GDPR alapján a vonatkozó kötelezettségek közé tartozhat az adatminimalizálás, a tárolás korlátozása, a megfelelő biztonság, az adatfeldolgozói megállapodások és a nemzetközi adattovábbítások biztosítékai. A pontos felelősségek attól függnek, hogyan van konfigurálva a szolgáltatás, és milyen szerepet töltenek be a felek.

A hivatalos GDPR-szöveg biztosítja a jogi hivatkozást, beleértve az 5., 28. és 32. cikket, valamint az V. fejezetet. A szolgáltatói nyilatkozatokat tekintse a felülvizsgálat kiindulópontjának, ne pedig a tervezett adatkezelési megállapodás ellenőrzésének helyettesítőjeként.

  • Azonosítsa, mely mezőket igényli az integráció, és ne küldjön nevet, címet vagy elérhetőséget, kivéve, ha az a kívánt funkcióhoz szükséges.
  • Kérje a vonatkozó adatfeldolgozási megállapodást, és tisztázza az adatkezelői és adatfeldolgozói szerepeket.
  • Ellenőrizze a tárhelyek helyét, az alfeldolgozókat és a releváns nemzetközi adattovábbítási megállapodásokat.
  • Erősítse meg a megőrzési, törlési, hozzáférés-vezérlési és incidensértesítési eljárásokat.
  • Az API-hitelesítő adatokat és a szükségtelen személyes információkat tartsa távol az alkalmazásnaplóktól.

Ne feltételezze, hogy a franciaországi kézbesítési követelmény automatikusan azt jelenti, hogy minden adatkezelési tevékenységnek Franciaországban kell történnie. Ugyanígy ne feltételezze, hogy egy uniós tárhelyre vonatkozó állítás minden megfelelőségi kérdést megold. A jóváhagyás előtt vonja be adatvédelmi vagy jogi csapatát.

Hasonlítsa össze a számlázási egységet a szállítmány életciklusával

Valós forgalmi mintája alapján kérjen ajánlatot. A „követésenkénti” díj addig nem elég pontos, amíg a szolgáltató nem magyarázza el, mi számít számlázható egységnek.

Kérdezze meg, hogyan kezeli a szerződés a regisztrációkat, az ismételt lekérdezéseket, a duplikált beküldéseket, a sikertelen regisztrációkat, a visszaküldéseket és a hosszú ideig aktív szállítmányokat. Erősítse meg, hogy az értesítések, az előzményekhez való hozzáférés, a támogatás vagy a további környezetek befolyásolják-e az árat. Ezek beszerzési kérdések, nem pedig egy adott szolgáltató díjmodelljére vonatkozó feltételezések.

Modellezze a szokásos keresletet és a várható csúcsidőszakot is. Az előfizetési vagy használati díjak mellett vegye figyelembe a fejlesztési karbantartást és a támogatási terhelést. Az alacsonyabb listaár nem feltétlenül jelent alacsonyabb üzemeltetési költséget, ha csapatának gyakori eltéréseket kell manuálisan rendeznie.

Az elfogadott korlátokat és számlázási definíciókat írásban rögzítse. Ha a nyilvános dokumentáció nem tisztáz egy követelményt, jegyezze fel megerősítést igénylő tételként, ne pedig nem támogatott képességként kezelje.

Futtasson olyan pilotot, amely egyértelmű döntést tesz lehetővé

Használjon reprezentatív, valós szállítmánykészletet az adatvédelmi ellenőrzések betartásával. Tartalmazzon szokásos sikeres és nehéz eseteket: késedelmes szkenneléseket, átvételi pontra történő kézbesítést, sikertelen kísérleteket, nemzetközi átadásokat, visszaküldéseket és nemrég létrehozott címkéket fizikai átvételi szkennelés nélkül.

  1. Készítsen referencia-nyilvántartást. Mentse el a releváns fuvarozói követési előzményeket és a megfigyelési időpontokat. A fuvarozó oldala hasznos referencia, bár saját közzétételi időzítése eltérhet más csatornákétól.
  2. Kapcsolja össze a kívánt folyamatot. Tesztelje a regisztrációt, az események fogadását, a tárolást, az állapottérképezést és az értesítéseket – ne csak a konzolban megjelenő mintaválaszokat.
  3. Mérje a meghatározott eredményeket. Kövesse a használható követési eredményeket, az állapottérképezés pontosságát, a megfigyelt frissítési késedelmet és a manuális beavatkozásokat. Minden mérőszámhoz határozza meg a nevezőt.
  4. Szimulálja a hibákat. Ideiglenesen szakítsa meg a fogadót, játsszon vissza egy eseményt, küldjön be érvénytelen számot, és teszteljen ellenőrzött forgalmi kiugrást az elfogadott korlátokon belül.
  5. Vizsgálja felül az eltéréseket. Különítse el a fuvarozói közzétételi hiányosságokat, a szolgáltató lekérési problémáit és a saját feldolgozási hibáit.
  6. Írásos kritériumok alapján hagyja jóvá. A fejlesztési, operációs és adatvédelmi felelősök külön-külön hagyják jóvá a saját követelményeiket.

A pilot előtt állítson be számszerű küszöbértékeket a szolgáltatási igényei alapján. Nincs minden kereskedő számára univerzálisan elfogadható késés vagy sikerességi arány. Egy támogatási irányítópult és egy időérzékeny átvételi emlékeztető eltérő szabványokat igényelhet.

Olyan API-t válasszon, amely elfogadható költség és karbantartási ráfordítás mellett teljesíti a legnagyobb volumenű és legnagyobb kockázatú folyamatait. Ha egyik lehetőség sem felel meg, szűkítse a bevezetést ellenőrzött szolgáltatásokra, vagy tartson fenn külön integrációt a problémás fuvarozóhoz. Az ellenőrzött részleges indulás jobb, mint a megbízhatatlan kézbesítési információ teljes lefedettségként való bemutatása.

GYIK

El tud kezelni egyetlen követési API minden Franciaországba irányuló kézbesítést?

Ne feltételezze. Erősítse meg az Ön által használt pontos fuvarozókat, szolgáltatásokat, célállomásokat és átadási mintákat. Még ha egy fuvarozat szerepel is a listán, tesztelje az ügyfél- és támogatási folyamataihoz szükséges eseményrészletességet.

Vásárol címkéket vagy szervez kézbesítést egy követési API?

Nem feltétlenül. A követés, a címkelétrehozás, a szállítmányfoglalás, a címellenőrzés és a kézbesítési dátum előrejelzése különálló funkciók. Csak szükség esetén vegye fel ezeket a követelmények közé, és mindegyiket külön ellenőrizze.

Webhookokat használjunk lekérdezés helyett?

A webhookok hasznosak lehetnek a frissítések fogadására anélkül, hogy minden szállítmányt ismételten lekérdezne. A megvalósításnak továbbra is kezelnie kell a hitelesítést, a duplikátumokat, az újrapróbálkozásokat és a helyreállítási útvonalat. Erősítse meg, hogy egy lekérdezési végpont vagy más mechanizmus pótolhatja-e a kiesés utáni hiányokat.

Ígérhetünk kézbesítési dátumot a követési események alapján?

Csak akkor, ha megfelelő forrással rendelkezik az adott dátumhoz, és érti annak jelentését. A becsült kézbesítési dátum nem jelent automatikusan garantált vállalást. Különböztesse meg a fuvarozói becsléseket, a szolgáltató által generált előrejelzéseket és az alkalmazása által számított dátumokat.

Mit tegyünk, ha az API és a fuvarozó webhelye eltérő adatokat mutat?

Hasonlítsa össze az esemény szövegét, az esemény idejét, a lekérés idejét, a fuvarozó személyét és a nyomkövetési számot. Őrizze meg mindkét rekordot, és vizsgálja meg, hogy az eltérés közzétételi időzítésből, állapottérképezésből, átadásból vagy helytelen találatból ered-e. Egyetlen eltérés alapján ne vonjon le következtetést az egész szolgáltatóról.

Források

  • 17TRACK Tracking API – hivatalos termékoldal az útmutatóban tárgyalt API-lehetőség értékeléséhez.
  • 17TRACK API documentation – hivatalos műszaki referencia az integrációs követelmények és a támogatott működés ellenőrzéséhez a megvalósítás előtt.
  • Regulation (EU) 2016/679, General Data Protection Regulation – elsődleges jogi hivatkozás a fent tárgyalt adatvédelmi alapelvekhez, adatfeldolgozói kötelezettségekhez, biztonsági követelményekhez és nemzetközi adattovábbítási kerethez.