Môže sledovacie API fungovať bez prepravných štítkov? Sledovanie objednávok 3Pl a objednávok z online trhovísk?
Áno. Sledovacie API môže fungovať aj bez toho, aby vaša firma vytvárala prepravné štítky, pokiaľ prepravca alebo prepravný partner vytvoril sledovateľnú zásielku a vy môžete získať použiteľné sledovacie číslo alebo iný identifikátor podporovaný rozhraním API. Je to bežné v prípadoch, keď plnenie objednávok zabezpečuje poskytovateľ logistických služieb tretej strany (3PL) alebo trhovisko. Rozdiel spočíva medzi tým, že štítok nekupujete sami a tým, že vôbec nemáte identifikátor zásielky: prvá situácia je zvyčajne realizovateľná, zatiaľ čo v druhej nemusí mať API čo sledovať.

Pre predajcu, prevádzkovateľa trhoviska alebo integračný tím je praktickou úlohou prepojiť každú objednávku so zásielkou vytvorenou stranou, ktorá ju skutočne odosiela. To si vyžaduje prístup k správnym údajom, nie nevyhnutne kontrolu nad vytváraním štítkov.
Čo sledovacie API potrebuje, keď nevytvárate štítok
Prepravný štítok je jedným zo spôsobov vytvorenia identifikátora zásielky, no zvyčajne nejde o vstup, ktorý sledovacie API načítava. Sledovacie integrácie vo všeobecnosti pracujú s údajmi o zásielke dodanými po vytvorení štítku na inom mieste. Pred návrhom prepojenia oddeľte tri záznamy, ktoré sa často považujú za vzájomne zameniteľné:
- ID objednávky: Identifikuje nákup vo vašom obchode, účte na trhovisku alebo systéme správy objednávok. Môže zahŕňať viacero položiek a viacero zásielok.
- ID plnenia objednávky alebo balíka: Identifikuje úkon plnenia objednávky alebo balík v systéme 3PL či trhoviska. Jeho formát a význam závisia od daného systému.
- Sledovacie číslo prepravcu: Identifikuje zásielku na účely sledovania v závislosti od toho, či ho prepravca a sledovacia služba akceptujú.
Vaše interné ID objednávky vám pomáha nájsť správnu zákaznícku objednávku. Automaticky však nefunguje ako sledovacie číslo prepravcu. Bežný spôsob integrácie spočíva v získaní sledovacieho čísla od 3PL alebo trhoviska, registrácii či vyhľadaní tohto čísla prostredníctvom sledovacieho API a uložení vrátených informácií o zásielke k príslušnej objednávke alebo balíku.
Môže byť potrebný aj názov alebo kód prepravcu. Niektoré služby sa môžu pokúsiť prepravcu rozpoznať, no túto možnosť treba otestovať a nie považovať za samozrejmosť, najmä keď sa identifikátory prekrývajú medzi prepravcami alebo objednávka prechádza cez viacero doručovacích sietí. Pred implementáciou si v dokumentácii API overte podporované identifikátory, pravidlá výberu prepravcu, požiadavky na registráciu a stavové polia.
Sledovanie objednávok odoslaných prostredníctvom 3PL
Keď 3PL zabalí objednávku, kúpi štítok a odovzdá balík prepravcovi, vaša firma samotný štítok možno nikdy neuvidí. Stále však potrebujete údaje o zásielke, ktoré z tohto procesu vzniknú. Opýtajte sa 3PL, ktorý systém alebo dátový kanál poskytuje sledovacie čísla, informácie o prepravcovi, identifikátory balíkov a referenciu objednávky, ktorú ste zadali pri požiadavke na plnenie.
Funkčný proces 3PL zvyčajne vyzerá takto:
- Odošlite objednávku a stabilnú referenciu 3PL prostredníctvom existujúceho procesu plnenia.
- Prijmite potvrdenie plnenia obsahujúce sledovacie číslo na úrovni balíka a, ak je k dispozícii, aj prepravcu.
- Priraďte balík k správnej zákazníckej objednávke a položkám.
- Odošlite podporovaný identifikátor zásielky do sledovacieho API alebo použite predpísaný proces vyhľadávania v API.
- Zaznamenávajte aktualizácie sledovania k balíku a následne ich zobrazte na úrovni objednávky svojmu prevádzkovému tímu alebo zákazníkovi.
Kroku priraďovania treba venovať mimoriadnu pozornosť. Jedna objednávka môže opustiť sklad v dvoch kartónoch alebo môže byť jedna položka odoslaná neskôr než ostatné. V oboch prípadoch neexistuje jediný stav balíka, ktorý by presne opisoval celú objednávku. Uchovávajte záznamy na úrovni balíkov a všetky správy na úrovni objednávky z nich odvodzujte. Napríklad neoznačujte objednávku ako doručenú len preto, že bol doručený jej prvý balík.
Dohodnite sa s 3PL na spôsobe doručovania opráv. Štítky možno stornovať, balíky prebaľovať a pôvodné sledovacie číslo nahradiť. Integrácia musí byť schopná priradiť náhradné číslo k rovnakej objednávke bez toho, aby obe čísla naďalej zobrazovala ako aktívne zásielky.
Sledovanie objednávok z trhoviska, keď prepravu kontroluje trhovisko
Plnenie objednávok na trhovisku prináša podobnú technickú otázku, ale odlišnú otázku prístupu. Trhovisko alebo jeho partner pre plnenie môže vytvoriť štítok, no predajca môže dostať iba prepravné údaje, ktoré sprístupňuje jeho účet, proces objednávky alebo autorizovaná integrácia. Sledovacie API nedokáže nahradiť sledovacie číslo, ktoré vám trhovisko nesprístupnilo.
Začnite identifikáciou modelu plnenia pre každú objednávku. Pri objednávkach plnených predajcom môže byť zdrojom údajov o balíku váš vlastný proces prepravy alebo 3PL. Pri objednávkach plnených trhoviskom môže byť zdrojom informácií o zásielke samotné trhovisko a polia dostupné predajcovi sa môžu líšiť. Nepredpokladajte, že stránka objednávky zobrazujúca stav doručenia zároveň poskytuje sledovacie číslo prepravcu vhodné na registráciu v samostatnom API.
Ak trhovisko poskytuje sledovateľné číslo, overte, či máte povolenie načítať ho a používať v zamýšľanom systéme. Potom otestujte, či sledovacie API tento identifikátor akceptuje a či výsledné udalosti poskytujú užitočné informácie navyše oproti stavu na trhovisku. Ak trhovisko sprístupňuje iba vlastnú referenciu objednávky alebo doručenia, overte, či existuje výslovne podporovaný spôsob vyhľadávania. Neodosielajte interné ID objednávky trhoviska, akoby išlo o číslo prepravcu, a neočakávajte spoľahlivé výsledky.
Stav objednávky na trhovisku a stav zásielky v sledovacom API uchovávajte oddelene. Trhovisko môže objednávku označiť ako odoslanú po potvrdení plnenia, zatiaľ čo sledovanie prepravcu stále nemusí zobrazovať skenovanie pri prijatí. Tieto záznamy odpovedajú na odlišné otázky a môžu sa aktualizovať v rôznom čase.
Kedy sledovanie bez štítku problém nevyrieši
„Štítok sme nevytvorili my“ nie je prekážkou. Problémom však môžu byť tieto situácie:
- Zásielka nebola vytvorená: Kým plnenie nevygeneruje použiteľný identifikátor, nemusí existovať žiadna zásielka prepravcu, ktorú možno vyhľadať. Samotné potvrdenie objednávky nie je dôkazom, že je balík v preprave.
- Identifikátor vám nie je dostupný: 3PL alebo trhovisko môže číslo uchovávať bez toho, aby ho sprístupnilo prostredníctvom vášho autorizovaného procesu. Tento problém s prístupom k údajom vyriešte pri zdroji.
- Identifikátor nie je podporovaný: Referenčné číslo, kód určený iba pre trhovisko alebo nepodporovaný formát prepravcu nemusí s vybraným API fungovať. Overte podporované vstupy v dokumentácii a pomocou testovacej zásielky.
- Balík zatiaľ nemá nové skenovanie: Číslo môže existovať ešte predtým, než prepravca zaznamená udalosť prijatia. Prázdny alebo nezmenený výsledok považujte za stav, ktorý treba preskúmať, nie za automatický dôkaz neplatnosti čísla.
- Sledovanie je obmedzené alebo neúplné: Prepravca, služba alebo proces prepravy nemusia poskytovať udalosti potrebné pre váš zákaznícky scenár. Skutočnú kvalitu udalostí overte na reprezentatívnych zásielkach.
Tieto obmedzenia sú dôležité, pretože API nedokáže vytvoriť chýbajúce fyzické udalosti ani poskytnúť prístup k údajom o objednávkach inej strany. Jeho hodnota spočíva v načítaní a usporiadaní podporovaných informácií o sledovaní po získaní potrebného identifikátora a oprávnení.
Ako vyhodnotiť API pre tento proces
Sledovacie API od 17TRACK je relevantnou možnosťou na preskúmanie, keď váš tím potrebuje údaje o sledovaní zásielok vo vlastných systémoch, a nie nástroj na nákup štítkov. Dokumentácia pre vývojárov je miestom, kde si overíte akceptované registračné polia, podporovaných prepravcov, štruktúru odpovedí, autentifikáciu a dostupné spôsoby doručovania aktualizácií pre váš prípad použitia. Z existencie všeobecného sledovacieho API nevyvodzujte podporu konkrétneho 3PL, trhoviska alebo proprietárneho identifikátora.
Pred výberom alebo nasadením poskytovateľa vytvorte malú testovaciu skupinu. Zahrňte objednávku 3PL s číslom prepravcu, objednávku z trhoviska, pri ktorej váš účet sprístupňuje číslo, objednávku s viacerými balíkmi, číslo vytvorené pred prvým skenovaním a zásielku s neskoršou udalosťou doručenia. Ak sú náhrady alebo medzinárodné odovzdania bežné, zahrňte aj tie. Test by mal odpovedať na prevádzkové otázky, nielen na to, či požiadavka vráti úspešnú HTTP odpoveď:
- Dokážete odovzdať identifikátory, ktoré skutočne dostávate, bez ich manuálneho prepisovania?
- Dokážete spoľahlivo priradiť každý záznam sledovania k správnej objednávke a balíku?
- Sú opisy udalostí, časové pečiatky a informácie o prepravcovi dostatočné pre správy zákazníkom a pracovné postupy podpory?
- Ako bude váš systém spracúvať duplicitné aktualizácie, chýbajúce udalosti, zmeny čísel a neúspešné požiadavky?
- Je zamýšľané používanie údajov z trhoviska a údajov zákazníkov v súlade s podmienkami prístupu platnými pre tieto údaje?
Pri samotnej integrácii uchovávajte pôvodný zdrojový záznam aj záznam zo sledovacieho API. Ukladajte referenciu objednávky, referenciu balíka, odoslané sledovacie číslo, informácie o prepravcovi, ak sú dostupné, a čas prijatia každej aktualizácie. Uľahčí to skúmanie nesúladu bez toho, aby ste udalosť z API prezentovali ako úplnú históriu plnenia. Ak API ponúka voľbu medzi kontrolou podľa plánu a prijímaním aktualizácií prostredníctvom podporovaného mechanizmu doručovania, vyberte podľa zdokumentovaného správania a potreby včasných aktualizácií; ani jeden prístup neodstraňuje potrebu spracovania chýb.
Praktické rozhodnutie
Sledovacie API používajte bez vytvárania štítkov vtedy, keď balík odosiela iná strana a poskytne vám podporovaný identifikátor zásielky, ktorý máte oprávnenie používať. Najprv si zabezpečte spoľahlivý dátový kanál s údajmi o balíkoch od 3PL alebo trhoviska. Potom otestujte identifikátory a udalosti sledovania oproti API a logike priraďovania objednávok. Ak máte iba ID objednávky alebo stav na trhovisku, vyriešte túto medzeru v zdrojových údajoch ešte pred investovaním do integrácie sledovania prepravcu.
Často kladené otázky
Môžem sledovať objednávku iba pomocou čísla objednávky v mojom obchode?
Zvyčajne nie prostredníctvom API na sledovanie prepravcu. Číslo objednávky v obchode identifikuje nákup vo vašom systéme. Vo všeobecnosti potrebujete príslušný identifikátor zásielky, pokiaľ konkrétna služba výslovne nepodporuje vyhľadávanie podľa vášho typu referencie objednávky.
Potrebujem povolenie 3PL na používanie jeho sledovacích čísel?
Overte si zmluvný a technický prístup k údajom o zásielke. 3PL už môže vracať sledovacie čísla ako súčasť svojho dátového kanála plnenia, no integrácia by mala používať autorizovaný kanál a primerane spracúvať údaje zákazníkov.
Prečo API po odoslaní čísla zo strany 3PL nezobrazuje žiadny pohyb?
Číslo mohlo byť vytvorené pred prvým zaznamenaným skenovaním prepravcu. Skontrolujte, či sú identifikátor a prepravca správne, či bol pôvodný štítok nahradený a či neskoršie vyhľadávanie zobrazí udalosti. „Zatiaľ žiadne skenovanie“ nestotožňujte s „neodoslané“ bez kontroly záznamu o plnení.
Čo ak je jedna objednávka z trhoviska odoslaná vo viacerých balíkoch?
Každý dostupný identifikátor balíka sledujte samostatne a všetky balíky priraďte k rovnakej objednávke. Stav objednávky určený zákazníkovi uchovávajte oddelene od stavu jednotlivých balíkov, aby jeden doručený balík nespôsobil, že celá objednávka bude vyzerať ako dokončená.
Zdroje
- 17TRACK Tracking API — informácie o produkte na vyhodnotenie integrácie sledovania zásielok.
- 17TRACK API Documentation — technická referencia na overenie podporovaných vstupov a správania integrácie.


