Інтеграція з Новою Поштою
Покрокова інструкція для менеджера: як підключити API Нової Пошти в CatPro, зберегти параметри відправника, створювати ТТН із замовлень та контролювати статуси доставки.
1) Де знаходиться інтеграція
- Відкрийте Мій Бізнес → Інтеграції.
- Знайдіть блок Нова Пошта.
- У цьому блоці зберігається API key, налаштовується відправник і є тестовий інструмент для перевірки міст/відділень та створення ТТН.
2) Підключення API (перший запуск)
- Вставте API Key Нової Пошти у поле API Key (Нова Пошта).
- Натисніть Зберегти.
- Натисніть Тест підключення.
- Якщо все правильно — CatPro покаже повідомлення про успішне підключення.
Якщо тест не проходить — перевірте, що ключ збережено та він активний (правильні права в НП).
3) Пошук міст та відділень (перевірка API)
- У блоці Пошук міст та відділень введіть назву міста.
- Оберіть місто зі списку.
- Натисніть Знайти біля поля відділень (або Enter).
- Оберіть відділення/поштомат зі списку.
Цей блок допомагає перевірити, що API key працює і дані НП підтягуються коректно.
4) Збереження відправника (обов’язково перед ТТН)
Без збереженого відправника створення ТТН з замовлень не працюватиме.
- Відправник (Counterparty) — завантажується кнопкою Оновити.
- Контактна особа НП (Ref) — завантажується кнопкою Завантажити.
- Місто / Відділення відправника — вибираються у блоці пошуку.
- Контакт та Телефон відправника.
Після заповнення натисніть Зберегти відправника.
5) Тестове створення ТТН у розділі Інтеграції
- Заповніть дані одержувача (ПІБ, телефон, місто, відділення).
- Заповніть параметри відправлення (вага, вартість, місця, опис).
- Натисніть Створити ТТН (тест).
- CatPro покаже номер ТТН, Ref та відповідь API.
Увага
- Це реальний API-виклик. Якщо дані реальні — ТТН може створитись у НП.
6) Створення ТТН із замовлення (рекомендовано)
- Перейдіть у Мій Бізнес → Замовлення.
- У рядку замовлення натисніть кнопку 🚚 (Нова Пошта ТТН).
- Перевірте автопідставлені дані одержувача.
- Перевірте/оберіть місто та відділення одержувача.
- Натисніть Створити ТТН.
Після успіху ТТН зберігається локально до замовлення і відображається в таблиці замовлень.
7) Автопідбір міста та відділення одержувача
- CatPro пробує знайти місто по shipping_address_city.
- Потім пробує підібрати відділення по тексту адреси shipping_address_street.
- Після автопідбору можна вручну вибрати інший варіант зі списку.
Автопідбір економить час, але перед створенням ТТН перевірте, що вибрано правильне відділення.
8) Статуси ТТН у замовленнях
- У таблиці замовлень є стовпець ТТН.
- Видно: номер, статус, дату доставки (якщо є) і вартість НП (якщо є).
Кольори статусу:
зелений — доставлено / вручено;
синій — в дорозі / транзит;
жовтий — створено / оформлено;
червоний — проблема / повернення.
зелений — доставлено / вручено;
синій — в дорозі / транзит;
жовтий — створено / оформлено;
червоний — проблема / повернення.
9) Швидкі дії з ТТН
- Скопіювати ТТН — копіює номер в буфер.
- Трекінг НП — відкриває сторінку відстеження.
- Оновити статус — запитує актуальний статус через API.
10) Типові причини помилок і що перевірити
Найчастіші причини
- Не задано API key — збережіть ключ у Інтеграціях.
- Не збережений відправник — Counterparty, Contact Ref, місто, відділення, телефон.
- Помилка API при створенні — перевірте місто/відділення, телефон, параметри вантажу.
- Неправильний автопідбір — виберіть відділення вручну.
Порада: спочатку перевірте API key і збережіть відправника, а вже потім переходьте до ТТН у замовленнях.