Skip to main content
НачалоБлогРъководстваКак платформите за логистични технологии могат да вградят проследяването на пратките в своите продукти

Как платформите за логистични технологии могат да вградят проследяването на пратките в своите продукти

17TRACK

Логистичните технологични платформи могат да вграждат проследяване на пратки, като свързват данните от превозвачите с бекенд услуга за проследяване, преобразуват събитията по пратките в единен вътрешен модел и предоставят тази информация чрез собствените си табла, клиентски портали и API. За продуктовите и инженерните екипи основният въпрос не е как да се покаже номер за проследяване. Въпросът е как да се осигури надеждна видимост на пратките, без всеки продуктов процес да зависи от специфичните за превозвача формати на данните.

Как логистичните технологични платформи могат да вградят проследяване на пратки в своите продукти

Практическата реализация разделя събирането на данни, обработката на събития и представянето. Това позволява на система за управление на поръчки, транспортна платформа, складово приложение или логистичен маркетплейс да използва една и съща основа за проследяване, като същевременно представя различна информация на операторите и клиентите.

Определете какво трябва да прави продуктът ви с проследяването

Започнете с действието, което потребителят трябва да предприеме, след като види актуализация за пратката. Клиентът, който проверява напредъка на доставката, се нуждае от разбираем статус и часа на последната актуализация. Оперативният екип, който разследва забавени пратки, се нуждае от история на събитията, контекст за превозвача и възможност да възложи разследване. Интеграционният партньор може да се нуждае от структурирани събития, а не от страница за проследяване.

Това са различни продуктови изисквания. Разглеждането им като единен уиджет за проследяване може да остави важни процеси без необходимата поддръжка.

  • Видимост за клиента: Показвайте напредъка на пратката, съответната информация за доставката и ясна следваща стъпка при възникване на проблем.
  • Оперативна видимост: Извеждайте изключения, остарели записи, предавания между превозвачи и пратки, изискващи внимание.
  • Автоматизация на процесите: Стартирайте вътрешни задачи или последващи съобщения, когато се промени значимо условие, свързано с пратката.
  • Разширяемост на платформата: Дайте на клиентите или партньорите достъп до нормализирани данни за проследяване чрез контролирани API или абонаменти за събития.

Изберете един основен процес за първото издание. Клиентската времева линия и таблото за управление на изключения могат да споделят инфраструктура, но изискват различни разрешения, интерфейсни решения и тестове за приемане.

Изберете модела на интеграция, преди да проектирате интерфейса

Подходящият модел на интеграция зависи от набора ви от превозвачи, необходимата дълбочина на данните и готовността ви да поддържате връзки с превозвачите. Оценявайте пътя на данните отделно от слоя за представяне: страницата за проследяване сама по себе си не осигурява оперативен конвейер за събития.

ПодходПолезен е, когатоОсновна отговорност
Директни интеграции с превозвачиПродуктът ви зависи от специфични полета на превозвача или от строго определена мрежа от превозвачи.Поддържане на удостоверяването, картографирането на данни, обработката на грешки и промените за всяка връзка.
API за проследяване на множество превозвачиПродуктът ви се нуждае от общ интеграционен слой за няколко превозвача.Проверка на действителната поддръжка на пратките, семантиката на събитията, механизмите за доставка и търговските условия.
Хибридна интеграцияСподеленият слой за проследяване покрива повечето нужди, но избрани превозвачи изискват директни връзки.Разрешаване на противоречиви актуализации и запазване на единен вътрешен модел на пратката.

За платформа, обслужваща търговци с различни взаимоотношения с превозвачи, оценяването на API за множество превозвачи е разумна отправна точка. Директните интеграции си струва да бъдат разгледани, когато задължително поле или оперативен процес не може да бъде удовлетворен чрез споделения слой. Нито един от подходите не премахва необходимостта от собствена идентичност на пратките, правила за оторизация или потребителско изживяване.

Къде се вписва 17TRACK

Tracking API на 17TRACK е подходяща опция за оценяване като вграден слой за данни за проследяване. Използвайте официалната документация на API, за да установите как нейният модел на интеграция се съпоставя с продукта ви, преди да се ангажирате с дадена архитектура.

За този случай оценявайте интеграцията за разработчици, вместо да приемате, че потребителска страница за проследяване или приложение за електронен магазин отговаря на бекенд изискванията на платформата. Потвърдете приложимите формати на заявките, възможностите за доставка на актуализации, изискванията за удостоверяване, ограниченията за използване и търговските условия. След това тествайте представителни пратки от собствения си набор от превозвачи и маршрути. Не приемайте само наличието на превозвач в списъка като доказателство, че всяка услуга, маршрут или тип пратка предоставя необходимите за процеса ви полета.

Изградете конвейер за проследяване, а не директна връзка от браузъра към доставчика

Препоръчителната архитектура е: създаване на пратка в продукта ви, регистрация в бекенда към източника за проследяване, получаване на актуализации, нормализиране на събитията, вътрешно съхранение и доставяне към интерфейса ви или към последващи услуги. Съхранявайте идентификационните данни на доставчика на сървъра. Фронтендът ви трябва да заявява оторизирана информация за пратките от вашия бекенд, вместо да получава повторно използваем секрет на доставчика.

1. Създайте вътрешна идентичност на пратката

Задайте вътрешен идентификатор на пратката, преди да регистрирате номера за проследяване. Свържете го с клиента, поръчката, пакета, информацията за превозвача и всеки специфичен за доставчика идентификатор. Една поръчка може да съдържа няколко пакета, а един пакет може да получи друга референция за проследяване при предаване. Моделирайте тези връзки изрично, вместо да вкарвате един номер за проследяване в един запис на поръчка.

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

2. Направете регистрацията възстановима

Изпълнявайте регистрацията чрез устойчива задача или еквивалентен възстановим процес. Разграничавайте невалидната заявка от временната повреда на връзката и проследявайте резултата за всяка пратка. Когато доставчикът поддържа идемпотентност, използвайте я; в противен случай поддържайте вътрешно състояние на регистрацията, за да намалите дублираните изпращания.

Успешната регистрация трябва да означава само, че източникът за проследяване е приел заявката според документираната си семантика. Това не трябва автоматично да означава, че превозвачът физически е получил пакета.

3. Получавайте актуализации, без да блокирате бизнес логиката

Ако избраният доставчик поддържа уебхукове, валидирайте входящите заявки чрез документирания механизъм за проверка. Записвайте приетите съобщения трайно, преди да ги потвърдите, след което ги обработвайте асинхронно. Това намалява вероятността бавна услуга за известия или изчисление на табло да доведе до загуба на иначе валидна актуализация.

Ако е необходимо извличане чрез периодични заявки, планирайте го в рамките на ограниченията на доставчика и изискванията на продукта ви за актуалност. Когато е поддържано и разрешено, заявките за съгласуване могат да помогнат за възстановяване на пропуснати при прекъсване актуализации. Не приемайте, че периодичното извличане и push доставката имат идентични полезни товари или последствия за таксуването.

4. Нормализирайте събитията, като запазвате детайлите от източника

Използвайте малък вътрешен речник от статуси за поведението на продукта, като същевременно запазвате оригиналното описание на превозвача за поддръжка и разследване. Възможните вътрешни категории включват получена информация, в движение, на разнос, доставена и изключение. Това са предложени продуктови категории, а не твърдение, че всеки източник използва точно тези етикети.

Полезният нормализиран запис съдържа:

  • Вътрешен идентификатор на пратката и идентификатор на клиента.
  • Изходна система, идентификатор на превозвача и съответната референция за проследяване.
  • Оригинално описание на статуса и нормализиран статус.
  • Час на възникване на събитието, включително информация за часовата зона, когато е предоставена.
  • Часът, в който платформата ви е получила актуализацията.
  • Информация за местоположението, ако е налична и подходяща за съхранение.
  • Идентификатор на събитието от източника или вътрешно генериран ключ за дедупликация.
  • Версия на картографирането, така че решенията за нормализация да могат да бъдат проследени.

Поддържайте неизвестните стойности изрични. Липсващо местоположение трябва да остане липсващо, вместо да бъде извеждано от предишно сканиране. Съхранявайте необработени полезни товари само при подходяща политика за достъп и съхранение; те могат да съдържат информация, от която клиентският интерфейс няма нужда.

Обработвайте забавени, повтарящи се и противоречиви събития

Проектирайте за актуализации, които могат да се повтарят, да се забавят или да бъдат получени извън последователност, вместо да приемате идеална доставка. Премахвайте дубликатите, преди да задействате странични ефекти, и разграничавате момента на възникване на събитието от момента, в който системата ви го е получила. По-старо събитие, пристигнало по-късно, не трябва автоматично да заменя по-новото състояние на пратката.

Простото подреждане на статусите не е достатъчно за всяка ситуация. Опити за доставка, връщания, корекции и предавания между превозвачи могат да създадат преходи, които не се вписват в права линия от изпратена до доставена. Поддържайте история на събитията и изрични правила за преходи, вместо да разчитате само на последното получено съобщение.

Прилагайте същата дисциплина и към известията. Определете бизнес тригер, например първия приет преход към „на разнос“, след което запишете, че известието е изпратено. Повторното изпълнение на задача за получаване не трябва да изпраща отново същото клиентско съобщение.

Разделяйте изключенията при пратките от интеграционните повреди. Неуспешният опит за доставка е логистично събитие. Грешката при удостоверяване е инцидент на платформата. Те се нуждаят от различни сигнали, отговорници и пътища за ескалация.

Проектирайте изживяване за проследяване, което обяснява несигурността

Показвайте какво знае системата, без да внушавате по-голяма точност от предоставената от източника. Обозначавайте отделно часа на събитието от превозвача и часа на последното обновяване от платформата. Ако показвате прогнозна дата на доставка, посочете нейния източник и не я представяйте като гарантиран час.

Разграничавайте следните състояния в интерфейса:

  • Проследяването е регистрирано, няма докладвано движение: Системата разполага с референция за проследяване, но няма квалифициращо събитие за движение.
  • Пратката се придвижва: Събитията показват движение, дори когато няма налична прогноза за доставка.
  • Информацията за проследяване е остаряла: Записът е надхвърлил определения праг за актуалност.
  • Услугата за актуализации е недостъпна: Платформата ви в момента не може да извлече или обработи нова информация.
  • Изключение при доставката: Събитие за пратката показва проблем, изискващ тълкуване или действие.

Тези разграничения предотвратяват представянето на техническа повреда като неуспешна доставка. Дайте на операторите пълната история на събитията и път за разследване; на клиентите дайте кратко обяснение и подходящото следващо действие. Избягвайте да описвате проследяването като проследяване в реално време, освен ако действителното поведение на източника не подкрепя това обещание.

Защитете границите между клиентите и достъпа до проследяване

Оторизирайте всяка справка за проследяване спрямо клиента на заявяващия потребител и разрешенията му за пратката. Валидният номер за проследяване не е достатъчно разрешение за разкриване на поръчка, данни за получателя или вътрешни бележки. Публичните връзки за проследяване трябва да разкриват само необходимата за предназначението им информация.

Не съхранявайте API идентификационни данни в браузърния код и обичайните логове. Използвайте поддържаните от избрания доставчик механизми за управление и проверка на идентификационните данни и документирайте процедура за ротация. Прилагайте минимизиране на данните към съхраняваните полезни товари, експорти и инструменти за поддръжка.

Преди старта потвърдете договорните изисквания, свързани с внедряването ви, включително съхранението, разрешеното използване на данните и приложимите договорености за обработка или прехвърляне. Тези условия изискват пряк преглед; не трябва да бъдат извеждани от маркетинговото описание на продукта.

Валидирайте с реални пратки, преди да разширявате

Използвайте доказателство за концепция, което представлява планираните ви клиенти, а не само удобни примерни номера. Включете превозвачите, маршрутите, типовете услуги и етапите на пратките, които са важни за първото издание. При трансгранични процеси включете предаванията, когато са приложими; при поръчки с няколко пакета проверете поведението на ниво пакет.

Тествайте както логистични събития, така и инфраструктурни повреди:

  • Регистрация преди първото физическо сканиране от превозвача.
  • Двусмислени или отхвърлени референции за проследяване.
  • Дублирани съобщения и събития извън последователност.
  • Прекъсване на крайна точка за уебхукове, последвано от възстановяване.
  • Опити за доставка, връщания и коригирани събития, когато са налични тестови данни.
  • Опити за неоторизиран достъп между клиенти.
  • Повторна обработка без повторно изпращане на клиентски известия.

Съгласувайте критериите за приемане, преди да оценявате интеграцията. Измервайте използваемата пълнота на събитията, наблюдаваното забавяне на актуализациите, точността на нормализацията, поведението при възстановяване и разходите според действителния модел на таксуване на доставчика. Определяйте целите за актуалност според процеса, вместо да прилагате един универсален праг към всеки превозвач и маршрут.

За текущите операции проследявайте неуспешните регистрации, грешките при получаване, натрупаните задачи за обработка, дублираните събития и пратките с остарели данни. Разпределете отговорността между инженеринг, продукт и логистични операции, така че сигналът да достига до човек, който може да го разреши.

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

Често задавани въпроси

Достатъчна ли е вградената страница за проследяване за една логистична платформа?

Тя може да е достатъчна, когато изискването е просто да позволи на потребителите да виждат напредъка на пратката. Ако проследяването трябва да задвижва сигнали, вътрешни задачи, анализи или партньорски API, е необходима и бекенд интеграция на данните. Оценявайте слоя за представяне и конвейера за събития като отделни изисквания.

Трябва ли актуализациите за проследяване да използват уебхукове или периодично извличане?

Използвайте механизмите, които избраният доставчик поддържа, и документирайте поведението им при доставка. Уебхуковете могат да намалят повтарящите се заявки за непроменени записи, докато периодичното извличане може да е необходимо за извличане или съгласуване. Нито един от подходите не премахва необходимостта от дедупликация, възстановяване след грешки и наблюдение на актуалността.

Как трябва платформата да обработва неизвестен превозвач?

Съхранявайте всеки контекст за превозвача, предоставен от процеса на изпращане. Ако доставчикът на проследяване предлага откриване на превозвач, тествайте двусмислените случаи, вместо да приемате, че откриването винаги е категорично. Поддържайте нерешените записи идентифицируеми и осигурете път за корекция, вместо тихо да избирате несигурно съвпадение.

Могат ли данните за проследяване да докажат, че поръчката е изпълнена?

Събитието „доставена“ е сигнал на ниво пратка, а не непременно доказателство, че всеки пакет от поръчката е пристигнал или че получателят няма възражения. Разглеждайте доставката на пакет, приключването на поръчката и клиентските претенции като отделни бизнес понятия с изрични правила, които ги свързват.

Какво трябва да проверят екипите, преди да изберат API за проследяване?

Проверете поддръжката на представителни пратки, необходимите полета на събитията, поведението при доставка на актуализации, удостоверяването, ограниченията, възможностите за възстановяване, условията за данните и ценовите определения. Тествайте целия процес в собствената си среда. Контролният списък с функции не може да установи дали действителните данни за пратките ще отговарят на критериите за приемане на продукта ви.

Източници

Официалните ресурси по-долу идентифицират предложението на 17TRACK за разработчици и неговата интеграционна документация. Архитектурата, вътрешният модел на данните и тестовият план в това ръководство са препоръки за реализация, а не твърдения за гаранции от доставчика.

  • 17TRACK Tracking API — официален продуктов ресурс за оценяване на предложението за API за проследяване.
  • 17TRACK API Documentation — официална справка за проверка на интеграционните изисквания и поддържаното поведение на API.