Нова Пошта в OpenCart: не підтягуються відділення

1. Ключ API

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

Перевірте в кабінеті Нової Пошти (Налаштування → Безпека → API-ключі), що ключ із налаштувань модуля там є і активний.

2. Застарілий довідник відділень

Більшість модулів не запитують відділення щоразу, а зберігають довідник міст і відділень у базі сайту й оновлюють його за розкладом (cron). Якщо cron не працює, на сайті лишаються закриті відділення, а нові поштомати не з’являються.

Перевірте дату останнього оновлення довідника в налаштуваннях модуля і чи налаштований cron на хостингу.

3. Модуль звертається до старих методів API

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

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

4. Вартість доставки нуль або помилка

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

• заповніть вагу й розміри хоча б для основних товарів;
• задайте в модулі вагу й розміри за замовчуванням;
• перевірте одиниці виміру: кілограми чи грами, сантиметри чи міліметри в налаштуваннях OpenCart.

5. Конфлікт з оформленням замовлення

Модулі швидкого оформлення (Simple, однокрокові чекаути, кастомні теми) по-своєму оновлюють блок доставки через AJAX. Якщо модуль Нової Пошти розрахований на стандартний чекаут, список відділень може не оновлюватися після вибору міста.

Перевірте консоль браузера (F12 → Console) на сторінці оформлення: червоні помилки JavaScript там часто прямо вказують на конфлікт.

6. Не створюються ТТН з адмінки

Для створення накладної потрібні дані відправника: контрагент, контактна особа, телефон, адреса чи відділення відправлення. Якщо щось змінилося в кабінеті (новий менеджер, інший склад), налаштування модуля треба оновити.

Коли варто звернутися до розробника

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