Може ли API за проследяване да работи без транспортни етикети? Проследяване на поръчки 3Pl и от маркетплейси?
Да. API за проследяване може да работи, без вашият бизнес да създава товарителници, стига превозвач или партньор за доставки да е създал пратка, която може да бъде проследявана, и да можете да получите валиден номер за проследяване или друг идентификатор, поддържан от API. Това е обичайно, когато външен логистичен доставчик (3PL) или маркетплейс обработва изпълнението на поръчките. Разликата е между това да не закупите товарителницата сами и изобщо да нямате идентификатор на пратка: първото обикновено е възможно; второто може да остави API без нищо за проследяване.

За продавач, оператор на маркетплейс или екип по интеграцията практическата задача е да свърже всяка поръчка с пратката, създадена от страната, която действително я изпраща. Това изисква достъп до правилните данни, а не непременно контрол върху създаването на товарителницата.
Какво е необходимо на API за проследяване, когато не създавате товарителницата
Товарителницата е един от начините за създаване на идентификатор на пратка, но обикновено не е входът, който API за проследяване използва. Интеграциите за проследяване обикновено работят с данни за пратката, предоставени след създаването на товарителницата на друго място. Преди да проектирате връзката, разграничете три записа, които често се приемат за взаимозаменяеми:
- Идентификатор на поръчката: Идентифицира покупка във вашия магазин, профил в маркетплейс или система за управление на поръчки. Може да обхваща няколко артикула и няколко пратки.
- Идентификатор за изпълнение или пакет: Идентифицира действие по изпълнение или колет в система на 3PL или маркетплейс. Форматът и значението му зависят от съответната система.
- Номер за проследяване на превозвача: Идентифицира пратка с цел проследяване, при условие че превозвачът и услугата за проследяване го приемат.
Вашият вътрешен идентификатор на поръчката ви помага да намерите правилната клиентска поръчка. Той не функционира автоматично като номер за проследяване на превозвач. Обичайният модел на интеграция е да получите номера за проследяване от 3PL или маркетплейса, да регистрирате или потърсите този номер чрез API за проследяване и да съхраните върнатата информация за пратката към съответната поръчка или пакет.
Може да е необходимо и име или код на превозвача. Някои услуги могат да опитат автоматично да открият превозвача, но това трябва да бъде тествано, а не приемано по подразбиране, особено когато идентификаторите се припокриват между превозвачи или поръчката преминава през няколко мрежи за доставка. Проверете документацията на API за приеманите идентификатори, правилата за избор на превозвач, изискванията за регистрация и полетата за статуса, преди да се ангажирате с внедряване.
Проследяване на поръчки, изпратени от 3PL
Когато 3PL опакова поръчка, закупи товарителницата и предаде колета на превозвач, вашият бизнес може никога да не види самата товарителница. Все пак са ви необходими данните за пратката, които произтичат от този процес. Попитайте 3PL коя система или канал предоставя номерата за проследяване, информацията за превозвача, идентификаторите на пакетите и референцията към поръчката, която сте предоставили при заявяване на изпълнението.
Обичайният работещ процес с 3PL изглежда така:
- Изпратете поръчката и стабилна референция към 3PL чрез съществуващия процес за изпълнение.
- Получете потвърждение за изпълнение, съдържащо номера за проследяване на ниво пакет и, когато е налична, информация за превозвача.
- Свържете този пакет с правилната клиентска поръчка и артикулите в нея.
- Изпратете поддържания идентификатор на пратката към вашия API за проследяване или използвайте предписания от API процес за търсене.
- Записвайте актуализациите за проследяване към пакета, след което представяйте изглед на ниво поръчка на оперативния екип или клиента.
Стъпката по съпоставяне заслужава специално внимание. Една поръчка може да напусне склада в два кашона или един артикул може да бъде изпратен по-късно от останалите. И в двата случая няма единен статус на пакет, който точно да описва цялата поръчка. Поддържайте записи на ниво пакет и извеждайте всяко съобщение на ниво поръчка въз основа на тях. Например не отбелязвайте поръчка като доставена само защото първият ѝ колет е доставен.
Уточнете с 3PL как ще бъдат предоставяни корекциите. Товарителниците могат да бъдат анулирани, колетите могат да бъдат преопаковани, а първоначалният номер за проследяване може да бъде заменен. Интеграцията ви трябва да може да свърже заместващия номер със същата поръчка, без да показва и двата номера като активни пратки за неопределено време.
Проследяване на поръчки от маркетплейс, когато маркетплейсът контролира доставката
Изпълнението на поръчки чрез маркетплейс поставя подобен технически въпрос, но различен въпрос относно достъпа. Маркетплейсът или неговият партньор за изпълнение може да създаде товарителницата, докато продавачът може да получи само данните за доставката, които неговият профил, работният процес на поръчката или оторизираната интеграция предоставя. API за проследяване не може да компенсира номер за проследяване, който маркетплейсът не ви е предоставил.
Започнете, като определите модела на изпълнение за всяка поръчка. При поръчки, изпълнявани от продавача, вашият собствен процес за доставка или 3PL може да бъде източникът на данните за пакета. При поръчки, изпълнявани от маркетплейса, маркетплейсът може да бъде източникът на информацията за пратката, а наличните за продавача полета може да се различават. Не приемайте, че страница на поръчка, показваща статус на доставката, предоставя и номер за проследяване на превозвача, подходящ за регистрация в отделен API.
Ако маркетплейсът предоставя номер, който може да бъде проследяван, потвърдете, че имате право да го извличате и използвате в предвидената от вас система. След това проверете дали API за проследяване приема този идентификатор и дали получените събития добавят полезна информация извън статуса в маркетплейса. Ако маркетплейсът предоставя само собствена референция към поръчката или доставката, проверете за изрично поддържан метод за търсене. Не изпращайте вътрешен идентификатор на поръчка в маркетплейс, сякаш е номер на превозвач, и не очаквайте надеждни резултати.
Поддържайте отделно състоянието на поръчката в маркетплейса и състоянието на пратката в API за проследяване. Маркетплейсът може да опише поръчката като изпратена, след като изпълнението е потвърдено, докато проследяването от превозвача все още може да не показва сканиране при приемане. Тези записи отговарят на различни въпроси и могат да се актуализират по различно време.
Кога проследяването без товарителница няма да реши проблема
„Няма товарителница, създадена от нас“ не е пречка. Следните ситуации обаче могат да бъдат:
- Не е създадена пратка: Преди изпълнението да генерира използваем идентификатор, може да няма пратка на превозвач, която да бъде заявена. Самото потвърждение на поръчката не е доказателство, че колетът е в движение.
- Идентификаторът не е достъпен за вас: 3PL или маркетплейсът може да съхранява номера, без да го предоставя чрез оторизирания ви работен процес. Решете проблема с достъпа до данните при източника.
- Идентификаторът не се поддържа: Референтен номер, код, използван само в маркетплейса, или неподдържан формат на превозвача може да не работи с избрания API. Проверете приетите входни данни в документацията и с тестова пратка.
- Колетът все още няма ново сканиране: Номерът може да съществува, преди превозвачът да запише събитие за приемане. Третирайте празен или непроменен резултат като състояние за проверка, а не като автоматично доказателство, че номерът е невалиден.
- Проследяването е ограничено или непълно: Превозвачът, услугата или работният процес на пратката може да не предоставя събитията, необходими за сценария ви, насочен към клиентите. Потвърдете действителното качество на събитията чрез представителни пратки.
Тези ограничения са важни, защото API не може да създаде липсващи физически събития или да предостави достъп до данните за поръчки на друга страна. Стойността му е в извличането и организирането на поддържана информация за проследяване, след като са налични необходимият идентификатор и съответните разрешения.
Как да оцените API за този работен процес
Tracking API на 17TRACK е подходяща опция за проучване, когато екипът ви се нуждае от данни за проследяване на пратки в собствените си системи, а не от инструмент за закупуване на товарителници. Неговата документация за разработчици е мястото, където да проверите приеманите полета за регистрация, поддържаните превозвачи, структурата на отговорите, удостоверяването и наличните методи за доставка на актуализации за вашия сценарий. Не правете извод, че конкретен 3PL, маркетплейс или патентован идентификатор се поддържа само въз основа на съществуването на общ API за проследяване.
Създайте малък тестов набор, преди да изберете или внедрите доставчик. Включете поръчка от 3PL с номер на превозвач, поръчка от маркетплейс, за която профилът ви предоставя номер, поръчка с няколко колета, номер, създаден преди първото му сканиране, и пратка с по-късно събитие за доставка. Ако замяната на номера или международното предаване са обичайни, включете и такива случаи. Тестът трябва да отговори на оперативни въпроси, а не само дали заявката връща успешен HTTP отговор:
- Можете ли да предадете идентификаторите, които действително получавате, без да ги преразписвате ръчно?
- Можете ли надеждно да свържете всеки запис за проследяване с правилната поръчка и пакет?
- Достатъчни ли са описанията на събитията, времевите отметки и информацията за превозвача за клиентските ви съобщения и работните процеси за поддръжка?
- Как системата ви ще обработва дублирани актуализации, липсващи събития, промени на номера и неуспешни заявки?
- Съответства ли предвиденото от вас използване на данните от маркетплейса и клиентите на приложимите условия за достъп до тези данни?
За самата интеграция съхранявайте както оригиналния запис от източника, така и записа от API за проследяване. Съхранявайте референцията към поръчката, референцията към пакета, изпратения номер за проследяване, информацията за превозвача, ако е налична, и времето на получаване на всяка актуализация. Това улеснява разследването на несъответствие, без да представяте събитие от API като пълната история на изпълнението. Ако API предлага избор между проверка по график и получаване на актуализации чрез поддържан механизъм за доставка, направете избора според документираното поведение и нуждата ви от навременни актуализации; нито един от двата подхода не премахва необходимостта от обработка на грешки.
Практическото решение
Използвайте API за проследяване без създаване на товарителници, когато друга страна изпраща колета и ви предоставя поддържан идентификатор на пратката, който имате право да използвате. Първо осигурете надежден канал за данни за пакетите от 3PL или маркетплейса. След това тествайте идентификаторите и събитията за проследяване спрямо API и логиката си за съпоставяне на поръчките. Ако разполагате само с идентификатор на поръчка или статус от маркетплейс, решете този проблем с данните от източника, преди да инвестирате в интеграция за проследяване от превозвач.
ЧЗВ
Мога ли да проследя поръчка, използвайки само номера на поръчката от моя магазин?
Обикновено не чрез API за проследяване на превозвач. Номерът на поръчката в магазина идентифицира покупката във вашата система. Обикновено ви е необходим съответният идентификатор на пратката, освен ако конкретната услуга изрично не поддържа търсене по вашия тип референция към поръчка.
Необходимо ли е разрешение от 3PL, за да използвам неговите номера за проследяване?
Потвърдете договорния и техническия си достъп до данните за пратката. 3PL може вече да връща номера за проследяване като част от канала си за изпълнение, но интеграцията трябва да използва оторизиран канал и да обработва правилно клиентските данни.
Защо API не показва движение, след като 3PL изпрати номер?
Номерът може да е създаден преди първото записано сканиране от превозвача. Проверете дали идентификаторът и превозвачът са правилни, дали първоначалната товарителница е заменена и дали по-късна заявка връща събития. Не приравнявайте „все още няма сканиране“ с „не е изпратено“, без да проверите записа за изпълнение.
Какво да направя, ако една поръчка от маркетплейс бъде изпратена в няколко колета?
Проследявайте всеки наличен идентификатор на пакет отделно и свържете всички пакети със същата поръчка. Поддържайте отделно статуса на поръчката, видим за клиента, и статуса на отделните колети, така че един доставен колет да не прави цялата поръчка да изглежда завършена.
Източници
- 17TRACK Tracking API — информация за продукта за оценка на интеграцията за проследяване на пратки.
- 17TRACK API Documentation — техническа справка за проверка на приеманите входни данни и поведението на интеграцията.


