Skip to main content
ДомаБлогВодичиКако да се интегрираат податоците за следење на пратките во BI системите за прекугранична е-трговија

Како да се интегрираат податоците за следење на пратките во BI системите за прекугранична е-трговија

17TRACK

За интегрирање на податоците за следење на пратки во BI системи за прекугранична е-трговија, собирајте ги ажурирањата за следење преку API или поддржан извор на настани, зачувувајте ги оригиналните записи, нормализирајте ги настаните од превозниците и поврзете ја секоја пратка со податоците за нарачките. Потоа изградете модели во складиштето на податоци што ги пресметуваат успешноста на испораката, исклучоците и свежината на податоците, пред тие модели да ги изложите на контролните табли. Најважната дизајнерска одлука е да се оддели што ѝ се случило на пратката од моментот кога вашите системи дознале за тоа.

Како да се интегрираат податоците за следење на пратки во BI системи

Овој водич е наменет за инженери за податоци, аналитички тимови и менаџери за логистика кои го градат тој процес. Инженерството треба да биде одговорно за внесувањето и сигурноста; операциите треба да ги дефинираат клучните моменти на пратката и правилата за исклучоци; аналитиката треба да биде одговорна за дефинициите на метриките. Без тие заеднички дефиниции, технички успешната интеграција сепак може да создава извештаи што доведуваат во заблуда.

Изградете процес на податоци, а не врска помеѓу контролна табла и API

Корисна референтна архитектура е:

Извор на следење → услуга за внесување → трајно складирање на необработени податоци → трансформација и валидација → аналитичко складиште на податоци → семантички BI модел → контролни табли и предупредувања

17TRACK API Global Shipment Tracking Solution — Поврзете се со повеќе од 3.500 превозници ширум светот преку единствен API за лесно, прецизно и сигурно следење на пратки. Обидете се бесплатно →

Branded Order Tracking Solution — Обезбедете подобро корисничко искуство и поттикнете повеќе повторни купувања со брендирано следење и автоматизирани известувања. Обидете се бесплатно →

Чувајте ги податоците за нарачките, исполнувањето и корисничката поддршка заедно со процесот за следење, со контролирани поврзувања меѓу нив. Настаните за следење го објаснуваат движењето на пратката. Самите по себе, тие не го утврдуваат ветениот датум на испорака, вредноста на нарачката, исходот од повратот на средства или историјата на поддршката на клиентот.

Директното поврзување на контролна табла со API за следење може да функционира за мал прототип, но го отежнува контролирањето на историската реконструкција, повторните обиди и заедничките дефиниции на метриките. За редовно оперативно известување, зачувајте ги податоците пред да ги прикажете.

Каде се вклопува 17TRACK

17TRACK Tracking API е релевантна опција за извор при интеграција на податоци за следење. Користете ја официјалната API документација за да го потврдите договорот за интеграција во вашата имплементација. Пред дизајнот да го засновате на нив, проверете ја автентикацијата, регистрацијата на пратки, достапните полиња за настани, начините на доставување на ажурирањата, ограничувањата за користење и постапувањето со грешки.

17RETURNS — Поедноставете ги повратите и замените за да го намалите обемот на работа на DTC поддршката и загубата на приходи. Дознајте повеќе →

Однесувајте се кон изворот за следење и BI процесот како кон одделни слоеви. Не претпоставувајте дека пристапот до податоците за следење вклучува изворен конектор до вашето складиште на податоци или BI алатка. Тестирајте ги конкретните превозници, услуги за испорака, целни пазари и конфигурацијата на сметката што планирате да ги користите.

1. Дефинирајте ги оперативните прашања и деталноста на известувањето

Започнете со одлуките што контролната табла мора да ги поддржи. На логистичкиот менаџер кој истражува задоцнети пратки му се потребни исклучоци на ниво на пратка. На комерцијалниот аналитичар кој ги споредува услугите за испорака му се потребни кохорти на испораки и конзистентни именители. Тоа се поврзани прикази, но не треба да се градат од недефинирана збирка статуси за следење.

  • Успешност на испораката: Кои транспортни линии не го исполнуваат ветувањето кон клиентот?
  • Управување со исклучоци: Кои активни пратки треба да се истражат?
  • Примопредавања меѓу превозници: Каде исчезнува видливоста помеѓу фазите на транспортот?
  • Влијание врз клиентите: Кои обрасци на испорака се поврзани со контакти со поддршката или поврати на средства?
  • Здравје на интеграцијата: Кои извори испорачуваат нецелосни или застарени податоци?

Изберете примарна деталност за известување: обично една физичка пратка или пакет, а не една нарачка. Нарачката може да содржи повеќе пакети, а заменската пратка може да постои заедно со оригиналната. Зачувајте ги овие односи наместо секоја нарачка да ја присилувате на еден број за следење.

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

2. Креирајте идентитет на пратката пред да внесете настани

Не користете број за следење како единствен клуч во базата на податоци. Неговото толкување може да зависи од превозникот и контекстот на пратката. Креирајте внатрешен идентификатор на пратката и зачувајте ги надворешните референци потребни за усогласување на записите.

ПолеНаменаРазмислување при дизајнот
shipment_idСтабилен внатрешен идентитетЧувајте го независен од промените на надворешните референци.
order_id and fulfillment_idПоврзување на испораката со трговските записиПоддржете поделени нарачки и заменски пратки.
tracking_number and carrier_referenceИдентификување на следеното движењеЗачувајте ги необработените вредности и сите стандардизирани идентификатори.
shipment_leg_idПретставување на транспортна фазаКористете го кога постојат одделни меѓународни и референци за последната милја.
source_systemОбјаснување на потеклото на записотРазликувајте ги вредностите од системот за нарачки од вредностите од изворот за следење.
promised_delivery_atМерење на успешноста во однос на обврскатаЗачувајте го применливото ветување и историјата на неговите ревизии.

Изградете поврзувачка табела кога една пратка има повеќе референци или делници за следење. Така аналитичарите можат да следат прекугранична пратка низ примопредавање без да ја бројат како две испорачани пратки.

3. Внесувајте ажурирања имајќи ги предвид повторувањето и усогласувањето

Користете го механизмот за ажурирање што го поддржува вашиот извор. Ако е достапна испорака на настани, примајте ги ажурирањата преку услуга што ги валидира барањата и ги запишува прифатените содржини во трајно складирање. Ако е потребно периодично испитување, закажувајте ги барањата според документираните ограничувања и барањата за свежина на податоците.

При внесување управувано од настани, потврдете успешен прием само откако содржината е безбедно зачувана или ставена во трајна редица. Одржувајте ја крајната точка за прием лесна; скапите трансформации извршувајте ги подоцна. Следете ги документираните механизми на изворот за автентикација и проверка на барањата наместо да измислувате претпоставен формат на потпис.

При периодично испитување, зачувајте ги контролните точки за преземање и користете преклопувачки прозорци за преземање кога API дозволува. Преклопувањето може да помогне да се фатат задоцнети ажурирања, но бара и отстранување дупликати. Не претпоставувајте дека курсорот за страници претставува трајна историска контролна точка освен ако документацијата не го наведува тоа.

  • Зачувајте ја оригиналната содржина, временската ознака на приемот, идентификаторот на изворот и идентификаторот на извршувањето на внесувањето.
  • Повторувајте ги привремените неуспеси со контролирано зголемување на интервалот и почитувајте ги документираните ограничувања на стапката.
  • Записите што постојано не успеваат насочете ги во редица за проверка наместо тивко да ги отфрлате.
  • Усогласете ги следените пратки со системот за исполнување за да ги идентификувате регистрациите што недостасуваат.
  • Периодично проверувајте ги активните пратки чии податоци за следење престанале да се ажурираат.

Направете ги запишувањата идемпотентни: повторната обработка на истото ажурирање не треба да создаде дополнителен логички настан. Претпочитајте документиран стабилен идентификатор на настанот. Ако не постои, дефинирајте и тестирајте композитен отпечаток со идентитетот на пратката, времето на настанот, кодот на настанот, локацијата и други релевантни полиња. Зачувајте ги необработените записи за да може да се истражат судирите или исправките.

4. Нормализирајте ги настаните без да го изгубите нивното значење

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

Почетната таксономија може да вклучува: примена на информацијата, прифатено од превозникот, во транзит, испратено на испорака, испорачано, обид за испорака, исклучок и повратно движење. Ова се предложени внатрешни категории, а не тврдење дека секој извор за следење ги користи истите статуси.

Чувајте го статусот на клучниот момент одделно од атрибутите на исклучокот. Пратката може да остане во транзит и истовремено да има исклучок поврзан со царина. Присилувањето на двата концепта во едно поле го отежнува разликувањето на физичкиот напредок од оперативниот ризик.

Експлицитно постапувајте со прекуграничната нејасност

  • Царински настани: Зачувајте го пријавеното значење на настанот. Не толкувајте ја секоја царинска референца како доцнење или завршено царинење.
  • Примопредавања меѓу превозници: Поврзаните референци придружете ги на истата пратка кога односот е потврден. Новата референца не значи нужно нов пакет.
  • Непознати настани: Чувајте ги видливи како немапирани записи. Не присилувајте ги непознатите кодови во погодна категорија.
  • Исправки: Овозможете подоцнежните информации да ја ревидираат толкуваната состојба без бришење на претходните докази.

Верзионирајте ги правилата за мапирање. Кога ќе се промени толкувањето, треба да можете да објасните дали историскиот графикон се променил затоа што се променила успешноста на испораката или затоа што се промениле правилата за трансформација.

5. Одделно моделирајте го времето на настанот, времето на внесување и локалните датуми

Зачувајте најмалку временска ознака на пријавениот настан и временската ознака кога вашата платформа го примила записот. Временската ознака на вчитувањето во складиштето е исто така корисна за дијагностицирање на внатрешните доцнења во обработката. Овие временски ознаки одговараат на различни прашања.

Користете формат за размена што го поддржува поместувањето, кога е достапен. RFC 3339 дефинира формат на временска ознака што вклучува UTC или нумеричко поместување. Зачувајте ја оригиналната вредност, нормализирајте ги недвосмислените моменти во UTC за пресметки на изминатото време и изведете локални датуми за известување користејќи експлицитно правило за временска зона.

Ако изворот обезбедува локална временска ознака без поместување или сигурна временска зона, означете ја таа неизвесност. Не третирајте ја тивко како UTC. Претпоставките на ниво на земја може да бидат недоволни таму каде што се применуваат повеќе временски зони.

И настаните што пристигнуваат доцна бараат внимание. Постар настан примен денес не треба автоматски да ја замени поновата состојба на пратката. Изведувајте ја тековната состојба користејќи документирани семантики на настаните, временски ознаки и правила за исправки, а не само последниот внесен ред во базата на податоци.

6. Изградете модели во складиштето со јасни договори за метриките

Практичен модел ја одделува историјата на настаните од резимеата на пратките:

  • Факт за настан: Еден ред за секој логички настан за следење, со потекло и нормализирани атрибути.
  • Факт за пратка: Еден ред за секоја пратка, со изведени клучни моменти и тековна состојба.
  • Табели за односи: Врски меѓу нарачки, пакети, транспортни делници и надворешни референци.
  • Димензии: Превозник, услуга, потекло, дестинација, канал и други одобрени атрибути за известување.

Избегнувајте директно поврзување на приходот од нарачката со секој настан за следење и негово собирање. Така вредноста на нарачката се повторува низ редовите на настаните. Агрегирајте на соодветното ниво или користете експлицитно контролирани односи во семантичкиот модел.

МетрикаПрепорачана дефиницијаЗаштита при толкување
Времетраење на транзитотВременска ознака на испораката минус првата квалификувана временска ознака на прифаќање од превозникотПријавете скенирања на прифаќање што недостасуваат; не заменувајте ги со креирање етикета без откривање.
Стапка на навремена испоракаПодобните пратки испорачани до применливото ветување поделени со подобните пратки во кохортата со истечен рок на ветувањетоДефинирајте го крајниот рок, временската зона, исклучоците и постапувањето со неиспорачаните пратки со поминат рок.
Зачестеност на исклучоциУникатни пратки со квалификуван исклучок поделени со подобната кохорта на праткиБројте пратки, а не повторени пораки за исклучоци.
Неактивност на следењетоВремето на известување минус времето на последниот квалификуван настан за следењеНеактивноста е сигнал за истрага, а не доказ дека пакетот е изгубен.
Забележано доцнење на ажурирањетоВремето на прием минус пријавеното време на настанотОдделете ја латентноста на изворот од неизвесноста на временската ознака и доцнењето во складиштето.

Користете кохорти на испорачани пратки за разбирање на завршените времетраења на транзитот, но не третирајте ги како целосната слика за успешноста. Бавните пратки што сè уште се во транзит се отсутни од таа пресметка. Комбинирајте ги статистиките за завршени испораки со приказ на стареењето на отворените пратки и кохорта со истечен рок на ветувањето.

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

7. Валидирајте го процесот пред да објавите оперативни контролни табли

Тестирајте сценарија, а не само успешни API одговори. Вклучете нормална испорака, поделена нарачка, заменска пратка, примопредавање меѓу превозници, дупликатно ажурирање, настан надвор од редослед, недостиг на временска зона, настан поврзан со царина, повратно движење и задоцнета исправка.

За секое сценарио, следете ја необработената содржина низ нормализираните настани, резимеата на пратките и конечната контролна табла. Операциите треба да потврдат дека прикажаниот статус и препорачаното дејство се совпаѓаат со основните докази.

  • Опфат: Споредете ги подобните исполнети пратки со пратките присутни во процесот за следење.
  • Целосност: Мерете ги идентификаторите на пратки, времињата на настани, референците на превозници и ветувањата за испорака што недостасуваат.
  • Конзистентност: Означете ги невозможните или сомнителните низи на клучни моменти за проверка наместо автоматски да ги препишувате.
  • Свежина: Одделно следете го приемот од изворот, обработката во складиштето и освежувањето на контролната табла.
  • Повторливост: Повторно изградете период на известување од зачуваните влезови и потврдете го очекуваниот резултат.

Прикажете индикатор за свежина на податоците на оперативните контролни табли. Исклучок кај пратката и прекин во внесувањето може да изгледаат слично кога и двата се појавуваат како „нема неодамнешно ажурирање“. На корисниците им е потребен доволен контекст за да ги разликуваат.

8. Воведете го решението со сопственост, контроли на пристап и корисни предупредувања

Пилотирајте ја интеграцијата на ограничен сет транспортни линии што вклучува репрезентативна прекугранична сложеност. Проширете ја откако усогласувањето на пратките, толкувањето на статусите и усогласувањето на метриките ќе ги исполнат договорените критериуми за прифаќање. Пилот составен само од лесни испораки нема да ги тестира тешките делови на моделот.

Ограничете го внесувањето за аналитика на полињата потребни за целта на известувањето. Ограничете го пристапот до референците за следење и личните податоци, чувајте ги акредитивите надвор од BI извештаите и воспоставете постапки за задржување и бришење во согласност со применливите обврски.

Доделете сопственик на секое предупредување. Застарен извор за внесување припаѓа на инженерството; немапиран настан припаѓа на тимот за податоци и логистичките специјалисти; пратка со поминат рок припаѓа на релевантниот оперативен процес. Започнете со мал број предупредувања на кои може да се дејствува, наместо да создавате известување за секое необично скенирање.

Интеграцијата е подготвена за поширока употреба кога деловниот корисник може да го проследи резултатот на контролната табла назад до пратка, нормализиран настан и неговиот изворен запис — и да разбере кои претпоставки влијаеле врз резултатот.

Често поставувани прашања

Дали ми се потребни податоци за следење во реално време за BI известување?

Не нужно. Историското известување за успешноста може да функционира со закажани ажурирања, додека активното постапување со исклучоци може да бара посвежи податоци. Прво дефинирајте го потребното време на одговор, а потоа земете ги предвид доцнењата во ажурирањето од изворот, латентноста на внесувањето, обработката во складиштето и освежувањето на контролната табла. Побрзо освежување на контролната табла не може да создаде настани од превозникот што не биле пријавени.

Дали податоците за следење можат да го мерат времето на царинење?

Само кога изворот обезбедува настани што сигурно го претставуваат почетокот и крајот на царинската фаза што сакате да ја измерите. Јазот меѓу две скенирања не е доволен доказ за времето на царинската обработка. Кога границите се нејасни, означете ја мерката како забележан интервал наместо потврдено времетраење на царинењето.

Како треба да се постапува со повеќе броеви за следење за една нарачка?

Моделирајте го односот нарачка-кон-пратка одделно од односите пратка-кон-референца за следење. Неколку пакети може да припаѓаат на една нарачка, додека неколку референци може да опишуваат различни делници од патувањето на еден пакет. Одделното чување на овие односи спречува дуплирање на броењето на пратки и неточно известување за завршувањето на нарачките.

Дали треба да користам периодично испитување или ажурирања управувани од настани?

Користете ги механизмите што ги поддржува изворот и изберете ги според барањата за свежина и сигурност. Испораката управувана од настани може да ги намали повторените барања, додека периодичното испитување може да поддржи преземање или усогласување каде што е достапно. Ниту еден пристап не ја отстранува потребата од отстранување дупликати, повторни обиди, следење и опоравување од пропуштени ажурирања.

Дали податоците за следење можат да објаснат зошто се зголемиле повратите на средства?

Можат да поддржат истрага кога се поврзани со записите за поврати на средства и поддршка преку соодветни идентификатори и временски прозорци. Сами по себе не можат да утврдат причинско-последична врска. Проверете ги причините за поврат, проблемите со производите, сегментите на клиенти, услугите за испорака и другите релевантни фактори пред зголемувањето да го припишете на успешноста на испораката.

Извори

  • 17TRACK Tracking API — официјална почетна точка за оценување на 17TRACK како извор на податоци за следење.
  • 17TRACK API documentation — референца за потврдување на договорот за имплементација и поддржаното однесување на интеграцијата.
  • RFC 3339: Date and Time on the Internet: Timestamps — претставување на временски ознаки, UTC и конвенции за нумерички поместувања.