Як платформи повернення використовують Shipment Tracking API для відстеження відправлень повернення
Платформи повернення використовують API відстеження відправлень, щоб пов’язати схвалене повернення з його фізичним відправленням. Платформа фіксує перевізника та ідентифікатор відстеження відправлення повернення, отримує події відстеження й використовує їх, щоб показувати перебіг або ініціювати операційну перевірку. API забезпечує видимість відправлення; платформа повернення й надалі відповідає за запит на повернення, рішення щодо політики, перевірку на складі та процес повернення коштів.

Для команди, що займається операціями повернення або продуктом, корисне питання полягає не просто в тому, чи може API відображати статус відстеження. Потрібно з’ясувати, чи здатна інтеграція надійно визначити потрібне відправлення повернення, правильно інтерпретувати отримані події та запобігти тому, щоб оновлення відстеження запускало неправильне повідомлення клієнту або дію щодо повернення коштів.
Місце відстеження у поверненні
Повернення починається як бізнес-запис: клієнт просить повернути товар, а продавець вирішує, що дозволити. Запис відстеження описує інше: переміщення посилки. Поєднання цих двох записів дає платформі повернення змогу відповісти на такі запитання: чи схоже на те, що клієнт передав посилку перевізнику, чи рухається вона до місця повернення та чи було зареєстровано подію доставки.
Цей зв’язок має бути явним. Замовлення може містити кілька товарів, клієнт може оформити більше одного повернення за одним замовленням, а одне повернення може включати кілька посилок. Початковий номер відстеження вихідного відправлення не слід плутати з номером відстеження повернення. Практична модель даних зберігає окремі ідентифікатори для замовлення, дозволу на повернення, посилки повернення, перевізника та запису відстеження, а потім зберігає зв’язки між ними.
Відстеження також має чіткі межі. Подія доставки, зареєстрована перевізником, може свідчити про те, що посилка досягла адреси або об’єкта. Але вона не підтверджує, що склад отримав очікуваний товар, що товар пройшов перевірку або що настав час повертати кошти. Для цих рішень потрібні власні докази та правила.
Процес інтеграції: від дозволу до отримання
1. Створіть запис про повернення до початку відстеження посилки
Спочатку платформа повернення фіксує запит, товари, яких він стосується, дозволене місце призначення та доступний варіант вирішення. Якщо для повернення використовується етикетка, видана продавцем, платформа може пов’язати ідентифікатор відстеження етикетки з посилкою повернення. Якщо клієнт самостійно організовує доставку, платформі може знадобитися спосіб отримати й перевірити перевізника та номер відстеження до початку моніторингу.
Це перша точка, у якій якість даних впливає на видимість. Номер відстеження без надійного зв’язку між посилкою та поверненням може створити абсолютно точне оновлення від перевізника, але для неправильного повернення. Команди також мають вирішити, як оброблятимуть виправлені номери відстеження, замінені етикетки та випадки, коли клієнти повторно надсилають той самий ідентифікатор.
2. Зареєструйте відправлення або знайдіть його
Платформа надсилає обраному постачальнику відстеження інформацію, необхідну для створення або отримання запису про відправлення. Точні поля запиту та послідовність дій залежать від документації цього постачальника. Щонайменше реалізація має забезпечувати надійний спосіб пов’язати посилання постачальника на відправлення із власним записом про посилку повернення. Якщо потрібна ідентифікація перевізника, платформа має з’ясувати, як обробляються неоднозначні або непідтримувані дані про перевізника, а не припускати, що одного номера відстеження достатньо.
Зберігайте відповідь постачальника, помилки інтеграції та дату початку моніторингу платформою. Прийнятий запит не обов’язково означає, що перевізник відсканував посилку. До першого сканування стан для клієнта може мати повідомляти, що відстеження очікується, а не що повернення перебуває в дорозі.
3. Отримуйте оновлення, не втрачаючи початкову подію
Залежно від API оновлення можуть надходити через вебхук, отримуватися за допомогою опитування або передаватися іншим задокументованим способом. Інтеграція має зберігати необроблену інформацію про подію від постачальника разом із будь-яким спрощеним статусом, що відображається на платформі повернення. До корисних полів можуть належати опис події, час події, місце, якщо воно надане, посилання на перевізника та час отримання оновлення платформою.
Ці два моменти часу відповідають на різні запитання. Часова мітка події описує, коли, як повідомляється, відбулася дія; час отримання показує, коли платформа повернення дізналася про неї. Інакше затримки, повторні доставки та повідомлення, що надходять не по порядку, можуть створити враження, ніби повернення рухається назад. Якщо постачальник надає ідентифікатори подій, використовуйте їх для усунення дублікатів. Якщо ні, визначте обережний метод дедуплікації та протестуйте його на реальних зразках інтеграції.
4. Перетворюйте події відстеження на статуси повернення
Описи подій перевізника не є політикою повернення. Зазвичай платформа повернення перетворює їх на менший набір операційних статусів, як-от очікується передача, у дорозі, доставку зареєстровано або потребує перевірки. Під час такого зіставлення слід враховувати невідомі події, а не мовчки сприймати кожне нерозпізнане оновлення як ознаку прогресу.
Наприклад, першого сканування перевізником може бути достатньо, щоб повідомити клієнту, що його посилка, схоже, вже в дорозі. Але цього може бути недостатньо, щоб обіцяти дату повернення коштів. Подія доставки може допомогти складу визначити пріоритетність відповідної посилки, однак правило повернення коштів усе ще може вимагати фізичного отримання та перевірки. Команди мають зафіксувати ці відмінності в робочому процесі до підключення статусів до автоматизованих дій.
5. Замкніть цикл за допомогою складських доказів
Після прибуття посилки склад або пункт повернення може відсканувати внутрішній штрихкод, зіставити посилку з дозволом на повернення, перевірити її вміст і зафіксувати результат. Це події керування поверненнями, а не події відстеження перевізником. Якщо обидві системи підключені, платформа може показати кориснішу послідовність: переміщення відправлення, доставка, зареєстрована перевізником, отримання посилки об’єктом і завершення обробки.
Така послідовність також допомагає вирішувати виняткові ситуації. Якщо відстеження повідомляє про доставку, але запису про отримання складом немає, оператор може перевірити місце призначення, подію перевізника, чергу приймання об’єкта та ідентифікатор посилки, перш ніж робити твердження для клієнта. Якщо склад отримує посилку без придатної історії відстеження, фізичне отримання все одно можна зафіксувати; відсутні дані відстеження не повинні стирати незалежні докази складу.
Що API відстеження може і чого не може повідомити платформі
API відстеження відправлень може зробити доступними для іншої програми дані про переміщення, повідомлені перевізником, з урахуванням задокументованого покриття, доступності подій і поведінки інтеграції постачальника. Сам по собі він не може перевірити вміст повернення або визначити, чи виконано політику продавця. До того ж до першого сканування перевізником він може не мати жодного оновлення.
Ця відмінність важлива під час проєктування автоматизації. Статуси слід розглядати як сигнали з визначеним призначенням, а не як взаємозамінні докази. Подія передачі перевізнику може запустити сповіщення про перебіг. Подія доставки може створити завдання для подальшої перевірки складом. Підтверджене отримання складом може перевести повернення до перевірки. Рішення про повернення коштів або обмін має відповідати фактичним правилам продавця та доказам, яких ці правила вимагають.
Мова, орієнтована на клієнта, має відображати ті самі межі. Якщо перевірка ще не відбулася, фраза «Перевізник повідомляє, що ваше повернення доставлено» точніша за «Ми схвалили ваше повернення коштів». Так само повідомлення «Ми очікуємо на перше оновлення від перевізника» інформативніше, ніж незрозуміла порожня сторінка відстеження.
Перевірки проєкту, що запобігають помилкам у відстеженні повернень
- Зіставляйте на рівні посилки. Тестуйте розділені повернення, кілька посилок за одним дозволом, замінені етикетки та повторні повернення за одним замовленням. Кожна посилка повинна мати однозначний зв’язок із власним записом відстеження.
- Визначте пріоритетність статусів. Вирішіть, що відбувається, якщо старіша подія «у дорозі» надходить після події доставки. Зберігайте історію подій, не знижуючи автоматично відображуваний статус повернення.
- Відокремлюйте помилки постачальника від відсутності повідомлень перевізника. Помилка автентифікації, відхилений запит або невдала обробка вебхука є проблемою інтеграції. Відсутність сканування — інший стан, про який слід повідомляти інакше.
- Плануйте обробку дублікатів і повторних спроб. Оновлення про доставку може повторюватися. Зробіть отримання подій безпечним для повторного виконання та не допускайте повторного надсилання одного й того самого сповіщення клієнту або повторного створення того самого завдання.
- Захищайте дані клієнтів і відправлень. Обмежуйте доступ до облікових даних відстеження, зберігайте лише дані, необхідні для робочого процесу, і до запуску перевірте задокументовані вимоги постачальника щодо автентифікації та безпеки.
- Зберігайте ручний шлях. Для деяких повернень дані відстеження будуть неповними, запізнілими або невідповідними. Операторам потрібен спосіб перевіряти та виправляти запис про повернення, не вигадуючи подій перевізника.
Ці перевірки найкорисніші, коли їх тестують на конкретних сценаріях, а не на одному успішному відправленні. Невеликий набір тестів має включати відсутність першого сканування, неправильний номер відстеження, дублікат події, подію не по порядку, повідомлення про доставку без отримання складом і отримання складом без відповідного повідомлення про доставку. Очікуване повідомлення клієнту та дія оператора мають бути визначені для кожного випадку.
Вибір API та визначення розподілу роботи
Почніть із напрямків повернення та перевізників, якими бізнес фактично користується. Потім перевірте в актуальній документації постачальника, як відбувається реєстрація відправлень, які ідентифікатори потрібні, як доставляються оновлення, які дані подій доступні та як обробляються помилки й повторні спроби. Підтвердьте відповідних перевізників і маршрути повернення безпосередньо, а не робіть висновки із загальної заяви про покриття перевізників. Проведіть тестування на типових відправленнях, перш ніж покладатися на зіставлені статуси для комунікації з клієнтами або автоматизації.
17TRACK публікує огляд Tracking API і документацію API; його сторінка продукту 17RETURNS охоплює частину робочого процесу, пов’язану з керуванням поверненнями. Це доречні відправні точки для команди, яка оцінює видимість відстеження разом із процесом повернення. Наявність обох напрямів продуктів не слід сприймати як доказ доступності певної інтеграції, перевізника, події або автоматизованого правила повернення коштів. Перевірте точний робочий процес в актуальній документації та, за потреби, у постачальника.
Під час закупівлі або перевірки концепції попросіть команду, яка відповідає за політику повернень та складські операції, разом із інженерами перевірити зіставлення статусів. Інженери можуть підтвердити, чи надає API придатні для використання події; операційна команда може підтвердити, чи виправдовують ці події запропоновану дію. Успішна інтеграція допомагає співробітникам і клієнтам стежити за посилкою, водночас зберігаючи дозвіл, отримання, перевірку та вирішення як окремі етапи.
Поширені запитання
Чи потрібен поверненню інший номер відстеження, ніж у початкового замовлення?
Платформа має зберігати окремі записи про вихідне відправлення та відправлення повернення. Повернення зазвичай транспортується як окреме відправлення, тому його ідентифікатор відстеження потрібно пов’язувати з посилкою повернення, а не вважати ідентифікатором вихідного відправлення початкового замовлення. Точні доступні ідентифікатори залежать від способу доставки повернення.
Чи може API відстеження підтвердити, що кошти слід повернути?
Ні. Жодна окрема подія відстеження не підтверджує, що повернений товар відповідає умовам продавця для повернення коштів. Платформа може використовувати події перевізника як вхідні дані робочого процесу, але право на повернення коштів також може залежати від дозволу, фізичного отримання, перевірки та політики продавця.
Що робити, якщо відстеження показує доставку, але склад не може знайти посилку?
Зберігайте окремо подію доставки, повідомлену перевізником, і запис про отримання складом. Перевірте вказане місце призначення та деталі події, а потім дослідіть процес приймання й зіставлення на об’єкті. Не перетворюйте мовчки доставку перевізником на підтверджене отримання складом.
Чи обов’язкові вебхуки для відстеження відправлень повернення?
Не обов’язково. Метод оновлення залежить від обраного постачальника та його задокументованих можливостей. Якщо вебхуки доступні, передбачте автентифікацію, повторні спроби, дублікати доставок і помилки обробки. Якщо використовується опитування, виберіть інтервал і правило припинення, які відповідають робочому процесу повернення та вимогам постачальника.
Коли клієнт має побачити перше оновлення відстеження?
Це залежить від того, коли перевізник повідомить про подію та коли інтеграція її отримає. Створення етикетки або реєстрація відправлення можуть відбутися до сканування перевізником. Чітко відображайте цю відмінність, щоб клієнти не сприймали очікування першого оновлення як підтверджене переміщення.


