Skip to main content
НачалоБлогРъководстваКак да изберете API за проследяване на пратки за доставки в Европа

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

17TRACK

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

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

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

Определете какво трябва да помогне на екипа ви да прави API

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

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

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

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

Оценявайте европейските маршрути за доставка, а не само покритието по държави

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

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

Модел на доставкаКакво да тестватеЗащо е важно
Вътрешна доставка до домаПърво сканиране, опит за доставка, събитие за доставена праткаСъздава базова линия за обикновени пратки
Предаване през границаПромени в номера за проследяване и непрекъснатост между превозвачитеПоказва дали видимостта се запазва след предаването
Доставка до пункт или шкафче за праткиСтатус „готова за получаване“ спрямо „получена“Предотвратява съобщаването на клиентите, че неполучена пратка е получена
Пратка, включваща митническа обработкаНалични събития за оформяне и описания на изключениятаПомага да се разграничи отчетената митническа дейност от необяснима липса на проследяване
Връщане до подателяПосока на връщане и краен статусПредотвратява третирането на върната пратка като успешна доставка до клиента

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

Проверете значението на данните за проследяване

Съхранявайте стандартизирани статуси и оригинални събития

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

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

Разграничавайте времето на събитието от времето на актуализацията

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

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

Отнасяйте се внимателно към прогнозите и преводите

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

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

Тествайте интеграцията при откази, а не само при успех

Успешният отговор от API доказва, че една заявка е работила. Той не доказва, че приложението ви ще остане синхронизирано при повторни опити, забавени събития или прекъсване.

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

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

  • Регистрация: Тествайте дублирани изпращания, невалидни идентификатори и пратки, регистрирани преди първото сканиране от превозвача.
  • Подреждане на събитията: Проверете дали забавено по-старо събитие може неправилно да замени по-новото състояние на пратката.
  • Възстановяване: Прекъснете получателя си и потвърдете как могат да бъдат възстановени актуализациите след това.
  • Сигурност: Прегледайте ротацията на идентификационните данни, контролите за достъп, сигурността на преноса и всеки документиран механизъм за проверка на webhook.
  • Жизнен цикъл: Определете кога проследяването спира, колко дълго остава налична историята и дали при необходимост дадена пратка може да бъде проследявана отново.
  • Управление на промените: Попитайте как се съобщават версиите на API, несъвместимите промени и инцидентите, свързани с превозвачите.

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

Включете изискванията за поверителност в процеса на снабдяване

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

Общият регламент относно защитата на данните определя изисквания, свързани с този преглед, включително минимизиране на данните и ограничаване на съхранението в член 5, отношенията с обработващите лични данни в член 28, сигурността в член 32 и изискванията за международни трансфери в глава V. Приложимите задължения зависят от дейностите ви по обработване и ролите на страните.

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

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

Сравнете общите разходи при еднакво натоварване

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

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

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

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

Мястото на 17TRACK в оценката

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

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

Решението трябва да следва пилотния проект: включете услугата в краткия списък, ако отговаря на изискванията ви на ниво маршрут и на оперативните ви изисквания, вместо да приемате познаваемостта на марката или широките твърдения за покритие като достатъчно доказателство.

Проведете пилотен проект с ясни критерии за приемане

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

  1. Първо определете изискванията за успешно или неуспешно преминаване. Примерите включват поддръжка на критичен маршрут, правилно разграничаване на получаването и доставката, възстановими актуализации и приемливи условия за обработване.
  2. Проверявайте спрямо записите на превозвача. Сравнете избрани API събития със собствения запис за проследяване на превозвача. Записвайте липсващи събития, разлики в статусите и нееднозначни времеви обозначения.
  3. Измервайте актуалността справедливо. Записвайте кога тестът ви наблюдава събитие в източника на превозвача и чрез API. Опишете метода на наблюдение; той може да не покаже точния момент, в който превозвачът за първи път е публикувал събитието.
  4. Тествайте оперативните резултати. Потвърдете, че служителите по поддръжката могат да интерпретират изключенията и че известията до клиентите остават точни, когато събитията пристигат със закъснение или се повтарят.
  5. Разследвайте несъответствията. Разделяйте пропуските на превозвача източник, поведението на доставчика и грешките във вашето собствено съпоставяне. Не приписвайте всяко липсващо събитие на API.
  6. Документирайте решението. Запишете приетите ограничения, нерешените въпроси, търговските предпоставки и отговорника за всяко последващо действие.

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

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

Означава ли по-голям списък с превозвачи по-добро проследяване в Европа?

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

Може ли API за проследяване да накара превозвача да актуализира сканиранията си по-бързо?

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

Имам ли нужда от webhooks, периодично извличане или и от двете?

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

Трябва ли всяко изключение при проследяването да предизвиква съобщение до клиента?

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

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

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

Източници