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

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


