Укрпочта до сих пор охватывает то, что не всегда охватывают другие перевозчики: малые города и сёла, 11000+ пунктов выдачи, тарифы без объёмного веса. Но без интеграции работать с ней из магазина неудобно: менеджер копирует данные заказа в кабинет Укрпочты, вручную печатает накладную, потом так же вручную ищет статус и пишет клиенту. Модуль «Укрпочта API» переносит эту работу в админку OpenCart: покупатель выбирает отделение и видит стоимость и срок доставки при оформлении, а накладная создаётся из карточки заказа с уже заполненной формой.
Модуль работает через API Укрпочты для e-commerce. Помимо способа доставки, в нём есть работа с накладными, калькуляторы стоимости и срока доставки, автоматическое отслеживание отправлений с изменением статусов заказа и уведомлениями. Общее сравнение модулей доставки для украинских перевозчиков есть в статье о модулях доставки для OpenCart: Новая почта, Укрпочта, Rozetka, а здесь разберём именно этот модуль по экранам админки.
Основные настройки и ключи API
Первая вкладка отвечает за подключение. Сюда вводятся три ключа от Укрпочты: eCom Bearer, StatusTracking Bearer и User token, без них модуль не будет работать. Здесь же включается режим отладки, задаётся логотип перевозчика и место, где он выводится при оформлении. Полезная мелочь: под кнопкой сохранения есть загрузка базовых настроек, а также экспорт и импорт, так что настроенный модуль можно перенести в другой магазин без ручного повторения.

- Меню сохранения. Сохранить и выйти, загрузить базовые настройки, импорт и экспорт настроек.
- Вкладки модуля. Тарифы, база данных, отправитель, получатель, отправления, оплата, ТТН, задания Cron и поддержка.
- Режим отладки. Включайте, когда нужно разобраться, что именно отвечает API.
- Ключи Укрпочты. eCom Bearer, StatusTracking Bearer и User token, все три обязательны.
- Логотип и место вывода. Изображение перевозчика и где оно показывается среди способов доставки.
- cURL тайм-ауты. Отдельно на подключение и на выполнение запроса к API.
Способы доставки: Экспресс и Стандарт
Модуль даёт четыре способа доставки: Экспресс в отделение, Экспресс курьером, Стандарт в отделение и Стандарт курьером. Каждый настраивается отдельно: название на нескольких языках, геозона, налоговый класс, минимальная и максимальная сумма заказа, порог бесплатной доставки с собственным текстом. Стоимость можно считать через API Укрпочты или по собственным тарифам с вкладки «Тарифы», отдельно включается показ срока доставки. Для доставки в отделение дополнительно выбирается, какие типы отделений показывать покупателю.

- Переключатель способов. Общие настройки и четыре способа доставки, каждый со своими параметрами.
- Геозона и налоговый класс. Ограничение способа по регионам и налоги на доставку.
- Бесплатная доставка. Сумма, от которой доставка бесплатна, и текст, который увидит покупатель.
- Расчёт стоимости. Показ стоимости, расчёт через API или по тарифам.
- Типы отделений. Какие отделения показывать: городские, сельские, передвижные.
База данных: области, населённые пункты, отделения
Справочники, области, населённые пункты и отделения модуль хранит в своей базе, поэтому покупатель при оформлении не ждёт ответа API на каждый символ. На вкладке видно, когда база обновлялась в последний раз и сколько записей добавилось. Обновить можно вручную кнопкой или поставить на Cron, об этом ниже.

- Справочники и области. Служебная информация Укрпочты и список областей, обновление не затрагивает стандартные области OpenCart.
- Населённые пункты и отделения. Основные данные для выбора адреса при оформлении, со счётчиком новых записей.
- Ручное обновление. Кнопка запускает обновление конкретного справочника сразу.
Оплата и наложенный платёж
На вкладке «Оплата» задаются значения по умолчанию для накладной: кто платит за доставку, какие способы оплаты в магазине считать наложенным платежом, учитывать ли его и комиссию за объявленную стоимость в расчёте. Отдельно выбирается, кто платит за обратную доставку денег и куда их получать: в отделении или на расчётный счёт.

- Плательщик доставки. Отправитель или получатель.
- Метод оплаты наложенным платежом. Способы оплаты магазина, для которых в накладную добавляется наложенный платёж.
- Учёт наложенного платежа. Выключено, включено или для всех способов оплаты.
- Комиссия за объявленную стоимость. Добавлять ли её в расчёт.
- Плательщик обратной доставки. Кто оплачивает перевод денег.
- Способ получения перевода. В отделении или на расчётный счёт.
Задания Cron: обновление базы и отслеживание отправлений
Здесь модуль сам генерирует команды для планировщика на хостинге. Разработчик советует частоту: населённые пункты и отделения раз в сутки, области и справочники раз в месяц, отслеживание отправлений по необходимости. Отслеживание меняет статус заказа в соответствии со статусом посылки и может отправлять e-mail или SMS администратору и покупателю по шаблонам с макросами. Статусы Укрпочты, которые нужно отслеживать, выбираются в списке, а соответствие статусов магазина, задержка и тексты уведомлений настраиваются ниже на этой же вкладке.

- Рекомендуемая частота. Подсказка, как часто запускать каждое задание.
- Cron ключ. Защищает адреса заданий от сторонних запусков, генерируется кнопкой справа.
- Обновление базы данных. Отдельные команды для справочников, областей, населённых пунктов и отделений.
- Отслеживание отправлений. Команда, которая проверяет статусы посылок и меняет статусы заказов.
- Статусы и макросы. Какие статусы Укрпочты отслеживать и макросы для шаблонов уведомлений.
Создание накладной из заказа
Больше всего времени модуль экономит именно здесь. Если покупатель выбрал совместимый способ доставки, в заказе появляется кнопка работы с накладной. Форма заполняется автоматически: отправитель берётся из настроек, получатель и адрес из заказа, вес, габариты, объявленная стоимость и описание рассчитываются по правилам с вкладки «Отправления». Перед отправкой в API поля проверяются, а клиент и адрес в базе Укрпочты ищутся или создаются автоматически. Любое значение можно исправить вручную перед сохранением.

- Сохранить накладную. Создаёт отправление в Укрпочте и привязывает его к заказу.
- Отправитель. Данные из настроек, тип клиента, ИНН, IBAN, адрес.
- Получатель. Данные из заказа с выбором области, населённого пункта и отделения.
- Поиск по телефону. Подтягивает данные получателя по номеру.
- Оплата. Плательщик доставки, сумма и плательщик обратной доставки, способ получения перевода.
- Вес и габариты. Рассчитываются автоматически, можно добавить несколько мест.
- Объявленная стоимость и описание. Описание формируется из товаров заказа.
- Дополнительные услуги. Уведомление о вручении, SMS, осмотр при вручении и действие в случае невручения.
Список накладных и печать
Все созданные накладные собраны в отдельном списке с фильтром по номеру накладной и заказа. Отсюда накладную можно редактировать, удалить, добавить в группу отправлений или загрузить в PDF вместе с сопроводительными документами. Формат печати настраивается отдельно.

- Действия со списком. Печать, создание и удаление накладных.
- Фильтр. Поиск по номеру накладной или номеру заказа.
- Меню накладной. Добавить в группу, редактировать, настройки печати, удалить.
Как это видит покупатель
При оформлении заказа покупатель видит способы Укрпочты со стоимостью и сроком доставки, выбирает населённый пункт из списка с поиском, а отделение ищет по индексу. Для курьерской доставки подставляются поля адреса.

- Способы доставки. Экспресс и Стандарт, в отделение или курьером, с ценой и сроком.
- Населённый пункт. Выбор из списка с поиском по названию.
- Отделение. Список отделений с индексами для выбранного города.
Что учесть перед покупкой
- Нужен договор с Укрпочтой и три ключа API: eCom Bearer, StatusTracking Bearer и User token. По словам разработчика, клиенты API Укрпочты получают скидку 5% на отправления.
- Модуль закодирован, на сервере должен быть ionCube Loader 5.0 или новее, а также PHP с cURL. Поддерживаются PHP от 5.6 до 8.3.
- Работает на OpenCart от 2.0.3 до 3.0.5 и сборках на их основе, на скриншотах ocStore 3.0.4.1.
- Модуль обращается к серверу разработчика, но если он недоступен, дополнение продолжает работать. Лицензия на один домен с поддоменами, включая тестовые.
- Для автоматического обновления базы и отслеживания посылок нужно настроить задания Cron на хостинге.
- Полный функционал на оформлении есть с One Page Checkout, Smart Checkout шаблонов OCTemplates и Simple. Со стандартным оформлением и Ajax Quick Checkout работает только выбор города и отделения. Для других модулей и шаблонов разработчик делает адаптацию за отдельную плату.
- SMS-уведомления поддерживаются через SmsFly, из редакторов заказов совместим «Менеджер Заказов».
Кому подойдёт
Магазинам, которые регулярно отправляют Укрпочтой, особенно в небольшие населённые пункты, и хотят создавать накладные из админки и автоматически менять статусы заказов. Если отправок несколько в месяц, выгода менее очевидна: придётся получить ключи API и настроить Cron. Если у вас нестандартное оформление заказа, сначала уточните у разработчика совместимость.
«Укрпочта API» от Prorab337 на маркетплейсе OpenCart Code. Вопросы по настройке можно задать разработчику прямо на странице модуля.