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

Како давателите на услуги по купувањето можат да управуваат со следењето на повеќе брендови со еден API

17TRACK

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

Како давателите на услуги по купувањето можат да управуваат со следењето за повеќе брендови

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

Што треба да значи „еден API“ во модел со повеќе брендови

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

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

Овој модел создава три граници што не треба да се мешаат:

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

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

Започнете со модел на податоци свесен за закупецот

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

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

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

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

Нормализирајте ги податоците за превозниците пред да ги изложите на брендовите

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

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

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

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

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

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

Договорот треба да документира:

  • Како се автентицираат закупците и апликациите.
  • Кои идентификатори се задолжителни, а кои се изборни.
  • Како се доставуваат, откриваат или исправуваат кодовите на превозниците.
  • Што значи успешен одговор наспроти барање прифатено за подоцнежна обработка.
  • Како се претставуваат непознатите, одложените, дуплираните или конфликтните настани.
  • Како се обработуваат пагинацијата, повторните обиди, ограничувањата на стапката и грешките.
  • Како се управува со потписите на webhook-ите, заштитата од повторување и редоследот на настаните ако се користат webhook-и.

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

Одвојте го заедничкиот слој со податоци од искуството на брендот

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

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

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

Изградете мониторинг за платформата, а не само за пратките

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

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

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

Користете контролиран процес на воведување за секој бренд

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

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

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

Вообичаени начини на неуспех што треба да се избегнуваат

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

Практична рамка за одлучување

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

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

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

ЧПП

Може ли еден API да опслужува повеќе брендови без споделување на нивните податоци?

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

Дали секој бренд треба да ја користи истата страница за следење?

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

Што треба да се тестира пред продукција?

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

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

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

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

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

Извори