Skip to main content
ДомаБлогВодичиСледење на воздушен карго наспроти прекугранични пратки: Кои API-можности ви се потребни?

Следење на воздушен карго наспроти прекугранични пратки: Кои API-можности ви се потребни?

17TRACK

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

Воздушен товар наспроти прекугранично следење пратки: кои можности треба да ги има API-то

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

Започнете со единицата на пратката, а не со начинот на транспорт

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

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

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

Област на одлукаСледење на воздушен товарСледење прекугранични пратки
Примарен објектВоздушна товарителница, пратка или транспортен сегментПоединечен пакет и неговите идентификатори кај превозникот
Оперативни прашањаДали товарот е примен, транспортиран со авион, пристигнат или предаден?Каде се наоѓа пакетот, што го блокира и дали е испорачан?
Односи што треба да се зачуваатРеференци на главната и куќната товарителница, сегменти, парчиња и поделени движењаВрски меѓу нарачката и пакетот, предавања меѓу превозници, заменски идентификатори и враќања
Типичен одговорен сопственикТим за шпедиција, транспорт или операции со товарТим за операции во е-трговија, корисничка поддршка или управување со испораки
Главен ризик при толкувањетоТретирање на еден сегмент или делумно пристигнување како завршување на целата праткаТретирање на предавање или нејасен настан за испорака како прием од купувачот

Што треба да поддржува API-то за следење на воздушен товар

Идентитет на воздушната товарителница и односи меѓу пратките

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

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

Видливост на транспортните сегменти и ракувањето

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

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

Делумни движења и значењето на клучните моменти

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

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

Иницијативата ONE Record на IATA претставува релевантна индустриска референца за споделување податоци за товарот и стандардизирани структури на податоци. Сепак, тврдењето за усогласеност со стандарди не е доказ за пристап до секоја авиокомпанија, оператор, пратка или клучен момент. Прашајте која имплементација, кои односи меѓу податоците, дозволи и оперативни извори се навистина достапни.

Што треба да поддржува API-то за следење прекугранични пратки

Идентификација на превозникот и континуитет при предавањето

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

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

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

Нормализирани статуси со оригинални докази

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

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

Резултати од испораката и исклучоци за кои може да се преземе дејство

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

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

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

Можности што им се потребни на двата типа API

Сигурно внесување настани и опоравување

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

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

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

Актуелност, потекло и обработка на временските ознаки

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

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

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

Пристап, трошоци и оперативни контроли

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

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

Кога да користите едно API и кога да комбинирате извори на податоци

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

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

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

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

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

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

Не третирајте ја проценката на API за пратки како потврда за функционалност на воздушен товар. Ако ви се потребни и односи меѓу главната и куќната товарителница, детали за летачките сегменти или делумни движења на парчињата, побарајте експлицитна потврда и примероци од одговори за тие барања. Вистинската улога на производот се определува според работните процеси што може да ги поткрепи, а не според широчината на зборот „следење“.

Спроведете доказ за концептот пред да се обврзете

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

  1. Дефинирајте ја одлуката што мора да ја поддржува секој настан. Примери се истражување на пропуштено поврзување на товарот, контактирање купувач поради проблем со адресата или испраќање известување за испорака.
  2. Изградете репрезентативен тест-сет. Вклучете предавања меѓу превозници, периоди без настани, обиди за испорака, враќања и поделени движења на товарот кога е релевантно.
  3. Проверете ја точноста на ниво на објект. Потврдете дали секој настан се однесува на лет, пратка, дел или поединечен пакет.
  4. Споредете со оперативниот извор. Проверете ги пропуштените клучни моменти, временските ознаки, локациите, оригиналните пораки и обработката на корекциите во однос на записите од превозникот или партнерот до кои сте овластени да пристапите.
  5. Тестирајте го опоравувањето од грешки. Тестирајте дупликатни настани, задоцнети настани, невалидни идентификатори, нејасни превозници, прекини на webhook известувањата и усогласување.
  6. Потврдете ги економичноста и одговорноста. Проценете го трошокот врз основа на вашето оптоварување и доделете одговорност за проблемите со изворните податоци, неуспесите на интеграцијата и комуникацијата со клиентите.

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

Најчесто поставувани прашања

Може ли едно API за следење да покрива воздушен товар и пратки?

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

Може ли да користам број на воздушна товарителница за следење поединечен пакет?

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

Дали „следење во реално време“ значи континуирана физичка локација?

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

Дали webhook известувањата се подобри од анкетирањето?

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

Дали настанот „испорачано“ докажува дека купувачот ја примил пратката?

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

Извори

  • IATA — ONE Record: индустриска референца за стандардизирано споделување податоци за товарот; не е гаранција за опфатот на одредено API.
  • 17TRACK — Tracking API: официјална референца за производот при проценка на интеграција за следење пратки.
  • 17TRACK — API документација: техничка референца за потврдување на барањата за имплементација.