Hogyan követhetik nyomon az előfizetéses e-kereskedelmi márkák az ismétlődő szállítmányokat egy nyomkövetési API segítségével
Az ismétlődő szállítmányok nyomon követéséhez tracking API-val hozzon létre egy szállítmányrekordot minden fizikai csomaghoz, kapcsolja azt az adott előfizetési ciklus teljesítési rendeléséhez, és regisztrálja a nyomkövetési számát, amikor a raktár vagy a teljesítési partner megadja azt. Az API nyomonkövetési frissítéseivel jelenítse meg az ügyfeleknek, hol található a csomag, és jelölje a kézbesítési kivételeket a csapata számára. Az előfizetés azonosítóját ciklusokon átívelő hivatkozásként használja, ne egy csomag azonosítójaként.

A csomagot kövesse nyomon, ne az előfizetést
Az előfizetés azt mutatja meg, hogy az ügyfél mit fog ütemezetten megkapni egy időszak alatt. A teljesítési rendelés azt mutatja meg, hogy egy adott ciklusban minek kell kiszállításra kerülnie. A nyomkövetési szám egy konkrét csomagról ad információt. E rekordok elkülönítése megakadályozza, hogy az egyik ciklus késedelmes szállítmánya a következő ciklus nyomkövetési oldalán jelenjen meg.
Tegyük fel például, hogy egy májusi előfizetéses dobozt két csomagra osztanak, és a júniusi dobozt akkor szállítják ki, amikor az egyik májusi csomag még úton van. Az ügyfélnek két csomagot kell látnia a májusi rendelés alatt, valamint egy külön csomagot a júniusi rendelés alatt. A májusi késedelmes frissítés csak a májusi csomagot módosíthatja. Ha csereterméket küld, hozzon létre új szállítmányrekordot, és kapcsolja az eredetihez, hogy az ügyfélszolgálat lássa, miért létezik mindkettő.
- Előfizetés: Tárolja az előfizetés azonosítóját, hogy az ügyfélszolgálat megtalálhassa az ügyfél szállítási előzményeit.
- Ciklus és rendelés: Rögzítse a ciklus azonosítóját vagy az ütemezett teljesítési dátumot, a rendelés azonosítóját és minden olyan teljesítési azonosítót, amely szükséges a csomagok megfelelő rendeléshez való hozzárendeléséhez. Ne következtesse ki a ciklust abból a dátumból, amikor egy nyomkövetési esemény beérkezik.
- Szállítmány: Adjon minden csomagnak belső szállítmányazonosítót. Tárolja a fuvarozót és a nyomkövetési számot, a kapcsolódó teljesítési hivatkozást, valamint a szolgáltató által visszaadott nyomkövetési regisztrációs azonosítót. A törölt címkéket és a lecserélt nyomkövetési számokat ne jelenítse meg az ügyfelek aktív nézetében, de az előzményeket tartsa meg az ügyfélszolgálat számára.
Egy rendelés oldalán a csomagszintű előrehaladást jelenítse meg a rendelés összegzése mellett. Ha az egyik csomagot kézbesítették, a másik pedig úton van, ezt egyértelműen jelezze. A teljes rendelést csak akkor jelölje kézbesítettként, amikor a teljesítéséhez szükséges összes csomag megérkezett, figyelembe véve a törölt szállítmányokat és a cseréket is.
A teljesítési folyamat összekapcsolása a tracking API-val
- Regisztráljon teljesítési eseményből. Akkor indítsa el a regisztrációt, amikor egy teljesítési rendszer, raktár vagy külső logisztikai partner elküldi a fuvarozót és a nyomkövetési számot. A megújítási fizetés még túl korai: a rendelés továbbra is szállításra várhat, és lehet, hogy még nem létezik nyomkövetési szám.
- Mentse a szállítmányt az API-hívás előtt. Tartósan mentse a belső szállítmányrekordot, és helyezze sorba a regisztrációs kérelmet. Ha ugyanaz az üzenet kétszer érkezik meg, új csomag létrehozása helyett használja fel újra a rekordot. Ha az API-hívás időtúllépés miatt megszakad, újrapróbálkozás előtt ellenőrizze, hogy az eredeti kérelem sikeres volt-e, ha a szolgáltató erre lehetőséget biztosít.
- A frissítéseket a regisztrált csomaghoz rendelje. Használja a szolgáltató regisztrációs azonosítóját, ha az szerepel a frissítésekben. Ellenkező esetben a dokumentációban meghatározott azonosítók alapján végezze az egyeztetést, majd ellenőrizze az eredményt a szállítmányrekordjai alapján. Ha egy frissítés több rekordhoz is tartozhat, küldje felülvizsgálatra, ahelyett hogy a legutóbbi rendelésre alkalmazná.
- Válassza külön a címke létrehozását és a fuvarozó általi továbbítást. Nyomkövetési szám már azelőtt is létezhet, hogy a fuvarozó átvette volna a csomagot. Ha csak egy címke áll rendelkezésére, használjon olyan üzenetet, mint „Előkészítés a fuvarozói átvételre”. Az „Úton” állapotot csak akkor használja, ha azt fuvarozói információ is alátámasztja.
A 17TRACK Tracking API egy lehetőség ehhez a megoldáshoz. A fejlesztői dokumentáció szolgál referenciaként a nyomkövetési számok regisztrálásához és a nyomkövetési frissítések fogadásához. Ezekkel a frissítésekkel tartsa karban a rendszerében lévő csomagrekordot; a ciklushoz rendelést, a rendelés teljesítését és az ügyfélértesítési szabályokat az e-kereskedelmi alkalmazásban kezelje. Bevezetés előtt teszteljen a tényleges fuvarozói útvonalakról és teljesítési partnerektől származó csomagokkal, ne csupán egy fuvarozói listára hagyatkozzon.
Tegye biztonságossá a frissítések kétszeri feldolgozását
Ha a szolgáltató webhooks lehetőséget kínál, használja azt a frissítések fogadására ahelyett, hogy folyamatosan lekérdezné az összes csomagot. A webhook egy HTTP-kérés, amelyet a szolgáltató küld az alkalmazásának. Kövesse a szolgáltató ellenőrzési követelményeit, tartósan tárolja az elfogadott payloadokat, és a dokumentált válaszszabályok szerint nyugtázza a kéréseket. A lassabb műveleteket, például a rendelési nézetek frissítését vagy e-mailek küldését, a kéréskezelőn kívül futtassa.
Úgy alakítsa ki a feldolgozási folyamatot, hogy egy ismételt frissítésnek ne legyen további hatása. Ha a szolgáltató stabil eseményazonosítókat biztosít, használja ezeket az ismétlések felismerésére. Ha egyedi események helyett nyomkövetési pillanatképeket küld, a művelet előtt hasonlítsa össze a beérkező állapotot és a szkennelési előzményeket a már tárolt adatokkal. Az ügyfélüzeneteket külön deduplikálja: egy már elküldött kézbesítési értesítést ne küldjön újra csak azért, mert ugyanazt a szállítmányadatot kétszer dolgozták fel.
A szkennelés időpontját különítse el attól az időponttól, amikor az alkalmazása fogadta azt. Egy késve beérkező, úton lévő csomagról szóló szkennelés bekerülhet a csomag előzményeibe anélkül, hogy felülírná az újabb, kézbesített állapotot. Ne feltételezze azonban, hogy minden valós változás előreviszi a csomagot. Egy fuvarozói korrekció vagy a feladónak történő visszaküldésről szóló frissítés módosíthatja a megjelenítendő állapotot. Ha az új adatok ellentmondanak a tárolt állapotnak, és nem állapítható meg, melyik a helyes, helyezze a szállítmányt felülvizsgálati sorba.
Rendszeresen ellenőrizze azokat a nyitott szállítmányokat, amelyek figyelmet igényelhetnek: a még függőben lévő regisztrációkat, azokat a csomagokat, amelyeknél a várt átadás után nem történt első szkennelés, valamint azokat a szállítmányokat, amelyek nyomkövetése elcsendesedett. Ha az API támogat lekérdezést vagy frissítést, a szolgáltató korlátain belül, szelektíven használja ezeket. A súlyosbítás előtt vizsgálja meg a fuvarozók és raktárak közötti mintázatot. Ha sok, egymástól független szállítmány frissítése egyszerre leáll, vizsgálja ki az integrációt, mielőtt egyedi kézbesítési eseteket nyitna.
Alakítsa a nyomkövetési adatokat hasznos ügyfélüzenetekké
Az ügyfeleknek ritkán van szükségük minden egyes szkennelésről e-mailre. Kezdje olyan üzenetekkel, amelyek valami fontos tudnivalóhoz vagy teendőhöz kapcsolódnak: a csomag belépett a fuvarozó hálózatába, a kézbesítési kísérlet intézkedést igényel, vagy a fuvarozó kézbesítést jelentett. Jelenítse meg a rendelési hivatkozást és a kapcsolódó dobozt vagy ciklust, hogy az előfizetők megállapíthassák, melyik szállítmányról szól az üzenet. Megosztott rendelés esetén azonosítsa a csomagot, és tegye egyértelművé, hogy a rendelés többi része még úton van-e.
- Címke létrehozva, nincs szkennelés: Ellenőrizze a várt átadást a raktári nyilvántartások alapján. Ha az átadási időablak lejárt, kérje meg a teljesítési csapatot annak megerősítésére, hogy a csomag elhagyta-e a létesítményt, mielőtt közölné az ügyféllel, hogy a szállítmány késik.
- A nyomkövetés nem halad: Olyan küszöbértékeket használjon, amelyek az útvonalat és a szolgáltatást tükrözik, ne egyetlen időzítőt minden csomaghoz. Nemzetközi szállítmányok esetén vizsgálja meg az utolsó fuvarozói eseményt, mielőtt kapcsolatba lépne az ügyféllel vagy súlyosbítaná az esetet.
- Sikertelen kísérlet vagy átvétel szükséges: Mondja el az ügyfélnek, milyen intézkedés szükséges, ha a fuvarozó egyértelmű utasításokat ad. Ha az esemény homályos, irányítsa az esetet az ügyfélszolgálathoz ahelyett, hogy találgatna az újrakézbesítés dátumáról vagy az átvételi helyről.
- Kézbesítettként jelölve, de nem érkezett meg: Őrizze meg a fuvarozó által jelentett állapotot, és nyisson külön ügyfélszolgálati esetet. Az ügyfélszolgálati folyamatnak meg kell különböztetnie az ügyfél bejelentését a fuvarozói korrekciótól.
Biztosítson az ügyfélszolgálati munkatársaknak egyetlen nézetet a ciklusról, a rendelésről, a csomag előzményeiről és a már elküldött üzenetekről. Minden kivételhez rendeljen felelőst és következő lépést. A teljesítési csapat kivizsgálhat egy hiányzó átadást, a logisztika követheti a fuvarozói kivételt, az ügyfélszolgálat pedig kezelheti az ügyfélkommunikációt. A nyomkövetési állapot a csomagot írja le; nem dönti el, hogy jár-e csere vagy visszatérítés.
Tesztelje az átfedést a bevezetés előtt
Kezdje egy teljesítési partnerrel és olyan szállítmányokkal, amelyek tükrözik, hogyan adja fel ténylegesen a rendeléseket. Tartalmazzon több csomagot tartalmazó ciklust, érvénytelenített címkét, cserét, valamint egy régebbi, még nyitott szállítmányt, amikor a következő ciklust feladják. Ezután szándékosan játsszon vissza egy ismételt webhookot, majd egy újabb után kézbesítsen egy régebbi eseményt. Ellenőrizze a csomagrekordot, az ügyfél rendelési oldalát, az ügyfélszolgálati nézetet és az értesítési naplót. Egy kizárólag sikeres API-választ ellenőrző teszt nem feltétlenül fedezi fel a legköltségesebb hibát: a rossz rendelés frissítését vagy a rossz ügyfél értesítését.
Figyelje a regisztrációs hibákat, a sikeresen regisztrált jogosult csomagok arányát, a vártnál későbbi első szkenneléseket és az egyeztetetlen frissítéseket. Ha a frissítési késleltetést méri, különítse el a fuvarozói esemény és annak fogadása közötti időt attól az időtől, amelyet a saját rendszere a feldolgozásra fordít. Ez segít eldönteni, hogy egy fuvarozói adatfolyamot, a webhook-végpontot vagy az alkalmazáson belüli sort kell-e kivizsgálni.
Terjessze ki több útvonalra, amikor bármely csomag esetén meg tud válaszolni három kérdést: Melyik ciklushoz tartozik? Mit jelentett legutóbb a fuvarozó? Ki intézkedik, ha a frissítés hiányzik vagy hibás? Ha bármelyik válasz nem egyértelmű, javítsa a rekordok hozzárendelését vagy a kivételkezelési folyamatot, mielőtt további értesítési szabályokat adna hozzá.
GYIK
Meg tudja mondani egy tracking API az ügyfeleknek, mikor szállítják ki a következő előfizetéses dobozukat?
A következő tervezett feladási dátumhoz használja az előfizetési ütemezést és a teljesítési rendszert. A tracking API egy konkrét csomaghoz használható, miután rendelkezésre állnak a nyomkövetési adatok. A tervezett feladási dátum, a fuvarozó kézbesítési becslése és a megerősített kézbesítés különböző tények, ezért ezeket külön kell megjelölni.
Mi történik, ha a raktár lecseréli a nyomkövetési számot, miután egy e-mailt már elküldtek?
Jelölje a régi címkét lecseréltként, és kapcsolja az új nyomkövetési számot ugyanahhoz a rendeléshez. Ha az e-mail rendelési szintű nyomkövetési oldalra mutat, frissítse az oldalt, hogy az ügyfél az eredeti fuvarozói hivatkozás nélkül is megtalálja az aktív csomagot. Küldjön helyesbítést, ha a változás olyan információt érint, amely alapján az ügyfélnek intézkednie kell.
Mi történik, ha egy teljesítési partner fuvarozói kódok nélkül küldi el a nyomkövetési számokat?
Kérje meg a partnert, hogy adjon meg egységes fuvarozói mezőt vagy leképezést a szállítási szolgáltatáskódjaihoz. Ha az API fuvarozófelismerést kínál, ellenőrizze, hogyan működik a partner címkéivel, mielőtt támaszkodna rá. A kétértelmű egyezéseket küldje felülvizsgálatra, ahelyett hogy kizárólag a nyomkövetési szám alapján választana fuvarozót.
Szükségük van nyomkövetési rekordokra a szüneteltetett vagy kihagyott előfizetéseknek?
Nem szükséges csomagrekord ahhoz a ciklushoz, amelyet soha nem szállítanak ki. Ha egy korábbi szállítmány még nyitott, folytassa a nyomon követését akkor is, ha az előfizetést szüneteltetik, kihagyják vagy lemondják. Az előfizetés állapota a jövőbeli teljesítést szabályozza; nem mondja meg, mi történt egy olyan csomaggal, amely már elhagyta a raktárt.
Források
- 17TRACK Tracking API — termékáttekintés a csomagkövetés üzleti rendszerekbe történő integrálásához.
- 17TRACK Tracking API documentation — megvalósítási referencia a nyomkövetési számok regisztrálásához és a nyomkövetési adatok fogadásához.
- Stripe webhook documentation — referencia az általános webhook-gyakorlatokhoz, például az ismételt események kezeléséhez és a kézbesítési sorrendre vonatkozó feltételezések elkerüléséhez. Az ellenőrzéshez és a nyugtázáshoz kövesse saját nyomkövetési szolgáltatója szabályait.


