Skip to main content
НачалоБлогРъководстваКак платформите за връщане използват API за проследяване на пратки, за да проследяват пратките за връщане

Как платформите за връщане използват API за проследяване на пратки, за да проследяват пратките за връщане

17TRACK

Платформите за връщане използват API за проследяване на пратки, за да свържат одобрено връщане с физическата му пратка. Платформата записва превозвача и идентификатора за проследяване на пратката за връщане, извлича събитията за проследяване и използва тези събития, за да показва напредъка или да подканва към оперативен преглед. API предоставя видимост върху пратката; платформата за връщания все още управлява заявката за връщане, решенията съгласно политиката, складовата проверка и процеса за възстановяване на средства.

Как платформите за връщане използват API за проследяване на пратки

За екип, отговарящ за операциите по връщане или за продукта, полезният въпрос не е просто дали API може да показва статус на проследяване. Въпросът е дали интеграцията може надеждно да идентифицира правилната пратка за връщане, да интерпретира получените събития и да предотврати задействането на неправилно съобщение към клиента или действие за възстановяване на средства от актуализацията за проследяване.

Къде се вписва проследяването при връщане

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

Тази връзка трябва да бъде изрично зададена. Една поръчка може да съдържа няколко артикула, клиентът може да направи повече от едно връщане по същата поръчка, а едно връщане може да включва няколко пратки. Номерът за проследяване на първоначалната изходяща пратка не трябва да се бърка с номера за проследяване на връщането. Практическият модел на данните поддържа отделни идентификатори за поръчката, разрешението за връщане, пратката за връщане, превозвача и записа за проследяване, след което съхранява връзките между тях.

Проследяването също има ясна граница. Събитие за доставка от превозвача може да покаже, че пратката е достигнала адрес или обект. То не доказва, че складът е получил очаквания артикул, че артикулът е преминал проверка или че се дължи възстановяване на средства. Тези решения изискват собствени доказателства и правила.

Процесът на интеграция — от разрешаването до получаването

1. Създайте записа за връщане, преди да проследявате пратката

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

Това е първата точка, в която качеството на данните влияе върху видимостта. Номер за проследяване без надеждна връзка между пратката и връщането може да създаде напълно точна актуализация от превозвача за неправилното връщане. Екипите трябва също да решат как ще обработват коригирани номера за проследяване, заместващи етикети и клиенти, които изпращат един и същ идентификатор два пъти.

2. Регистрирайте или потърсете пратката

Платформата изпраща необходимата информация до избрания доставчик на проследяване, за да създаде или извлече запис за пратката. Точните полета и последователността на заявката зависят от документацията на доставчика. Най-малкото реализацията се нуждае от надежден начин да свърже референцията на пратката при доставчика със собствения си запис за пратката за връщане. Когато е необходима идентификация на превозвача, платформата трябва да потвърди как се обработват неясни или неподдържани данни за превозвача, вместо да приема, че само номерът за проследяване е достатъчен.

Съхранявайте отговора на доставчика, грешките при интеграцията и датата, на която платформата е започнала мониторинга. Приета заявка не е непременно доказателство, че превозвачът е сканирал пратката. Преди първото сканиране състоянието, видимо за клиента, може да трябва да показва, че проследяването е в изчакване, а не че връщането е в транзит.

3. Приемайте актуализациите, без да губите първоначалното събитие

В зависимост от API актуализациите могат да пристигат чрез webhook, да се извличат чрез polling или да използват друг документиран метод. Интеграцията трябва да съхранява необработената информация за събитията от доставчика заедно с всяко опростено състояние, показвано в платформата за връщания. Полезните полета могат да включват описанието на събитието, часа на събитието, местоположението, когато е предоставено, референцията на превозвача и часа, в който платформата е получила актуализацията.

Тези два момента отговарят на различни въпроси. Клеймото за време на събитието описва кога се твърди, че е настъпила дадена дейност; клеймото за време на получаване показва кога платформата за връщания е научила за нея. Забавянията, повторните доставки и съобщенията извън ред могат иначе да създадат впечатление, че връщането се движи назад. Ако доставчикът предлага идентификатори на събития, използвайте ги за премахване на дубликати. Ако не предлага, дефинирайте предпазлив метод за премахване на дубликати и го тествайте с реални интеграционни примери.

4. Преобразувайте събитията за проследяване в състояния на връщането

Описанията на събитията от превозвача не са политика за връщане. Платформата за връщания обикновено ги преобразува в по-малък набор от оперативни състояния, като очаква предаване, в транзит, отчетена доставка или изисква преглед. Преобразуването трябва да отчита неизвестните събития, вместо мълчаливо да третира всяка непозната актуализация като напредък.

Например първото сканиране от превозвача може да е достатъчно, за да се каже на клиента, че пратката му изглежда е на път. То може да не е достатъчно, за да се обещае дата за възстановяване на средства. Събитие за доставка може да помогне на склада да даде приоритет на съответстваща пратка, но правилото за възстановяване все още може да изисква физическо получаване и проверка. Екипите трябва да запишат тези разграничения в работния процес, преди да свържат състоянията с автоматизирани действия.

5. Затворете цикъла с доказателства от склада

След пристигането на пратката складът или обектът за връщане може да сканира вътрешен баркод, да съпостави пратката с разрешение за връщане, да провери съдържанието ѝ и да запише резултата. Това са събития от управлението на връщанията, а не събития от проследяването от превозвача. Когато двете системи са свързани, платформата може да покаже по-полезна последователност: движение на пратката, доставка, отчетена от превозвача, получаване на пратката от обекта и приключено решение.

Тази последователност също помага за разрешаване на изключения. Ако проследяването отчита доставка, но няма запис за получаване в склада, операторът може да провери местоназначението, събитието от превозвача, опашката за приемане в обекта и идентификатора на пратката, преди да направи твърдение пред клиента. Ако складът получи пратка без използваема история на проследяването, физическото получаване все пак може да бъде записано; липсващите данни за проследяване не трябва да заличават независимите доказателства от склада.

Какво може и какво не може да каже API за проследяване на пратки на платформата

API за проследяване на пратки може да направи движението, отчетено от превозвача, достъпно за друго приложение, в зависимост от документирания обхват на доставчика, наличността на събитията и поведението на интеграцията. Само по себе си то не може да провери съдържанието на връщането или да реши дали политиката на търговеца е изпълнена. Възможно е също да няма актуализация за отчитане преди първото сканиране от превозвача.

Разграничението е важно при проектирането на автоматизация. Състоянията трябва да се третират като сигнали с определени употреби, а не като взаимозаменяемо доказателство. Събитие за предаване на превозвача може да задейства известие за напредъка. Събитие за доставка може да създаде задача за последваща проверка от склада. Потвърденото получаване в склада може да придвижи връщането към проверка. Решението за възстановяване или замяна трябва да следва действителните правила на търговеца и доказателствата, изисквани от тези правила.

Езикът, насочен към клиента, трябва да отразява същата граница. „Превозвачът отчита, че връщането ви е доставено“ е по-точно от „Одобрихме възстановяването на средствата ви“, когато не е извършена проверка. По същия начин „Очакваме първата актуализация от превозвача“ е по-информативно от необяснима празна страница за проследяване.

Проверки при проектирането, които предотвратяват предотвратими грешки при проследяване на връщания

  • Съпоставяйте на ниво пратка. Тествайте разделени връщания, няколко пратки по едно разрешение, заместващи етикети и повторни връщания по една поръчка. Всяка пратка трябва да има недвусмислена връзка със собствения си запис за проследяване.
  • Определете приоритета на състоянията. Решете какво се случва, ако по-старо събитие „в транзит“ пристигне след събитие за доставка. Запазете историята на събитията, без автоматично да понижавате показваното състояние на връщането.
  • Разделяйте грешките на доставчика от липсата на информация от превозвача. Неуспешно удостоверяване, отхвърлена заявка или неуспешна обработка на webhook са проблеми с интеграцията. Липсата на сканиране е различно състояние и трябва да се съобщава по различен начин.
  • Планирайте за дубликати и повторни опити. Актуализацията за доставка може да се повтори. Направете приемането на събития безопасно за повторен опит и избягвайте изпращането на едно и също известие до клиента или създаването на една и съща задача два пъти.
  • Защитете данните за клиента и пратката. Ограничете достъпа до идентификационните данни за проследяване, съхранявайте само данните, необходими за работния процес, и прегледайте документираните изисквания на доставчика за удостоверяване и сигурност преди стартирането.
  • Поддържайте ръчен път. Някои връщания ще имат непълна, закъсняла или несъответстваща информация за проследяване. Операторите се нуждаят от начин да проучват и коригират записа за връщане, без да измислят събития от превозвача.

Тези проверки са най-полезни, когато се тестват с конкретни сценарии, а не само с една успешна пратка. Малкият набор от тестове трябва да включва липса на първо сканиране, неправилен номер за проследяване, дублирано събитие, събитие извън ред, отчетена доставка без получаване в склада и получаване в склада без съответстващ отчет за доставка. Очакваното съобщение към клиента и действието на оператора трябва да бъдат определени за всеки случай.

Избор на API и определяне на разделението на работата

Започнете с маршрутите за връщане и превозвачите, които бизнесът действително използва. След това проверете в актуалната документация на доставчика как работи регистрацията на пратки, кои идентификатори са задължителни, как се доставят актуализациите, какви данни за събития се предоставят и как се обработват грешките и повторните опити. Потвърдете съответните превозвачи и маршрути за връщане директно, вместо да ги извеждате от общо твърдение за покритието на превозвачите. Тествайте с представителни пратки, преди да разчитате на преобразувани състояния за комуникация с клиентите или автоматизация.

17TRACK публикува преглед на Tracking API и документация за API; неговата продуктова страница на 17RETURNS разглежда управленската страна на връщанията в работния процес. Те са подходящи отправни точки за екип, който оценява видимостта върху проследяването заедно с процеса по връщане. Съществуването на двете продуктови области не трябва да се приема като доказателство, че конкретна интеграция, превозвач, събитие или автоматизирано правило за възстановяване е налично. Проверете точния работен процес в актуалната документация и, когато е необходимо, при доставчика.

За снабдяване или доказване на концепция помолете екипа, който отговаря за политиката за връщания и складовите операции, да прегледа съпоставянето на състоянията заедно с инженерния екип. Инженерният екип може да потвърди дали API предоставя използваеми събития; оперативният екип може да потвърди дали тези събития оправдават предложеното действие. Успешната интеграция е тази, която помага на служителите и клиентите да проследяват пратката, като същевременно запазва разрешаването, получаването, проверката и решението като отделни стъпки.

Често задавани въпроси

Нужно ли е връщането да има различен номер за проследяване от оригиналната поръчка?

Платформата трябва да поддържа отделни записи за изходящата пратка и пратката за връщане. Връщането обикновено пътува като отделна пратка, така че идентификаторът му за проследяване трябва да бъде свързан с пратката за връщане, а не да се приема за идентификатора на изходящата пратка от оригиналната поръчка. Точните налични идентификатори зависят от начина на изпращане на връщането.

Може ли API за проследяване да потвърди, че трябва да бъде издадено възстановяване?

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

Какво да направя, ако проследяването показва доставка, но складът не може да намери пратката?

Поддържайте отделно отчетеното от превозвача събитие за доставка и записа за получаване в склада. Проверете отчетеното местоназначение и подробностите за събитието, след което проучете процеса на приемане и съпоставяне в обекта. Не преобразувайте мълчаливо доставката от превозвача в потвърдено получаване в склада.

Задължителни ли са webhook за проследяване на пратки за връщане?

Не непременно. Методът за актуализация зависи от избрания доставчик и документираните от него възможности. Ако са налични webhook, планирайте удостоверяване, повторни опити, дублирани доставки и грешки при обработката. Ако се използва polling, изберете интервал и правило за спиране, които са подходящи за работния процес по връщане и изискванията на доставчика.

Кога клиентът трябва да види първата актуализация за проследяване?

Това зависи от момента, в който превозвачът отчита събитие, и момента, в който интеграцията го получава. Създаването на етикет или регистрирането на пратка може да се случи преди сканирането от превозвача. Показвайте ясно това разграничение, за да не интерпретират клиентите изчакването на първата актуализация като потвърдено движение.

Източници