Как складовете в чужбина могат да използват API за проследяване, за да наблюдават местните доставки
Складовете в чужбина могат да използват API за проследяване, за да наблюдават местните доставки, като свързват всеки изпратен пакет с неговия превозвач и номер за проследяване, въвеждат събитията за проследяване в системата за управление на склада или поръчките си и превръщат изключенията при доставката в задачи с определен отговорник. Най-полезната конфигурация разграничава създаването на етикет от приемането от превозвача, запазва историята на пратката и показва на оперативните екипи кои пакети изискват действие, а не просто кои пакети имат нов статус.

Това ръководство е предназначено за складове, които съхраняват инвентар извън основния пазар на търговеца и изпращат поръчки до клиенти на съответния пазар. За тези екипи проследяването на международните пратки трябва да свързва записите за изпращане от склада с пътя на доставката чрез местния превозвач. Тази връзка помага на складовите мениджъри, транспортните координатори и екипите за поддръжка на търговците да работят с един и същ запис за пратката.
Определете къде приключва видимостта на склада и започва видимостта на превозвача
Системата за управление на склада може да запише, че дадена поръчка е била взета, опакована, етикетирана и поставена в зоната за изпращане. Тези записи сами по себе си не доказват, че превозвачът е приел пакета. API за проследяване добавя събития, докладвани от превозвача, но не може да замени запис за предаване от склада или да създаде физическо сканиране, което никога не е било извършено.
Разделяйте три ключови момента: готовност за получаване, предаване според записите на склада и приемане според събитията за проследяване на превозвача. Това разделение улеснява разследването на пакети, които изглеждат изпратени вътрешно, но нямат движение от превозвача.
Например, ако пакетът фигурира в манифест за получаване, но няма събитие за приемане, следва да проверите записите за товарене и да се свържете с превозвача, който извършва получаването. Преждевременно е пакетът да бъде определен като изгубен. Ако превозвачът вече е докладвал неуспешен опит за доставка, подходящото действие е различно: разследвайте причината и координирайте следващата стъпка с търговеца или упълномощеното лице за контакт на получателя.
Изградете записа за пратката, преди да свържете API
Основата е надеждната връзка между поръчката на клиента, физическия пакет и идентификатора за проследяване на превозвача. Не използвайте номера на поръчката като заместител на идентификатор на пакет. Една поръчка може да напусне склада в няколко пакета, а заместващата пратка трябва да има собствен запис.
| Запис | Препоръчителни полета | Оперативна цел |
|---|---|---|
| Идентичност на пратката | Вътрешен идентификатор на пратката, идентификатор на поръчката, идентификатор на пакета, акаунт на търговеца | Поддържайте разделени разделените пратки и различните клиенти. |
| Идентичност на превозвача | Идентификатор на превозвача, номер за проследяване, услуга, когато е известна | Изпращайте правилната заявка за проследяване и насочвайте разследванията. |
| Предаване от склада | Склад, час на изпращане, референция за получаване, референция на манифеста | Сравнявайте физическите доказателства за изпращане със събитията на превозвача. |
| История на проследяването | Необработено събитие, съпоставен статус, час на събитието, час на получаване, местоположение, когато е предоставено | Запазвайте доказателствата и различавайте времето на събитието от забавянията при отчитане. |
| Работен процес при изключения | Тип на проблема, отговорник, следващо действие, краен срок за преглед, разрешение | Превръщайте информацията за проследяване в работа с ясен отговорник. |
Съхранявайте номерата за проследяване като текст, за да запазите форматирането. Когато складът вече знае превозвача от генерирането на етикета, предавайте тази идентичност чрез интеграцията, вместо да разчитате единствено на разпознаване по номера. Също така запазвайте връзките между оригиналните, заместващите, върнатите и препратените пакети, без да презаписвате индивидуалните им истории.
Изберете интеграция, която съответства на набора от превозвачи на склада
Складът може да се интегрира директно с превозвачите си или да използва API за проследяване на множество превозвачи. Директната интеграция може да е практична за стабилна операция, използваща малък брой превозвачи, особено когато са необходими специфични за превозвача данни. API за множество превозвачи си струва да бъде оценен, когато складът се нуждае от общ интерфейс за проследяване в няколко мрежи за доставки.
17TRACK’s Tracking API е подходяща опция за този модел на интеграция. Използвайте официалната документация на API, за да оцените как регистрацията на пратки, извличането на данни за проследяване и актуализациите на проследяването ще се впишат във вашата система. Потвърдете точните комбинации от превозвач и услуга, използвани от всеки склад, вместо да приемате общата наличност на превозвача като доказателство, че всяко необходимо събитие ще бъде върнато.
Оценете връзката спрямо реалните оперативни изисквания:
- Може ли системата ви надеждно да регистрира пакетите, генерирани по време на пиковете при изпращане?
- Кои събития се връщат за местните услуги за доставка, които действително закупувате?
- Как се обработват неуспешните заявки, дублираните регистрации и невалидните идентификатори на превозвачи?
- Как се доставят или извличат актуализациите и как могат да бъдат съгласувани пропуснатите актуализации?
- Какви са приложимите ограничения за използване, условията за съхранение, контролите за сигурност и търговските условия за вашия акаунт?
Не трябва да се приема, че връзката за проследяване включва закупуване на етикети, корекция на адреси, пренасрочване на доставки или подаване на рекламации. Третирайте ги като отделни работни процеси, освен ако съответната продуктова документация изрично не потвърждава друго.
Свържете изпращането, актуализациите за проследяване и обработката на изключения
1. Регистрирайте пакетите при контролиран етап на изпращане
Изберете постоянен тригер за регистрация, например потвърждение на етикета или потвърждение на изпращането. Регистрацията при създаване на етикета може да покаже пакетите, които остават неполучени, но изисква и обработка на анулирани етикети. Регистрацията едва след изпращането намалява неизползваните регистрации, но може да скрие интервала между създаването на етикета и физическото предаване.
Независимо кой тригер изберете, запазете резултата от регистрацията към пакета. Неуспешните регистрации трябва да попадат в опашка за повторен опит или корекция, вместо да изчезват в логовете на приложението. Използвайте стабилен вътрешен идентификатор, за да предотвратите създаването на дублирани бизнес записи при повторна обработка.
2. Получавайте актуализации, без таблото да се превръща в източник на истина
В зависимост от документираните опции на API актуализациите могат да се извличат чрез заявки или да се получават чрез webhook известия. Webhook е съобщение, изпратено до системата ви, когато доставчикът има актуализация; при polling системата ви заявява информацията.
При реализации, базирани на webhook, валидирайте входящите съобщения чрез документирания метод за проверка на доставчика. Записвайте приетите съобщения трайно, преди да ги потвърдите, след което ги обработвайте асинхронно. Проектирайте системата за дублирани съобщения и събития, пристигащи извън последователност. Следвайте документираните изисквания за отговор и повторен опит, вместо да приемате, че всеки доставчик работи по един и същ начин.
При polling приоритизирайте активните пратки и неразрешените изключения, като спазвате приложимите ограничения за използване. Когато е поддържано, използвайте заявки за съгласуване, за да проверявате пратки, чиято история на актуализациите изглежда непълна. Записвайте отделно грешките при приемане от изключенията при доставката от превозвача: прекъснатата връзка не е доказателство, че пакетът е спрял да се движи.
3. Нормализирайте статусите, като запазвате оригиналните доказателства
Създайте малък набор от оперативни категории, например очаква приемане, в транзит, предстои доставка, направен е опит за доставка, доставено и движение за връщане. Това са предложени складови категории, а не обещание, че всеки превозвач предоставя съответстващи събития.
Запазвайте оригиналното описание заедно със съпоставената категория. „Налично за получаване“ не трябва мълчаливо да се превръща в „доставено“, а „връщането е започнало“ не трябва да се превръща в „получено обратно в склада“. Позволете неизвестно или несъпоставено състояние, така че непознатите събития да останат видими за преглед.
Съхранявайте както времевия печат на събитието, така и времето, когато системата ви го е получила. Запазвайте оригиналната часова зона или отместване, когато са предоставени, и използвайте единен вътрешен стандарт за време. Събитие, пристигнало със закъснение, не трябва автоматично да връща пратката назад само защото е получено последно; прилагайте изрични правила за последователност и запазвайте историята.
4. Определяйте отговорници за действията при изключения
Сигналът е полезен само когато някой може да предприеме действие. Насочвайте липсващите сканирания за приемане към екипа за изпращане на склада, опитите за доставка, изискващи информация от получателя, към екипа за поддръжка на търговеца, а продължителните проблеми с движението при превозвача към транспортния координатор. Това са препоръчителни начални точки; отговорностите трябва да отразяват договорите и оперативния модел на склада.
Прикрепяйте към всеки случай историята на проследяването, референцията за предаване, последното събитие, бележките от разследването и времето за следващ преглед. Групирайте повтарящите се сигнали под един и същ отворен проблем, така че един блокиран пакет да не генерира нова задача след всяка синхронизация.
Настройте сигналите около очакванията за услугата, а не около произволни таймери
Няма универсален интервал, след който пакет без ново сканиране става закъснял или изгубен. Конфигурирайте праговете за сигнали според услугата на превозвача, графика за получаване, работните дни, дестинацията и ангажимента на търговеца. Поддържайте вътрешния праг за разследване отделно от обещанието за доставка, видимо за клиента.
- Няма приемане след предаването: Проверете записа за получаване и потвърждението от превозвача, преди да ескалирате.
- Няма движение след очаквания интервал: Прегледайте последното събитие, очакванията за услугата и известните оперативни прекъсвания.
- Неуспешен опит за доставка: Прочетете причината, преди да решите дали следващото действие принадлежи на превозвача, търговеца или получателя.
- Движение за връщане: Подгответе процеса за връщания, но не увеличавайте наличния за продажба инвентар, преди физическото получаване и необходимата проверка.
- Доставено, но оспорено: Започнете разследване и потърсете наличните доказателства за доставката; не приемайте, че самият статус разрешава оплакването.
Проследяването отразява докладвани събития за пратката, а не непрекъснатото местоположение на пакета. Показването на времевия печат на последната актуализация помага на служителите да разберат актуалността на информацията, без да създава впечатление за GPS видимост в реално време.
Осигурете полезен изглед за всеки екип
Ръководителите на складове се нуждаят от изключения между изпращането и приемането. Транспортните координатори се нуждаят от опашки, специфични за превозвача, и остаряващи случаи. Екипите за поддръжка на търговците се нуждаят от ясна времева линия на пратката и следващото договорено действие. Общият модел на данните може да поддържа тези изгледи, без да предоставя на всеки потребител достъп до пратките на всеки търговец.
За склад с множество клиенти налагайте достъп на ниво търговец от страна на сървъра, а не само чрез филтри на таблото. Дръжте идентификационните данни за API извън кода на браузъра, ограничете достъпа до информацията за получателите и определете правила за съхранение и изтриване. Избягвайте поставянето на ненужни лични данни в референции за проследяване или диагностични логове.
Полезните измервания включват дела на изпратените пакети, успешно регистрирани за проследяване, дела с приемане от превозвача, времето от изпращане до приемане, възрастта на неразрешените изключения и грешките при обработката на интеграцията. Определете всеки знаменател и времева база. Ако измервате доставките навреме, сравнявайте с документирано обещание или ангажимент за услугата, а не с обща продължителност на доставката.
Пилотирайте работния процес, преди да го разширите
Започнете с ясно определени склад, набор от превозвачи и група търговци. Включете обичайни доставки, както и сложни записи: анулирани етикети, разделени поръчки, липсващи първи сканирания, неуспешни опити за доставка, дублирани известия, събития извън последователност и връщания. Използвайте разрешени тестови данни или исторически записи, когато е подходящо; не измисляйте събития на превозвача в продукционна среда.
Договорете критериите за приемане преди старта. Всеки изпратен пакет трябва или да има успешно записана регистрация, или случай на неуспех с определен отговорник. Повторно възпроизведените съобщения не трябва да създават дублирани задачи. Събитията за проследяване трябва да могат да бъдат проследени до своя източник, а потребителите не трябва да виждат записи на друг търговец.
Разширявайте едва след като оперативният персонал може надеждно да обработва опашката с изключения, а техническият персонал може да възстановява неуспешни актуализации. Практическата цел не е табло, изпълнено със статуси. Целта е проследима връзка от изпращането в склада до доставката от превозвача, с ясно определен отговорник винаги когато този път изисква внимание.
Често задавани въпроси
Може ли API за проследяване да замени система за управление на склад?
Не. API за проследяване предоставя видимост върху пратките. Системата на склада остава отговорна за дейности като контрол на инвентара, вземане, опаковане и физически записи за изпращане. Свържете двете чрез идентификатори на пакети, така че събитията от превозвача да добавят контекст, без да заменят доказателствата от склада.
Предоставя ли API за проследяване GPS местоположение в реално време?
Не приемайте това по подразбиране. Проследяването на пакети обикновено се състои от докладвани събития и местоположения. Времето на актуализациите зависи от превозвача и интеграцията. Непрекъснатото местоположение на превозно средство или пакет изисква отделно потвърдена възможност.
Какво трябва да направят служителите, когато пакетът няма актуализации за проследяване?
Първо проверете успешната регистрация, идентичността на превозвача и точността на номера за проследяване. След това сравнете последното събитие с доказателствата за предаване от склада и очакваната времева рамка на услугата. Разследвайте отделно грешките в интеграцията и липсващите сканирания от превозвача, преди да решите кой екип трябва да ескалира случая.
Могат ли събитията за проследяване автоматично да задействат възстановяване на суми или актуализации на инвентара?
Те могат да информират работен процес, но действията с последствия изискват допълнителни контроли. Изключението при доставката не установява непременно право на възстановяване на сума, а движението за връщане не доказва физическо получаване в склада. Прилагайте политиките на търговеца, проверките за оторизация и процедурите за приемане, преди да променяте парични или складови записи.
Как трябва да се показват разделените поръчки на екипите за поддръжка на търговците?
Показвайте всеки пакет отделно под основната поръчка. Доставката на един пакет не трябва да маркира цялата поръчка като завършена, когато друг пакет все още е в транзит. Поддържайте заместващите и върнатите пратки свързани, но различими.
Източници
- 17TRACK Tracking API — официален продуктов справочник за опцията за интеграция на API за проследяване.
- 17TRACK API Documentation — технически справочник за валидиране на регистрацията, заявките за проследяване, обработката на актуализациите и изискванията за реализация. Оперативните работни процеси и правилата за сигнали в това ръководство са препоръки, а не гаранции за поведението на доставчика или превозвача.


