Může Tracking API fungovat bez přepravních štítků? Sledování objednávek 3Pl a objednávek z marketplace?
Ano. Sledovací API může fungovat i bez toho, aby vaše firma vytvářela přepravní štítky, pokud přepravce nebo logistický partner vytvořil zásilku, kterou lze sledovat, a vy můžete získat použitelný sledovací kód nebo jiný identifikátor podporovaný daným API. To je běžné v případech, kdy fulfillment zajišťuje poskytovatel logistických služeb třetí strany (3PL) nebo marketplace. Rozdíl spočívá mezi tím, že štítek nekupujete sami a tím, že nemáte žádný identifikátor zásilky: první možnost je obvykle realizovatelná, zatímco druhá může znamenat, že API nemá co sledovat.

Pro prodejce, provozovatele marketplace nebo integrační tým spočívá praktický úkol v propojení každé objednávky se zásilkou vytvořenou stranou, která ji skutečně odesílá. To vyžaduje přístup ke správným údajům, nikoli nutně kontrolu nad vytvářením štítků.
Co sledovací API potřebuje, když štítek nevytváříte
Přepravní štítek je jedním ze způsobů, jak vytvořit identifikátor zásilky, ale obvykle nejde o vstup, který sledovací API používá. Integrace sledování obecně pracují s údaji o zásilce dodanými poté, co byl štítek vytvořen jinde. Před návrhem propojení rozlišujte tři záznamy, které se často považují za zaměnitelné:
- ID objednávky: Identifikuje nákup ve vašem obchodě, účtu na marketplace nebo systému pro správu objednávek. Může zahrnovat několik položek a několik zásilek.
- ID fulfillmentu nebo balíku: Identifikuje úkon fulfillmentu nebo zásilku v systému 3PL či marketplace. Jeho formát a význam závisí na daném systému.
- Sledovací číslo přepravce: Identifikuje zásilku pro účely sledování, pokud jej přepravce a sledovací služba přijímají.
Interní ID objednávky vám pomáhá najít správnou zákaznickou objednávku. Automaticky však nefunguje jako sledovací číslo přepravce. Obvyklý způsob integrace spočívá v získání sledovacího čísla od 3PL nebo marketplace, registraci či vyhledání tohoto čísla prostřednictvím sledovacího API a uložení vrácených informací o zásilce k příslušné objednávce nebo balíku.
Může být potřeba také název nebo kód přepravce. Některé služby se mohou pokusit přepravce rozpoznat automaticky, ale je třeba to otestovat, nikoli předpokládat, zejména když se identifikátory mezi přepravci překrývají nebo objednávka prochází několika doručovacími sítěmi. Před zahájením implementace si v dokumentaci API ověřte podporované identifikátory, pravidla výběru přepravce, požadavky na registraci a stavová pole.
Sledování objednávek odesílaných prostřednictvím 3PL
Když 3PL zabalí objednávku, zakoupí štítek a předá zásilku přepravci, vaše firma samotný štítek možná nikdy neuvidí. Stále však potřebujete údaje o zásilce, které z tohoto procesu vzniknou. Zeptejte se 3PL, který systém nebo datový kanál poskytuje sledovací čísla, informace o přepravci, identifikátory balíků a referenci objednávky, kterou jste zadali při požadavku na fulfillment.
Praktický tok u 3PL obvykle vypadá takto:
- Odešlete objednávku a stabilní referenci 3PL prostřednictvím stávajícího procesu fulfillmentu.
- Obdržíte potvrzení fulfillmentu obsahující sledovací číslo na úrovni balíku a případně také přepravce.
- Propojíte balík se správnou objednávkou zákazníka a jejími položkami.
- Předáte podporovaný identifikátor zásilky sledovacímu API nebo použijete předepsaný proces vyhledávání API.
- Uložíte aktualizace sledování k balíku a následně zobrazíte přehled na úrovni objednávky svému provoznímu týmu nebo zákazníkovi.
Kroku párování je třeba věnovat zvláštní pozornost. Jedna objednávka může opustit sklad ve dvou kartonech nebo může být jedna položka odeslána později než ostatní. V obou případech neexistuje jediný stav balíku, který by přesně popisoval celou objednávku. Uchovávejte záznamy na úrovni balíků a případné sdělení na úrovni objednávky z nich odvozujte. Například neoznačujte objednávku jako doručenou jen proto, že byl doručen její první balík.
S 3PL se dohodněte, jak budou předávány opravy. Štítky lze stornovat, balíky přebalit a původní sledovací číslo nahradit. Vaše integrace musí umět přiřadit náhradní číslo ke stejné objednávce, aniž by obě čísla trvale zobrazovala jako aktivní zásilky.
Sledování objednávek z marketplace, když marketplace řídí přepravu
Fulfillment prostřednictvím marketplace přináší podobnou technickou otázku, ale jinou otázku týkající se přístupu. Marketplace nebo jeho fulfillmentový partner může vytvořit štítek, zatímco prodejce obdrží pouze přepravní údaje, které zpřístupňuje jeho účet, proces objednávky nebo autorizovaná integrace. Sledovací API nemůže nahradit sledovací číslo, které vám marketplace nezpřístupnil.
Začněte určením modelu fulfillmentu pro každou objednávku. U objednávek plněných prodejcem může být zdrojem údajů o balíku váš vlastní přepravní proces nebo 3PL. U objednávek plněných marketplace může být zdrojem informací o zásilce samotný marketplace a pole dostupná prodejci se mohou lišit. Nepředpokládejte, že stránka objednávky zobrazující stav doručení poskytuje také sledovací číslo přepravce vhodné k registraci v samostatném API.
Pokud marketplace poskytuje číslo, které lze sledovat, ověřte, zda je smíte získat a používat ve vašem zamýšleném systému. Poté otestujte, zda sledovací API tento identifikátor přijímá a zda výsledné události poskytují užitečné informace nad rámec stavu marketplace. Pokud marketplace zpřístupňuje pouze vlastní referenci objednávky nebo doručení, ověřte, zda existuje výslovně podporovaný způsob vyhledávání. Nepředávejte interní ID objednávky marketplace jako číslo přepravce a neočekávejte spolehlivé výsledky.
Stav objednávky na marketplace a stav zásilky ve sledovacím API uchovávejte odděleně. Marketplace může objednávku označit jako odeslanou ihned po potvrzení fulfillmentu, zatímco sledování přepravce může stále zobrazovat, že nebyl zaznamenán sken převzetí. Tyto záznamy odpovídají na různé otázky a mohou se aktualizovat v různou dobu.
Kdy sledování bez štítku problém nevyřeší
„Štítek jsme nevytvořili“ není překážkou. Problémem však mohou být tyto situace:
- Žádná zásilka nebyla vytvořena: Než fulfillment vytvoří použitelný identifikátor, nemusí existovat žádná zásilka přepravce, kterou by bylo možné dotazovat. Samotné potvrzení objednávky není důkazem, že je balík v přepravě.
- Identifikátor vám není dostupný: 3PL nebo marketplace může číslo uchovávat, aniž by je zpřístupnil prostřednictvím vašeho autorizovaného procesu. Tento problém s přístupem k údajům je třeba vyřešit u zdroje.
- Identifikátor není podporován: Referenční číslo, kód používaný pouze marketplace nebo nepodporovaný formát přepravce nemusí s vybraným API fungovat. Ověřte podporované vstupy v dokumentaci a pomocí testovací zásilky.
- Balík zatím nemá nový sken: Číslo může existovat ještě předtím, než přepravce zaznamená událost převzetí. Prázdný nebo nezměněný výsledek považujte za stav vyžadující prověření, nikoli automaticky za důkaz, že je číslo neplatné.
- Sledování je omezené nebo neúplné: Přepravce, služba nebo proces přepravy nemusí poskytovat události potřebné pro váš zákaznický scénář. Skutečnou kvalitu událostí ověřte na reprezentativních zásilkách.
Tato omezení jsou důležitá, protože API nemůže vytvořit chybějící fyzické události ani poskytnout přístup k údajům o objednávkách jiné strany. Jeho hodnota spočívá v získávání a organizování podporovaných informací o sledování poté, co existuje potřebný identifikátor a oprávnění.
Jak vyhodnotit API pro tento proces
Tracking API společnosti 17TRACK je vhodnou možností k prověření, pokud váš tým potřebuje údaje o sledování zásilek ve vlastních systémech, nikoli nástroj pro nákup štítků. Její dokumentace pro vývojáře je místem, kde si ověříte podporovaná registrační pole, přepravce, strukturu odpovědi, autentizaci a případné dostupné metody doručování aktualizací pro váš scénář. Z existence obecného sledovacího API nevyvozujte podporu konkrétního 3PL, marketplace nebo proprietárního identifikátoru.
Před výběrem nebo nasazením poskytovatele vytvořte malou testovací sadu. Zahrňte objednávku 3PL se sledovacím číslem přepravce, objednávku marketplace, u které váš účet zpřístupňuje číslo, objednávku s několika balíky, číslo vytvořené před prvním skenem a zásilku s pozdější událostí doručení. Pokud jsou běžné náhrady čísel nebo mezinárodní předání, zahrňte i ty. Test by měl zodpovědět provozní otázky, nejen ověřit, zda požadavek vrací úspěšnou HTTP odpověď:
- Můžete předat identifikátory, které skutečně obdržíte, bez jejich ručního přepisování?
- Dokážete každý záznam sledování spolehlivě přiřadit ke správné objednávce a balíku?
- Jsou popisy událostí, časová razítka a informace o přepravci dostatečné pro vaše zákaznická sdělení a podpůrné procesy?
- Jak bude váš systém nakládat s duplicitními aktualizacemi, chybějícími událostmi, změnami čísel a neúspěšnými požadavky?
- Je zamýšlené používání údajů marketplace a zákazníků v souladu s podmínkami přístupu platnými pro dané údaje?
V samotné integraci uchovávejte původní zdrojový záznam i záznam sledovacího API. Uložte referenci objednávky, referenci balíku, odeslané sledovací číslo, případné informace o přepravci a čas přijetí každé aktualizace. Usnadní to vyšetření nesrovnalosti, aniž by se událost API prezentovala jako úplná historie fulfillmentu. Pokud API nabízí volbu mezi kontrolou podle plánu a přijímáním aktualizací prostřednictvím podporovaného mechanismu doručování, vyberte podle zdokumentovaného chování a potřeby včasných aktualizací; žádný z těchto přístupů neodstraňuje nutnost zpracování chyb.
Praktické rozhodnutí
Sledovací API používejte bez vytváření štítků tehdy, když zásilku odesílá jiná strana a poskytne vám podporovaný identifikátor zásilky, který jste oprávněni používat. Nejprve si zajistěte spolehlivý datový kanál s údaji o balících od 3PL nebo marketplace. Poté otestujte identifikátory a události sledování proti API a logice párování objednávek. Pokud máte pouze ID objednávky nebo stav marketplace, vyřešte tento nedostatek zdrojových údajů dříve, než investujete do integrace sledování přepravce.
FAQ
Mohu sledovat objednávku pouze pomocí čísla objednávky ve svém obchodě?
Obvykle ne prostřednictvím API pro sledování přepravce. Číslo objednávky ve vašem obchodě identifikuje nákup ve vašem systému. Obecně potřebujete odpovídající identifikátor zásilky, pokud konkrétní služba výslovně nepodporuje vyhledávání podle vašeho typu reference objednávky.
Potřebuji ke gebruikání sledovacích čísel 3PL jeho povolení?
Ověřte svůj smluvní a technický přístup k údajům o zásilce. 3PL může již sledovací čísla vracet jako součást svého datového kanálu fulfillmentu, ale integrace musí používat autorizovaný kanál a správně nakládat s údaji zákazníků.
Proč API po odeslání čísla 3PL nezobrazuje žádný pohyb?
Číslo mohlo být vytvořeno před prvním zaznamenaným skenem přepravce. Ověřte, zda jsou identifikátor a přepravce správné, zda nebyl původní štítek nahrazen a zda pozdější dotaz vrací události. Neztotožňujte „zatím žádný sken“ s „neodesláno“, aniž byste zkontrolovali záznam fulfillmentu.
Co když je jedna objednávka z marketplace odeslána v několika balících?
Každý dostupný identifikátor balíku sledujte samostatně a všechny balíky přiřaďte ke stejné objednávce. Stav objednávky zobrazovaný zákazníkovi udržujte odděleně od stavu jednotlivých balíků, aby jeden doručený balík nezpůsobil, že celá objednávka bude vypadat jako dokončená.
Zdroje
- 17TRACK Tracking API — informace o produktu pro vyhodnocení integrace sledování zásilek.
- 17TRACK API Documentation — technická reference pro ověření podporovaných vstupů a chování integrace.


