База знань Kiero OMS.

Нова пошта підключається до Kiero OMS за вашим API-ключем. Поточна інтеграція охоплює доставку відділення–відділення по Україні та вибір відділення у Kiero Store.

Що підготувати

Потрібний бізнес-кабінет Нової пошти з коректними даними відправника й контакту. В OMS потрібне право змінювати налаштування. Демонстраційна організація не може підключити обліковий запис перевізника. Для Store підготуйте український профіль ринку та ціни каталогу в UAH.

Де отримати API-ключ

1. Відкрийте бізнес-кабінет Нової пошти та увійдіть в обліковий запис, з якого відправлятимете посилки.
2. Перейдіть у Налаштування → Безпека.
3. Натисніть Створити ключ і перейдіть за посиланням Отримати API Key. За офіційною інструкцією інтеграції генерація ключа безплатна.
4. Скопіюйте ключ у форму підключення OMS. Не надсилайте його в листах, чатах чи на знімках екрана.

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

Підключення в Kiero OMS

1. Відкрийте Налаштування → Інтеграції, додайте Нову пошту й задайте зрозумілу назву підключення.
2. Вставте API-ключ і завантажте список відправників. Виберіть відправника цього облікового запису.
3. Знайдіть і виберіть місто відправлення, потім завантажте й виберіть відділення за номером або адресою.
4. Завантажте контакти відправника, виберіть контакт і перевірте номер телефону.
5. Виберіть платника доставки, спосіб оплати й формат етикетки: PDF A6 або PDF A4.
6. Збережіть підключення. Сервер перевіряє зв’язок відправника, контакту й відділення. Під час редагування залиште поле ключа порожнім, щоб зберегти наявний ключ.

Зміна міста скидає вибране відділення. Для відправлення недоступні поштомати, закриті відділення та пункти, які працюють лише на отримання.

Підключення до Kiero Store

У панелі Store відкрийте Доставку (/admin/shipping) та виберіть обліковий запис Нової пошти з OMS. Перевірте збереженого відправника; за потреби виберіть іншого саме для цього магазину. Підтвердьте прив’язку, задайте ціну доставки для покупця в UAH та опублікуйте спосіб доставки. Збережена прив’язка відновлюється при повторному відкритті налаштувань.

API-ключ залишається в OMS. Відправник магазину не змінює спільних налаштувань облікового запису перевізника. Опублікована в Store ціна доставки — ваш тариф для покупців; розрахунок перевізника не підміняє його автоматично.

Як перевірити підключення

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

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

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

Помилки та безпека ключа

• Немає відправників чи контактів: перевірте обліковий запис і дані в кабінеті перевізника. Контакт має належати вибраному відправнику.
• Немає відділення: перевірте місто, номер та можливість відправляти посилки з цього пункту.
• Тимчасовий ліміт API: зачекайте перед повторним завантаженням. Обмеження не означає втрату збереженого ключа.
• Невизначений результат створення ТТН: перевірте кабінет перевізника й зверніться до підтримки перед повторенням; нове створення може спричинити дубль.
• Ключ розкрито: замініть його в кабінеті перевізника й оновіть підключення OMS. Не додавайте ключ до знімків екрана для підтримки.

Дивіться також доставку й етикетки, інтеграції та офіційний API-портал.