Skip to main content
ГоловнаБлогПосібникиЯк закордонні склади можуть використовувати API відстеження для моніторингу місцевих доставок

Як закордонні склади можуть використовувати API відстеження для моніторингу місцевих доставок

17TRACK

Закордонні склади можуть використовувати API відстеження для моніторингу місцевих доставок: пов’язувати кожну відправлену посилку з перевізником і номером відстеження, передавати події відстеження до системи управління складом або замовленнями та перетворювати винятки доставки на призначені завдання. Найефективніша конфігурація розрізняє створення етикетки та прийняття посилки перевізником, зберігає історію відправлення й повідомляє операційним командам, які посилки потребують дій, а не просто які посилки отримали новий статус.

Як закордонні склади можуть використовувати API відстеження для моніторингу місцевих доставок

Цей посібник присвячений складам, які зберігають запаси за межами внутрішнього ринку продавця та відправляють замовлення клієнтам на цьому цільовому ринку. Для таких команд відстеження закордонних відправлень має пов’язувати записи про відправлення зі складу з маршрутом доставки місцевого перевізника. Такий зв’язок допомагає керівникам складів, координаторам перевезень і командам підтримки продавця працювати з одним і тим самим записом про відправлення.

Визначте, де закінчується видимість складу та починається видимість перевізника

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

Розділяйте три етапи: готовність до отримання, передача відповідно до записів складу та прийняття відповідно до подій відстеження перевізника. Таке розділення спрощує розслідування щодо посилок, які внутрішньо позначені як відправлені, але не мають руху в системі перевізника.

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

Створіть запис про відправлення до підключення API

Основою є надійний зв’язок між замовленням клієнта, фізичною посилкою та ідентифікатором відстеження перевізника. Не використовуйте номер замовлення замість ідентифікатора посилки. Одне замовлення може залишити склад у кількох пакунках, а замінене відправлення має мати власний запис.

ЗаписРекомендовані поляОпераційне призначення
Ідентифікація відправленняВнутрішній ID відправлення, ID замовлення, ID посилки, обліковий запис продавцяРозділяти часткові відправлення та різних клієнтів.
Ідентифікація перевізникаІдентифікатор перевізника, номер відстеження, послуга, якщо відомаНадсилати правильний запит на відстеження та спрямовувати розслідування.
Передача зі складуСклад, час відправлення, посилання на забір, посилання на маніфестПорівнювати фізичні докази відправлення з подіями перевізника.
Історія відстеженняНеоброблена подія, зіставлений статус, час події, час отримання, місцезнаходження, якщо наданоЗберігати докази та розрізняти час події й затримки звітування.
Процес роботи з виняткамиТип проблеми, відповідальний, наступна дія, крайній термін перевірки, вирішенняПеретворювати інформацію про відстеження на відповідальну роботу.

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

Виберіть інтеграцію, що відповідає переліку перевізників складу

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

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

Оцінюйте підключення відповідно до реальних операційних вимог:

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

Не слід припускати, що підключення для відстеження включає придбання етикеток, виправлення адреси, перенесення доставки або подання претензій. Вважайте їх окремими процесами, якщо відповідна документація продукту прямо не підтверджує інше.

Поєднайте відправлення, оновлення відстеження та обробку винятків

1. Реєструйте посилки на контрольованому етапі відправлення

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

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

2. Отримуйте оновлення, не роблячи інформаційну панель джерелом істини

Залежно від задокументованих можливостей API, оновлення можна отримувати через запити або через сповіщення webhook. Webhook — це повідомлення, яке надсилається вашій системі, коли постачальник має оновлення; опитування означає, що ваша система сама запитує інформацію.

Для реалізацій на основі webhook перевіряйте вхідні повідомлення за допомогою задокументованого постачальником методу верифікації. Надійно зберігайте прийняті повідомлення до підтвердження їх отримання, а потім обробляйте їх асинхронно. Передбачте дубльовані повідомлення та події, що надходять не по порядку. Дотримуйтеся задокументованих вимог щодо відповідей і повторних спроб, а не припускайте, що всі постачальники працюють однаково.

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

3. Нормалізуйте статуси, зберігаючи оригінальні докази

Створіть невеликий набір операційних категорій, наприклад очікує прийняття, у дорозі, передано кур’єру для доставки, спроба доставки, доставлено та повернення. Це рекомендовані категорії складу, а не гарантія того, що кожен перевізник надає відповідні події.

Зберігайте оригінальний опис разом зі зіставленою категорією. «Доступно для отримання» не має непомітно перетворюватися на «доставлено», а «повернення розпочато» — на «отримано назад на склад». Дозвольте невідомий або незіставлений стан, щоб незнайомі події залишалися видимими для перевірки.

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

4. Призначайте відповідальних за винятки

Сповіщення корисне лише тоді, коли хтось може вжити заходів. Спрямовуйте відсутні сканування прийняття команді відправлення складу, спроби доставки, що потребують участі одержувача, — команді підтримки продавця, а тривалі проблеми з рухом у перевізника — координатору перевезень. Це рекомендовані початкові точки; обов’язки мають відповідати договорам та операційній моделі складу.

Додавайте до кожного випадку історію відстеження, посилання на передачу, останню подію, нотатки розслідування та час наступної перевірки. Об’єднуйте повторні сповіщення в межах тієї самої відкритої проблеми, щоб одна затримана посилка не створювала нове завдання після кожної синхронізації.

Налаштовуйте сповіщення відповідно до очікувань щодо послуги, а не довільних таймерів

Не існує універсального інтервалу, після якого посилка без нового сканування стає простроченою або втраченою. Налаштовуйте пороги сповіщень з урахуванням послуги перевізника, графіка забору, робочих днів, пункту призначення та зобов’язань продавця. Відокремлюйте внутрішній поріг розслідування від обіцянки доставки для клієнта.

  • Немає прийняття після передачі: Перевірте запис про забір і підтвердження перевізника перед ескалацією.
  • Немає руху понад очікуваний інтервал: Перегляньте останню подію, очікування щодо послуги та відомі операційні перерви.
  • Невдала спроба доставки: Ознайомтеся з причиною, перш ніж вирішувати, чи належить наступна дія перевізнику, продавцю або одержувачу.
  • Повернення: Підготуйте процес повернення, але не збільшуйте доступні для продажу запаси до фізичного отримання та необхідної перевірки.
  • Позначено як доставлене, але статус оскаржується: Відкрийте розслідування та запитайте доступні докази доставки; не вважайте сам статус вирішенням скарги.

Відстеження відображає повідомлені події відправлення, а не безперервне місцезнаходження посилки. Відображення часу останнього оновлення допомагає персоналу зрозуміти актуальність інформації, не створюючи враження про доступність GPS у реальному часі.

Надайте кожній команді зручне представлення

Керівникам складу потрібні винятки між відправленням і прийняттям. Координаторам перевезень потрібні черги за перевізниками та застарілі випадки. Командам підтримки продавця потрібні зрозуміла часова шкала відправлення та наступна узгоджена дія. Спільна модель даних може підтримувати ці представлення, не надаючи кожному користувачеві доступу до відправлень усіх продавців.

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

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

Пілотуйте процес, перш ніж розширювати його

Почніть із чітко визначених складу, набору перевізників і групи продавців. Включіть звичайні доставки, а також складні записи: скасовані етикетки, розділені замовлення, відсутні перші сканування, невдалі спроби доставки, дубльовані сповіщення, події не по порядку та повернення. За потреби використовуйте дозволені тестові дані або історичні записи; не вигадуйте події перевізника у виробничому середовищі.

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

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

FAQ

Чи може API відстеження замінити систему управління складом?

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

Чи надає API відстеження місцезнаходження GPS у реальному часі?

Не припускайте цього. Відстеження посилок зазвичай складається з повідомлених подій і місцезнаходжень. Час оновлення залежить від перевізника та інтеграції. Безперервне місцезнаходження транспортного засобу або посилки потребує окремо перевіреної функціональності.

Що мають робити працівники, якщо посилка не має оновлень відстеження?

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

Чи можуть події відстеження автоматично запускати повернення коштів або оновлення запасів?

Вони можуть інформувати робочий процес, але наслідкові дії потребують додаткових засобів контролю. Виняток доставки не обов’язково визначає право на повернення коштів, а рух повернення не підтверджує фізичне отримання на складі. Застосовуйте політики продавця, перевірки авторизації та процедури приймання, перш ніж змінювати записи про кошти або запаси.

Як розділені замовлення мають відображатися для команд підтримки продавця?

Показуйте кожну посилку окремо в межах батьківського замовлення. Доставка одного пакунка не має позначати все замовлення як завершене, якщо інший пакунок залишається в дорозі. Пов’язуйте замінені та повернені відправлення, але зберігайте їх відмінність.

Джерела

  • 17TRACK Tracking API — офіційна інформація про продукт для варіанта інтеграції API відстеження.
  • 17TRACK API Documentation — технічна довідка для перевірки реєстрації, запитів на відстеження, обробки оновлень і вимог до реалізації. Операційні процеси та правила сповіщень у цьому посібнику є рекомендаціями, а не гарантіями поведінки постачальника або перевізника.