Як бренди електронної комерції за підпискою можуть відстежувати регулярні відправлення за допомогою 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 — довідник із загальних практик роботи з вебхуками, як-от обробка дублікатів подій і недопущення припущень щодо порядку доставки. Дотримуйтеся власних правил постачальника відстеження щодо перевірки та підтверджень.


