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

Следете го пакетот, а не претплатата
Претплатата ви кажува што е планирано клиентот да прима со текот на времето. Нарачката за исполнување ви кажува што треба да биде испратено во еден циклус. Бројот за следење ви кажува за конкретен пакет. Одделното чување на овие записи спречува задоцнета пратка од еден циклус да се појави на страницата за следење на следниот циклус.
На пример, замислете дека кутијата со претплата за мај е поделена на два пакети, а кутијата за јуни се испраќа додека еден пакет од мај сè уште е во транзит. Клиентот треба да гледа два пакети под нарачката за мај и посебен пакет под нарачката за јуни. Задоцнетото ажурирање за мај треба да го промени само пакетот од мај. Ако испратите замена, креирајте нов запис за пратката и поврзете го со оригиналниот за поддршката да може да види зошто постојат и двата.
- Претплата: Чувајте го ID-то на претплатата за поддршката да може да ја пронајде историјата на пратките на клиентот.
- Циклус и нарачка: Запишете го идентификаторот на циклусот или планираниот датум на исполнување, ID-то на нарачката и сите ID-ја за исполнување потребни за поврзување на пакетите со соодветната нарачка. Не го извлекувајте циклусот од датумот кога пристигнува настанот за следење.
- Пратка: Доделете внатрешен ID на пратката за секој пакет. Чувајте го превозникот и бројот за следење, соодветната референца за исполнување и секој ID за регистрација на следење што ќе го врати давателот. Откажаните етикети и заменетите броеви за следење нека не се прикажуваат во активниот приказ за клиентите, но зачувајте ја историјата за поддршката.
На страницата на нарачката прикажете го напредокот на ниво на пакет заедно со резимето на нарачката. Ако еден пакет е испорачан, а друг е во транзит, наведете го тоа. Целата нарачка прикажете ја како испорачана само кога ќе пристигнат сите пакети потребни за нејзино комплетирање, земајќи ги предвид откажаните пратки и замените.
Поврзете го исполнувањето со API-то за следење
- Регистрирајте од настан за исполнување. Активирајте регистрација кога системот за исполнување, магацинот или партнерот за логистика од трета страна ќе ги испрати превозникот и бројот за следење. Плаќањето за обновување е прерано: нарачката можеби сè уште чека испорака и можеби не постои број за следење.
- Зачувајте ја пратката пред да го повикате API-то. Зачувајте го внатрешниот запис за пратката и ставете го барањето за регистрација во редица. Ако истата порака за исполнување пристигне двапати, повторно употребете го тој запис наместо да креирате друг пакет. Ако повикот кон API-то истече, проверете дали оригиналното барање било успешно пред повторно да го испратите, кога давателот ви овозможува таква проверка.
- Поврзете ги ажурирањата со регистрираниот пакет. Користете го идентификаторот за регистрација на давателот ако се враќа во ажурирањата. Во спротивно, поврзете ги записите според идентификаторите наведени во неговата документација и потврдете го резултатот во однос на записите за вашите пратки. Ако ажурирањето може да припаѓа на повеќе од еден запис, испратете го на проверка наместо да го примените на најновата нарачка.
- Одделете го креирањето етикета од движењето на превозникот. Бројот за следење може да постои пред превозникот да потврди дека ја презел пратката. Користете порака како „Подготовка за преземање од превозникот“ кога имате само етикета. „Во транзит“ користете само кога тоа е поткрепено со информации од превозникот.
17TRACK Tracking API е една од опциите за ова поставување. Неговата документација за програмери е референца за регистрирање броеви за следење и примање ажурирања за следење. Користете ги тие ажурирања за одржување на записот за пакетот во вашиот систем; доделувањето на циклусот, завршувањето на нарачката и правилата за известување на клиентите чувајте ги во вашата апликација за е-трговија. Пред пуштањето во употреба, тестирајте со пакети од вашите реални рути на превозници и партнери за исполнување, наместо да се потпирате само на список на превозници.
Направете ги ажурирањата безбедни за двојна обработка
Кога вашиот давател нуди веб-куки, користете ги за примање ажурирања без постојано анкетирање на секој пакет. Веб-куката е HTTP барање што давателот го испраќа до вашата апликација. Следете ги барањата на давателот за верификација, трајно чувајте ги прифатените содржини и потврдувајте ги барањата според неговите документирани правила за одговор. Побавната работа, како ажурирање на приказите на нарачките или испраќање е-пошта, извршувајте ја надвор од обработувачот на барањето.
Изградете ја патеката за обработка така што повтореното ажурирање нема дополнителен ефект. Ако давателот испорачува стабилни ID-ја на настани, користете ги за препознавање повторувања. Ако испраќа снимки од следењето наместо поединечни настани, споредете ја дојдовната состојба и историјата на скенирања со она што веќе го имате пред да преземете дејство. Дедуплицирајте ги пораките до клиентите одделно: известувањето за испорака што веќе е испратено не треба повторно да се испрати само затоа што истите податоци за пратката биле обработени двапати.
Чувајте го времето кога се случило скенирањето одделно од времето кога вашата апликација го примила. Задоцнето скенирање „во транзит“ може да припаѓа во историјата на пакетот без да го замени поновиот статус „испорачано“. Сепак, не претпоставувајте дека секоја легитимна промена го придвижува пакетот напред. Корекција од превозникот или ажурирање за враќање до испраќачот може да наложи промена на она што го прикажувате. Ако новите податоци се во конфликт со зачуваната состојба и не можете да утврдите што е точно, ставете ја пратката во редица за проверка.
Периодично проверувајте ги отворените пратки на кои можеби им е потребно внимание: регистрации што сè уште се во тек, пакети без прво скенирање по очекуваното предавање и пратки чие следење престанало да се ажурира. Кога API-то поддржува пребарување или освежување, користете го селективно во рамките на ограничувањата на давателот. Проверете ја шемата кај повеќе превозници и магацини пред да ескалирате. Ако ажурирањата престанат истовремено за многу неповрзани пратки, истражете ја интеграцијата пред да отворате поединечни случаи за испорака.
Претворете ги податоците за следење во корисни пораки за клиентите
На клиентите ретко им е потребна е-пошта за секое скенирање. Започнете со пораки поврзани со нешто што треба да го знаат или направат: пакетот влегол во мрежата на превозникот, обидот за испорака бара дејство или превозникот пријавил испорака. Прикажете ја референцата на нарачката и соодветната кутија или циклус за претплатниците да можат да утврдат на која пратка се однесува пораката. Кај поделена нарачка, идентификувајте го пакетот и јасно наведете дали остатокот од нарачката сè уште е на пат.
- Етикетата е креирана, нема скенирање: Споредете го очекуваното предавање со записите на магацинот. Ако рокот за предавање поминал, побарајте од тимот за исполнување да потврди дали пакетот го напуштил објектот пред да му кажете на клиентот дека испораката е одложена во транзит.
- Следењето престанало да се ажурира: Користете прагови што ја одразуваат рутата и услугата наместо еден тајмер за секој пакет. Кај прекуграничните пратки, прегледајте го последниот настан од превозникот пред да одлучите дали да го контактирате клиентот или да ескалирате.
- Неуспешен обид или потребно преземање: Кажете му на клиентот какво дејство е потребно ако превозникот обезбедува јасни упатства. Ако настанот е нејасен, упатете го случајот до поддршката наместо да погодувате датум за повторна испорака или локација за преземање.
- Означено како испорачано, но не е примено: Зачувајте го пријавениот статус од превозникот и отворете посебен случај за поддршка. Вашиот процес за поддршка треба да разликува пријава од клиент од корекција од превозникот.
На персоналот за поддршка обезбедете му единствен приказ на циклусот, нарачката, историјата на пакетот и веќе испратените пораки. За секој исклучок доделете одговорно лице и следен чекор. Исполнувањето може да истражи пропуштено предавање, логистиката може да следи исклучок од превозникот, а поддршката може да комуницира со клиентот. Статусот на следење го опишува пакетот; тој не одлучува дали следуваат замена или поврат на средства.
Тестирајте го преклопувањето пред пуштање во употреба
Започнете со еден партнер за исполнување и сет пратки што го одразува начинот на кој тој навистина ги испраќа нарачките. Вклучете циклус со повеќе пакети, поништена етикета, замена и постара пратка што сè уште е отворена кога се испраќа следниот циклус. Потоа намерно повторно испратете дуплирана веб-кука и испорачајте постар настан по понов. Проверете го записот за пакетот, страницата на нарачката на клиентот, приказот за поддршка и дневникот на известувања. Тестот што само проверува успешен одговор од API-то може да ја пропушти најскапата грешка: ажурирање на погрешна нарачка или испраќање порака до погрешен клиент.
Следете ги неуспесите при регистрација, уделот на подобните пакети што успешно се регистрирани, првите скенирања што се случиле подоцна од очекуваното и неповрзаните ажурирања. Ако ја следите доцнењето на ажурирањата, разликувајте го времето меѓу настанот од превозникот и приемот од времето што му е потребно на вашиот систем да го обработи. Тоа ви помага да одлучите дали да го истражите доводот од превозникот, крајната точка на вашата веб-кука или редицата во вашата апликација.
Проширете се на повеќе рути откако ќе можете да одговорите на три прашања за секој пакет: На кој циклус му припаѓа? Што пријавил превозникот последно? Кој постапува ако ажурирањето недостасува или е погрешно? Ако некој одговор е нејасен, поправете го мапирањето на записите или процесот за исклучоци пред да додадете повеќе правила за известување.
ЧПП
Може ли API-то за следење да им каже на клиентите кога ќе биде испратена нивната следна кутија со претплата?
Користете го распоредот на претплатата и системот за исполнување за следниот планиран датум на испорака. API-то за следење е наменето за конкретен пакет откако ќе постојат информации за следење. Планираниот датум на испорака, проценката на испорака од превозникот и потврдената испорака се различни факти и треба да бидат означени одделно.
Што ако магацинот го замени бројот за следење откако ќе биде испратена е-пошта?
Означете ја старата етикета како заменета и поврзете го новиот број за следење со истата нарачка. Ако вашата е-пошта упатува на страница за следење на ниво на нарачка, ажурирајте ја таа страница за клиентот да може да го пронајде активниот пакет без да му треба оригиналната врска од превозникот. Испратете исправка кога промената влијае врз информациите според кои клиентот треба да постапи.
Што ако партнерот за исполнување испрати броеви за следење без кодови на превозник?
Побарајте од партнерот конзистентно поле за превозник или мапирање од неговите кодови за услуги за испорака. Ако вашето API нуди откривање на превозник, проверете како функционира со етикетите на партнерот пред да се потпрете на него. Нејасните совпаѓања испратете ги на проверка наместо да изберете превозник само врз основа на бројот за следење.
Дали паузираните или прескокнатите претплати бараат записи за следење?
Не е потребен запис за пакет за циклус што никогаш не се испраќа. Ако претходна пратка сè уште е отворена, продолжете да ја следите дури и кога претплатата е паузирана, прескокната или откажана. Состојбата на претплатата го контролира идното исполнување; таа не ви кажува што се случило со пакетот што веќе го напуштил магацинот.
Извори
- 17TRACK Tracking API — преглед на производот за интегрирање следење пакети во деловни системи.
- Документација за 17TRACK Tracking API — референца за имплементација при регистрирање броеви за следење и примање податоци за следење.
- Документација за веб-куки на Stripe — референца за општи практики на веб-куки, како обработка на дуплирани настани и избегнување претпоставки за редоследот на испорака. Следете ги сопствените правила на давателот на следење за верификација и потврдување.


