Ничего не найдено

Попробуйте другой поисковый запрос

Популярные запросы:

Добавить в корзину

Корзина

У вас пока нет покупок

Перейти в маркетплейс
Начальная сумма:
Скидка на товары:
Скидка за количество:
Всего:
Оформить заказ

Доставка Укрпочтой в OpenCart: обзор модуля «Укрпочта API»

Разбираем модуль «Укрпочта API» по экранам админки: ключи API, способы доставки, локальная база отделений, наложенный платёж, Cron, создание накладных и что учесть перед покупкой.

7 мин чтения
54
1
Доставка Укрпочтой в OpenCart: обзор модуля «Укрпочта API»

Укрпочта до сих пор охватывает то, что не всегда охватывают другие перевозчики: малые города и сёла, 11000+ пунктов выдачи, тарифы без объёмного веса. Но без интеграции работать с ней из магазина неудобно: менеджер копирует данные заказа в кабинет Укрпочты, вручную печатает накладную, потом так же вручную ищет статус и пишет клиенту. Модуль «Укрпочта API» переносит эту работу в админку OpenCart: покупатель выбирает отделение и видит стоимость и срок доставки при оформлении, а накладная создаётся из карточки заказа с уже заполненной формой.

Модуль работает через API Укрпочты для e-commerce. Помимо способа доставки, в нём есть работа с накладными, калькуляторы стоимости и срока доставки, автоматическое отслеживание отправлений с изменением статусов заказа и уведомлениями. Общее сравнение модулей доставки для украинских перевозчиков есть в статье о модулях доставки для OpenCart: Новая почта, Укрпочта, Rozetka, а здесь разберём именно этот модуль по экранам админки.

Основные настройки и ключи API

Первая вкладка отвечает за подключение. Сюда вводятся три ключа от Укрпочты: eCom Bearer, StatusTracking Bearer и User token, без них модуль не будет работать. Здесь же включается режим отладки, задаётся логотип перевозчика и место, где он выводится при оформлении. Полезная мелочь: под кнопкой сохранения есть загрузка базовых настроек, а также экспорт и импорт, так что настроенный модуль можно перенести в другой магазин без ручного повторения.

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

Способы доставки: Экспресс и Стандарт

Модуль даёт четыре способа доставки: Экспресс в отделение, Экспресс курьером, Стандарт в отделение и Стандарт курьером. Каждый настраивается отдельно: название на нескольких языках, геозона, налоговый класс, минимальная и максимальная сумма заказа, порог бесплатной доставки с собственным текстом. Стоимость можно считать через API Укрпочты или по собственным тарифам с вкладки «Тарифы», отдельно включается показ срока доставки. Для доставки в отделение дополнительно выбирается, какие типы отделений показывать покупателю.

Настройки способа доставки Укрпочта Экспресс в отделение
Настройки способа «Экспресс в отделение», остальные способы имеют такой же набор полей.
  1. Переключатель способов. Общие настройки и четыре способа доставки, каждый со своими параметрами.
  2. Геозона и налоговый класс. Ограничение способа по регионам и налоги на доставку.
  3. Бесплатная доставка. Сумма, от которой доставка бесплатна, и текст, который увидит покупатель.
  4. Расчёт стоимости. Показ стоимости, расчёт через API или по тарифам.
  5. Типы отделений. Какие отделения показывать: городские, сельские, передвижные.

База данных: области, населённые пункты, отделения

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

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

Оплата и наложенный платёж

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

Настройки оплаты и наложенного платежа в модуле «Укрпочта API»
Параметры оплаты, которые автоматически подставляются в новую накладную.
  1. Плательщик доставки. Отправитель или получатель.
  2. Метод оплаты наложенным платежом. Способы оплаты магазина, для которых в накладную добавляется наложенный платёж.
  3. Учёт наложенного платежа. Выключено, включено или для всех способов оплаты.
  4. Комиссия за объявленную стоимость. Добавлять ли её в расчёт.
  5. Плательщик обратной доставки. Кто оплачивает перевод денег.
  6. Способ получения перевода. В отделении или на расчётный счёт.

Задания Cron: обновление базы и отслеживание отправлений

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

Задания Cron в модуле «Укрпочта API» для обновления базы и отслеживания отправлений
Команды Cron для обновления базы и отслеживания. Ключ и команды с ним размыты.
  1. Рекомендуемая частота. Подсказка, как часто запускать каждое задание.
  2. Cron ключ. Защищает адреса заданий от сторонних запусков, генерируется кнопкой справа.
  3. Обновление базы данных. Отдельные команды для справочников, областей, населённых пунктов и отделений.
  4. Отслеживание отправлений. Команда, которая проверяет статусы посылок и меняет статусы заказов.
  5. Статусы и макросы. Какие статусы Укрпочты отслеживать и макросы для шаблонов уведомлений.

Создание накладной из заказа

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

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

Список накладных и печать

Все созданные накладные собраны в отдельном списке с фильтром по номеру накладной и заказа. Отсюда накладную можно редактировать, удалить, добавить в группу отправлений или загрузить в PDF вместе с сопроводительными документами. Формат печати настраивается отдельно.

Список накладных Укрпочты в модуле для OpenCart
Список накладных. Имя, телефон и адрес получателя размыты.
  1. Действия со списком. Печать, создание и удаление накладных.
  2. Фильтр. Поиск по номеру накладной или номеру заказа.
  3. Меню накладной. Добавить в группу, редактировать, настройки печати, удалить.

Как это видит покупатель

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

Выбор доставки Укрпочтой и отделения при оформлении заказа в OpenCart
Оформление заказа на стандартном checkout.
  1. Способы доставки. Экспресс и Стандарт, в отделение или курьером, с ценой и сроком.
  2. Населённый пункт. Выбор из списка с поиском по названию.
  3. Отделение. Список отделений с индексами для выбранного города.

Что учесть перед покупкой

  • Нужен договор с Укрпочтой и три ключа 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. Вопросы по настройке можно задать разработчику прямо на странице модуля.

Перейти к модулю

Рекомендованные товары
P Prorab337 Доставка

«Укрпочта API» - модуль доставки для OpenCart

«Укрпошта API» для OpenCart - современный модуль доставки с полной интеграцией API E-COMMERCE. Автоматизирует оформление накладных, расчёт стоимости и сроков доставки, уведомления клиентов и смену статусов заказов. Экономит время, снижает расходы и упрощает обработку заказов.

7
продаж
1 797 ₴ -28%
1 300 ₴
OCTemplates

OCTemplates

OCTemplates — команда розробників та дизайнерів з України з досвідом у веброзробці з 2002 року. З 2015 року спеціалізуються на шаблонах та модулях для OpenCart: швидких, SEO-оптимізованих і готових до роботи в реальних умовах e-commerce. Продукти OCTemplates використовують тисячі інтернет-магазинів у Європі, Азії, Північній Америці та Австралії. Кожен покупець отримує не лише готове рішення, а й технічну підтримку та консультації з налаштування магазину.

статей
28
просмотров
27,710
лайков
22
подписчиков
0
Похожие статьи
Сравнение модулей доставки для OpenCart: Нова пошта, Укрпошта, Rozetka Обзоры

Сравнение модулей доставки для OpenCart: Нова пошта, Укрпошта, Rozetka

Сравниваем три модуля доставки с маркетплейса OpenCart Code: Нова пошта API, Укрпошта API и ROZETKA Delivery. Расчёт стоимости через API, ТТН из админки, автотрекинг, ограничения каждого модуля и чек-лист запуска.

Доставка Модули Обзоры
829 4 8 мин
20 июл 2026
Обработка, отправка и доставка: три разных срока, которые часто путают Производительность

Обработка, отправка и доставка: три разных срока, которые часто путают

Узнайте разницу между обработкой, отправкой и доставкой заказа. Объясняйте клиентам реальные сроки и правильно рассчитывайте сроки. Читайте статью!

Производительность Доставка
197 3 4 мин
05 ноя 2026
Комментарии (0)
Ответ для

Войдите, чтобы оставить комментарий

Войти

Комментариев пока нет

Будьте первым, кто оставит комментарий к этой статье!

Мы используем cookies

Мы используем cookies и схожие технологии для улучшения вашего опыта, анализа трафика и показа персонализированной рекламы. Подробнее — в нашей Политике cookies.