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

Това ръководство е предназначено за екипи по електронна търговия, разработчици и отговорни за снабдяването, които свързват видимостта на пратките с онлайн магазин, система за управление на поръчки, платформа за обслужване на клиенти или вътрешно табло. Целта е да изберете надежден източник на информация за доставките, а не просто крайна точка, която приема номера за проследяване.
Започнете с доставките, които бизнесът ви действително извършва
„Покритие във Франция“ е твърде широко понятие, за да служи като изискване при закупуване. Бизнес, който изпраща вътрешни пратки до домашни адреси, има различни нужди от търговец, който внася стоки във Франция и ги доставя до пунктове за получаване. Определете профила на пратките, преди да поискате демонстрации или оферти.
- География на доставката: Идентифицирайте отделно континентална Франция, Корсика и всички френски отвъдморски дестинации. Поискайте от доставчиците да потвърдят съответните услуги, вместо да приемате, че едно географско обозначение обхваща всеки маршрут.
- Метод на доставка: Разделете доставката до дома, обслужваните пунктове за получаване, автоматите за пратки и другите услуги, които действително предлагате.
- Превозвач и услуга: Записвайте името на оператора и услугата, а не само платформата за изпращане, чрез която сте закупили етикета.
- Посока на пратката: Разграничавайте вътрешните доставки, входящите международни пратки, изходящите поръчки и връщанията.
- Оперативна употреба: Решете дали проследяването ще захранва известията към клиентите, управлението на изключенията, проверките от отдела за поддръжка или и трите.
Изградете матрица на превозвачите въз основа на скорошни поръчки. В зависимост от бизнеса ви тя може да включва услуги, свързани с Colissimo, Chronopost или Mondial Relay. Това са примери, които да проверите спрямо собствените си записи за доставки, а не твърдение, че даден API поддържа всяка услуга, която те предлагат.
Включете очаквания обем по превозвач и услуга. Доставчик, който надеждно обработва най-натоварения ви поток от доставки, може да е по-подходящ от такъв с по-голям глобален каталог, но с непроверена поддръжка на основните ви маршрути.
Изберете между директни интеграции с превозвачи и API за множество превозвачи
Директната интеграция с превозвач си заслужава да бъде разгледана, когато един превозвач обработва по-голямата част от пратките и екипът ви се нуждае от достъп до специфична за превозвача информация. Все пак ще трябва да проверите допустимостта на акаунта, документацията, наличността на събитията и условията за интеграция с този превозвач.
API за проследяване на множество превозвачи си заслужава да бъде разгледан, когато бизнесът ви използва няколко превозвача или редовно обработва международни предавания. Потенциалната му стойност е намаляването на броя интеграции, които екипът ви поддържа, и представянето на различни формати за проследяване чрез общ интерфейс. Дали ще постигне тази стойност зависи от превозвачите и работните процеси, които тествате.
Нито един от двата подхода автоматично не гарантира по-бързи актуализации или по-подробни събития. Сравнявайте действителните резултати и изискванията за поддръжка, вместо да приемате, че директният достъп винаги е по-богат или че обобщаването винаги е по-просто.
При кратък списък от API за множество превозвачи Tracking API на 17TRACK е подходяща опция за проучване. Използвайте неговата официална документация за API и проведете техническа дискусия, за да проверите необходимите услуги на превозвачите, работния процес на интеграцията, доставката на събития и търговските условия. Подходящността му за доставки във Франция трябва да бъде установена чрез собствена извадка от пратки, а не да се извежда от наличността на потребителската му услуга за проследяване.
Тествайте покритието на услугите, а не само разпознаването на превозвачите
Успешното търсене по номер за проследяване е само първият тест. Приложението ви се нуждае от достатъчно информация, за да обясни какво се е случило и да поддържа следващото действие.
| Област на оценяване | Какво да проверите | Защо е важно |
|---|---|---|
| Идентифициране на превозвача | Разпознаване на действителните ви номера и начин за коригиране на нееднозначни съвпадения | Правдоподобно, но неправилно съвпадение може да доведе до подвеждащи резултати. |
| Покритие на услугите | Събития за конкретните вътрешни и международни услуги, които закупувате | Самото име на превозвача не доказва покритие на ниво услуга. |
| Събития в пунктове за получаване | Отделно обработване на пристигането, наличността за получаване и получаването от клиента | Пратка, която чака получаване, не трябва да задейства съобщение за завършена доставка. |
| Международни предавания | Непрекъснатост между превозвача в началната точка и мрежата за доставка в дестинацията | Клиентите се нуждаят от видимост и след като пратката смени мрежата. |
| Подробност на събитията | Оригинални описания, нормализирани статуси, местоположения и времеви печати, когато са налични | Екипите за поддръжка се нуждаят от контекст отвъд общия етикет на статуса. |
Не приемайте липсващо поле като доказателство за дефект в API, без да проверите базовите данни от превозвача. Част от информацията може да не се публикува от превозвача, да зависи от услугата или да е налична само при определени условия за достъп. Поискайте от доставчика да обясни границите.
Проверете дали събитията за доставки във Франция водят до правилното действие
Пунктове за получаване и автомати
При доставки, базирани на получаване от пункт, наличността и завършването са различни бизнес събития. Проверете дали API запазва това разграничение и дали приложението ви го преобразува правилно. Ако данните включват инструкции за получаване или краен срок, проверете източника и значението им, преди да ги покажете. Не изчислявайте универсален краен срок за получаване въз основа на предполагаема политика на превозвача.
Полезен тест за приемане е прост: когато пратката стане налична за получаване, системата ви трябва да изпрати инструкции за получаване, а не съобщение „доставено до вас“. Когато получателят я получи, времевата линия на поръчката трябва да отрази финалното събитие, без да изпраща отново предишното известие.
Опити за доставка и изключения
Широка категория за изключение може да прикрива много различни ситуации, включително неуспешен опит за доставка, проблем с адреса или забавяне, свързано с митнически процедури. Запазете оригиналното описание на събитието достъпно за служителите по поддръжката, дори ако клиентите виждат опростен етикет.
Решете кои събития изискват намеса. Проблем с адреса може да изисква билет към отдела за поддръжка; обикновено сканиране при обработка обикновено не изисква. Тези правила трябва да бъдат част от оперативния ви дизайн, а не да се приемат автоматично от таксономията на статусите на доставчика.
Език и време
Попитайте дали описанията на събитията са оригинален текст на превозвача, преведен текст или стандартизирани етикети. Вашият онлайн магазин може да предоставя последователна формулировка на френски, но не трябва да добавя сигурност, която изходното събитие не съдържа.
Запазвайте отместванията на времевите печати и различавайте времето на настъпване на събитието от времето, в което системата ви го е получила. За континентална Франция използвайте реализация, съобразена с часовата зона, като Europe/Paris, когато показвате местни часове, вместо фиксирано UTC отместване. Когато е уместно, обработвайте часовите зони на други дестинации отделно.
Оценете доставката на актуализации и поведението при възстановяване
Уебхуковете могат да намалят нуждата от повтарящи се заявки за статус, но получаването на уебхук не означава, че събитието е било заснето непосредствено след физическото сканиране. Възможно е да има отделни интервали между сканирането, публикуването от превозвача, извличането от доставчика на проследяването и обработката от приложението ви.
Поискайте от доставчиците да обяснят тези етапи и всички документирани ангажименти за обслужване. Избягвайте сравняването на твърдения за „проследяване в реално време“ без общо определение.
- Удостоверяване: Как се удостоверяват входящите известия и как се сменят идентификационните данни?
- Повторни опити: Какво се случва, когато крайната ви точка изтече или върне грешка?
- Дубликати: Може ли едно и също събитие да пристигне повече от веднъж и как трябва да го идентифицирате?
- Подреждане: Могат ли по-ранни събития да пристигнат след по-късни?
- Възстановяване: Можете ли да извлечете историята на пратката или да възстановите актуализации след прекъсване?
- Ограничения: Какви ограничения за заявки, регистрации, едновременност или полезен товар се прилагат?
Проектирайте интеграцията си така, че да понася повторни опити и закъснели събития. Съхранявайте събитията надеждно, предотвратявайте дублирани съобщения към клиентите и не заменяйте статус за завършена доставка с по-стар статус „в транзит“ само защото е пристигнал по-късно.
Тествайте също неуспешните регистрации на пратки. Невалиден номер, неподдържана услуга или нееднозначно съвпадение на превозвач трябва да попадне във видима опашка за изключения, вместо да изчезне от покритието за проследяване.
Прегледайте защитата на данните, преди да изпращате реална информация за клиенти
Данните за проследяване могат да представляват лични данни, когато са свързани с идентифицируемо лице. Съгласно GDPR съответните задължения могат да включват минимизиране на данните, ограничение на съхранението, подходяща сигурност, договорености с обработващи лични данни и гаранции при международни трансфери. Точните отговорности зависят от конфигурацията на услугата и ролите на страните.
Официалният текст на GDPR предоставя правната референция, включително членове 5, 28 и 32 и глава V. Приемайте уверенията на доставчика като отправна точка за преглед, а не като заместител на проверката на предложената договореност за обработване.
- Идентифицирайте кои полета изисква интеграцията и избягвайте изпращането на имена, адреси или данни за контакт, освен ако не са необходими за предвидената функция.
- Поискайте приложимото споразумение за обработване на данни и изяснете ролите на администратора и обработващия.
- Проверете местоположенията на хостинга, подизпълнителите и всички относими договорености за международни трансфери.
- Потвърдете процедурите за съхранение, изтриване, контрол на достъпа и уведомяване при инциденти.
- Не съхранявайте идентификационни данни за API и ненужна лична информация в регистрационните файлове на приложението.
Не приемайте, че изискването за доставка във Франция автоматично означава, че всяка дейност по обработване на данни трябва да се извършва във Франция. Също така не приемайте, че твърдението за хостинг в ЕС разрешава всеки въпрос за съответствие. Включете екипа си по защита на личните данни или правния си екип преди одобрение.
Сравнете таксуваната единица с жизнения цикъл на пратките си
Поискайте оферта въз основа на действителния си модел на трафика. Такса, описана като „за проследяване“, не е достатъчно точна, докато доставчикът не обясни какво се счита за таксувана единица.
Попитайте как договорът третира регистрациите, повтарящите се търсения, дублираните изпращания, неуспешните регистрации, връщанията и пратките, които остават активни дълго време. Потвърдете дали известията, историческият достъп, поддръжката или допълнителните среди влияят върху цената. Това са въпроси за снабдяването, а не предположения за модела на таксуване на конкретен доставчик.
Моделирайте както обичайното търсене, така и очаквания пик. Включете инженерната поддръжка и натоварването на екипа по поддръжката наред с абонаментните или потребителските такси. По-ниската обявена цена може да не доведе до по-ниски оперативни разходи, ако екипът ви трябва ръчно да разрешава чести несъответствия.
Получете договорените ограничения и определенията за таксуване в писмен вид. Когато публичната документация не разрешава дадено изискване, запишете го като изискващо потвърждение, вместо да го приемате за неподдържана възможност.
Проведете пилотен проект, който може да доведе до ясно решение
Използвайте представителен набор от реални пратки при спазване на контролите за защита на данните. Включете обичайни успешни доставки и трудни маршрути: закъснели сканирания, доставка до пункт за получаване, неуспешни опити, международни предавания, връщания и наскоро създадени етикети без физическо сканиране при приемане.
- Създайте референтен запис. Запазете съответната история на проследяване от превозвача и часовете на наблюдение. Страницата на превозвача е полезна референция, въпреки че времето на публикуване от него може да се различава от това на други канали.
- Свържете предвидения работен процес. Тествайте регистрацията, приемането на събития, съхранението, преобразуването на статуси и известията — не само примерните отговори в конзола.
- Измерете определените резултати. Проследявайте използваемите резултати от проследяването, точността на преобразуването на статуси, наблюдаваното закъснение на актуализациите и ръчните намеси. Определете знаменателя за всяка метрика.
- Симу-лирайте повреди. Временно прекъснете приемника си, възпроизведете събитие, изпратете невалиден номер и тествайте контролиран скок на трафика в рамките на договорените ограничения.
- Прегледайте несъответствията. Разделете пропуските при публикуване от страна на превозвача, проблемите при извличане от доставчика и собствените си грешки при обработката.
- Одобрете спрямо писмени критерии. Осигурете подписване от отговорните за инженерната дейност, операциите и защитата на личните данни на съответните им изисквания.
Определете числови прагове преди пилотния проект според нуждите на услугата. Няма универсално приемливо закъснение или процент на успех за всеки търговец. Табло за поддръжка и чувствително към времето напомняне за получаване може да изискват различни стандарти.
Изберете API, който преминава през работните процеси с най-голям обем и най-висок риск при приемливи разходи и усилия за поддръжка. Ако нито една опция не премине, ограничете внедряването до проверени услуги или запазете отделна интеграция за проблемния превозвач. Контролираното частично стартиране е за предпочитане пред представянето на ненадеждна информация за доставките като пълно покритие.
Често задавани въпроси
Може ли един API за проследяване да обработва всяка доставка до Франция?
Не приемайте това. Потвърдете конкретните превозвачи, услуги, дестинации и модели на предаване, които използвате. Дори когато даден превозвач е в списъка, тествайте подробността на събитията, необходима за работните процеси на клиентите и отдела за поддръжка.
API за проследяване закупува ли етикети или организира ли доставки?
Не непременно. Проследяването, създаването на етикети, резервирането на пратки, проверката на адреси и прогнозирането на датата на доставка са отделни функции. Включете ги в изискванията си само ако са необходими и проверете всяка от тях отделно.
Трябва ли да използваме уебхукове вместо периодично извличане?
Уебхуковете могат да бъдат полезни за получаване на актуализации, без да се изисква многократно запитване за всяка пратка. Реализацията ви все пак се нуждае от удостоверяване, обработване на дубликати, повторни опити и път за възстановяване. Потвърдете дали крайна точка за търсене или друг механизъм може да запълни пропуските след прекъсване.
Можем ли да обещаем дата на доставка въз основа на събитията за проследяване?
Само ако разполагате с подходящ източник за тази дата и разбирате значението ѝ. Очакваната дата на доставка не е автоматично гарантиран ангажимент. Разграничавайте оценките на превозвача, прогнозите, генерирани от доставчика, и датите, изчислени от собственото ви приложение.
Какво трябва да направим, когато API и уебсайтът на превозвача не са съгласни?
Сравнете текста на събитието, часа на събитието, часа на извличане, самоличността на превозвача и номера за проследяване. Запазете и двата записа и проверете дали разликата отразява времето на публикуване, преобразуването на статуса, предаване или неправилно съвпадение. Не превръщайте едно несъответствие в заключение за целия доставчик.
Източници
- 17TRACK Tracking API — официална продуктова страница за оценяване на разглежданата в това ръководство API опция.
- Документация за API на 17TRACK — официална техническа референция за проверка на изискванията за интеграция и поддържаното поведение преди внедряване.
- Регламент (ЕС) 2016/679, Общ регламент относно защитата на данните — основна правна референция за принципите за защита на данните, задълженията на обработващите, изискванията за сигурност и рамката за международни трансфери, обсъдени по-горе.


