Как да изберете API за проследяване на пратки в Обединеното кралство: покритие на превозвачите и интеграция
Изберете API за проследяване на пратки във Великобритания, като тествате превозвачите и услугите за доставка, които действително използвате, след което проверите дали събитията за проследяване могат надеждно да се интегрират във вашите системи. Дългият списък с превозвачи не е достатъчен: краткият ви списък трябва да премине реални тестове с пратки за вътрешни доставки във Великобритания, трансгранични предавания, точност на статусите, обработка на webhook известия и общи оперативни разходи.
За ръководителя на операциите в електронната търговия резултатът е надеждна видимост на пратките. За инженерния екип това е интеграция, която остава предвидима, когато актуализациите пристигат със закъснение, номерата за проследяване са нееднозначни или партньорите за доставка се променят. Оценете и двата резултата, преди да се ангажирате с даден доставчик.
Започнете с вашия праткопоток, а не с броя превозвачи на доставчика
API за проследяване извлича информация за пратки, която се използва в приложение, система за управление на поръчки, инструмент за обслужване на клиенти или друг софтуер. Не приемайте, че интеграцията за проследяване също закупува етикети, резервира вземания или управлява връщания. Това са отделни изисквания, които трябва да проверите.
Преди да преглеждате доставчици, експортирайте представителна извадка от вашите пратки и ги групирайте по превозвач, услуга, произход, местоназначение и бизнес важност. Включете успешно доставени и проблемни пратки. Извадка, съдържаща само стандартни вътрешни доставки, няма да ви каже много за международните предавания или изключенията при доставка.
Създайте таблица с изисквания със следните полета:
- Превозвач и услуга: Запишете точната услуга, която използва вашият бизнес, а не само търговското име на превозвача.
- Маршрут: Разделете вътрешните пратки във Великобритания, входящите пратки към Великобритания и изходящите пратки от Великобритания.
- Идентификатор на пратката: Отбележете дали получавате номер на пакет, референция на пратка, референция на поръчка или няколко идентификатора.
- Необходими събития: Определете ключовите етапи, които задействат съобщения към клиентите или оперативни действия.
- Отговорно лице: Определете отговорник за разследването на задържани пратки, неуспешни доставки и неправилни актуализации.
Списъкът ви със задължително покритие може да включва Royal Mail, Parcelforce Worldwide, Evri или DPD в зависимост от договорите ви. Това са примери за проверка, а не твърдение, че даден API поддържа всяка услуга, предлагана от тези превозвачи.
Какво трябва да означава покритието на превозвачите на практика
„Поддържа този превозвач“ е само началото на оценката. Полезното покритие означава, че API извлича събитията, необходими за работните ви процеси, за услугите и маршрутите, които използвате. Приемайте списъка с превозвачи като причина за тест, а не като доказателство за готовност за продукционна среда.
Проверете покритието на ниво услуга и маршрут
Поискайте от доставчика да потвърди точната интеграция с превозвача, необходимите идентификационни данни за акаунта и всички допълнителни полета за пратката. Установете дали проследяването работи за договорените от вас услуги и дали са нужни пощенски код или информация за местоназначението. Не приемайте, че успешният тест с една услуга доказва поддръжка за друга.
Използвайте собствените си пратки, за да проверите пълнотата на събитията. Сравнете отговора на API със страницата за проследяване на превозвача, като записвате кога е извършена всяка проверка. Целта не е непременно формулировката да бъде идентична, а оперативно значимата информация да се запази в интеграцията.
Тествайте международните предавания отделно
Трансграничните пратки могат да включват повече от един партньор за доставка. Проверете дали интеграцията показва последващ превозвач или номер за проследяване, когато тази информация е налична. Проверете също дали приложението ви може да свърже няколко номера за проследяване с една пратка, без да създава дублиращи се известия към клиентите.
Не приемайте, че API може да покаже събития, които основната мрежа за доставка не е предоставила. Разграничете проблем с интеграцията, забавяне при публикуване от превозвача и действителна празнина в пътя на пратката, преди да определяте отговорност.
Проверете откриването на превозвача и нееднозначните номера
Ако доставчикът предлага автоматично откриване на превозвач, тествайте нееднозначни и неправилно въведени номера. Попитайте дали можете да подадете изричен идентификатор на превозвача и как системата обработва несигурно съвпадение. Грешно съвпадение, което генерира правдоподобно изглеждащи събития, може да бъде по-проблемно от ясна грешка при валидирането.
При работни процеси с по-висок риск съхранявайте превозвача, предоставен от системата ви за изпълнение на поръчки, заедно с номера за проследяване. Приемайте автоматичното откриване като функция за валидиране, а не като заместител на съхраняването на метаданни за пратката.
Изберете между директни интеграции с превозвачи и API за множество превозвачи
Директната интеграция с превозвач може да е подходяща за бизнес със стабилен набор от превозвачи и изисквания, тясно свързани с данните на конкретен превозвач. Тя обаче оставя на екипа ви отговорността да внедри и поддържа всяка отделна връзка.
API за множество превозвачи си заслужава да бъде оценен, когато системите ви се нуждаят от обща интеграция с няколко мрежи за доставка. Общият интерфейс обаче не означава автоматично еднаква дълбочина на данните, честота на актуализациите или качество на събитията при всички превозвачи. Тези разлики все още трябва да бъдат тествани.
17TRACK е относим към тази оценка чрез своето предложение за Tracking API. Използвайте официалната документация за API като отправна точка за проверка на изискванията за интеграция, след което валидирайте директно списъка си с превозвачи и услуги. Това е кандидат за оценка в рамките на същия процес на приемане, а не причина да пропускате тестовете за покритие или надеждност.
Правило за решение: предпочетете подход с множество превозвачи, когато общата интеграция съществено намалява поддръжката, без да губите необходимите събития. Предпочетете директна интеграция, когато специфично изискване на превозвача е решаващо и екипът ви може да го поддържа. Хибридният подход може да е подходящ, но определете кой източник има приоритет, ако и двата отчитат една и съща пратка.
Оценете модела на събитията, преди да изграждате работни процеси за клиентите
Данните за проследяване стават полезни само когато софтуерът ви ги интерпретира правилно. Поискайте примерни отговори, обхващащи нормални доставки, изключения, връщания и пратки, за които все още няма събития. Прегледайте както общите категории статуси, така и наличните оригинални описания от превозвача.
Общият статус „изключение“ може да е подходящ за табло, но екипът ви за поддръжка може да трябва да различава проблем с адреса от неуспешен опит за доставка. Обратно, необработеното съобщение от превозвача може да бъде твърде непоследователно, за да задейства комуникация с клиентите без допълнително съпоставяне.
- Времеви маркери: Определете дали дадено поле представлява времето на събитието, времето на извличане или времето на известяването и как се изразяват часовите зони.
- Идентичност на събитието: Проверете дали събитията имат стабилни идентификатори или приложението ви трябва да създаде ключ за премахване на дубликати.
- Промени в статуса: Установете как се представят корекциите, по-старите събития и актуализациите след привидна доставка.
- Липсваща информация: Потвърдете как се показват неизвестните местоположения, липсващите времеви маркери и неналичните прогнози за доставка.
- Необработени подробности: Решете дали запазването на оригиналното описание на събитието е необходимо за поддръжка и разследване.
Разграничаването на „все още няма събития за проследяване“ от „изгубена“ е важно. По същия начин не превръщайте прогнозата за доставка в гарантирана дата на доставка. Приложението ви трябва да запазва несигурността, вместо да създава сигурност, която изходните данни не подкрепят.
Проектирайте за неуспешни webhook известия, а не само за успешни заявки
Ако API в краткия списък предлага webhook известия, проучете как се удостоверяват, повтарят и потвърждават. Ако използва периодично извличане, установете ограниченията за заявките и график за извличане, който отговаря на оперативните ви нужди. Нито един от двата подхода не премахва необходимостта от наблюдение и възстановяване.
При интеграция, базирана на webhook известия, надеждният дизайн е да валидирате заявката, да съхраните трайно или да поставите в опашка полезния товар и след това да потвърдите получаването му според изискванията на доставчика. Обработвайте известията към клиентите отделно, така че бавната услуга за съобщения да не блокира приемането.
Преди внедряването отговорете на следните въпроси:
- Как вашият краен адрес проверява, че заявката идва от доставчика?
- Какво се случва, когато крайният ви адрес изтече или върне грешка?
- Могат ли доставките да се дублират или да пристигнат извън ред?
- Могат ли пропуснатите актуализации да бъдат извлечени или възпроизведени?
- Как се сменят идентификационните данни, без да се прекъсва услугата?
- Какво се случва, когато по време на възстановяване бъдат достигнати ограниченията за честота?
Проектирайте обработката да бъде идемпотентна: повторното получаване на същата актуализация не трябва да създава ново съобщение към клиента или дублираща се задача за поддръжка. Съхранявайте състоянието на пратката отделно от историята на известията и записвайте защо е задействано всяко действие, насочено към клиента.
Планирайте и за неуспешни регистрации. Ако добавянето на номер за проследяване е неуспешно, съхранете ясна грешка и повторете опита само когато е подходящо. Повтарящото се изпращане на невалиден идентификатор не е стратегия за възстановяване.
Проведете доказване на концепцията с ясни критерии за успешно преминаване
Полезното доказване на концепцията сравнява интеграцията с вашите изисквания, а не с изпипана демонстрация. Включете пратки от всяка важна комбинация превозвач–услуга и умишлено тествайте неблагоприятни условия.
| Тестов случай | Какво да проверите | Принцип за приемане |
|---|---|---|
| Вътрешна доставка във Великобритания | Пълнота на събитията и краен статус | Необходимите етапи достигат до правилната поръчка. |
| Трансгранично предаване | Промени на превозвача и допълнителни идентификатори | Наличната информация за предаването остава свързана с пратката. |
| Изключение при доставка | Значение на статуса и оригинални подробности | Подходящият екип може да определи следващото действие. |
| Дублираща се или по-стара актуализация | Премахване на дубликати и подреждане на събитията | Не се създава дублиращо съобщение или неправилно връщане към предишно състояние. |
| Временен отказ на крайния адрес | Повторни опити и съгласуване | Пропуснатата информация може да бъде възстановена чрез тестван процес. |
Определете собствените си прагове преди теста. Измерете пълнотата на събитията спрямо дефинираните етапи и запишете закъснението между наблюдаването на събитие при превозвача и получаването му чрез API. Поддържайте методите за наблюдение последователни; само времевият маркер на събитието не установява кога това събитие е станало достъпно.
Разделете критичните повреди от предпочитанията. Липсващото задължително покритие или неизползваемият процес за възстановяване трябва да блокират внедряването. По-малко удобното табло може да не го блокира. Не позволявайте високият общ резултат да прикрива провал по задължително изискване.
Сравнете общите разходи, обработката на данни и поддръжката
Поискайте оферта, базирана на обема и модела на използване на вашите пратки. Изяснете какво се таксува: регистрирани номера за проследяване, заявки, активни пратки, актуализации или друга единица. Попитайте как се третират дублиращите се регистрации, историческите справки, неуспешните подавания и надвишените лимити. Не приемайте, че два плана използват еднаква дефиниция за проследявана пратка.
Включете инженерната поддръжка, наблюдението, обработката на изключения и работата по миграцията във вашия модел на разходите. Ниската абонаментна такса не означава непременно ниски оперативни разходи, както и по-високата такса не е доказателство за по-добро качество на проследяване.
Що се отнася до обработката на данни, документирайте кои полета ще напускат системите ви и защо. Избягвайте да изпращате информация за клиенти, от която интеграцията не се нуждае. Прегледайте с екипите си по сигурността и поверителността контрола на достъпа, съхранението, изтриването, хостинг договореностите и договорните отговорности. Не правете извод за локализиране на данните във Великобритания или за регулаторна пригодност само защото API проследява пратки във Великобритания.
Договореностите за поддръжка трябва да съответстват на бизнес въздействието при повреда. Попитайте как се ескалира специфичен за превозвача проблем, каква диагностична информация е необходима на поддръжката и кои ангажименти за обслужване са договорни. Общият ангажимент за достъпност на платформата сам по себе си не гарантира навременни събития от всеки превозвач.
Направете внедряването обратимо
Започнете с контролирана група пратки и сравнете резултатите, преди да активирате автоматизацията, насочена към клиентите. Когато е практично, стартирайте новата интеграция в режим на наблюдение, за да може екипът ви да проверява съпоставянето на статусите, без да изпраща съобщения.
Определете отговорник за идентификационните данни, конфигурацията на превозвачите, известяването и реакцията при инциденти. Съхранявайте достатъчно идентификатори на пратките и история на обработката, за да разследвате грешки и да поддържате бъдеща миграция. Потвърдете, че екипът ви може да експортира необходимите записи, вместо да приемате тяхната преносимост.
Правилният API за проследяване на пратки във Великобритания е този, който преминава задължителните ви тестове за маршрути и събития, вписва се във вашата интеграционна архитектура и има приемливи оперативни условия. Вземете това решение въз основа на доказателства от пратки и тестове за възстановяване, а не само на общия брой превозвачи или етикетите на функциите.
Често задавани въпроси
Нуждае ли се бизнес във Великобритания от API за проследяване, хоствано във Великобритания?
Не автоматично. Покритието на превозвачите, местоположението на хостинга и договореностите за обработка на данни са различни въпроси. Първо определете бизнес изискванията и изискванията си за поверителност, след което проверете дали договореностите на доставчика ги изпълняват. Проследяването на пратки във Великобритания не установява къде се обработват данните.
Мога ли да проследя пратка, използвайки само номер на поръчка?
Не приемайте, че е така. Вътрешният номер на поръчка може да не бъде разпознат от превозвача или API. Системата ви трябва да съхранява връзката между поръчката и идентификаторите на пратките, включително няколко пакета или заместващи пратки. Потвърдете кои идентификатори приема интеграцията.
Винаги ли webhook известията са по-добри от периодичното извличане?
Не. Webhook известията могат да намалят повтарящите се заявки за извличане, но изискват надежден краен адрес за получаване и обработка на дубликати. Периодичното извличане може да е подходящо за някои работни процеси при спазване на ограниченията за заявки и приемливи закъснения. Избирайте въз основа на документираното поведение и тестваното възстановяване, вместо да приемате, че някой от методите е достатъчен по своята същност.
Какво да направя, когато страницата на превозвача и API не съвпадат?
Запишете номера за проследяване, превозвача, необработените отговори и времето на наблюдение. Проверете дали разликата се отнася до формулировка, липсващи събития или действително различно състояние на пратката. Прилагайте определен процес за ескалация и съгласуване; избягвайте тихото превключване между източници, без да вземете предвид дублиращите се известия или конфликтните съпоставяния на статуси.
Източници
Официалните препратки по-долу са отправни точки за оценяване на 17TRACK като кандидат. Наличността на услуги на превозвачите, ценообразуването, договореностите за сигурност и договорните ангажименти трябва да бъдат потвърдени за предложеното внедряване. Критериите за тестване и избор в това ръководство са редакционни препоръки, а не твърдения, че всеки доставчик предлага описаните възможности.
- 17TRACK Tracking API — официална продуктова справка за предложението за API, обсъждано в това ръководство.
- 17TRACK API documentation — официална техническа справка за проверка на изискванията за интеграция преди внедряването.


