Skip to main content
KezdőlapBlogÚtmutatókHogyan használhatják a tengerentúli raktárak a nyomkövetési API-kat a helyi kézbesítések nyomon követésére

Hogyan használhatják a tengerentúli raktárak a nyomkövetési API-kat a helyi kézbesítések nyomon követésére

17TRACK

A tengerentúli raktárak nyomkövetési API-k segítségével figyelhetik a helyi kézbesítéseket: minden feladott csomagot összekapcsolnak a fuvarozójával és a nyomkövetési számával, a nyomkövetési eseményeket betöltik a raktár- vagy rendeléskezelő rendszerükbe, a kézbesítési kivételekből pedig kiosztott feladatokat hoznak létre. A leghasznosabb beállítás külön kezeli a címke létrehozását és a fuvarozói átvételt, megőrzi a szállítási előzményeket, és azt jelzi az operatív csapatoknak, mely csomagok igényelnek intézkedést – nem csupán azt, hogy mely csomagokhoz érkezett új állapot.

Hogyan használhatják a tengerentúli raktárak a nyomkövetési API-kat a helyi kézbesítések figyelésére

Ez az útmutató azokra a raktárakra összpontosít, amelyek a kereskedő hazai piacán kívül tárolnak készletet, és a célpiacon található ügyfeleknek adnak fel rendeléseket. Ezeknek a csapatoknak a tengerentúli nyomkövetésnek össze kell kapcsolnia a raktári feladási nyilvántartásokat a helyi fuvarozó kézbesítési folyamatával. Ez a kapcsolat lehetővé teszi, hogy a raktárvezetők, a szállítási koordinátorok és a kereskedői támogatási csapatok ugyanazon szállítási rekord alapján dolgozzanak.

Határozza meg, hol ér véget a raktári láthatóság, és hol kezdődik a fuvarozói láthatóság

A raktárkezelő rendszer rögzítheti, hogy egy rendelést összeszedtek, becsomagoltak, felcímkéztek és egy feladási területre helyeztek. Ezek a rekordok önmagukban nem bizonyítják, hogy a fuvarozó átvette a csomagot. A nyomkövetési API fuvarozó által jelentett eseményeket ad hozzá, de nem helyettesítheti a raktári átadási rekordot, és nem hozhat létre olyan fizikai szkennelést, amely soha nem történt meg.

Tartson külön három mérföldkövet: begyűjtésre kész, a raktári nyilvántartás szerint átadva, valamint a fuvarozó nyomkövetési eseményei szerint átvéve. Ez a szétválasztás megkönnyíti azoknak a csomagoknak a kivizsgálását, amelyek belsőleg feladottként jelennek meg, de a fuvarozónál nem mutatnak mozgást.

Ha például egy csomag szerepel a begyűjtési jegyzéken, de nincs átvételi eseménye, a következő lépés a rakodási nyilvántartások ellenőrzése és a begyűjtést végző fuvarozó megkeresése. Korai lenne elveszettként minősíteni a csomagot. Ha a fuvarozó már sikertelen kézbesítési kísérletet jelentett, más intézkedés szükséges: vizsgálja ki az okot, és egyeztessen a következő lépésről a kereskedővel vagy a jogosult címzett kapcsolattartójával.

Építse fel a szállítási rekordot az API csatlakoztatása előtt

Az alap egy megbízható kapcsolat az ügyfél rendelése, a fizikai csomag és a fuvarozói nyomkövetési azonosító között. Ne használja a rendelési számot a csomagazonosító helyettesítőjeként. Egy rendelés több csomagban is elhagyhatja a raktárt, a pótszállítmánynak pedig saját rekordra van szüksége.

RekordJavasolt mezőkOperatív cél
Szállítási azonosításBelső szállítási azonosító, rendelési azonosító, csomagazonosító, kereskedői fiókA részszállítmányok és a különböző ügyfelek elkülönítése.
Fuvarozói azonosításFuvarozói azonosító, nyomkövetési szám, szolgáltatás, ha ismertA megfelelő nyomkövetési kérés elküldése és a kivizsgálások irányítása.
Raktári átadásRaktár, feladási idő, begyűjtési hivatkozás, jegyzékhivatkozásA fizikai feladás bizonyítékainak összevetése a fuvarozói eseményekkel.
Nyomkövetési előzményekNyers esemény, leképezett állapot, esemény ideje, átvétel ideje, helyszín, ha rendelkezésre állA bizonyítékok megőrzése és az esemény időzítésének elkülönítése a jelentési késésektől.
Kivételkezelési folyamatProblématípus, felelős, következő intézkedés, felülvizsgálati határidő, megoldásA nyomkövetési információ felelőshöz rendelt munkává alakítása.

A nyomkövetési számokat szövegként tárolja, hogy a formázás megmaradjon. Ha a raktár már a címke létrehozásakor ismeri a fuvarozót, ezt az azonosítót adja tovább az integráción keresztül, ahelyett hogy kizárólag a számazonosításra hagyatkozna. Őrizze meg az eredeti, pótló, visszaküldési és továbbkézbesítési csomagok közötti kapcsolatokat is anélkül, hogy felülírná az egyes csomagok előzményeit.

Válasszon a raktár fuvarozói összetételéhez illő integrációt

A raktár közvetlenül integrálódhat fuvarozóival, vagy használhat többfuvarozós nyomkövetési API-t. A közvetlen integráció praktikus lehet egy stabil, kevés fuvarozót használó működés esetén, különösen akkor, ha fuvarozóspecifikus adatokra van szükség. Többfuvarozós API-t akkor érdemes mérlegelni, ha a raktárnak több kézbesítési hálózaton átívelő, közös nyomkövetési felületre van szüksége.

A 17TRACK Tracking API releváns lehetőség ehhez az integrációs modellhez. A hivatalos API-dokumentáció segítségével értékelje, hogyan illeszkedne a szállítmányok regisztrációja, a nyomkövetési adatok lekérése és a nyomkövetési frissítések fogadása a rendszerébe. Erősítse meg az egyes raktárak által használt pontos fuvarozó- és szolgáltatáskombinációkat, ahelyett hogy az általános fuvarozói elérhetőséget annak bizonyítékaként kezelné, hogy minden szükséges esemény visszaérkezik.

Értékelje a kapcsolatot a tényleges operatív követelmények alapján:

  • Rendszere megbízhatóan tudja regisztrálni a feladási csúcsidőszakokban létrehozott csomagokat?
  • Mely eseményeket küldik vissza az Ön által ténylegesen igénybe vett helyi kézbesítési szolgáltatások?
  • Hogyan kezeli a rendszer a sikertelen kéréseket, a duplikált regisztrációkat és az érvénytelen fuvarozói azonosítókat?
  • Hogyan kézbesíti vagy kéri le a rendszer a frissítéseket, és hogyan egyeztethetők a kimaradt frissítések?
  • Milyen használati korlátok, megőrzési feltételek, biztonsági ellenőrzések és kereskedelmi feltételek vonatkoznak a fiókra?

Nem szabad feltételezni, hogy a nyomkövetési kapcsolat magában foglalja a címkevásárlást, a cím helyesbítését, a kézbesítés átütemezését vagy a kárigény benyújtását. Ezeket külön munkafolyamatként kezelje, kivéve, ha a vonatkozó termékdokumentáció kifejezetten mást erősít meg.

Kapcsolja össze a feladást, a nyomkövetési frissítéseket és a kivételkezelést

1. Regisztrálja a csomagokat ellenőrzött feladási mérföldkőnél

Válasszon következetes regisztrációs kiváltó eseményt, például a címke megerősítését vagy a feladás megerősítését. A címke létrehozásakor végzett regisztráció láthatóvá teheti a begyűjtésre váró csomagokat, de ehhez a törölt címkék kezelésére is szükség van. A kizárólag feladás után végzett regisztráció csökkenti a nem használt regisztrációkat, ugyanakkor elrejtheti a címke létrehozása és a fizikai átadás közötti időszakot.

Bármelyik kiváltó eseményt választja, mentse a regisztráció eredményét a csomaghoz. A sikertelen regisztrációknak újrapróbálási vagy javítási sorba kell kerülniük, nem pedig eltűnniük az alkalmazásnaplókban. Használjon stabil belső azonosítót annak megakadályozására, hogy az ismételt feldolgozás duplikált üzleti rekordokat hozzon létre.

2. Fogadja a frissítéseket anélkül, hogy az irányítópult lenne az elsődleges adatforrás

Az API dokumentált lehetőségeitől függően a frissítések lekérhetők kérésekkel, vagy webhook-értesítéseken keresztül fogadhatók. A webhook olyan üzenet, amelyet a szolgáltató frissítés esetén küld a rendszerének; a lekérdezés azt jelenti, hogy a rendszer kéri le az információt.

Webhook-alapú megvalósítások esetén ellenőrizze a bejövő üzeneteket a szolgáltató dokumentált hitelesítési módszerével. A fogadott üzeneteket tartósan mentse el a visszaigazolás előtt, majd dolgozza fel őket aszinkron módon. Készüljön fel a duplikált üzenetekre és a sorrenden kívül érkező eseményekre. Kövesse a dokumentált válasz- és újrapróbálási követelményeket, ahelyett hogy feltételezné, hogy minden szolgáltató azonosan működik.

Lekérdezés esetén részesítse előnyben az aktív szállítmányokat és a megoldatlan kivételeket, miközben betartja az alkalmazandó használati korlátokat. Ha támogatott, használjon egyeztetési kéréseket azoknak a szállítmányoknak az ellenőrzésére, amelyek frissítési előzményei hiányosnak tűnnek. A betöltési hibákat külön rögzítse a fuvarozói kézbesítési kivételektől: a megszakadt kapcsolat nem bizonyítja, hogy a csomag mozgása leállt.

3. Normalizálja az állapotokat az eredeti bizonyíték megőrzése mellett

Hozzon létre néhány operatív kategóriát, például átvételre vár, úton van, kézbesítés alatt, kézbesítési kísérlet történt, kézbesítve és visszaküldés folyamatban. Ezek javasolt raktári kategóriák, nem pedig annak ígérete, hogy minden fuvarozó megfelelő eseményeket biztosít.

Őrizze meg az eredeti leírást a leképezett kategória mellett. A „Begyűjtésre elérhető” állapot nem válhat észrevétlenül „kézbesítve” állapottá, és a „Visszaküldés kezdeményezve” nem válhat „visszaérkezett a raktárba” állapottá. Engedélyezzen ismeretlen vagy le nem képezett állapotot, hogy az ismeretlen események láthatók maradjanak felülvizsgálatra.

Tárolja mind az esemény időbélyegét, mind azt az időpontot, amikor a rendszer fogadta azt. Ha rendelkezésre áll, őrizze meg az eredeti időzónát vagy eltolást, és használjon egységes belső időszabványt. A későn érkező esemény nem mozgathatja automatikusan visszafelé a szállítmányt csupán azért, mert utolsóként érkezett; alkalmazzon kifejezett sorrendezési szabályokat, és őrizze meg az előzményeket.

4. Rendeljen felelősöket a kivételekhez

Egy riasztás csak akkor hasznos, ha valaki intézkedni tud róla. A hiányzó átvételi szkenneléseket irányítsa a raktári feladási csapathoz, a címzett közreműködését igénylő kézbesítési kísérleteket a kereskedő támogatási csapatához, a tartós fuvarozói mozgási problémákat pedig a szállítási koordinátorhoz. Ezek ajánlott kiindulópontok; a felelősségeket a raktár szerződéseihez és működési modelljéhez kell igazítani.

Minden esethez csatolja a nyomkövetési előzményeket, az átadási hivatkozást, az utolsó eseményt, a kivizsgálási jegyzeteket és a következő felülvizsgálat időpontját. Az ismétlődő riasztásokat ugyanazon nyitott probléma alatt csoportosítsa, hogy egy elakadt csomag ne hozzon létre új feladatot minden szinkronizálás után.

A riasztásokat a szolgáltatási elvárások, ne önkényes időzítők köré építse

Nincs olyan általános időintervallum, amely után egy új szkennelés nélküli csomag késedelmesnek vagy elveszettnek minősül. A riasztási küszöbértékeket a fuvarozói szolgáltatás, a begyűjtési ütemezés, a munkanapok, a célállomás és a kereskedői vállalás alapján állítsa be. A belső kivizsgálási küszöböt különítse el az ügyfél felé tett kézbesítési ígérettől.

  • Nincs átvétel az átadás után: A továbbítás előtt ellenőrizze a begyűjtési rekordot és a fuvarozói visszaigazolást.
  • A várható időintervallumon túl nincs mozgás: Tekintse át az utolsó eseményt, a szolgáltatási elvárásokat és az ismert működési fennakadásokat.
  • Sikertelen kézbesítési kísérlet: A következő intézkedés meghatározása előtt olvassa el az okot, és döntse el, hogy az a fuvarozóhoz, a kereskedőhöz vagy a címzetthez tartozik-e.
  • Visszaküldés folyamatban: Készítse elő a visszaküldési folyamatot, de ne növelje az értékesíthető készletet a fizikai átvétel és a szükséges ellenőrzés előtt.
  • Kézbesítve, de vitatott: Indítson kivizsgálást, és kérje be a rendelkezésre álló kézbesítési bizonyítékokat; önmagában az állapotot ne tekintse a panasz megoldásának.

A nyomkövetés a jelentett szállítási eseményeket tükrözi, nem a csomag folyamatos helyzetét. Az utolsó frissítés időbélyegének megjelenítése segít a munkatársaknak megérteni az információ aktualitását anélkül, hogy élő GPS-láthatóságot sugallna.

Biztosítson minden csapat számára használható nézetet

A raktári felügyelőknek a feladástól az átvételig felmerülő kivételekre van szükségük. A szállítási koordinátoroknak fuvarozóspecifikus sorokra és korosodó esetekre van szükségük. A kereskedői támogatási csapatoknak egyértelmű szállítási idővonalra és a következő egyeztetett intézkedésre van szükségük. Egy közös adatmodell támogathatja ezeket a nézeteket anélkül, hogy minden felhasználó hozzáférést kapna minden kereskedő szállítmányaihoz.

Több ügyfelet kiszolgáló raktár esetén a kereskedői szintű hozzáférést a szerveren érvényesítse, ne csak az irányítópult szűrőivel. Az API-hitelesítő adatokat tartsa távol a böngészőkódoktól, korlátozza a címzetti információkhoz való hozzáférést, és határozza meg a megőrzési és törlési szabályokat. Kerülje a szükségtelen személyes adatok elhelyezését a nyomkövetési hivatkozásokban vagy diagnosztikai naplókban.

Hasznos mérőszámok a nyomkövetéshez sikeresen regisztrált feladott csomagok aránya, a fuvarozói átvételi eseménnyel rendelkező csomagok aránya, a feladástól az átvételig eltelt idő, a megoldatlan kivételek kora és az integráció feldolgozási hibái. Határozza meg minden nevezőt és időalapot. A pontos kézbesítés mérésekor dokumentált ígérethez vagy szolgáltatási vállaláshoz hasonlítsa az eredményt, ne általános kézbesítési időtartamhoz.

A folyamat bővítése előtt végezzen pilotot

Kezdje egy egyértelműen meghatározott raktárral, fuvarozói körrel és kereskedői csoporttal. A szokásos kézbesítések mellett vegyen fel nehéz eseteket is: törölt címkéket, részrendeléseket, hiányzó első szkenneléseket, sikertelen kézbesítési kísérleteket, duplikált értesítéseket, sorrenden kívüli eseményeket és visszaküldéseket. Ahol megfelelő, használjon engedélyezett tesztadatokat vagy korábbi rekordokat; éles környezetben ne találjon ki fuvarozói eseményeket.

A bevezetés előtt állapodjon meg az elfogadási feltételekről. Minden feladott csomagnak vagy sikeres regisztrációs rekorddal, vagy felelős által kezelt hibás esettel kell rendelkeznie. Az újrajátszott üzenetek nem hozhatnak létre duplikált feladatokat. A nyomkövetési eseményeknek visszakövethetőnek kell maradniuk a forrásukig, és a felhasználók nem láthatják más kereskedő rekordjait.

Csak akkor bővítse a rendszert, ha az operatív munkatársak megbízhatóan tudják kezelni a kivételsort, a műszaki munkatársak pedig helyre tudják állítani a sikertelen frissítéseket. A gyakorlati cél nem egy állapotokkal teli irányítópult. Hanem egy visszakövethető kapcsolat a raktári feladástól a fuvarozói kézbesítésig, világos felelősséggel minden olyan esetben, amikor ez az út figyelmet igényel.

GYIK

Helyettesítheti-e a nyomkövetési API a raktárkezelő rendszert?

Nem. A nyomkövetési API láthatóságot biztosít a szállítmányokhoz. A raktárrendszer továbbra is felelős az olyan tevékenységekért, mint a készletkezelés, az összeszedés, a csomagolás és a fizikai feladási rekordok. A kettőt csomagazonosítókon keresztül kapcsolja össze, hogy a fuvarozói események további kontextust adjanak a raktári bizonyítékok helyettesítése nélkül.

Biztosít-e a nyomkövetési API valós idejű GPS-helyzetet?

Ne feltételezze automatikusan. A csomagkövetés jellemzően jelentett eseményekből és helyszínekből áll. A frissítések időzítése a fuvarozótól és az integrációtól függ. A jármű vagy a csomag folyamatos helyzetéhez külön ellenőrzött képesség szükséges.

Mit tegyenek a munkatársak, ha egy csomaghoz nem érkeznek nyomkövetési frissítések?

Először ellenőrizzék a regisztráció sikerességét, a fuvarozó személyét és a nyomkövetési szám pontosságát. Ezután vessék össze az utolsó eseményt a raktári átadás bizonyítékaival és a várt szolgáltatási idővonallal. A továbblépésért felelős csapat meghatározása előtt külön vizsgálják ki az integrációs hibákat és a hiányzó fuvarozói szkenneléseket.

Kiválthatják-e a nyomkövetési események automatikusan a visszatérítést vagy a készletfrissítést?

Tájékoztathatnak egy munkafolyamatot, de a jelentős következményekkel járó intézkedésekhez további ellenőrzések szükségesek. Egy kézbesítési kivétel nem feltétlenül igazolja a visszatérítésre való jogosultságot, és a visszaküldés folyamata nem bizonyítja a fizikai raktári átvételt. A pénz- vagy készletnyilvántartás módosítása előtt alkalmazza a kereskedői szabályzatokat, a jogosultsági ellenőrzéseket és az átvételi eljárásokat.

Hogyan jelenjenek meg a részrendelések a kereskedői támogatási csapatok számára?

Minden csomagot külön jelenítsen meg a szülőrendelés alatt. Egy csomag kézbesítése ne jelölje teljesítettként a teljes rendelést, ha egy másik csomag még úton van. A pótló és visszaküldési szállítmányokat kapcsolja össze, de tartsa őket megkülönböztethetően.

Források

  • 17TRACK Tracking API — a nyomkövetési API-integrációs lehetőség hivatalos termékreferenciája.
  • 17TRACK API Documentation — műszaki referencia a regisztráció, a nyomkövetési kérések, a frissítések kezelése és a megvalósítási követelmények ellenőrzéséhez. Az útmutatóban szereplő operatív munkafolyamatok és riasztási szabályok ajánlások, nem pedig a szolgáltató vagy a fuvarozók működésére vonatkozó garanciák.