Како да изберете API за следење на пратки за европски испораки
Изберете API за следење на пратки за европски испораки така што ќе ги тестирате вашите реални превознички рути, прекуграничните предавања, точноста на настаните и сигурноста на интеграцијата — а не само со споредување на бројот на превозници. За тимот за е-трговски операции и неговиот инженерски партнер, вистинскиот API е оној што ги претвора настаните на пратките во сигурни ажурирања за клиентите и применливи исклучоци, истовремено исполнувајќи ги вашите барања за приватност, поддршка и трошоци.

Започнете со испораките што вашиот бизнис навистина ги реализира. Домашна пратка, меѓународна пратка предадена на локален партнер за испорака и поврат може да постават многу различни барања за истата интеграција. Користете ги овие испораки за да направите кратка листа, спроведете контролиран пилот и донесете одлука за купување.
Дефинирајте за што треба да му помогне API-то на вашиот тим
API за следење презема или испорачува информации за статусот на пратките за употреба во вашите системи. Тој автоматски не е услуга за испраќање транспортни етикети, услуга за царинење или гаранција за успешна испорака. Чувајте ги овие барања одделно, освен ако конкретно не ви е потребно комбинирано решение.
Пред да ги разгледате добавувачите, усогласете се околу оперативните резултати. Поддршката за клиенти можеби ќе има потреба од најновиот настан од превозникот и причина за ескалација. Системот за управување со нарачки можеби ќе има потреба од стандардизирани статуси. Страницата за следење наменета за клиентите можеби ќе има потреба од преведени пораки и јасно разграничување меѓу проценета и потврдена испорака.
- Именувајте го носителот на одлуката. Операциите треба да ги дефинираат работните текови за испорака; инженерството треба да го потврди однесувањето на интеграцијата; тимовите за приватност и набавки треба да ги одобрат релевантните договорни услови.
- Мапирајте ги вклучените системи. Идентификувајте кој систем ги регистрира пратките, ги прима ажурирањата, ја складира историјата и испраќа известувања до клиентите.
- Одделете ги барањата од преференциите. Точното следење на критична испорачателна рута е барање. Практичната контролна табла може да биде преференција ако вашиот тим веќе работи во интерна платформа.
- Дефинирајте го однесувањето при неуспех. Одлучете што се случува кога API-то не е достапно, кога превозникот престанува да известува настани или кога бројот за следење не може да се идентификува.
Ова спречува честа грешка при набавка: избор на привлечна листа со функции пред да се одлучи како ќе се користат податоците.
Проценувајте ги европските испорачателни рути, а не само покриеноста по земји
„Европска покриеност“ е премногу широк поим за да служи како критериум за прифаќање. Европа и Европската Унија не се заменливи географски опфати, а царинскиот третман зависи од териториите, стоката и конкретното движење. Тоа што една земја се појавува на страницата за покриеност не значи дека секоја услуга на превозникот или секое предавање на вашата рута е поддржано.
Создадете матрица на рути користејќи ја сопствената историја на пратки. Вклучете потекло, дестинација, превозник, услуга и секој познат партнер за испорака. На оперативно најважните рути доделете им најголем удел во пилотот, но вклучете и тешки рути што создаваат несразмерно многу работа за поддршката.
| Модел на испорака | Што да се тестира | Зошто е важно |
|---|---|---|
| Домашна испорака до адреса | Прво скенирање, обид за испорака, настан „испорачано“ | Поставува основа за вообичаени пратки |
| Прекугранично предавање | Промени на бројот за следење и континуитет меѓу превозниците | Покажува дали видливоста опстојува по предавањето |
| Испорака до пакетомат или шкафче | Статус „подготвено за преземање“ наспроти „преземено“ | Спречува клиентите да бидат известени дека е примена непреземена пратка |
| Пратка што вклучува царинска обработка | Достапни настани за царинење и описи на исклучоци | Помага да се разликува пријавена царинска активност од необјаснет прекин во следењето |
| Враќање до испраќачот | Насока на враќање и краен статус | Спречува вратена пратка да се третира како успешна испорака до клиентот |
За секоја рута, побарајте од добавувачот да ја потврди точната поддршка за превозникот и услугата. Разјаснете дали треба да доставите идентификатор на превозникот, дали е достапно автоматско откривање и како се обработуваат нејасните броеви за следење. Не претпоставувајте дека поддршката за брендот на превозникот ги опфаќа сите негови услуги или поврзани мрежи.
Испитајте го значењето на податоците за следење
Чувајте ги стандардизираните статуси и оригиналните настани
Стандардизираните статуси го олеснуваат создавањето работни текови низ повеќе превозници. Сепак, широка ознака како „во транзит“ може да сокрие информации што му се потребни на тимот за поддршка. Побарајте и нормализиран статус и опис на основниот настан, кога е достапен.
Проверувајте тешки примери, а не само успешни испораки. Неуспешен обид, проблем со адресата, настан поврзан со царина и пратка што чека преземање треба да доведат до различни оперативни реакции. Интеграцијата не треба секој необичен настан да го претвора во исто итно известување до клиентот.
Разликувајте го времето на настанот од времето на ажурирањето
Постојат неколку корисни временски ознаки: кога превозникот вели дека се случил настанот, кога добавувачот на следењето го примил и кога вашата апликација го обработила. Чувајте ги овие разлики каде што податоците го дозволуваат тоа.
Обработката на временските зони е важна за европските рути. Прашајте дали временските ознаки вклучуваат отстапувања, како се претставуваат недостасувачките информации за временската зона и дали историјата на настани може да пристигне по невообичаен редослед. Не доделувајте тивко прецизна временска зона на нејасна изворна временска ознака.
Внимателно третирајте ги проценките и преводите
Ако ви се потребни проценети датуми на испорака, утврдете дали тие потекнуваат од превозникот или ги пресметува добавувачот. Проверете што се случува кога проценката ќе се промени или исчезне. Проценката треба визуелно да се разликува од потврдениот настан на испорака.
Исто така, одделете го јазикот на интерфејсот од преводот на настаните. Документација за API на англиски не значи дека настаните на превозникот се преведени на секој јазик што ви е потребен. Тестирајте репрезентативни пораки, особено упатства за преземање и исклучоци при испорака, и зачувајте го изворниот текст за истрага.
Тестирајте ја интеграцијата при неуспех, а не само при успех
Успешниот одговор од API докажува дека едно барање функционирало. Тој не докажува дека вашата апликација ќе остане синхронизирана при повторни обиди, доцни настани или прекин на услугата.
Ако добавувачот нуди веб-куки, проверете го методот на автентикација, однесувањето при повторен обид, очекувањата за истек на време и обработката на дупликатни испораки. Вашиот приемник треба да го потврди барањето, трајно да го зачува или стави во редица и навремено да го врати потребното потврдување. Дизајнирајте ја понатамошната обработка така што приемот на ист настан двапати нема да испрати две известувања или повторно да изврши деловно дејство.
Ако е достапно периодично преземање, разберете ги ограничувањата на стапката и начинот на усогласување на пропуштените ажурирања. Интеграцијата управувана од веб-куки и понатаму може да има корист од патека за обновување, но потврдете кои механизми за обновување навистина ги поддржува добавувачот.
- Регистрација: Тестирајте дупликатни поднесувања, неважечки идентификатори и пратки регистрирани пред првото скенирање од превозникот.
- Редослед на настани: Проверете дали задоцнет постар настан може неправилно да замени понова состојба на пратката.
- Обновување: Прекинете го приемникот и потврдете како може да се обноват ажурирањата потоа.
- Безбедност: Прегледајте ја ротацијата на акредитивите, контролите на пристап, безбедноста на преносот и секој документиран механизам за проверка на веб-куки.
- Животен циклус: Утврдете кога престанува следењето, колку долго останува достапна историјата и дали пратката може повторно да се следи ако е потребно.
- Управување со промени: Прашајте како се соопштуваат верзиите на API, промените што го нарушуваат компатибилитетот и инцидентите поврзани со превозниците.
Чувајте ја достапноста на услугата одделно од свежината на следењето. API може да биде достапен додека каналот на превозникот престанал да создава нови информации. Следењето треба да ги опфати и техничките неуспеси и неочекуваното молчење на важните рути.
Вклучете ги барањата за приватност во набавката
Бројот за следење не е нужно анонимен. Кога може да се поврзе со идентификуван клиент, неговото обработување може да вклучува лични податоци. Прегледајте го целосниот пакет податоци, вклучувајќи имиња, адреси, детали за испорака и сите други информации што вашата интеграција ги испраќа или прима.
Општата регулатива за заштита на податоците ги утврдува барањата релевантни за овој преглед, вклучувајќи минимизација на податоците и ограничување на чувањето во член 5, аранжмани со обработувачите во член 28, безбедност во член 32 и барања за меѓународен пренос во Поглавје V. Применливите обврски зависат од вашите активности за обработка и улогите на страните.
Побарајте од добавувачот релевантни услови за обработка на податоците, информации за подобработувачите, аранжмани за задржување, процес за бришење и локации на обработка. Ако личните податоци се пренесуваат надвор од Европската економска област, вашиот тим за приватност треба да ги процени применливите аранжмани за пренос. Самото европско хостирање не докажува усогласеност, а обработката надвор од Европа не е автоматски забранета.
Намалете ја изложеноста и во сопствената имплементација. Избегнувајте испраќање информации за клиентите што не му се потребни на работниот тек за следење, ограничете го пристапот до необработените пакети податоци и спречете непотребни лични податоци да влегуваат во дневниците на апликацијата.
Споредете го вкупниот трошок користејќи исто оптоварување
Не споредувајте ги главните цени додека не разберете што наплатува секој план. Прашајте дали трошоците се однесуваат на регистрирани пратки, барања, ажурирања, кредити или друга единица. Потврдете како се третираат неуспешните регистрации, дупликатните регистрации, повторното следење и надминувањата.
На секој добавувач од кратката листа доставете му ист опис на оптоварувањето: очекуван број месечни пратки, врвен сообраќај при регистрација, вообичаено времетраење на следењето, потребни рути и очекувања за поддршка. Побарајте писмена проценка и претпоставките зад неа.
Вашата интерна споредба треба да ги опфати работата на имплементацијата, следењето, напорот за поддршка и обработката на исклучоците — а не само фактурата за API. Не припишувајте претпоставени заштеди на помал број контакти со поддршката освен ако вашиот пилот или постојните оперативни податоци не ја поддржуваат таа претпоставка.
Проверете и како би ја напуштиле услугата. Разберете дали можете да ја извезете потребната историја на пратките, како се повлекуваат акредитивите и складираните податоци и какви промени би барала миграцијата во вашиот интерен модел на статуси.
Каде се вклопува 17TRACK во проценката
За бизнис што проценува интеграција за следење со повеќе превозници, Tracking API на 17TRACK е релевантен кандидат за проценка. Користете ја официјалната документација за API за да ги испитате барањата за интеграција, а потоа потврдете ги вашите европски рути со репрезентативни пратки.
Применете ги истите критериуми за прифаќање на 17TRACK што би ги примениле на секој добавувач од кратката листа. Потврдете ја поддршката за превозникот и услугата, однесувањето на настаните, ограничувањата на сметката, комерцијалните услови и барањата за приватност за планираната имплементација. Пребарувањето на пратка за потрошувачи може да помогне при истрага на поединечна пратка, но не го заменува тестирањето на работниот тек на API што ќе го користи вашиот продукциски систем.
Одлуката треба да следи по пилотот: изберете ја услугата ако ги исполнува вашите барања на ниво на рута и операции, наместо да ја сметате познатоста на брендот или широките тврдења за покриеност за доволен доказ.
Спроведете пилот со јасни критериуми за прифаќање
Користете историски пратки за да ги испитате завршените низи на настани, а активни пратки за да го тестирате доставувањето на ажурирањата. Вклучете успешни испораки, предавања, неуспешни обиди, испораки до места за преземање и поврати каде што е релевантно. Отстранете ги непотребните податоци за клиентите од тестниот сет.
- Прво дефинирајте ги условите за поминување или непоминување. Примери се поддршка за критична рута, правилно разликување на преземањето и испораката, ажурирања што може да се обноват и прифатливи услови за обработка.
- Проверете според записите на превозникот. Споредете ги примероците на API настани со сопствениот запис за следење на превозникот. Забележете ги недостасувачките настани, разликите во статусите и нејасностите кај временските ознаки.
- Измерете ја свежината праведно. Забележете кога вашиот тест набљудува настан во изворот на превозникот и преку API. Опишете го методот на набљудување; тој можеби нема да го открие точниот момент кога превозникот првпат го објавил настанот.
- Тестирајте ги оперативните резултати. Потврдете дека персоналот за поддршка може да ги толкува исклучоците и дека известувањата до клиентите остануваат точни кога настаните пристигнуваат доцна или се повторуваат.
- Истражете ги несогласувањата. Одделете ги празнините кај изворниот превозник, однесувањето на добавувачот и грешките во вашето мапирање. Не припишувајте му го секој недостасувачки настан на API.
- Документирајте ја одлуката. Запишете ги прифатените ограничувања, нерешените прашања, комерцијалните претпоставки и сопственикот на секое последователно дејство.
Изберете го API-то што ги поминува вашите критични рути и сценарија на неуспех пред да ги оптимизирате изборните функции. Ако ниту еден кандидат не помине, ограничете го опфатот на имплементацијата или решете ги празнините пред пошироко воведување. Јасно ограничување полесно се управува од непроверена претпоставка вградена во комуникацијата со клиентите.
ЧПП
Дали поголема листа на превозници значи подобро европско следење?
Не. Листата на превозници е корисна за правење кратка листа, но не докажува поддршка на ниво на услуга, континуитет при предавање или квалитет на настаните за вашите рути. Тестирајте ги превозниците и моделите на испорака што се важни за вашиот бизнис.
Може ли API за следење да го натера превозникот побрзо да ги ажурира скенирањата?
Не самото API. Процесот на преземање и доставување на добавувачот влијае на тоа кога вашиот систем ги прима достапните информации, но не може да создаде физичко скенирање што превозникот не го евидентирал. Испитајте го изворниот запис пред секој празен простор во следењето да го третирате како проблем со интеграцијата.
Дали ми се потребни веб-куки, периодично преземање или и двете?
Веб-куките можат да ги намалат повторените барања кога добавувачот ги поддржува. Периодичното преземање може да поддржи закажано преземање или усогласување. Изберете според документираните гаранции за доставување, ограничувањата на стапката и опциите за обновување, а обработката на дупликати направете ја безбедна без оглед на методот.
Дали секој исклучок при следењето треба да активира порака до клиентот?
Не. На некои исклучоци им е потребна интерна истрага, а не итно дејство од клиентот. Мапирајте ги настаните кон деловни правила и разликувајте информативно ажурирање од барање клиентот да направи нешто.
Што треба да го блокира пуштањето во продукција?
Нерешени неуспеси на критични рути, погрешни мапирања на статуси, несоодветно однесување при обновување или неисполнети безбедносни и барања за приватност треба да го блокираат пуштањето. Изборната функција на контролна табла генерално не треба. Усогласете се околу овие разлики пред да започне пилотот.
Извори
- 17TRACK Tracking API — официјална почетна страница на производот за проценка на понудата на API.
- 17TRACK API documentation — официјална референца за проверка на барањата за интеграција и документираното однесување.
- Регулатива (ЕУ) 2016/679: Општа регулатива за заштита на податоците — правен текст што ги поддржува размислувањата за приватност и набавки, особено членовите 5, 28 и 32 и Поглавјето V.


