Интеграция с «Новой Почтой» позволяет покупателям выбирать отделение, почтомат или адресную доставку прямо при оформлении заказа, а вам — создавать экспресс-накладные (ЭН) прямо из карточки заказа, без ручного переноса данных в кабинет перевозчика.
Шаг 1. Получите API-ключ в кабинете Новой Почты
- Зарегистрируйте бизнес-кабинет на сайте new.novaposhta.ua или войдите в имеющийся.
- Откройте Налаштування → Безпека и нажмите Створити ключ.
Кабинет Новой Почты: Налаштування → Безпека - Подтвердите создание ключа кнопкой Створити.
Подтверждение создания API-ключа - Скопируйте значение в колонке Ключ — оно понадобится на шаге 4.
Копирование API-ключа
Обратите внимание: API-ключ создаётся сроком на 1 год. По истечении срока ключ перестаёт работать — как его продлить, описано в конце статьи.
Шаг 2. Включите метод доставки «Новая Почта»
В админ-панели магазина откройте Магазин → Методы доставки. Метод «Новая Почта» уже есть в стандартном списке — убедитесь, что тумблер в колонке Вкл/Выкл включён.
В редактировании метода можно задать порог «Бесплатная доставка от, грн» — если сумма заказа достигает этого значения, доставка для покупателя становится бесплатной.
Важно: не удаляйте метод «Новая Почта» из списка — с ним связаны поля выбора города и отделения при оформлении заказа. Если метод временно не нужен, просто выключите его тумблером.
Шаг 3. Привяжите методы оплаты
Откройте Магазин → Методы оплаты и в каждом способе оплаты, который должен быть доступен для «Новой Почты», добавьте её в поле Методы доставки. Без этой привязки покупатель, выбрав «Новую Почту», не увидит ни одного способа оплаты.
Шаг 4. Создайте аккаунт в разделе «Новая Почта»
Откройте Интеграции → Новая Почта. Раздел состоит из трёх вкладок: Список ЭН, Справочники и Аккаунты. Пока аккаунт не создан, вы увидите предупреждение «Необходимо создать аккаунт».
Перейдите на вкладку Аккаунты, нажмите + Создать и заполните форму:
- API ключ — ключ, полученный на шаге 1;
- Название — произвольное название аккаунта, например название магазина;
- Плательщик — кто по умолчанию оплачивает доставку: Отправитель, Получатель или Третье лицо;
- Метод оплаты — Наличные или Безналичный;
- Тип груза — Посылка, Груз, Документы, Шины-диски или Паллеты;
- Тип доставки — типовая схема, например Отделение-Отделение.
Первый созданный аккаунт автоматически становится основным — именно его API-ключ система использует для всех запросов к Новой Почте. Аккаунтов может быть несколько (например, разные отправители), основной отмечен в списке.
Шаг 5. Импортируйте справочники
Перейдите на вкладку Справочники и нажмите Импорт справочников. Появится сообщение «Импорт начат. Ожидайте...» — система в фоновом режиме загрузит из API Новой Почты Области, Населённые пункты и Отделения/Почтоматы; на вкладке видны счётчики загруженных записей.
Новая Почта регулярно открывает новые отделения, поэтому импорт стоит время от времени повторять.
Шаг 6. Укажите город и отделение отправителя
Вернитесь на вкладку Аккаунты и откройте аккаунт на редактирование. После импорта справочников в форме доступны поля Город и Отделение с поиском — укажите, откуда будете отправлять посылки. При необходимости уточните Тип получателя и другие параметры по умолчанию и нажмите Сохранить.
Шаг 7. Проверьте оформление заказа
Откройте сайт магазина, добавьте товар в корзину и выберите доставку «Новая Почта». В форме должны появиться поля: Тип (Отделение / Почтомат / Адрес), Область, Город и Отделение или почтомат. Если списки городов пусты — см. раздел «Если что-то не работает».
Создание экспресс-накладной из заказа
Когда покупатель оформил заказ с доставкой Новой Почтой, откройте его в Магазин → Заказы — в карточке заказа есть вкладка Новая Почта:
- город и отделение получателя подставляются из заказа автоматически;
- укажите параметры отправления: объявленную стоимость, дату отправки, вес и габариты мест, описание груза; при необходимости включите Контроль оплаты или закажите Обратную доставку;
- нажмите Сгенерировать ЭН — накладная создастся в кабинете Новой Почты. Готовую ЭН можно распечатать, перегенерировать после изменений или удалить.
Все созданные накладные собраны в Интеграции → Новая Почта → Список ЭН: номер, дата, получатель, вес, статус, стоимость и дата доставки.
Продление срока действия API-ключа
Ключ действует один год. Чтобы продлить его: в кабинете Новой Почты откройте Налаштування → Безпека, нажмите иконку часов «Продовжити термін дії ключа» напротив нужного ключа и подтвердите кнопкой Підтвердити.
Продлить можно только ключ, срок действия которого ещё не истёк и который не изъят. Если срок уже прошёл — создайте новый ключ и обновите его в аккаунте (шаг 4).
Если что-то не работает
- В корзине пустой список городов или отделений — не выполнен импорт справочников (шаг 5) или API-ключ недействителен.
- Предупреждение «Необходимо указать API ключ» или «Необходимо создать аккаунт» — нет активного основного аккаунта с ключом (шаг 4).
- Покупатель выбрал «Новую Почту», но не видит способов оплаты — способы оплаты не привязаны к методу доставки (шаг 3).
- ЭН не создаётся — проверьте срок действия API-ключа и заполненность города и отделения отправителя в аккаунте (шаг 6).