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

Укрпошта - це національний оператор поштового зв'язку України. Розглянемо основні переваги, спираючись на які можна запропонувати цей спосіб доставки Вашим клієнтам:

  • розширення географії продажів - 11000+ точок видачі ваших товарів і залучення аудиторії невеликих міст і сіл
  • пересилання посилок вагою від 250 грамів - тільки в Укрпошті можна відправляти посилки масою від 250 грамів за вигідною ціною
  • оформлення посилок без урахування об'ємної ваги - враховується тільки фактична вага і розмір найдовшої сторони
  • тарифи - до 30% нижче середньоринкових

Даний модуль є найфункціональнішим рішенням для організації доставки Укрпоштою у Вашому інтернет-магазині, який використовує в роботі API для E-COMMERCE. Доповнення є чудовим помічником під час роботи з замовленнями, для яких клієнт обрав доставку Укрпоштою. Крім стандартних функцій модуля доставки є інструменти для роботи з Накладними. Також доступні два калькулятори: розрахунок вартості і терміну доставки. Розрахунок вартості відбувається на основі API, що гарантує отримання точних даних. Доповнення має низку функцій, які за Вас в автоматичному режимі виконують щоденну рутинну роботу: розсилка повідомлень з номером накладної, зміна статусів замовлення, нагадування про незабрані посилки та інші. Можливості постійно розширюються та покращуються.

Використовуючи модуль Ви будете економити свій час і значні грошові кошти на обробці замовлень. Клієнти, які використовують API Укрпошти, отримують 5% знижки на відправлення, тому маючи регулярні відправлення, модуль окупиться протягом 1-го місяця і почне економити ваші кошти.

Доповнення є авторською розробкою і захищено відповідними правами.

За посиланнями, наданими нижче, можна перейти на демонстраційний сайт. Для доступу в адмін-панель використовуйте наступні дані: логін і пароль - demo

Панель адміністратора Створення/редагування накладної Список накладних Магазин

Опис (основна інформація)

Функціональні можливості
Основні можливості
  • велика кількість налаштувань
  • створення, редагування та видалення накладних
  • максимальне заповнення форми накладної в автоматичному режимі
  • завантаження, налаштування друку, друк накладних
  • автоматичне відстеження відправлень, зміна статусів замовлення та відправка повідомлень
  • найточніший попередній розрахунок вартості доставки
  • розрахунок орієнтовного терміну доставки
  • автоматичний розрахунок параметрів відправлення
Можливості для адміністратора
  • підтримка мультимагазинів
  • експорт/імпорт налаштувань
  • завантаження базових налаштувань
  • увімкнення/вимкнення режиму налагодження
  • введення значень eCom Bearer, StatusTracking Bearer та User token Укрпошти
  • завантаження логотипу транспортної компанії
  • вибір місця відображення логотипу
  • налаштування cURL тайм-ауту підключення та виконання
  • налаштування способів доставки (Експрес у відділення, Експрес кур'єром, Стандарт у відділення, Стандарт кур'єром):
    • увімкнення/вимкнення способу доставки
    • редагована багатомовна назва доставки
    • вибір географічної зони
    • вибір податкового класу
    • можливість задати мінімальну суму замовлення при якій доставка буде доступною
    • можливість задати максимальну суму замовлення при якій доставка буде доступною
    • можливість задати мінімальну суму замовлення при якій доставка буде безкоштовною
    • редагований багатомовний текст безкоштовної доставки
    • увімкнення/вимкнення розрахунку вартості доставки
    • увімкнення/вимкнення API розрахунку вартості доставки (використовується інформація для розрахунку: тип доставки, індекс відправника та одержувача, вартість товару, вага товару, максимальна сторона, рекомендований лист)
    • увімкнення/вимкнення тарифного розрахунку вартості доставки (може використовуватися як самостійно, так і в разі недоступності API. Використовувана інформація для розрахунку: область відправника та одержувача, тип доставки, вартість товару, вага товару)
    • увімкнення/вимкнення розрахунку терміну доставки в днях (використовується інформація для розрахунку: область відправника та одержувача, тип доставки)
    • вибір типу відділення
    • вибір статусу відділення
  • можливість налаштувати тарифи та терміни доставки
  • робота з базою:
    • завантаження/оновлення довідників поштової компанії
    • завантаження/оновлення областей України
    • завантаження/оновлення населених пунктів компанії «Укрпошта»
    • завантаження/оновлення відділень компанії «Укрпошта»
  • налаштування параметрів відправника: відправник, тип відправника, ІПН, ЄДРПОУ, код банку, розрахунковий рахунок, e-mail, телефон, область, місто, вулиця, будинок, квартира, індекс, адресний забір
  • налаштування параметрів одержувача: одержувач, тип одержувача, ІПН, ЄДРПОУ, телефон, область, місто, адреса, вулиця, будинок, квартира, індекс
  • налаштування параметрів відправлення:
    • увімкнення/вимкнення обліку об'єму
    • вибір варіанту обліку об'єму відправлення
    • можливість задати кількість місць за замовчуванням
    • вибір складових для оголошеної вартості відправлення
    • можливість задати оголошену вартість за замовчуванням
    • можливість задати мінімальну оголошену вартість
    • можливість задати опис відправлення за замовчуванням у вигляді шаблону з використанням макросів замовлення та товару
    • увімкнення/вимкнення рекомендованого листа
    • увімкнення/вимкнення відправлення SMS про прибуття посилки клієнту
    • увімкнення/вимкнення огляду при врученні
    • вибір дії у разі невручення посилки
    • вибір способу застосування параметрів за замовчуванням
    • можливість задати вагу за замовчуванням
    • можливість задати мінімальну вагу
    • можливість задати розміри за замовчуванням
    • можливість задати допуски до розмірів відправлення
  • налаштування параметрів оплати:
    • вибір платника доставки за замовчуванням
    • вибір методу оплати для післяплати
    • налаштування розрахунку післяплати
    • налаштування обліку комісії за оголошену вартість
    • вибір платника зворотної доставки за замовчуванням
    • вибір способу отримання грошового переказу
  • налаштування інтеграції ТТН:
    • увімкнення/вимкнення за замовчуванням бонусних відправлень
    • вибір відображуваної інформації у списку накладних
    • налаштування друку
    • вибір сумісного способу доставки для створення накладних
    • увімкнення/вимкнення створення, редагування, видалення та присвоєння накладної у замовленні
    • можливість задати багатомовні назви пунктів меню для роботи з накладними у замовленні
  • завдання Cron:
    • можливість задати ключ безпеки виконання Cron команд
    • автоматичне оновлення бази даних модуля (довідники, області, міста, відділення)
    • автоматичне відстеження відправлень, зміна статусу замовлення та відправлення повідомлень
    • вибір статусів замовлення, для яких необхідно відстеження
    • налаштування залежностей для кожного статусу відправлення та статусу замовлення у магазині
    • можливість задати затримку виконання за кожним статусом відправлення
    • увімкнення/вимкнення повідомлень для адміністратора та покупця
    • можливість задати багатомовний шаблон повідомлення для e-mail та sms повідомлень з використанням макросів замовлення, товару та накладної
  • та інші стандартні опції модуля доставки
Можливості для роботи з накладними

При перегляді замовлення в адмін-панелі, якщо клієнт обрав сумісний спосіб доставки, з'являється кнопка для роботи з накладною. Можливо створити накладну на основі замовлення або призначити вже існуючу. При переході до створення, модуль максимально заповнює форму в автоматичному режимі. Якщо для переглядуваного замовлення накладна вже створена, то буде доступний пункт редагування та видалення. Також при перегляді замовлень можна перейти до списку всіх накладних. Доступний функціонал:

  • створення, редагування та видалення накладної
  • додавання/видалення накладних у групу
  • налаштування друку накладних
  • завантаження накладної та інших супровідних документів у форматі PDF
  • перегляд списку накладних з можливістю фільтру по номеру накладної та замовлення
  • автоматичне заповнення інформації відправника згідно з обраними налаштуваннями модуля з можливістю зміни даних безпосередньо перед створенням накладної
  • автоматичне заповнення параметрів одержувача згідно з даними з замовлення, у тому числі доступні такі функції:
    • увімкнення/вимкнення бонусного відправлення
    • вибір способу доставки (експрес чи стандарт)
    • вибір типу доставки (відділення чи адреса)
    • завантаження даних одержувача за номером телефону
    • вибір типу одержувача
    • введення ІПН
    • введення коду ЄДРПОУ
    • введення адреси доставки (область, місто, відділення, вулиця, будинок, квартира та індекс)
  • автоматичне заповнення параметрів відправлення:
    • вага
    • габарити
    • можливість задати кілька місць
    • оголошена вартість з можливістю коригування складових
    • опис
  • автоматичне заповнення параметрів оплати:
    • платник доставки
    • сума зворотної доставки, якщо обрана післяплата
    • платник зворотної доставки
    • спосіб отримання грошового переказу
  • додаткові параметри відправлення:
    • рекомендований лист
    • огляд при врученні
    • SMS повідомлення клієнту про прибуття відправлення
    • дія у разі невручення
  • поля автоматично, наскільки можливо, заповнюються модулем згідно з налаштуваннями
  • валідація полів під час редагування та перед передачею даних на сервер поштової компанії
  • автоматична перевірка існування клієнта в базі та створення у разі негативного результату
  • автоматичне редагування даних клієнта
  • автоматичний пошук адрес одержувача та створення нових у разі необхідності

При успішному створенні або редагуванні буде виконано перенаправлення до накладних та її підсвічування в загальному списку.

Можливості для клієнта
  • вибір типу доставки:
    • Укрпошта Експрес. Доставка у відділення
    • Укрпошта Експрес. Доставка кур'єром на адресу
    • Укрпошта Стандарт. Доставка у відділення
    • Укрпошта Стандарт. Доставка кур'єром на адресу
  • вибір населеного пункту отримання:
    • випадаючий список
    • пошук за назвою міста
  • вибір відділення:
    • випадаючий список
    • пошук за індексом
  • пошук індексу
  • інформація про вартість доставки
  • інформація про термін доставки
Підтримувані мови
  • українська
  • російська
  • англійська

У методах API реалізована підтримка української мови та частково англійської. Модуль автоматично використовує потрібну мову залежно від налаштувань OpenCart або переваг покупця під час оформлення замовлення.

Сумісність

Можливо, буде потрібно адаптація для конкретних версій. Адаптацію для інших модулів і шаблонів виконаємо за запитом за ДОДАТКОВУ ПЛАТУ.

Ліцензія
  • придбавши додаток, ви отримуєте пожиттєвий доступ до безкоштовних оновлень та безкоштовної технічної підтримки протягом року
  • ліцензія діє тільки на один домен і всі його піддомени, включаючи тестові сайти
  • інформація щодо отримання ліцензії доступна після встановлення модуля
  • активація ліцензії відбувається автоматично або вручну протягом години після покупки
Вимоги
  • ionCube Loader версії 5.0 і вище
  • PHP бібліотека cURL
  • PHP версії 5.6 і вище

Інструкція (встановлення, налаштування, оновлення та видалення)

Встановлення
  1. Завантажити вміст папки upload в корінь сайту
  2. Перейти в розділ Доповнення → Встановлення доповнень і завантажити необхідний модифікатор з папки modification. Перейти в розділ Доповнення → Менеджер доповнень і натиснути кнопку «Оновити». Докладніше про модифікатори в розділі Налаштування
  3. Зайти в адмін-панель магазину і перейти в розділ Доповнення → Доставка і навпроти модуля натиснути кнопку «Встановити»
  4. Перейти до редагування налаштувань модуля і активувати ліцензію
  5. На вкладці «Основні» в полі «eCom Bearer», «StatusTracking Bearer» і «User token» вставте відповідні значення, які згенерують і нададуть Вам після підписання договору з «Укрпоштою»
  6. Відкрийте випадаючий список поруч з кнопкою збереження налаштувань і завантажте базові налаштування
  7. Задайте необхідні налаштування на всіх вкладках
  8. Збережіть налаштування натиснувши "Зберегти". Модуль готовий до використання
Налаштування

Модуль сумісний практично з усіма популярними модулями оформлення замовлень і шаблонами OpenCart завдяки відповідним модифікаторам. Для повноцінної роботи на сторінці оформлення замовлення повинні виконуватися мінімальні вимоги для полів адреси доставки:

  • Область (zone_id) - стандартне поле OpenCart типу "select"
  • Місто (city) - стандартне текстове поле OpenCart
  • Адреса (address_1/address_2) - стандартне текстове поле OpenCart для введення адреси через кому
  • Індекс (postcode) - стандартне текстове поле Opencart

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

Опис модифікаторів:
shippingdata_admin – обов'язковий модифікатор, необхідний для розширення функціоналу в адмін-панелі.
shippingdata_ajax_quick_checkout – модифікатор забезпечує сумісність з модулем оформлення замовлень Ajax Quick Checkout. Додаткове налаштування не потрібне. Можливо, буде потрібна адаптація для конкретних версій.
shippingdata_default_checkout – модифікатор забезпечує сумісність зі стандартною формою замовлення. Додаткове налаштування не потрібне. Модифікатор замінює поле "Компанія" в адресі на checkbox з можливістю вибрати заздалегідь доставку. Якщо checkbox відзначено, то в полях місто і адреса підвантажуються списки міст і відділень відповідно.
shippingdata_octemplates_smart_checkout – модифікатор забезпечує сумісність з модулем оформлення замовлень Smart Checkout шаблону Deals. Додаткове налаштування не потрібне. Можливо, буде потрібна адаптація для конкретних версій.
shippingdata_simple – модифікатор забезпечує сумісність з модулем оформлення замовлень та реєстрації Simple. Є два варіанти налаштування:
  1. Відображення міста і відділення у вигляді простих текстових полів з підвантаженням випадаючих списків. Щоб налаштувати достатньо для полів city і address_1 в налаштуваннях модуля Simple увімкнути перезавантаження та вивести відповідні поля у блоці адреси доставки
  2. Відображення міста і відділення у вигляді випадаючих списків select. Цей спосіб сумісності доступний для версій Simple, у яких можливо налаштувати отримання значень викликом методу з catalog/model/tool/simpleapimain.php або catalog/model/tool/simpleapicustom.php.

    Налаштування:

    • після встановлення модифікатора shippingdata_simple зайдіть у налаштування модуля Simple і виберіть розділ "Поля"
    • для поля вибору міста встановіть такі налаштування:
      • тип – select
      • Список значень – Отримувати викликом методу в API модуля (catalog/model/tool/simpleapimain.php) або (catalog/model/tool/simpleapicustom.php)
      • Назва методу в API модуля – getShippingCities
      • Передавати у метод значення іншого поля – Регіон
    • для поля вибору відділення встановіть такі налаштування:
      • тип – select
      • Список значень – Отримувати викликом методу в API модуля (catalog/model/tool/simpleapimain.php) або (catalog/model/tool/simpleapicustom.php)
      • Назва методу в API модуля – getShippingDepartments
      • Передавати у метод значення іншого поля – Місто
    • всі інші налаштування є стандартними. Назви полів можуть відрізнятися
    для полів також потрібно увімкнути перезавантаження блоків при зміні полів у налаштуваннях блоку адреси доставки

shippingdata_simple_v_2.X.X / shippingdata_simple_v_3.X.X – модифікатор забезпечує сумісність з модулем оформлення замовлень Simple відповідних версій. Для полів city і address_1 в налаштуваннях потрібно увімкнути перезавантаження. Можливо, буде потрібна адаптація для конкретних версій.
Оновлення
Оновлення до v. 2.3.1:
  1. Завантажити, використовуючи FTP-менеджер, вміст папки upload в корінь сайту з заміною
  2. Завантажити нові модифікатори попередньо видаливши всі старі (Shipping Data ...) та оновити кеш модифікаторів (натиснути «Оновити»). Докладніше про модифікатори у розділі Налаштування
  3. Перевірити коректність усіх налаштувань і натиснути кнопку «Зберегти»
Оновлення з будь-якої версії на останню:
  1. Зайти в адмін-панель магазину
  2. Перейти до редагування модуля і зробити експорт налаштувань (випадаюче меню біля кнопки «Зберегти»)
  3. Перейти в розділ Доповнення → Доставка і навпроти модуля натисніть кнопку «Видалити»
  4. Завантажити використовуючи FTP менеджер вміст папки upload в корінь сайту із заміною
  5. Завантажити нові модифікатори попередньо видаливши всі старі (Shipping Data ...) і оновити кеш модифікаторів (натиснути «Оновити»). Докладніше про модифікатори в розділі Налаштування
  6. Перейти в розділ Доповнення → Доставка і навпроти модуля натисніть кнопку «Встановити»
  7. Перейти до редагування налаштувань модуля і на вкладці «Основні» в полях «eCom Bearer», «StatusTracking Bearer», «User token» вставте ключі доступу до API Укрпошти
  8. Після завантаження бази даних зробити імпорт раніше збережених налаштувань (випадаюче меню біля кнопки «Зберегти»)
  9. Перевірити коректність усіх налаштувань і натиснути кнопку «Зберегти»
Видалення
  1. Зайти в адмін-панель магазину
  2. Перейти в розділ Доповнення → Менеджер доповнень і видалити встановлені модифікатори модуля (відзначити і натиснути «Видалити»), після чого необхідно оновити кеш модифікаторів (натиснути «Оновити»)
  3. Перейти в розділ Доповнення → Доставка і навпроти модуля натиснути кнопку «Видалити» (відбудеться видалення інформації про модуль з бази)
  4. Видалити файли модуля з сервера

Підтримка (питання/відповіді, список змін, контакти)

Питання/Відповіді

Дотримуючись інструкції, встановіть розширення на домен, для якого хочете отримати ліцензію. Далі Вам необхідно зайти в налаштування модуля, заповнити та відправити інформацію про покупку. Після перевірки покупки модуль активується автоматично, і Вам на пошту прийде ключ активації.

Для тестових сайтів і піддоменів ключ надається безкоштовно. Тестові домени можна вказати через кому під час активації основного або навпаки.

Оновіть версію ionCube Loader.

Встановіть/активуйте безкоштовну бібліотеку ionCube Loader на своєму сервері/хостингу. Якщо, наприклад, у php_info, буде відображатися інформація про те, що бібліотека встановлена, а помилка не зникає - значить Ви неправильно встановили ionCube Loader.

  • перевірте, чи завантажилися всі файли модуля на сервер у кореневу директорію Вашого інтернет-магазину
  • перевірте, чи відповідають параметри Вашого сервера вимогам модуля
  • перевірте логи помилок сервера і OpenCart для уточнення конкретної помилки

  • перевірте, чи немає помилок у логах модифікаторів
  • перевірте, чи встановлений перемикач "Вартість доставки" у положення "Так"
  • перевірте "Безкоштовну доставку від", можливо сума у вашому кошику більше або дорівнює сумі для безкоштовної доставки
  • перевірте вагу товару в кошику. Якщо вага відсутня у картці товару, то можна задати значення за замовчуванням у налаштуваннях модуля
  • перевірте налаштування модуля, а також коректність даних отримувача
  • іноді деякі методи API поштової компанії недоступні, в такому разі можна увімкнути тарифний розрахунок у налаштуваннях модуля для відображення приблизної вартості доставки або почекати відновлення працездатності API

  • перевірте, чи немає помилок у логах модифікаторів
  • перевірте, чи встановлений перемикач "Термін доставки" у положення "Так"
  • перевірте налаштування модуля, а також коректність даних отримувача
  • іноді деякі методи API поштової компанії недоступні, в такому разі потрібно почекати відновлення працездатності API

    У папці extra є дамп країн і областей recovery_zone_and_country_tables_ru.sql і recovery_zone_and_country_tables_ua.sql з правильними назвами для України, російською та українською мовами відповідно. Завантажувати їх необхідно через адмін-панель магазину в розділі Система → Інструменти → Бекап / Відновлення попередньо перевіривши префікси таблиць, у файлах вони oc_

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

Інтеграція з накладними при перегляді списку замовлень
Інтеграція з накладними при перегляді списку замовлень
Інтеграція з накладними при перегляді конкретного замовлення
Інтеграція з накладними при перегляді конкретного замовлення

Відстеження в модулі здійснюється через відповідні методи API інтерфейсу Укрпошти. Все працює за принципом зміни статусів. Для кращого розуміння розглянемо роботу та налаштування на конкретному прикладі. Припустимо, нам необхідно відправляти повідомлення клієнту з номером накладної, коли замовлення буде відправлено і завершити угоду встановивши відповідний статус "Угода завершена".
  1. Для початку необхідно налаштувати Cron, використовуючи команду в модулі. Команда Cron дана для прикладу і для різних хостингів може відрізнятися. Інтервал відстеження, наприклад, кожну годину.
    Команда Cron для відстеження
    Команда Cron для відстеження
  2. Вкажіть статуси Вашого інтернет-магазину, які будуть відстежуватися. Модуль буде відстежувати замовлення з тими статусами, які Ви відзначите і для яких буде створена накладна. Для нашого прикладу це "В обробці" та "Відправлено".
  3. Налаштуйте відповідність між статусами Укрпошти та статусами Вашого інтернет-магазину. Модуль звіряє поточний статус відправлення з відповідним йому статусом інтернет-магазину, якщо статус замовлення не збігається - модуль змінює на новий. Для нашого прикладу модуль працюватиме таким чином:
    1. Вибирає всі замовлення, у яких присутній номер накладної та статус відповідає "В обробці" та "Відправлено"
    2. Відстежує вибрані замовлення за номером накладної
    3. Якщо у конкретного замовлення статус інтернет-магазину "В обробці", а статус у системі Укрпошти став "Відправлення", то модуль змінює статус в інтернет-магазині на "Відправлено"
    4. Якщо у конкретного замовлення статус інтернет-магазину "Відправлено" або "В обробці", а статус у системі Укрпошти став "Вручення", то модуль змінює статус в інтернет-магазині на "Угода завершена"
    Налаштування статусів
    Налаштування статусів
Список змін
v. 2.3.1 від 13.07.2026:
  • актуалізація методів АПІ
  • виправлені помилки сумісності
  • інші виправлення помилок, дрібні правки та поліпшення
v. 2.3.0 від 17.07.2024:
  • додана підтримка PHP 8.0, 8.1, 8.2
  • додана підтримка OpenCart 3.0.3.9
  • доданий друк декількох документів
  • доданий тарифний розрахунок післяплати
  • додана мінімальна вага за замовчуванням
  • додана мінімальна оголошена вартість за замовчуванням
  • додана можливість увімкнення/вимкнення обліку страховки в розрахунку вартості доставки
  • додана підтримка макросу product_id для товару
  • додана спливаюча підказка зазначеного міста і відділення у формі ТТН
  • оптимізація завантаження налаштувань і форми ТТН
  • актуалізація методів АПІ
  • виправлені помилки завантаження баз міст і відділень
  • виправлені помилки заповнення форми ТТН
  • виправлена помилка кількості місць за замовчуванням
  • виправлені помилки сумісності
  • інші виправлення помилок, дрібні правки і поліпшення
v. 2.2.0 від 21.11.2023:
  • додано налаштування типу відділень
  • додано налаштування статусів відділень
  • доданий пошук індексів
  • оновлений тарифний розрахунок
  • оптимізована робота зі списком накладних
  • виправлені помилки при створенні і редагуванні ТТН
  • виправлені помилки сумісності
  • інші виправлення помилок, дрібні правки і поліпшення
v. 2.1.0 від 09.04.2023:
  • додана підтримка бонусних відправлень
  • доданий пошук населених пунктів
  • доданий пошук відділень
  • додана можливість налаштування cURL таймаутів
  • додана підтримка PHP 7.4
  • доопрацьований тарифний розрахунок
  • оптимізована робота зі списком накладних
  • оптимізована робота з базою даних
  • актуалізація методів АПІ
  • виправлені помилки при створенні і редагуванні ТТН
  • виправлена помилка сортування способу доставка
  • виправлені помилки сумісності
  • інші виправлення помилок, дрібні правки і поліпшення
v. 2.0.0 від 02.01.2020:
  • додана підтримка OpenCart 3
  • додана робота з групами поштових відправлень
  • доданий друк форми 103а
  • доданий друк адресних ярликів для групи відправлень
  • додана опція рекомендованого листа
  • додано налаштування огляду при врученні посилки
  • додано налаштування дій у разі невручення посилки
  • додана можливість ручного створення/редагування відправника
  • доданий пошук отримувача і відправника за номером телефону
  • додана валідація API розрахунку вартості доставки
  • додана підтримка номера розрахункового рахунку у форматі IBAN
  • додана підтримка мультимагазину при створенні ТТН
  • додана підтримка макросів опцій товару
  • додана підтримка більш ранніх версій cURL
  • додано кешування для ряду API запитів
  • оптимізований вивід списку накладних
  • повністю змінений функціонал роботи з клієнтами
  • всі API методи приведені в актуальний стан
  • збільшені ліміти на виконання cURL запитів
  • оновлений список статусів для трекінгу відправлень
  • розширені налаштування друку супровідних документів
  • виправлена помилка парсера адреси отримувача
  • виправлена помилка визначення післяплати при створенні накладної
  • виправлені помилки режиму налагодження
  • виправлені помилки операцій з числами в PHP 7.1 і вище
  • виправлена помилка збереження налаштувань для мультимагазинів
  • виправлені помилки валідації форми накладної
  • виправлені помилки визначення безкоштовної доставки та мін./макс. кошика при різних налаштуваннях валюти
  • виправлені помилки тарифного розрахунку
  • виправлені помилки визначення параметрів посилки
  • виправлені різні помилки при оформленні замовлення
  • виправлені помилки сумісності з різними збірками OpenCart
  • покращена сумісність з низкою доповнень
  • інші виправлення помилок, дрібні правки і поліпшення
v. 1.1.0 від 29.11.2018:
  • доданий API розрахунок вартості доставки
  • додано отримання післяплати на банківський рахунок
  • додано автоматичне редагування даних клієнта
  • додані поля клієнтів (ІПН, банківський код, розрахунковий рахунок, e-mail)
  • додана підтримка OpenCart v 2.0.0.0-2.2.0.0
  • додана адаптація для OpenCart v 1.5.X.X
  • виправлений розрахунок параметрів відправлення
  • виправлена перевірка StatusTracking Bearer
  • інші виправлення помилок, дрібні правки і поліпшення
v. 1.0.0 від 14.10.2018:
  • перший реліз
Контакти

"Ukrposhta API" - delivery module for OpenCart

Ukrposhta is the national postal operator of Ukraine. Let's consider the main advantages that can be offered to your clients with this delivery method:

  • expanding sales geography - 11000+ pick-up points for your goods and attracting audiences from small towns and villages
  • shipping parcels weighing from 250 grams - only Ukrposhta allows you to send parcels weighing from 250 grams at a favorable price
  • parcel processing without volumetric weight accounting - only actual weight and the length of the longest side are considered
  • rates - up to 30% lower than the market average

This module is the most functional solution for organizing Ukrposhta delivery in your online store, using the E-COMMERCE API. The module is a great assistant when working with orders for which the client has chosen Ukrposhta delivery. In addition to the standard delivery module functions, there are tools for working with Invoices. There are also two calculators available: cost calculation and delivery time calculation. Cost calculation is based on the API, ensuring accurate data. The module includes several features that automate daily routine tasks: invoice number notifications, order status changes, reminders about unclaimed parcels, and more. The capabilities are constantly expanding and improving.

Using this module, you will save time and significant money on order processing. Clients who use the Ukrposhta API receive a 5% discount on shipments, so with regular shipments, the module will pay off within a month and start saving you money.

This module is an original development and is protected by appropriate rights.

Use the links below to visit the demo site. To access the admin panel, use the following credentials: login and password - demo

Admin Panel Create/Edit Invoice Invoice List Store

Description (main information)

Features
Main features
  • a large number of settings
  • creation, editing, and deletion of invoices
  • automatic filling of the invoice form
  • downloading, printing setup, and printing of invoices
  • automatic shipment tracking, order status changes, and notifications
  • the most accurate preliminary cost calculation
  • estimated delivery time calculation
  • automatic calculation of shipment parameters
Administrator features
  • multi-store support
  • export/import settings
  • loading basic settings
  • enable/disable debug mode
  • input eCom Bearer, StatusTracking Bearer, and User token values of Ukrposhta
  • uploading the transport company's logo
  • choosing the logo display location
  • configuring cURL connection and execution timeout
  • delivery methods settings (Express to branch, Express by courier, Standard to branch, Standard by courier):
    • enable/disable delivery method
    • editable multilingual delivery name
    • choosing the geographical zone
    • choosing the tax class
    • setting the minimum order amount for which delivery will be available
    • setting the maximum order amount for which delivery will be available
    • setting the minimum order amount for which delivery will be free
    • editable multilingual free delivery text
    • enable/disable delivery cost calculation
    • enable/disable API cost calculation (used information for calculation: delivery type, sender's and recipient's postal codes, product cost, product weight, maximum side, registered letter)
    • enable/disable tariff cost calculation (can be used independently or if the API is unavailable. Used information for calculation: sender's and recipient's region, delivery type, product cost, product weight)
    • enable/disable delivery time calculation in days (used information for calculation: sender's and recipient's region, delivery type)
    • choosing the branch type
    • choosing the branch status
  • setting tariffs and delivery times
  • working with the database:
    • uploading/updating postal company directories
    • uploading/updating regions of Ukraine
    • uploading/updating settlements of Ukrposhta
    • uploading/updating branches of Ukrposhta
  • configuring sender parameters: sender, sender type, tax number, EDRPOU, bank code, bank account, email, phone, region, city, street, house, apartment, postal code, address pickup
  • configuring recipient parameters: recipient, recipient type, tax number, EDRPOU, phone, region, city, address, street, house, apartment, postal code
  • configuring shipment parameters:
    • enable/disable volume accounting
    • choosing the volume accounting option
    • setting the default number of places
    • choosing the components for the declared value of the shipment
    • setting the default declared value
    • setting the minimum declared value
    • setting the default description of the shipment as a template using order and product macros
    • enable/disable registered letter
    • enable/disable SMS notification of the shipment arrival to the client
    • choosing the action in case of non-delivery
    • choosing the default parameter application method
    • setting the default weight
    • setting the minimum weight
    • setting the default dimensions
    • setting tolerances for shipment dimensions
  • configuring payment parameters:
    • choosing the default payer of delivery
    • choosing the payment method for COD
    • setting the calculation of COD
    • setting the accounting of commission for declared value
    • choosing the default payer of return delivery
    • choosing the method of receiving money transfer
  • configuring TTN integration:
    • enable/disable default bonus shipments
    • choosing the displayed information in the invoice list
    • setting up printing
    • choosing a compatible delivery method for creating invoices
    • enable/disable creation, editing, deletion, and assignment of invoices in the order
    • setting multilingual menu item names for working with invoices in the order
  • Cron tasks:
    • setting the security key for executing Cron commands
    • automatic module database update (directories, regions, cities, branches)
    • automatic shipment tracking, order status change, and notifications
    • choosing order statuses for tracking
    • configuring dependencies for each shipment status and order status in the store
    • setting the execution delay for each shipment status
    • enable/disable notifications for the administrator and the customer
    • setting a multilingual message template for email and SMS notifications using order, product, and invoice macros
  • and other standard delivery module options
Invoice management features

When viewing an order in the admin panel, if the client chose a compatible delivery method, a button for working with the invoice appears. It is possible to create an invoice based on the order or assign an existing one. When creating, the module fills out the form as much as possible automatically. If an invoice has already been created for the viewed order, the editing and deletion options will be available. You can also go to the list of all invoices when viewing orders. Available functionalities:

  • creation, editing, and deletion of invoices
  • adding/removing invoices to/from a group
  • setting up invoice printing
  • downloading the invoice and other accompanying documents in PDF format
  • viewing the invoice list with the ability to filter by invoice and order number
  • automatic filling of sender information according to the selected module settings with the possibility of data change directly before creating the invoice
  • automatic filling of recipient parameters according to the order data, including the following functions:
    • enable/disable bonus shipment
    • choosing the delivery method (express or standard)
    • choosing the delivery type (branch or address)
    • loading recipient data by phone number
    • choosing the recipient type
    • input of the tax number
    • input of the EDRPOU code
    • input of the delivery address (region, city, branch, street, house, apartment, and postal code)
  • automatic filling of shipment parameters:
    • weight
    • dimensions
    • possibility to set several places
    • declared value with the possibility of adjusting the components
    • description
  • automatic filling of payment parameters:
    • delivery payer
    • return delivery amount if COD is chosen
    • return delivery payer
    • method of receiving money transfer
  • additional shipment parameters:
    • registered letter
    • inspection upon delivery
    • SMS notification to the client about the arrival of the shipment
    • action in case of non-delivery
  • fields are automatically filled by the module as much as possible according to the settings
  • field validation during editing and before sending data to the postal company's server
  • automatic verification of the client's existence in the database and creation if the result is negative
  • automatic editing of the client's data
  • automatic search for recipient addresses and creation of new ones if necessary

Upon successful creation or editing, there will be a redirection to the invoice with its highlighting in the general list.

Client features
  • choosing the delivery type:
    • Ukrposhta Express. Delivery to branch
    • Ukrposhta Express. Delivery by courier to address
    • Ukrposhta Standard. Delivery to branch
    • Ukrposhta Standard. Delivery by courier to address
  • specifying the delivery address
  • choosing the receiving settlement:
    • drop-down list
    • search by city name
  • choosing the branch:
    • drop-down list
    • search by index
  • index search
  • information about delivery cost
  • information about delivery time
Supported Languages
  • Ukrainian
  • Russian
  • English

The API methods support the Ukrainian language and partially English. The module automatically uses the necessary language depending on the OpenCart settings or the customer's preferences during the order process.

Compatibility
  • OpenCart v. 1.5.x.x, 2.x.x.x, 3.x.x.x (and builds based on the corresponding OpenCart versions)
  • checkout forms: One Page Checkout - Simple Checkout, OCTemplates Smart Checkout, Simple checkout & registration - maximum functionality. Standard checkout, Ajax Quick Checkout - only city and branch selection
  • message sending modules: standard email sending, SmsFly order
  • order editors: Order Manager (Order Editor)

Adaptation may be required for specific versions. Adaptation for other modules and templates can be done upon request for an ADDITIONAL FEE.

License
  • By purchasing the module, you get lifetime access to free updates and free technical support for a year
  • The license is valid for one domain and all its subdomains, as well as test sites
  • Information on how to obtain the license is available after the module installation
  • The license activation occurs within a few hours after purchase
Requirements
  • ionCube Loader version 5.0 and higher
  • PHP cURL library
  • PHP version 5.6 and higher

Instructions (installation, setup, update, and removal)

Installation
  1. Upload the contents of the upload folder to the root of the site
  2. Go to Extensions → Installer and upload the necessary modifier from the modification folder. Go to Extensions → Modifications and click the "Refresh" button. More about modifiers in the Setup section
  3. Log in to the store admin panel and go to Extensions → Shipping and click the "Install" button next to the module
  4. Go to the module settings and activate the license
  5. On the "General" tab in the "eCom Bearer", "StatusTracking Bearer", and "User token" fields, enter the corresponding values that will be generated and provided to you after signing the contract with "Ukrposhta"
  6. Open the drop-down list next to the save settings button and load the basic settings
  7. Set the necessary settings on all tabs
  8. Save the settings by clicking "Save". The module is ready for use
Setup

The module is compatible with almost all popular order processing modules and OpenCart templates thanks to the appropriate modifiers. For the full operation on the checkout page, the following minimum requirements for delivery address fields must be met:

  • Region (zone_id) - standard OpenCart "select" field
  • City (city) - standard OpenCart text field
  • Address (address_1/address_2) - standard OpenCart text field for entering the address with a comma
  • Postcode (postcode) - standard OpenCart text field

If the used checkout module allows creating custom fields for the delivery address, it is possible to use separate fields for the street, house, and apartment.

Description of modifiers:
shippingdata_admin – mandatory modifier necessary to expand functionality in the admin panel.
shippingdata_ajax_quick_checkout – the modifier ensures compatibility with the Ajax Quick Checkout module. Additional configuration is not required. Adaptation may be required for specific versions.
shippingdata_default_checkout – the modifier ensures compatibility with the standard checkout form. Additional configuration is not required. The modifier replaces the "Company" field in the address with a checkbox allowing pre-selection of delivery. If the checkbox is checked, the city and address fields load lists of cities and branches respectively.
shippingdata_octemplates_smart_checkout – the modifier ensures compatibility with the Smart Checkout module of the Deals template. Additional configuration is not required. Adaptation may be required for specific versions.
shippingdata_simple – the modifier ensures compatibility with the Simple checkout and registration module. There are two configuration options:
  1. Displaying the city and branch as simple text fields with drop-down lists. To configure, it is enough to enable reloading for the city and address_1 fields in the Simple module settings and display the corresponding fields in the delivery address block.
  2. Displaying the city and branch as drop-down select lists. This compatibility method is available for Simple versions where it is possible to set the retrieval of values by calling a method from catalog/model/tool/simpleapimain.php or catalog/model/tool/simpleapicustom.php.

    Setup:

    • after installing the shippingdata_simple modifier, go to the Simple module settings and select the "Fields" section
    • for the city selection field, set the following settings:
      • type – select
      • Value list – Retrieve by calling a method in the module API (catalog/model/tool/simpleapimain.php) or (catalog/model/tool/simpleapicustom.php)
      • API module method name – getShippingCities
      • Pass the value of another field to the method – Region
    • for the branch selection field, set the following settings:
      • type – select
      • Value list – Retrieve by calling a method in the module API (catalog/model/tool/simpleapimain.php) or (catalog/model/tool/simpleapicustom.php)
      • API module method name – getShippingDepartments
      • Pass the value of another field to the method – City
    • all other settings are standard. Field names may vary.
    for the fields, it is also necessary to enable block reloading when changing fields in the delivery address block settings.

shippingdata_simple_v_2.X.X / shippingdata_simple_v_3.X.X – the modifier ensures compatibility with the Simple checkout module of the corresponding versions. For the city and address_1 fields in the settings, it is necessary to enable reloading. Adaptation may be required for specific versions.
Update
Update to v. 2.3.1:
  1. Upload the contents of the upload folder to the site root using an FTP manager, replacing existing files
  2. Upload new modifiers after deleting all old ones (Shipping Data ...) and refresh the modification cache (click "Refresh"). More about modifiers in the Setup section
  3. Check the correctness of all settings and click the "Save" button
Updating from any version to the latest:
  1. Log in to the store admin panel
  2. Go to the module settings and export the settings (drop-down menu next to the "Save" button)
  3. Go to Extensions → Shipping and click the "Uninstall" button next to the module
  4. Upload the contents of the upload folder to the root of the site using an FTP manager, replacing the existing files
  5. Upload new modifiers after deleting all old ones (Shipping Data ...) and refresh the modification cache (click "Refresh"). More about modifiers in the Setup section
  6. Go to Extensions → Shipping and click the "Install" button next to the module
  7. Go to the module settings and on the "General" tab, enter the access keys to the Ukrposhta API in the fields "eCom Bearer", "StatusTracking Bearer", and "User token"
  8. After loading the database, import the previously saved settings (drop-down menu next to the "Save" button)
  9. Check the correctness of all settings and click the "Save" button
Removal
  1. Log in to the store admin panel
  2. Go to Extensions → Modifications and delete the installed module modifiers (select and click "Delete"), then refresh the modification cache (click "Refresh")
  3. Go to Extensions → Shipping and click the "Uninstall" button next to the module (this will remove the module information from the database)
  4. Delete the module files from the server

Support (FAQ, changelog, contacts)

FAQ

Following the instructions, install the extension on the domain for which you want to get a license. Then, go to the module settings, fill out, and send the purchase information. After verifying the purchase, the module will be activated automatically and an activation key will be sent to your email.

For test sites and subdomains, the key is provided for free. Test domains can be specified with a comma during the activation of the main or vice versa.

Update the ionCube Loader version.

Install/activate the free ionCube Loader library on your server/hosting. If, for example, in php_info, it shows that the library is installed but the error persists, it means you have incorrectly installed ionCube Loader.

  • check if all module files were uploaded to the root directory of your online store
  • check if your server parameters meet the module requirements
  • check the server and OpenCart error logs for specific error details

  • check if there are errors in the modification logs
  • check if the "Shipping Cost" switch is set to "Yes"
  • check "Free shipping from", maybe the amount in your cart is equal to or greater than the amount for free shipping
  • check the weight of the item in the cart. If the weight is missing in the product card, you can set a default value in the module settings
  • check the module settings and the correctness of the recipient's data
  • sometimes some API methods of the postal company are unavailable, in this case, you can enable the tariff calculation in the module settings to display an approximate shipping cost or wait for the API to be restored

  • check if there are errors in the modification logs
  • check if the "Delivery time" switch is set to "Yes"
  • check the module settings and the correctness of the recipient's data
  • sometimes some API methods of the postal company are unavailable, in this case, you need to wait for the API to be restored

    In the extra folder, there is a dump of countries and regions recovery_zone_and_country_tables_ru.sql and recovery_zone_and_country_tables_ua.sql with correct names for Ukraine, in Russian and Ukrainian respectively. They need to be uploaded through the store admin panel in the System → Tools → Backup / Restore section after checking the table prefixes, in the files they are oc_.

If a compatible shipping method was selected during the order placement, a button for working with the waybill will be available when viewing the order list or a specific order. Also, when viewing the order list, there will be a button to go to the waybill list.

Integration with waybills when viewing the order list
Integration with waybills when viewing the order list
Integration with waybills when viewing a specific order
Integration with waybills when viewing a specific order

Tracking in the module is carried out through the appropriate methods of the Ukrposhta API interface. Everything works on the principle of status changes. For better understanding, let's consider the work and setup on a specific example. Suppose we need to send a notification to the client with the waybill number when the order is shipped and complete the deal by setting the corresponding status "Deal completed".
  1. First, you need to set up Cron using the command in the module. The Cron command is given as an example and may differ for different hostings. Tracking interval, for example, every hour.
    Cron command for tracking
    Cron command for tracking
  2. Specify the statuses of your online store that will be tracked. The module will track orders with those statuses that you mark and for which a waybill will be created. For our example, this is "Processing" and "Shipped".
  3. Set up the correspondence between Ukrposhta statuses and your online store statuses. The module checks the current status of the shipment with the corresponding store status, if the order status does not match, the module changes it to a new one. For our example, the module will work as follows:
    1. Selects all orders that have a waybill number and a status that matches "Processing" and "Shipped"
    2. Tracks the selected orders by waybill number
    3. If the store status of a specific order is "Processing", and the status in the Ukrposhta system has become "Shipment", the module changes the store status to "Shipped"
    4. If the store status of a specific order is "Shipped" or "Processing", and the status in the Ukrposhta system has become "Delivered", the module changes the store status to "Deal completed"
    Status setup
    Status setup
Changelog
v. 2.3.1 from 13.07.2026:
  • updated API methods
  • fixed compatibility issues
  • other bug fixes, minor tweaks, and improvements
v. 2.3.0 from 17.07.2024:
  • added support for PHP 8.0, 8.1, 8.2
  • added support for OpenCart 3.0.3.9
  • added printing of multiple documents
  • added tariff calculation for cash on delivery
  • added default minimum weight
  • added default minimum declared value
  • added ability to enable/disable insurance calculation in shipping cost
  • added product_id macro support for products
  • added tooltip for the specified city and department in the TTN form
  • optimized loading of settings and TTN form
  • updated API methods
  • fixed errors loading city and department databases
  • fixed errors filling out the TTN form
  • fixed default number of places
  • fixed compatibility issues
  • other bug fixes, minor tweaks, and improvements
v. 2.2.0 from 21.11.2023:
  • added department type setting
  • added department status setting
  • added zip code search
  • updated tariff calculation
  • optimized working with the waybill list
  • fixed errors when creating and editing TTNs
  • fixed compatibility issues
  • other bug fixes, minor tweaks, and improvements
v. 2.1.0 from 09.04.2023:
  • added support for bonus shipments
  • added search for settlements
  • added department search
  • added cURL timeout settings
  • added support for PHP 7.4
  • refined tariff calculation
  • optimized working with the waybill list
  • optimized working with the database
  • updated API methods
  • fixed errors when creating and editing TTNs
  • fixed delivery method sorting error
  • fixed compatibility issues
  • other bug fixes, minor tweaks, and improvements
v. 2.0.0 from 02.01.2020:
  • added support for OpenCart 3
  • added working with groups of postal items
  • added printing of form 103a
  • added printing of address labels for a group of shipments
  • added registered letter option
  • added inspection setting upon delivery
  • added setting for actions in case of non-delivery
  • added ability to manually create/edit the sender
  • added recipient and sender search by phone number
  • added validation of API shipping cost calculation
  • added support for IBAN account number
  • added multi-store support when creating TTNs
  • added support for product option macros
  • added support for earlier cURL versions
  • added caching for a number of API requests
  • optimized display of the waybill list
  • completely changed the functionality for working with customers
  • all API methods have been updated
  • increased limits for cURL requests
  • updated status list for shipment tracking
  • expanded settings for printing accompanying documents
  • fixed recipient address parser error
  • fixed error determining cash on delivery when creating a waybill
  • fixed debugging mode errors
  • fixed number operations errors in PHP 7.1 and higher
  • fixed saving settings for multi-stores
  • fixed validation errors in the waybill form
  • fixed errors determining free shipping and min./max. cart values for various currency settings
  • fixed tariff calculation errors
  • fixed errors determining parcel parameters
  • fixed various order processing errors
  • fixed compatibility errors with different OpenCart builds
  • improved compatibility with a number of extensions
  • other bug fixes, minor tweaks, and improvements
v. 1.1.0 from 29.11.2018:
  • added API shipping cost calculation
  • added cash on delivery to bank account
  • added automatic editing of customer data
  • added customer fields (TIN, bank code, account number, email)
  • added support for OpenCart v 2.0.0.0-2.2.0.0
  • added adaptation for OpenCart v 1.5.X.X
  • fixed shipment parameter calculation
  • fixed StatusTracking Bearer check
  • other bug fixes, minor tweaks, and improvements
v. 1.0.0 from 14.10.2018:
  • first release
Contacts

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

Укрпочта - это национальный оператор почтовой связи Украины. Рассмотрим основные преимущества, опираясь на которые можно предложить этот способ доставки Вашим клиентам:

  • расширение географии продаж - 11000+ точек выдачи ваших товаров и привлечения аудитории небольших городов и сел
  • пересылка посылок весом от 250 граммов - только в Укрпочте можно отправлять посылки массой от 250 граммов по выгодной цене
  • оформление посылок без учета объемного веса - учитывается только фактический вес и размер самой длинной стороны
  • тарифы - до 30% ниже среднерыночных

Данный модуль является самым функциональным решением для организации доставки Укрпочтой в Вашем интернет-магазине, который использует в работе API для E-COMMERCE. Дополнение является отличным помощником во время работы с заказами, для которых клиент выбрал доставку Укрпочтой. Кроме стандартных функций модуля доставки имеются инструменты для работы с Накладными. Также доступны два калькулятора: расчет стоимости и срока доставки. Расчет стоимости происходит на основе API, что гарантирует получение точных данных. Дополнение имеет ряд функций, которые за Вас в автоматическом режиме выполняют ежедневную рутинную работу: рассылка уведомлений с номером накладной, смена статусов заказа, напоминание о не забранных посылках и другие. Возможности постоянно расширяются и улучшаются

Дополнение является авторской разработкой и защищено соответствующими правами

По ссылкам, предоставленным ниже, можно перейти на демонстрационный сайт. Для доступа в админ-панель используйте следующие данные: логин и пароль - demo

Панель администратора Создание/редактирование накладной Список накладных Магазин

Описание (основная информация)

Функциональные возможности
Основные возможности
  • большое количество настроек
  • создание, редактирование и удаление накладных
  • максимальное заполнение формы накладной в автоматическом режиме
  • скачивание, настройка печати, печать накладных
  • автоматическое отслеживание отправлений, смена статусов заказа и отправка уведомлений
  • самый точный предварительный расчет стоимости доставки
  • расчет ориентировочного срока доставки
  • автоматический расчет параметров отправления
Возможности для администратора
  • поддержка мультимагазинов
  • экспорт/импорт настроек
  • загрузка базовых настроек
  • вкл/выкл режим отладки
  • ввод значений eCom Bearer, StatusTracking Bearer и User token Укрпочты
  • загрузка логотипа транспортной компании
  • выбор места отображения логотипа
  • настройка cURL тайм-аут подключения и выполнения
  • настройки способов доставки (Экспресс в отделение, Экспресс курьером, Стандарт в отделение, Стандарт курьером):
    • вкл/выкл способ доставки
    • редактируемое мультиязычное название доставки
    • выбор географической зоны
    • выбор налогового класса
    • возможность задать минимальную сумму заказа при которой доставка будет доступной
    • возможность задать максимальную сумму заказа при которой доставка будет доступной
    • возможность задать минимальную сумму заказа при которой доставка будет бесплатной
    • редактируемый мультиязычный текст бесплатной доставки
    • вкл/выкл расчет стоимости доставки
    • вкл/выкл API расчет стоимости доставки (используемая информация для расчета: тип доставки, индекс отправителя и получателя, стоимость товара, вес товара, максимальная сторона, заказное письмо)
    • вкл/выкл тарифный расчет стоимости доставки (может использоваться как самостоятельно, так и в случае недоступности API. Используемая информация для расчета: область отправителя и получателя, тип доставки, стоимость товара, вес товара)
    • вкл/выкл расчет срока доставки в днях (используемая информация для расчета: область отправителя и получателя, тип доставки)
    • выбор типа отделения
    • выбор статуса отделения
  • возможность настроить тарифы и сроки доставки
  • работа с базой:
    • загрузка/обновление справочников почтовой компании
    • загрузка/обновление областей Украины
    • загрузка/обновление населенных пунктов компании «Укрпочта»
    • загрузка/обновление отделений компании «Укрпочта»
  • настройка параметров отправителя: отправитель, тип отправителя, ИНН, ЕГРПОУ, код банка, расчетный счет, e-mail, телефон, область, город, улица, дом, квартира, индекс, адресный забор
  • настройка параметров получателя: получатель, тип получателя, ИНН, ЕГРПОУ, телефон, область, город, адрес, улица, дом, квартира, индекс
  • настройка параметров отправления:
    • вкл/выкл учет объёма
    • выбор варианта учета объёма отправления
    • возможность задать количество мест по умолчанию
    • выбор составляющих для объявленной стоимости отправления
    • возможность задать объявленную стоимость по умолчанию
    • возможность задать минимальную объявленную стоимость
    • возможность задать описание отправления по умолчанию в виде шаблона с использованием макросов заказа и товара
    • вкл/выкл заказное письмо
    • вкл/выкл отправку смс о прибытии посылки клиенту
    • вкл/выкл осмотр при вручении
    • выбор действия в случае невручения посылки
    • выбор способа применения параметров по умолчанию
    • возможность задать вес по умолчанию
    • возможность задать минимальный вес
    • возможность задать размеры по умолчанию
    • возможность задать допуски к размерам отправления
  • настройка параметров оплаты:
    • выбор плательщика доставки по умолчанию
    • выбор метода оплаты для наложенного платежа
    • настройка расчета наложенного платежа
    • настройка учета комиссии за объявленную стоимость
    • выбор плательщика обратной доставки по умолчанию
    • выбор способа получения денежного перевода
  • настройка интеграции ТТН:
    • вкл/выкл по умолчанию бонусные отправления
    • выбор отображаемой информации в списке накладных
    • настройка печати
    • выбор совместимого способа доставки для создания накладных
    • вкл/выкл создание, редактирование, удаление и присвоения накладной в заказе
    • возможность задать мультиязычные названия пунктов меню для работы с накладными в заказе
  • задания Cron:
    • возможность задать ключ безопасности выполнения Cron команд
    • автоматическое обновление базы данных модуля (справочники, области, города, отделения)
    • автоматическое отслеживание отправлений, смена статуса заказа и отправка уведомлений
    • выбор статусов заказа, для которых необходимо отслеживание
    • настройка зависимостей для каждого статуса отправления и статуса заказа в магазине
    • возможность задать задержку выполнения по каждому статусу отправления
    • вкл/выкл уведомления для администратора и покупателя
    • возможность задать мультиязычный шаблон сообщения для e-mail и sms уведомлений используя макросы заказа, товара и накладной
  • и другие стандартные опции модуля доставки
Возможности для работы с накладными

При просмотре заказа в админ-панели, если клиент выбрал совместимый способ доставки, появляется кнопка для работы с накладной. Возможно создать накладную на основе заказа или присвоить уже существующую. При переходе к созданию, модуль максимально заполняет форму в автоматическом режиме. Если для просматриваемого заказа накладная уже создана, то будет доступен пункт редактирования и удаления. Также при просмотре заказов можно перейти к списку всех накладных. Доступный функционал:

  • создание, редактирование и удаление накладной
  • добавление/удаление накладных в группу
  • настройка печати накладных
  • скачивание накладной и других сопроводительных документов в формате PDF
  • просмотр списка накладных с возможностью фильтра по номеру накладной и заказа
  • автоматическое заполнение информации отправителя согласно выбранным настройкам модуля с возможностью смены данных непосредственно перед созданием накладной
  • автоматическое заполнении параметров получателя согласно данным из заказа, в том числе доступны следующие функции:
    • вкл/выкл бонусное отправление
    • выбор способа доставки (экспресс или стандарт)
    • выбор типа доставки (отделение или адрес)
    • загрузка данных получателя по номеру телефона
    • выбор типа получателя
    • ввод ИНН
    • ввод кода ЕГРПОУ
    • ввод адреса доставки (область, город, отделение, улица, дом, квартира и индекс)
  • автоматическое заполнение параметров отправления:
    • вес
    • габариты
    • возможностью задать несколько мест
    • объявленная стоимость с возможностью корректировки составляющих
    • описание
  • автоматическое заполнение параметров оплаты:
    • плательщик доставки
    • сумма обратной доставки, если выбран наложенный платеж
    • плательщик обратной доставки
    • способ получения денежного перевода
  • дополнительные параметры отправления:
    • заказное письмо
    • осмотр при вручении
    • СМС сообщение клиенту о прибытии отправления
    • действие в случае невручения
  • поля автоматически, по мере возможности, заполняются модулем согласно настроек
  • валидация полей во время редактирования и перед передачей данных на сервер почтовой компании
  • автоматическая проверка существования клиента в базе и создание в случае отрицательного результата
  • автоматическое редактирование данных клиента
  • автоматический поиск адресов получателя и создание новых в случае необходимости

При успешном создании или редактировании будет выполнена переадресация к накладной и ее подсветкой в общем списке.

Возможности для клиента
  • выбор типа доставки:
    • Укрпочта Экспресс. Доставка в отделение
    • Укрпочта Экспресс. Доставка курьером на адрес
    • Укрпочта Стандарт. Доставка в отделение
    • Укрпочта Стандарт. Доставка курьером на адрес
  • указание адреса доставки
  • выбор населенного пункта получения:
    • выпадающий список
    • поиск по названию города
  • выбор отделения:
    • выпадающий список
    • поиск по индексу
  • поиск индекса
  • информация о стоимости доставки
  • информация о сроке доставки
Поддерживаемые языки
  • украинский
  • русский
  • английский

В методах API реализована поддержка украинского языка и частично английского. Модуль автоматически использует нужный язык в зависимости от настроек OpenCart или предпочтений покупателя во время оформления заказа.

Совместимость

Возможно потребуется адаптация для конкретных версий. Адаптацию для других модулей и шаблонов выполним по запросу за ДОПОЛНИТЕЛЬНУЮ ПЛАТУ.

Лицензия
  • приобретая дополнение Вы получаете пожизненный доступ к бесплатным обновлениям и бесплатную техническую поддержку в течении года
  • лицензия действует только на один домен и на все его поддомены, и тестовые сайты
  • информация о порядке получения лицензии доступна после установки модуля
  • активация лицензии происходит в течении нескольких часов после покупки
Требования
  • ionCube Loader версии 5.0 и выше
  • PHP библиотека cURL
  • PHP версии 5.6 и выше

Инструкция (установка, настройка, обновление и удаление)

Установка
  1. Загрузить содержимое папки upload в корень сайта
  2. Перейти в раздел Дополнения → Установка дополнений и загрузить необходимый модификатор из папки modification. Перейти в раздел Дополнения → Менеджер дополнений и нажать кнопку «Обновить». Подробнее о модификаторах в разделе Настройка
  3. Зайти в админ-панель магазина и перейти в раздел Дополнения → Доставка и напротив модуля нажать кнопку «Установить»
  4. Перейти к редактированию настроек модуля и активировать лицензию
  5. На вкладке «Основные» в поле «eCom Bearer», «StatusTracking Bearer» и «User token» вставьте соответствующие значения, которые сгенерируют и предоставят Вам после подписания договора с «Укрпочтой»
  6. Откройте выпадающий список рядом с кнопкой сохранения настроек и загрузите базовые настройки
  7. Задайте необходимые настройки на всех вкладках
  8. Сохраните настройки нажав "Сохранить". Модуль готов к использованию
Настройка

Модуль совместим практически со всеми популярными модулями оформления заказов и шаблонами OpenCart благодаря соответствующим модификаторам. Для полноценной работы на странице оформления заказа должны выполняться минимальные требования для полей адреса доставки:

  • Область (zone_id) - стандартное поле OpenCart типа "select"
  • Город (city) - стандартное текстовое поле OpenCart
  • Адрес (address_1/address_2) - стандартное текстовое поле OpenCart для ввода адреса через запятую
  • Индекс (postcode) - стандартное текстовое поле Opencart

Если используемый модуль оформления заказов позволяет создавать пользовательские поля для адреса доставки, то возможно использовать для улицы, дома и квартиры отдельные поля

Описание модификаторов:
shippingdata_admin – обязательный модификатор необходимый для расширения функционала в админ-панеле.
shippingdata_ajax_quick_checkout – модификатор обеспечивает совместимость с модулем оформления заказов Ajax Quick Checkout. Дополнительная настройка не требуется. Возможно потребуется адаптация для конкретных версий.
shippingdata_default_checkout – модификатор обеспечивает совместимость со стандартной формой заказа. Дополнительная настройка не требуется. Модификатор заменяет поле "Компания" в адресе на checkbox с возможностью выбрать заранее доставку. Если checkbox отмечен, то в полях город и адрес подгружаются списки городов и отделений соответственно.
shippingdata_octemplates_smart_checkout – модификатор обеспечивает совместимость с модулем оформления заказов Smart Checkout шаблона Deals. Дополнительная настройка не требуется. Возможно потребуется адаптация для конкретных версий.
shippingdata_simple – модификатор обеспечивает совместимость с модулем оформления заказов и регистрации Simple. Есть два варианта настройки:
  1. Отображение города и отделения в виде простых текстовых полей с подгрузкой выпадающих списков. Чтобы настроить достаточно для полей city и address_1 в настройках модуля Simple включить перезагрузку и вывести соответствующие поля в блоке адрес доставки
  2. Отображение города и отделения в виде выпадающих списков select. Данный способ совместимости доступен для версий Simple в которых возможно настроить получение значений вызовом метода из catalog/model/tool/simpleapimain.php или catalog/model/tool/simpleapicustom.php.

    Настройка:

    • после установки модификатора shippingdata_simple зайдите в настройки модуля Simple и выберите раздел "Поля"
    • для поля выбора города установите следующие настройки:
      • тип – select
      • Список значений – Получать вызовом метода в API модуля (catalog/model/tool/simpleapimain.php) или (catalog/model/tool/simpleapicustom.php)
      • Название метода в API модуля – getShippingCities
      • Передавать в метод значение другого поля – Регион
    • для поля выбора отделения установите следующие настройки:
      • тип – select
      • Список значений – Получать вызовом метода в API модуля (catalog/model/tool/simpleapimain.php) или (catalog/model/tool/simpleapicustom.php)
      • Название метода в API модуля – getShippingDepartments
      • Передавать в метод значение другого поля – Город
    • все остальные настройки являются стандартными. Названия полей могут отличаться
    для полей также нужно включить перезагрузку блоков при изминении полей в настройках блока адреса доставки

shippingdata_simple_v_2.X.X / shippingdata_simple_v_3.X.X – модификатор обеспечивает совместимость с модулем оформления заказов Simple соответствующих версий. Для полей city и address_1 в настройках нужно включить перезагрузку. Возможно потребуется адаптация для конкретных версий.
Обновление
Обновление до v. 2.3.1:
  1. Загрузить, используя FTP-менеджер, содержимое папки upload в корень сайта с заменой
  2. Загрузить новые модификаторы предварительно удалив все старые (Shipping Data ...) и обновить кэш модификаторов (нажать «Обновить»). Подробнее о модификаторах в разделе Настройка
  3. Проверить корректность всех настроек и нажать кнопку «Сохранить»
Обновление с любой версии на последнюю:
  1. Зайти в админ-панель магазина
  2. Перейти к редактированию модуля и сделать экспорт настроек (выпадающее меню возле кнопки «Сохранить»)
  3. Перейти в раздел Дополнения → Доставка и напротив модуля нажмите кнопку «Удалить»
  4. Загрузить используя FTP менеджер содержимое папки upload в корень сайта с заменой
  5. Загрузить новые модификаторы предварительно удалив все старые (Shipping Data ...) и обновить кэш модификаторов (нажать «Обновить»). Подробнее о модификаторах в разделе Настройка
  6. Перейти в раздел Дополнения → Доставка и напротив модуля нажмите кнопку «Установить»
  7. Перейти к редактированию настроек модуля и на вкладке «Основные» в полях «eCom Bearer», «StatusTracking Bearer», «User token» вставьте ключи доступа к API Укрпочты
  8. После загрузки базы данных сделать импорт ранее сохраненных настроек (выпадающее меню возле кнопки «Сохранить»)
  9. Проверить корректность всех настроек и нажать кнопку «Сохранить»
Удаление
  1. Зайти в админ-панель магазина
  2. Перейти в раздел Дополнения → Менеджер дополнений и удалить установленные модификаторы модуля (отметить и нажать «Удалить»), после чего необходимо обновить кэш модификаторов (нажать «Обновить»)
  3. Перейти в раздел Дополнения → Доставка и напротив модуля нажать кнопку «Удалить» (произойдет удаление информации о модуле с базы)
  4. Удалить файлы модуля с сервера

Поддержка (вопросы/ответы, список изменений, контакты)

Вопросы/Ответы

Следуя инструкции, установите расширение на домен для которого хотите получить лицензию. Далее Вам необходимо зайти в настройки модуля, заполнить и отправить информацию о покупке. После проверки покупки модуль активируется автоматически и Вам на почту придет ключ активации.

Для тестовых сайтов и поддоменов ключ предоставляется бесплатно. Тестовы домены можно указать через запятую во время активации основного или наоборот

Обновите версию ionCube Loader

Установите/активируйте бесплатную библиотеку ionCube Loader на своем сервере/хостинге. Если, к примеру в php_info, будет отображаться информация о том что библиотека установлена, а ошибка не пропадет - значит Вы не правильно установили ionCube Loader

  • проверьте, загрузились ли все файлы модуля на сервер в корневую директорию Вашего интернет-магазина
  • проверьте, соответствуют ли параметры Вашего сервера требованиям модуля
  • проверьте логи ошибок сервера и OpenCart для уточнения конкретной ошибки

  • проверьте, нет ли ошибок в логах модификаторов
  • проверьте, установлен ли переключатель "Стоимость доставки" в положение "Да"
  • проверьте "Бесплатную доставку от", возможно сумма в вашей корзине больше или равна чем сумма для бесплатной доставки
  • проверьте вес товара в корзине. Если вес отсутствует в карточке товара, то можно задать значение по умолчанию в настройках модуля
  • проверьте настройки модуля, а также корректность данных получателя
  • иногда некоторые методы API почтовой компании не доступны, в таком случае можно включить тарифный расчет в настройках модуля для отображения примерной стоимости доставки или подождать восстановления работоспособности API

  • проверьте, нет ли ошибок в логах модификаторов
  • проверьте, установлен ли переключатель "Срок доставки" в положение "Да"
  • проверьте настройки модуля, а также корректность данных получателя
  • иногда некоторые методы API почтовой компании не доступны, в таком случае нужно подождать восстановления работоспособности API

    В папке extra есть дамп стран и областей recovery_zone_and_country_tables_ru.sql и recovery_zone_and_country_tables_ua.sql с правильными названиями для Украины, на русском и украинском языках соответственно. Загружать их необходимо через админ-панель магазина в разделе Система → Инструменты → Бэкап / Восстановление предварительно проверив префиксы таблиц, в файлах они oc_

Если при оформлении заказа был выбран совместимый способ доставки, то при просмотре списка заказов или конкретного заказа будет доступна кнопка для работы с накладной. Также при просмотре списка заказов будет кнопка для перехода к списку накладных.

Интеграция с накладными при просмотре списка заказов
Интеграция с накладными при просмотре списка заказов
Интеграция с накладными при просмотре конкретного заказа
Интеграция с накладными при просмотре конкретного заказа

Отслеживание в модуле осуществляется через соответствующие методы API интерфейса Укрпочты. Всё работает по принципу смены статусов. Для лучшего понимания рассмотрим работу и настройку на конкретном примере. Допустим нам необходимо отправлять уведомление клиенту с номером накладной когда заказ будет отправлен и завершить сделку установив соответствующий статус "Сделка завершена".
  1. Для начала необходимо настроить Cron используя команду в модуле. Команда Cron дана для примера и для разных хостингов может отличаться. Интервал отслеживания, к примеру, каждый час.
    Команда Cron для отслеживания
    Команда Cron для отслеживания
  2. Укажите статусы Вашего интернет-магазина которые будут отслеживаться. Модуль будет отслеживать заказы с теми статусами, которые Вы отметите и для которых будет создана накладная. Для нашего примера это "В обработке" и "Отправлено".
  3. Настройте соответствие между статусами Укрпочты и статусами Вашего интернет-магазина. Модуль сверяет текущий статус отправления с соответствующим ему статусом интернет-магазина, если статус заказа не совпадает - модуль меняет на новый. Для нашего примера модуль будет работать следующий образом:
    1. Выбирает все заказы у которых присутствует номер накладной и статус соответствует "В обработке" и "Отправлено"
    2. Отслеживает выбранные заказы по номеру накладной
    3. Если у конкретного заказа статус интернет-магазина "В обработке", а статус в системе Укрпочты стал "Відправлення", то модуль меняет статус в интернет-магазине на "Отправлено"
    4. Если у конкретного заказа статус интернет-магазина "Отправлено" или "В обработке", а статус в системе Укрпочты стал "Вручення", то модуль меняет статус в интернет-магазине на "Сделка завершена"
    Настройка статусов
    Настройка статусов
Список изменений
v. 2.3.1 от 13.07.2026:
  • актуализация методов АПИ
  • исправлены ошибки совместимости
  • другие исправления ошибок, мелкие правки и улучшения
v. 2.3.0 от 17.07.2024:
  • добавлена поддержка PHP 8.0, 8.1, 8.2
  • добавлена поддержка OpenCart 3.0.3.9
  • добавлена печать нескольких документов
  • добавлен тарифный расчет наложенного платежа
  • добавлен минимальный вес по умолчанию
  • добавлена минимальная объявленная стоимость по умолчанию
  • добавлена возможность вкл/выкл учета страховки в расчете стоимости доставки
  • добавлена поддержка макроса product_id для товара
  • добавлена всплывающая подсказка указанного города и отделения в форме ТТН
  • оптимизация загрузки настроек и формы ТТН
  • актуализация методов АПИ
  • справлены ошибки загрузки баз городов и отделений
  • исправлены ошибки заполнения формы ТТН
  • исправлена ошибка количества мест по умолчанию
  • исправлены ошибки совместимости
  • другие исправления ошибок, мелкие правки и улучшения
v. 2.2.0 от 21.11.2023:
  • добавлена настройка типа отделений
  • добавлена настройка статусов отделений
  • добавлен поиск индексов
  • обновлен тарифный расчет
  • оптимизирована работа со списком накладных
  • исправлены ошибки при создании и редактировании ТТН
  • исправлены ошибки совместимости
  • другие исправления ошибок, мелкие правки и улучшения
v. 2.1.0 от 09.04.2023:
  • добавлена поддержка бонусных отправлений
  • добавлен поиск населенных пунктов
  • добавлен поиск отделений
  • добавлена возможность настройки cURL таймаутов
  • добавлена поддержка PHP 7.4
  • доработан тарифный расчет
  • оптимизирована работа со списком накладных
  • оптимизирована работа с базой данных
  • актуализация методов АПИ
  • исправлены ошибки при создании и редактировании ТТН
  • исправлена ошибка сортировки способа доставка
  • исправлены ошибки совместимости
  • другие исправления ошибок, мелкие правки и улучшения
v. 2.0.0 от 02.01.2020:
  • добавлена поддержка OpenCart 3
  • добавлена работа с группами почтовых отправлений
  • добавлена печать формы 103а
  • добавлена печать адресных ярлыков для группы отправлений
  • добавлена опция заказного письма
  • добавлена настройка осмотра при вручении посылки
  • добавлена настройка действий в случае невручения посылки
  • добавлена возможность ручного создания/редактирования отправителя
  • добавлен поиск получателя и отправителя по номеру телефона
  • добавлена валидация API расчета стоимости доставки
  • добавлена поддержка номера расчетного счета в формате IBAN
  • добавлена поддержка мультимагазина при создании ТТН
  • добавлена поддержка макросов опций товара
  • добавлена поддержка более ранних версий cURL
  • добавлено кеширование для ряда API запросов
  • оптимизирован вывод списка накладных
  • полностью изменен функционал работы с клиентами
  • все API методы приведены в актуальное состояние
  • увеличены лимиты на выполнение cURL запросов
  • обновлен список статусов для трекинга отправлений
  • расширены настройки печати сопроводительных документов
  • исправлена ошибка парсера адреса получателя
  • исправлена ошибка определения наложенного платежа при создании накладной
  • исправлены ошибки режима отладки
  • исправлены ошибки операций с числами в PHP 7.1 и выше
  • исправлена ошибка сохранения настроек для мультимагазинов
  • исправлены ошибки валидации формы накладной
  • исправлены ошибки определения бесплатной доставки и мин./макс. корзины при различных настройках валюты
  • исправлены ошибки тарифного расчета
  • исправлены ошибки определения параметров посылки
  • исправлены различные ошибки при оформлении заказа
  • исправлены ошибки совместимости с разными сборками OpenCart
  • улучшена совместимость с рядом дополнений
  • другие исправления ошибок, мелкие правки и улучшения
v. 1.1.0 от 29.11.2018:
  • добавлен API расчет стоимости доставки
  • добавлено получение наложенного платежа на банковский счет
  • добавлено автоматическое редактирование данных клиента
  • добавлены поля клиентов (ИНН, банковский код, расчетный счет, e-mail)
  • добавлена поддержка OpenCart v 2.0.0.0-2.2.0.0
  • добавлена адаптация для OpenCart v 1.5.X.X
  • исправлен расчет параметров отправления
  • исправлена проверка StatusTracking Bearer
  • другие исправления ошибок, мелкие правки и улучшения
v. 1.0.0 от 14.10.2018:
  • первый релиз
Контакты