Чи може Tracking API працювати без транспортних етикеток? Відстеження замовлень 3Pl і Marketplace?
Так. API відстеження може працювати без того, щоб ваша компанія створювала транспортні етикетки, за умови, що перевізник або партнер із доставки створив відправлення, яке можна відстежувати, і ви можете отримати придатний номер відстеження або інший ідентифікатор, який підтримує API. Це поширено, коли сторонній логістичний оператор (3PL) або маркетплейс займається виконанням замовлень. Різниця полягає між тим, що ви не купуєте етикетку самостійно, і повною відсутністю ідентифікатора відправлення: перший варіант зазвичай можливий, а другий може залишити API без даних для відстеження.

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


