Інтеграція з перевізником дає три речі: ТТН створюється прямо з замовлення, міста, відділення й вулиці підтягуються з довідників перевізника, а статус посилки оновлюється сам. Без інтеграції перевізником теж можна користуватися, але номер ТТН доведеться вписувати вручну.

Як підключити

  1. Відкрийте Налаштування → Способи доставки.
  2. На картці перевізника натисніть «Підключити». Відкриється вікно «Підключити Нова Пошта» (або іншого перевізника) з підказкою, де взяти ключі.
  3. За бажанням вкажіть «Назва», наприклад «НП — основний кабінет», і «Магазин», якщо кабінет обслуговує лише один із ваших магазинів (типово «Усі магазини»).
  4. Заповніть розділ «Доступ»: ключ, логін чи токени (див. нижче).
  5. Натисніть «Перевірити». Якщо все гаразд, зʼявиться «Підключено: …» з назвою вашого кабінету. Якщо ні — «Не вдалося підключитися: …» з причиною від перевізника.
  6. Натисніть «Підключити».

Одразу після цього те саме вікно попросить дані відправника («Нова Пошта: дані відправника»). Що знайшлося у вашому кабінеті, вже заповнено. Перевірте й доберіть решту, наприклад відділення відправлення, і натисніть «Зберегти». Кнопка «Заповнити пізніше» закриває вікно, але без цих даних ТТН не створиться.

Порада

Те саме можна зробити в Налаштування → Інтеграції, вкладка «Доставка». Там видно всі підключення, і там же їх видаляють.

Що потрібно для кожного перевізника

Нова Пошта

  • «API-ключ»: бізнес-кабінет new.novaposhta.ua → Налаштування → Безпека → Створити ключ.
  • Дані відправника після підключення: «Відправник (контрагент)», «Контактна особа», «Телефон відправника», «Місто відправлення», «Відділення відправлення». Відправника й контакт обирають зі списку з вашого кабінету, телефон підставляється сам.

Укрпошта

  • Ключі API видає менеджер Укрпошти після підписання договору: «Bearer eCom», «Bearer StatusTracking» і «Токен контрагента».
  • Перемикач «Тестове середовище (sandbox)» — для перевірки на тестових ключах.
  • Дані відправника: «Тип відправника» («ФОП», «Юрособа» або «Фізособа»), «ПІБ / назва відправника», «РНОКПП / ЄДРПОУ», «Телефон відправника», «Індекс відділення відправлення» і «IBAN для післяплати».
  • «UUID клієнта-відправника» заповнюється автоматично, коли ви збережете дані відправника.

Meest

  • «Логін API» і «Пароль API» видає менеджер Meest. Замість них можна вказати «Токен API (замість логіна)»: 24.meest.com → Налаштування → API інтеграції → «Укласти договір».
  • «ID договору (contractID)» потрібен для післяплати на рахунок і договірних тарифів. Без договору вкажіть «Картка для післяплати (без договору)».
  • Дані відправника: «ПІБ / назва відправника», «Телефон відправника», «Місто відправлення», «Відділення відправлення».

Зверніть увагу

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

«Не готова»: не заповнено дані відправника

Якщо даних відправника бракує, інтеграція має позначку «Не готова» і рядок «Не заповнено: …» з переліком полів. Що це означає на практиці:

  • у замовленні біля способу доставки з'являється підказка «Інтеграція не налаштована — ТТН не створиться»;
  • кнопка етапу, яка створює ТТН (типово «Запакувати»), не спрацює і покаже, чого бракує, з посиланням «Відкрити налаштування інтеграції»;
  • у вікні «Створити ТТН» видно попередження «В інтеграції «…» не заповнено: …» і кнопку «Налаштувати».

Заповнити дані може користувач із правом керувати інтеграціями. Решта бачить підказку «Попросіть адміністратора заповнити це в Налаштування → Інтеграції.»

Типові значення для ТТН

У налаштуваннях підключеної інтеграції є значення, які підставляються в кожну нову ТТН:

Поле Що робить
«Хто платить за доставку» «Одержувач» або «Відправник»
«Післяплата за замовчуванням» (Нова Пошта) «Грошовий переказ (накладений платіж)» або «Контроль оплати» (на рахунок ФОП/ТОВ; лише для бізнес-клієнтів із договором НП)
«Спосіб оплати доставки» (Meest) «Готівка / картка» або «Безготівково (за договором)»
«Тип відправлення» (Укрпошта) «Укрпошта Стандарт» або «Укрпошта Експрес»
«Опис вантажу» текст в ТТН, типово «Товари»
«Вага за замовчуванням, кг», «Довжина, см», «Ширина, см», «Висота, см» розмір посилки, якщо для замовлення нічого не збережено й немає шаблону коробки за замовчуванням

Післяплата потрапляє в ТТН лише тоді, коли в замовленні обрано спосіб оплати «Накладений платіж». Сума — це несплачений залишок замовлення. Оголошена вартість дорівнює сумі замовлення. Див. «Оплати та рахунок».

Кілька ФОП або кілька кабінетів

Можна підключити кілька кабінетів одного перевізника. Якщо компанія працює через кількох отримувачів оплати, у вікні підключення з'являється поле «Відправник (отримувач оплати)». ТТН замовлень цього отримувача створюватимуться з цього кабінету: посилку відправляє той, хто приймає оплату, і накладений платіж надходить йому. «Будь-який отримувач» означає, що кабінет підходить усім.

Щоб конкретний спосіб доставки завжди створював ТТН з певного кабінету, оберіть його в «Привʼязана інтеграція» в налаштуваннях способу. Див. «Способи доставки».

Журнал і відстеження

Картка інтеграції в Налаштування → Інтеграції має вкладки «Налаштування» і «Журнал». У журналі видно кожен обмін із перевізником: «Створення ТТН», «Видалення ТТН», «Оновлення статусів відправлень», «Перевірка підключення». Сюди варто зазирнути, якщо ТТН не створилася.

Статуси посилок оновлюються самі: Нової Пошти — приблизно раз на 30 хвилин, Укрпошти й Meest — приблизно раз на годину. Оновити негайно можна кнопкою «Оновити: відстеження» у картці інтеграції або «Оновити статус» біля конкретної ТТН. Що стається із замовленням, коли змінюється статус, — у статті «Відправлення».

Часті питання

Ключ правильний, але «Перевірити» показує помилку. Перевірте, що ключ скопійовано повністю, без пробілів, і що він не прострочений у кабінеті перевізника. Для Укрпошти перевірте перемикач «Тестове середовище (sandbox)»: тестові ключі не працюють у бойовому середовищі й навпаки.

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

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