Цей модуль по праву вважається найкращим рішенням для організації доставки Новою поштою у вашому інтернет-магазині. Доповнення вирішує практично всі завдання, які виникають при роботі з Новою поштою і є відмінним помічником на будь-якому етапі роботи з замовленнями. Крім стандартних функцій модуля доставки є інструменти для роботи з Експрес Накладними. Також доступні дві функції калькулятора: розрахунок вартості і терміну доставки. Всі розрахунки відбуваються за допомогою API, що гарантує отримання найточніших даних.
Доповнення також має низку функцій, які за вас в автоматичному режимі виконують щоденну рутинну роботу: розсилка сповіщень з номером накладної, зміна статусів замовлення, нагадування про не забрані посилки і т.д.
Модуль не перезаписує і не видаляє стандартні файли і таблиці бази OpenCart. У роботі модуля використовується API «Нової пошти», що дозволяє завжди мати актуальну інформацію про міста, відділення, відправлення і т.д., а також взаємодіяти безпосередньо з Новою поштою використовуючи велику кількість готових рішень, які надає компанія. І це не всі можливості модуля, функціонал постійно розширюється і покращується. Придбаваючи модуль ви будете економити чимало часу і значні грошові кошти на обробці замовлень і розробці аналогічного функціоналу.
Доповнення є авторською розробкою і захищено відповідними правами
За посиланнями, наданими нижче, можна перейти на демонстраційний сайт. Для доступу в адмін-панель використовуйте наступні дані: логін і пароль - demo
налаштування cURL тайм-ауту підключення та виконання
налаштування доставки до відділень, на адресу та в поштомат:
увімкнення/вимкнення способу доставки
редагований та багатомовний заголовок доставки
вибір географічної зони
вибір податкового класу
можливість вказати мінімальну суму замовлення, при якій доставка буде доступною
можливість вказати максимальну суму замовлення, при якій доставка буде доступною
можливість вказати мінімальну суму замовлення, при якій доставка буде безкоштовною
редагований та багатомовний текст безкоштовної доставки
увімкнення/вимкнення розрахунку вартості доставки
увімкнення/вимкнення API розрахунку вартості доставки
увімкнення/вимкнення тарифного розрахунку вартості доставки
увімкнення/вимкнення розрахунку терміну доставки в днях
увімкнення/вимкнення фільтру відділень за вагою
увімкнення/вимкнення фільтру відділень за розмірами
вибір типу відділення
вибір статусу відділення
налаштування тарифного розрахунку
налаштування розрахунку накладеного платежу
робота з базою:
завантаження/оновлення довідників компанії "Нова пошта"
завантаження/оновлення областей України
завантаження/оновлення міст компанії "Нова пошта"
завантаження/оновлення відділень компанії "Нова пошта"
увімкнення/вимкнення онлайн-пошуку населених пунктів для адресної доставки
увімкнення/вимкнення онлайн-пошуку вулиць для адресної доставки
налаштування параметрів відправника: відправник, контактна особа, область, місто, відділення або адреса відправки
налаштування параметрів отримувача: отримувач, контактна особа, телефон, ЄДРПОУ, область, місто, відділення, адреса, вулиця, будинок, квартира, бажана дата та час доставки
налаштування параметрів відправлення:
увімкнення/вимкнення авто-визначення типу відправлення
вибір типу відправлення за замовчуванням
увімкнення/вимкнення врахування об'єму
вибір варіанту врахування об'єму відправлення
можливість вказати кількість місць за замовчуванням
вибір складників для оголошеної вартості відправлення
можливість вказати оголошену вартість за замовчуванням
можливість вказати мінімальну оголошену вартість
можливість вказати опис відправлення за замовчуванням з використанням макросів замовлення та товару
можливість вказати додаткову інформацію про відправлення за замовчуванням з використанням макросів замовлення та товару
увімкнення/вимкнення загальних параметрів
увімкнення/вимкнення ручної обробки
увімкнення/вимкнення авіадоставки
вибір способу застосування параметрів за замовчуванням
можливість вказати вагу за замовчуванням
можливість вказати мінімальну вагу
можливість вказати розміри за замовчуванням
можливість вказати допуски до розмірів відправлення
увімкнення/вимкнення врахування упаковки
вибір типу упаковки
увімкнення/вимкнення авто-визначення типу упаковки
налаштування параметрів оплати:
вибір платника доставки за замовчуванням
вибір третьої особи
вибір форми оплати за замовчуванням
вибір методу оплати для накладеного платежу
налаштування розрахунку накладеного платежу
налаштування врахування комісії за оголошену вартість
вибір оберненої доставки за замовчуванням
вибір платника зворотньої доставки за замовчуванням
вибір складових для контролю оплати
налаштування інтеграції ТТН:
увімкнення/вимкнення відображення всіх накладних акаунта
вибір інформації для відображення в списку накладних
налаштування друку
вибір сумісного способу доставки для створення накладних
увімкнення/вимкнення створення, редагування, видалення та присвоєння накладної в замовленні
можливість вказати багатомовні назви пунктів меню для роботи з накладними в замовленні
задачі Cron:
можливість вказати ключ безпеки виконання Cron команд
автоматичне оновлення бази даних модуля (області, міста, відділення, довідники)
автоматичне відстеження відправлень, зміна статусу замовлення та відправка повідомлень
вибір статусів замовлення, для яких необхідно відстеження
налаштування залежностей для кожного статусу відправлення та статусу замовлення в магазині
можливість вказати затримку виконання для кожного статусу відправлення
увімкнення/вимкнення повідомлень для адміністратора та покупця
можливість вказати багатомовний шаблон повідомлення для e-mail та sms повідомлень з використанням макросів замовлення, товару та накладної
та інші стандартні опції модуля доставки
Можливості для роботи з накладними
При перегляді замовлення у панелі адміністратора, якщо клієнт обрав сумісний спосіб доставки, з'являється кнопка для роботи з накладною. Можливо створити накладну на основі замовлення або призначити вже існуючу. Під час створення модуль максимально заповнює форму в автоматичному режимі. Якщо для переглянутого замовлення накладна вже створена, то буде доступний пункт редагування та видалення. Також під час перегляду замовлень можна перейти до списку всіх накладних. Доступні функціональності:
створення, редагування та видалення накладної
робота з реєстрами
налаштування друку накладних
завантаження накладних та маркувань у форматі PDF для одного або декількох замовлень
друк у браузері накладної та маркувань для одного або декількох замовлень
перегляд накладних за числами відправки з можливістю фільтрації за типом та номером
автоматичне заповнення інформації відправника відповідно до обраних налаштувань модуля з можливістю зміни даних безпосередньо перед створенням накладної
автоматичне заповнення параметрів одержувача відповідно до даних замовлення, в тому числі доступні наступні функції:
вибір типу доставки (відділення, адреса та поштомат)
пошук одержувачів
вибір області
пошук міста, населеного пункту
пошук відділення
пошук вулиці
введення номера будинку та квартири
автоматичне заповнення параметрів відправлення:
тип
загальна вага
загальний об'єм
загальна об'ємна вага
упаковка
кількість місць з можливістю вказати параметри кожного місця відправлення
оголошена вартість з можливістю коригування складових
опис
автоматичне заповнення параметрів оплати:
платник доставки
вибір третьої особи
форма оплати
зворотня доставка
сума зворотньої доставки, якщо обрано накладений платіж
платник зворотньої доставки
контроль оплати
додаткові параметри відправлення:
вибір дати відправлення
вибір бажаної дати доставки
вибір бажаного часу доставки
заповнення поля "Внутрішній номер замовлення клієнта"
введення номеру упаковки
заповнення поля додаткової інформації про відправлення
підйом на поверх
ліфт
авіадоставка
поля автоматично, по можливості, заповнюються або вибираються модулем відповідно до налаштувань
валідація полів під час редагування та перед передачею даних на сервер поштової компанії
автоматична перевірка наявності контактної особи в базі одержувачів, якщо не буде знайдено, то створюється нова
автоматична корекція контактної особи
автоматичний пошук адрес одержувача та створення нових в разі необхідності
підсвітка роздрукованих та видалених накладних у списку
При успішному створенні або редагуванні буде виконана переадресація до створеної накладної та її підсвіткою в загальному списку.
Можливості для клієнта
вибір типу доставки:
доставка в відділення
доставка кур'єром за адресою
доставка в поштомат
вибір міста отримання:
випадаючий список
пошук за назвою міста
вибір відділення або поштомата:
випадаючий список
пошук за назвою, адресою або номером відділення
вибір населеного пункту для кур'єрської доставки
вибір вулиці для кур'єрської доставки
введення додаткових даних для кур'єрської доставки
інформація про вартість доставки
інформація про термін доставки
Підтримувані мови
українська
англійська
російська
У деяких методах API "Нової пошти" заявлена підтримка української, англійської та російської мов. На практиці реалізована 100% підтримка лише української мови. Назви міст і відділень "Нової пошти" доступні українською та російською мовами. Модуль автоматично показує потрібний переклад залежно від налаштувань OpenCart або вподобань покупця під час оформлення замовлення.
Сумісність
OpenCart v. 1.5.Х.Х, 2.X.X.Х, 3.Х.Х.Х (а також збірки на базі OpenCart відповідних версій)
форми замовлення: One Page Checkout - Просте оформлення замовлення, OCTemplates Smart Checkout, Simple checkout & registration - максимальний функціонал. Стандартне оформлення замовлень, Ajax Quick Checkout - тільки вибір міста та відділення
модулі відправки повідомлень: стандартна відправка e-mail, SmsFly order
Можлива потреба в адаптації для конкретних версій. Адаптацію для інших модулів і шаблонів виконаємо за запитом за ДОДАТКОВУ ПЛАТУ.
Ліцензія
придбавши додаток, ви отримуєте пожиттєвий доступ до безкоштовних оновлень та безкоштовної технічної підтримки протягом року
ліцензія діє тільки на один домен і всі його піддомени, включаючи тестові сайти
інформація щодо отримання ліцензії доступна після встановлення модуля
активація ліцензії відбувається автоматично або вручну протягом години після покупки
Вимоги
ionCube Loader версії 5.0 і вище
PHP бібліотека cURL
PHP версії 5.6 і вище
Інструкція
(встановлення, налаштування, оновлення та видалення)
Встановлення
Перед встановленням на робочому інтернет-магазині рекомендуємо виконати встановлення та тестування модуля на тестовому сайті або піддомені!
Виконуйте всі дії поетапно, дотримуючись послідовності!
Щоб не витрачати час, свій та розробника, уважно прочитайте інструкцію. Якщо виникли проблеми під час встановлення модуля або в процесі використання - можете скористатися розділом Питання/Відповіді, можливо там вже є рішення вашої проблеми.
Завантажити вміст папки upload в корінь сайту, використовуючи FTP-менеджер.
Увійти в адмін-панель магазину та перейти в розділ Додатки → Доставка, і навпроти модуля натиснути кнопку «Встановити».
Перейти в розділ Додатки → Встановлення додатків і завантажити необхідний модифікатор з папки modification. Перейти в розділ Додатки → Менеджер додатків і натиснути кнопку «Оновити». Для версій 1.5.x.x завантажити необхідні модифікатори потрібно на сервер у папку vqmod/xml/. Детальніше про модифікатори в розділі Налаштування.
Перейти до редагування налаштувань модуля та активувати ліцензію.
Після відправки даних про покупку повинно з'явитися повідомлення про те, що дані були успішно відправлені!
Після активації ліцензії повинно з'явитися підтверджуюче повідомлення!
На вкладці «Основні» в поле «Ключ API» вставте ключ доступу до API "Нової пошти", який ви можете знайти в особистому кабінеті на сайті компанії "Нова пошта" (novaposhta.ua) в розділі Налаштування → Безпека → Мої ключі API.
Відкрийте випадаючий список поруч із кнопкою збереження налаштувань і завантажте базові налаштування.
Задайте необхідні налаштування на всіх вкладках.
Збережіть, натиснувши "Зберегти". Модуль готовий до використання.
Налаштування
Даний модуль дозволяє забезпечити гнучку сумісність майже з усіма модулями оформлення замовлень та шаблонами OpenCart завдяки відповідним модифікаторам. Підвантаження всіх адрес відбувається лише при обраному способі доставки. Для повноцінної роботи модуля на сторінці оформлення замовлення повинні виконуватися мінімальні вимоги до полів адреси доставки:
Місто (city) - звичайне текстове поле
Адреса/Відділення (address_1) - звичайне текстове поле
зміна поля місто повинна викликати оновлення способу доставки для відображення вартості та терміну доставки
Опис модифікаторів:
Встановлюйте лише необхідні модифікатори!
shippingdata_admin – обов'язковий модифікатор, необхідний для розширення функціоналу в адмін-панелі.
shippingdata_ajax_quick_checkout – модифікатор забезпечує сумісність з модулем оформлення замовлень Ajax Quick Checkout. Додаткові налаштування не потрібні. Можлива потреба в адаптації для конкретних версій.
shippingdata_default_checkout – модифікатор забезпечує сумісність зі стандартною формою замовлення. Додаткові налаштування не потрібні. Модифікатор замінює поле "Компанія" у адресі на checkbox з можливістю вибрати заздалегідь доставку. Якщо checkbox відмічений, то у полях місто та адреса підвантажуються списки міст і відділень відповідно.
shippingdata_octemplates_smart_checkout – модифікатор забезпечує сумісність з модулем оформлення замовлень Smart Checkout шаблону Deals. Додаткові налаштування не потрібні. Можлива потреба в адаптації для конкретних версій.
shippingdata_simple – модифікатор забезпечує сумісність з модулем оформлення замовлень та реєстрації Simple. Можливі два варіанти налаштування:
Відображення міста і відділення у вигляді звичайних текстових полів з підвантаженням випадаючих списків. Достатньо для полів city і address_1 у налаштуваннях модуля Simple увімкнути перезавантаження і вивести відповідні поля в блоку адреса доставки
Відображення міста і відділення у вигляді випадаючих списків 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
Передавати в метод значення іншого поля – Місто
для поля вибору поштоматів Нової пошти встановіть наступні налаштування:
тип – select
Список значень – Отримувати викликом метода в API модуля (catalog/model/tool/simpleapimain.php) або (catalog/model/tool/simpleapicustom.php)
Назва методу в API модуля – getShippingPoshtomats
Передавати в метод значення іншого поля – Місто
усі інші налаштування є стандартними. Назви полів можуть відрізнятися
для полів також потрібно увімкнути перезавантаження блоків при зміні полів у налаштуваннях блоку адреса доставки
shippingdata_simple_v_2.X.X / shippingdata_simple_v_3.X.X – модифікатор забезпечує сумісність з модулем оформлення замовлень Simple відповідних версій. Для полів city і address_1 у налаштуваннях потрібно увімкнути перезавантаження. Можлива потреба в адаптації для конкретних версій.
Оновлення
Перед оновленням зробіть резервне копіювання налаштувань та файлів модуля!
Список областей, міст, відділень та довідників оновлюється в будь-який зручний час і необхідну кількість разів через адмін-панель модуля.
Оновлення з версії 4.1.0 на 4.1.1:
Увійти в адмін-панель магазину
Перейти до редагування модуля і зробити експорт налаштувань (випадаюче меню біля кнопки «Зберегти»)
Перейти до розділу Доповнення → Доставка і навпроти модуля натиснути кнопку «Видалити»
Завантажити, використовуючи FTP-менеджер, вміст папки upload в корінь сайту з заміною
Завантажити нові модифікатори попередньо видаливши всі старі (Shipping Data ...) та оновити кеш модифікаторів (натиснути «Оновити»). Докладніше про модифікатори у розділі Налаштування
Перейти до розділу Доповнення → Доставка і навпроти модуля натиснути кнопку «Встановити»
Перейти до редагування налаштувань модуля і на вкладці «Основні» в поле «Ключ API» вставити ключ доступу до API Нової пошти
Після завантаження бази даних зробити імпорт раніше збережених налаштувань (випадаюче меню біля кнопки «Зберегти»)
Перевірити коректність усіх налаштувань і натиснути кнопку «Зберегти»
Оновлення з версії 4.0.2 на 4.1.0:
Завантажити, використовуючи FTP-менеджер, вміст папки upload в корінь сайту з заміною
Завантажити нові модифікатори попередньо видаливши всі старі (Shipping Data ...) та оновити кеш модифікаторів (натиснути «Оновити»). Докладніше про модифікатори у розділі Налаштування
Перевірити коректність усіх налаштувань і натиснути кнопку «Зберегти»
Оновлення з будь-якої версії на останню:
Увійти в адмін-панель магазину
Перейти до редагування модуля і зробити експорт налаштувань (випадаюче меню біля кнопки «Зберегти»)
Перейти до розділу Доповнення → Доставка і навпроти модуля натиснути кнопку «Видалити»
Завантажити, використовуючи FTP-менеджер, вміст папки upload в корінь сайту з заміною
Завантажити нові модифікатори попередньо видаливши всі старі (Shipping Data ...) та оновити кеш модифікаторів (натиснути «Оновити»). Докладніше про модифікатори у розділі Налаштування
Перейти до розділу Доповнення → Доставка і навпроти модуля натиснути кнопку «Встановити»
Перейти до редагування налаштувань модуля і на вкладці «Основні» в поле «Ключ API» вставити ключ доступу до API Нової пошти
Після завантаження бази даних зробити імпорт раніше збережених налаштувань (випадаюче меню біля кнопки «Зберегти»)
Перевірити коректність усіх налаштувань і натиснути кнопку «Зберегти»
Видалення
Увійти в адмін-панель магазину
Перейти до розділу Доповнення → Менеджер доповнень і видалити встановлені модифікатори модуля (відзначити і натиснути «Видалити»), після чого необхідно оновити кеш модифікаторів (натиснути «Оновити»)
Перейти до розділу Доповнення → Доставка і навпроти модуля натиснути кнопку «Видалити» (відбудеться видалення інформації про модуль з бази)
Видалити файли модуля з сервера, використовуючи FTP-менеджер
Підтримка
(питання/відповіді, список змін, контакти)
Питання/Відповіді
Слідуючи інструкції, встановіть розширення на домен, для якого хочете отримати ліцензію. Далі вам необхідно зайти в налаштування модуля, заповнити і відправити інформацію про покупку. Після перевірки покупки вам на пошту прийде ключ активації.
Для тестових сайтів і піддоменів ключ надається безкоштовно. Процедура отримання для тестового сайту така ж, як і при отриманні ключа для основного домену.
Перевірте правильність введення ключа API Нової пошти
Можливо, закінчився термін дії ключа API Нової пошти
Можливо, не вистачає ресурсів вашого сервера або увімкнені які-небудь обмеження
Є ймовірність того, що під час першої встановлення виникли помилки, в такому випадку таблиці в базі даних не створились. Рішення: натисніть "Видалити/Встановити" навпроти модуля Нової пошти
Потрібно зробити наступні дії (перед усіма маніпуляціями необхідно зробити бекап бази даних):
Видалити старий модуль через адмін-панель магазину, також за можливості необхідно видалити файли цього модуля з сервера
Встановити новий модуль відповідно до інструкції
Зайти в адмін-панель магазину і перейти до розділу Система → Інструменти → Бекап / Відновлення і завантажити файл recovery_zone_and_country_tables_ru.sql або recovery_zone_and_country_tables_ua.sql, попередньо обравши його в архіві модуля у папці extra і натиснути "Відновити" (зверніть увагу на префікс для таблиць в вашій базі, в наданому файлі префікс для таблиць стандартний - oc_)
Оновіть версію ionCube Loader.
Встановіть/активуйте безкоштовну бібліотеку ionCube Loader на своєму сервері/хостингу. Якщо, наприклад, в php_info відображається інформація про те, що бібліотека встановлена, а помилка не зникає - це означає, що ви не правильно встановили ionCube Loader.
перевірте, чи завантажилися всі файли модуля на сервер в кореневу директорію вашого інтернет-магазину
перевірте, чи відповідають параметри вашого сервера вимогам модуля
перевірте, чи немає помилок у логах модифікаторів
перевірте, чи встановлено перемикач "Вартість доставки" в положення "Так"
перевірте "Безкоштовну доставку від", можливо, сума в вашому кошику більше або дорівнює сумі для безкоштовної доставки
перевірте вагу товару в кошику. Якщо вага відсутня в картці товару, то можна задати значення за замовчуванням у налаштуваннях модуля
перевірте налаштування модуля, а також правильність міста отримувача
іноді деякі методи API поштової компанії недоступні, у такому випадку можна увімкнути тарифний розрахунок в налаштуваннях модуля для відображення приблизної вартості доставки або зачекати відновлення працездатності API
перевірте, чи немає помилок у логах модифікаторів
перевірте, чи встановлено перемикач "Тривалість доставки" в положення "Так"
перевірте налаштування модуля, а також правильність міста отримувача
іноді деякі методи API поштової компанії недоступні, у такому випадку потрібно зачекати відновлення працездатності API
В папці extra знаходяться дампи країн і областей recovery_zone_and_country_tables_ru.sql та recovery_zone_and_country_tables_ua.sql з правильними назвами для України, українською та російською мовами відповідно. Завантажувати їх потрібно через адмін-панель магазину в розділі Система → Інструменти → Резервне копіювання / Відновлення, перед цим перевіривши префікси таблиць, у файлах вони oc_
Якщо при оформленні замовлення був обраний сумісний спосіб доставки, то при перегляді списку замовлень або конкретного замовлення буде доступна кнопка для роботи з накладною. Також при перегляді списку замовлень буде кнопка для переходу до списку накладних.
Інтеграція з накладними при перегляді списку замовленьІнтеграція з накладними при перегляді конкретного замовлення
Відстеження в модулі здійснюється через відповідні методи API інтерфейсу Нової пошти. Все працює за принципом зміни статусів. Для кращого розуміння розглянемо роботу і налаштування на конкретному прикладі. Допустимо, нам необхідно відправляти сповіщення клієнту з номером накладної, коли замовлення буде відправлене, і завершити угоду, встановивши відповідний статус "Угода завершена".
Спочатку потрібно налаштувати Cron, використовуючи команду у модулі. Команда Cron наведена для прикладу і може відрізнятися для різних хостингів/серверів. Інтервал відстеження, наприклад, кожну годину.
Команда Cron для відстеження
Вкажіть статуси вашого інтернет-магазину, які будуть відстежуватися. Модуль буде відстежувати замовлення з тими статусами, які ви відзначите і для яких буде створена накладна. Для нашого прикладу це "У обробці" та "Відправлено".
Налаштуйте відповідність між статусами Нової пошти та статусами вашого інтернет-магазину. Модуль порівнює поточний статус відправлення з відповідним статусом інтернет-магазину, якщо статус замовлення не співпадає - модуль змінює його на новий. Для нашого прикладу модуль буде працювати так:
Обирає всі замовлення, у яких є номер накладної і статус відповідає "У обробці" і "Відправлено"
Відстежує обрані замовлення за номером накладної
Якщо у конкретного замовлення статус інтернет-магазину "У обробці", а статус в системі Нової пошти став "Відправлено", то модуль змінює статус в інтернет-магазині на "Відправлено"
Якщо у конкретного замовлення статус інтернет-магазину "Відправлено" або "У обробці", а статус в системі Нової пошти став "Отримано", то модуль змінює статус в інтернет-магазині на "Угода завершена"
Налаштування статусів
Список змін
v. 4.1.1 від 07.07.2026:
актуалізація методів АПІ
виправлені помилки сумісності
інші виправлення помилок, дрібні правки та поліпшення
v. 4.1.0 від 14.05.2023:
додана підтримка PHP 8.0, 8.1, 8.2
додана підтримка OpenCart 3.0.3.9
доданий фільтр за розмірами для відділень
додана можливість відправки з поштоматів
доданий фільтр за вагою для поштоматів
доданий фільтр за розмірами для поштоматів
доданий мінімальна вага за замовчуванням
додана мінімальна оголошена вартість за замовчуванням
додана підтримка макроса product_id для товару
додана спливаюча підказка вказаного міста та відділення в формі ТТН
оптимізація завантаження списків міст та відділень
оптимізація завантаження налаштувань та форми ТТН
актуалізація методів АПІ
виправлені помилки заповнення форми ТТН
виправлена помилка створення ТТН на документи
виправлена помилка кількості місць за замовчуванням
виправлені помилки відстеження
виправлені помилки сумісності
інші виправлення помилок, дрібні правки та поліпшення
v. 4.0.2 від 13.04.2023:
виправлено завантаження відділень
додана сумісність з новою версією Укрпошти
інші виправлення помилок
v. 4.0.1 від 14.02.2023:
доданий пошук відділень за номером у панелі адміністратора
покращений пошук міст, населених пунктів та вулиць у кошику
виправлено збереження значення в таблиці статусів відстеження для OpenCart 3
виправлені помилки в модифікаторах
інші виправлення помилок
v. 4.0.0 від 10.02.2023:
додана робота з реєстрами
доданий розрахунок післяплати
доданий онлайн пошук населених пунктів та вулиць для адресної доставки
додана можливість роботи з декількома місцями відправлень
додана ручна обробка в ТТН
додана авіадоставка в ТТН
доданий вибір упаковки в ТТН
додана можливість додавання юридичних осіб як одержувачів
доданий фільтр відділень за статусом роботи
додана можливість увімкнення/вимкнення обліку страховки у розрахунку вартості доставки
додана підтримка PHP 7.4
додана підтримка макросів в описі відправлення
оптимізована робота з базою даних
актуалізація друкарських форм
актуалізація методів АПІ
виправлені помилки сумісності
інші виправлення помилок, дрібні правки та поліпшення
v. 3.5.0 від 14.11.2020:
додана доставка в поштомат, як спосіб доставки
додана можливість налаштування cURL таймаутів
додана підтримка мультимагазинів при створенні ТТН
оптимізовано оновлення бази даних
оновлені та додані модифікатори
оновлено підрахунок підсумків
виправлена помилка сторінкової навігації в списку накладних
додано присвоєння назви міста при оформленні замовлення з сесії для сумісності з деякими доповненнями
продубльовані коди статусів доставки в назві
доопрацьований модифікатор інтеграції з замовленнями
створення та видалення таблиць додатка винесено в модель
виправлені помилки, пов'язані з невстановленими модулями оплати, доставки та модулями обліку в замовленні
виправлена помилка з вибором оплати за безготівкою при створенні ТТН
виправлена помилка з розрахунком параметрів відправлення при створенні ТТН
виправлена помилка з оголошеною вартістю за замовчуванням
виправлена помилка, якщо не задані тарифи
виправлений розрахунок вартості упаковки
виправлені деякі макроси при відстеженні
інші виправлення помилок, дрібні правки та поліпшення
v. 3.3.0 від 12.12.2017:
перероблено збереження налаштувань
перероблений тарифний розрахунок
додано експорт/імпорт налаштувань
додано завантаження базових налаштувань
перероблений інтерфейс адміністратора
виправлені помилки при редагуванні накладної
оптимізовані і приведені в актуальний стан бази даних
виправлені помилки при застосуванні ключа API
додана можливість вибору декількох способів оплати накладним платежем
додано автоматичне визначення протоколу https
додано нові макроси для замовлення, товарів і накладних
дороблена відправка e-mail повідомлень
перероблено конвертацію ваги і розмірів відправлення
додано облік ваги з опцій
виправлена помилка в модифікаторі для стандартної корзини
виправлені помилки при створенні накладної
додано текст безкоштовної доставки для кожного способу доставки (в відділення і кур'єром)
додана можливість використовувати додаткові поля (вулиця, будинок, квартира) для адресної доставки
додане автовизнаення типу відправлення (документ, посилка, вантаж) та можливість увімкнути/вимкнути цю опцію
додана можливість вибору способу розрахунку об'єму відправлення
додано розрахунок кількості місць відправлення
додана можливість задати кількість місць відправлення за замовчуванням
додана можливість задати оголошену вартість за замовчуванням
додано автозаповнення для опису відправлення в налаштуваннях
додана можливість задати допуски для розмірів відправлення (+\- см)
додано облік упаковки відправлення
додано вибір типу упаковки відправлення
додане автовизначення типу упаковки на основі параметрів відправлення (вага, розміри)
додана вкладка з налаштуваннями оплати (платник, форма оплати, метод оплати накладеним платежем, платник зворотної доставки, спосіб отримання грошового переказу, платіжна карта)
додана можливість вибору відображення всіх накладних аккаунту або тільки прив'язаних до замовлень
додана можливість вибору інформації для відображення в списку накладних
додана можливість вибору сумісного способу доставки для створення накладних
додана можливість задати довільний спосіб оплати, доставки або підсумковий модуль
додана можливість вибору пунктів меню та задання їх назв у взаємодії накладних з замовленнями
додано опціональний показ та застосування контролю оплати, третьої особи та безготівкової оплати (в залежності від налаштувань конкретного відправника)
додано поетапне відстеження відправлень, яке дозволить обробляти більше 100 ЕН
додана сумісність з модулем накопичувальних знижок "Клубна програма"
додана підтримка користувацьких полів Simple
додана підтримка звичайних випадаючих списків при оформленні замовлення в Simple
додана підтримка двох форматів номерів телефону (з 38 і без) при створенні ЕН
додана підтримка різних кодів української мови
виправлений тарифний розрахунок відповідно до останніх змін Нової пошти
перероблена повністю модель доставки
перероблено виведення термінів доставки з нормальними закінченнями
перероблено застосування параметрів за замовчуванням
перероблено відстеження відправлень відповідно до останніх змін Нової пошти
виправлений вибір налаштувань відправника для приватних осіб
виправлені помилки при виведенні списку накладних
виправлені помилки в кроні
змінені вимоги до версії PHP, тепер 5.3 і вище
покращення та доробки в адміністративному інтерфейсі
v. 2.0 від 23.04.2016:
додана підтримка OpenCart v 2.2.0.0
додано автоматичне відстеження відправлень
додано автоматичне оновлення областей, міст, відділень та довідників Нової пошти
додано запис номера та Ref експрес-накладних в замовлення
додано редагування експрес-накладних з модуля
додано видалення експрес-накладних з модуля
додано створення експрес-накладних з "чистого" аркуша
додано можливість задати багатомовну назву для способу доставки
додано вибір варіанту розрахунку вартості доставки (за API або тарифний) та незалежна робота цих способів
додано можливість задати тарифну таблицю для визначення вартості доставки
додано вибір різних варіантів типів відділень (раніше можна було вибрати тільки один)
додано можливість вказати шаблон із змінними замовлення та товарів для поля додаткового опису відправлення
додано вибір варіанту застосування параметрів за замовчуванням (до всього замовлення або до товарів, у яких не заповнені дані в картці)
додано можливість включення обліку об'єму відправлення для підрахунку об'ємної ваги
додано автоматичне конвертування об'єму
додано облік об'ємної ваги для попереднього розрахунку вартості доставки
додано облік даних відправника для попереднього розрахунку вартості доставки (персональна знижка та ін.)
додано зручний вивід помилок, які повертає Нова пошта при роботі з експрес-накладними
додано прив'язку експрес-накладних до замовлень магазину при перегляді списку накладних
додано облік купонів та сертифікатів
оптимізовано оновлення бази даних модуля (швидкість оновлення зросла у рази)
оптимізовані запити до API, що дозволило скоротити кількість запитів при роботі з накладними та прискорити роботу модуля
оптимізована структура модуля
виправлена робота з третіми особами
виправлений фільтр перегляду списку експрес-накладних
виправлена валідація форми ЕН
виправлені дрібні помилки при роботі з базою даних модуля
дороблено конвертацію валют
виправлені помилки при конвертації ваги
виправлена пагінація при перегляді всіх накладних
оптимізація скриптів модуля, включаючи js
покращення та доробки в адміністративному інтерфейсі
v. 1.3.0 від 25.02.2016:
змінені вимоги до Ioncube Loader, тепер необхідна версія 5 і вище. Зміни з метою забезпечення сумісності з останніми версіями PHP
додана сумісність з модулем "Накладений платіж +"
виправлені помилки при валідації контактної особи одержувача
виправлені помилки в запитах при виборі деяких адрес
доробки по ядру модуля
v. 1.2.0 від 19.02.2016:
повністю перероблено front-end модуля, що дозволило додати новий функціонал і стабільність роботи
додані функції пошуку для полів міста та відділення при оформленні замовлень
виправлено сортування міст і відділень
додана підтримка IE при виборі адреси доставки
змінено принцип взаємодії з регіонами OpenCart, тепер модуль сам підлаштовується до вже існуючих регіонів і не вносить змін в таблицю zone
додана підтримка модуля оплати накладеним платежом при створенні Експрес Накладної
додана автоматична конвертація ваги товарів
додано фільтр відділень за вагою
додано вибір типу відділень
додана підтримка роботи з юридичними особами при створенні Експрес Накладної
додана можливість вказати третю особу як платника при створенні Експрес Накладної
додано контроль оплати при створенні Експрес Накладної
додана можливість задати параметри кожного місця відправлення
додана можливість змінювати відправника безпосередньо у формі створення ЕН
видалені помилки при встановленні модуля
видалені помилки при перегляді замовлення
виправлена валідація ПІБ (ё, -)
виправлена валідація адреси доставки, якщо мова адмінки і замовлення не співпадають
виправлені методи розрахунку загальної ваги та об'єму при створенні ЕН
виправлена помилка при створенні ТТН з відправкою документа в поштомат
додана сумісність з деякими сторонніми модулями
оптимізація коду (php, js) і запитів до API Нової пошти
виправлення помилок і поліпшення в інтерфейсі модуля
+ багато малих доробок
v. 1.1.0 від 09.11.2015:
додано створення експрес-накладних при відправці в поштомат
додано створення експрес-накладних з типом вантажу "Документи"
додано поле внутрішнього замовлення клієнта при створенні ЕН
додано поле додаткового опису відправлення при створенні ЕН
довідники перенесені з кешу в окрему таблицю модуля
виправлена помилка при створенні одержувача, якщо були зайві пробіли
додано опис відправлення за замовчуванням
додано перехід до списку створеної експрес-накладної і її підсвічування
додано автоматичний вибір платника відправника при створенні ТТН у разі якщо доставка безкоштовна
додано тарифний розрахунок (тариф для посилок) у разі недоступності API
оптимізація моделі front-end`а доставки
видалені знайдені помилки при запитах до API
виправлена безкоштовна доставка від суми замовлення
виправлені валютні корекції використовувані в модулі
зміни в інтерфейсі модуля
інші доробки і виправлення для усунення помилок та покращення зручності модуля. Всього виконано більше 20 пунктів
v. 1.0.0 від 24.10.2015:
модуль на 90% переписаний
оптимізований код
додано кешування деяких даних
додана підтримка OpenCart 2.1.0.1
доданий функціонал для роботи з Експрес Накладними
формат обміну даними через API змінено з xml на json
додано завантаження довідкникової інформації "Нової пошти"
додано відображення інформації про існуючу та додану кількість на вкладці "База даних"
додана підтримка багатовалютного відображення вартості доставки
при 0 значенні вартості доставки видалено відображення 0.00 грн
виправлена помилка з "Безкоштовною доставкою від", коли доставка була завжди безкоштовною, якщо не вказати значення для цього налаштування
якщо вага товару не вказана у картці та в налаштуваннях модулю, то вартість доставки не розраховується (як наслідок видалено кілька помилок)
виправлено візуальне підвисання при неробочому оновленні інформації на вкладці "База даних"
виправлена помилка з вибором деяких відділень
додано запис у логи помилок, повернених методами API "Нової пошти"
виправлена помилка з відключенням областей одразу після встановлення модулю
внесено зміни в модифікатори
модифікатор для Short Checkout вилучено на доопрацювання
виправлені помилки при відправці даних про покупку
візуальні покращення адмін-панелі модулю
і багато інших виправлень і доопрацювань, які забезпечують більш стабільну роботу модулю
v. 0.2.5 від 20.08.2015:
виправлена помилка при виборі поштоматів Нової пошти
додана підтримка модулю оформлення замовлень Journal 2 Quick Checkout
додана підтримка модулю оформлення замовлень Short Checkout
трохи удосконалено модифікатори сумісності з модулями оформлення замовлень
додано англійську мову (поки швидкий машинний переклад)
додано дамп відновлення стандартних даних для таблиць country and zone
додана нова, зручна і зрозуміла документація по модулю
v. 0.2.0 від 21.07.2015:
доданий хак, що дозволяє забезпечити сумісність з різними модулями оформлення замовлень
додана підтримка модулю оформлення замовлень Ajax Quick Checkout
додана підтримка ранніх версій модулю оформлення замовлень Simple checkout & Registration
доданий timeout на випадок недоступності серверів Нової пошти
знижені вимоги для Ioncube Loader
виправлені всі заявлені/знайдені помилки
v. 0.1.3 від 30.06.2015:
додана можливість встановлювати мінімальну суму покупок, при якій доставка буде безкоштовною
внесено зміни в модифікатор стандартної форми оформлення замовлення
додана кнопка "Зберегти і залишитися" для спрощення первинної налаштування модулю і подальшого редагування
This module is rightly considered the best solution for organizing Nova poshta delivery in your online store. The addition solves almost all tasks that arise when working with Nova poshta and is an excellent assistant at any stage of order processing. In addition to standard delivery module functions, there are tools for working with Express Waybills. Two calculator functions are also available: cost calculation and delivery time calculation. All calculations are made using the API, ensuring the most accurate data.
The addition also has a number of functions that automatically perform daily routine tasks for you: notification sending with the waybill number, order status change, reminders about uncollected parcels, etc.
Module does not overwrite or delete OpenCart standard files and database tables. The module uses the Nova poshta API, which allows you to always have up-to-date information about cities, departments, shipments, etc., as well as interact directly with Nova poshta using many ready-made solutions provided by the company. And these are not all the capabilities of the module; the functionality is constantly expanding and improving. By purchasing the module, you will save a lot of time and significant money on order processing and the development of similar functionality.
The addition is an author's development and is protected by the relevant rights
The links provided below can be used to visit the demo site. To access the admin panel, use the following data: login and password - demo
setting delivery to department, address, and postal locker:
enable/disable delivery method
editable and multilingual delivery name
selecting a geographical zone
selecting a tax class
ability to set a minimum order amount for which delivery will be available
ability to set a maximum order amount for which delivery will be available
ability to set a minimum order amount for which delivery will be free
editable and multilingual free delivery text
enable/disable delivery cost calculation
enable/disable API delivery cost calculation
enable/disable tariff delivery cost calculation
enable/disable delivery time calculation in days
enable/disable weight-based department filter
enable/disable dimension-based department filter
selecting department type
selecting department status
setting tariff calculation
setting cash on delivery calculation
working with the database:
loading/updating Nova poshta company directories
loading/updating Ukraine regions
loading/updating Nova poshta company cities
loading/updating Nova poshta company departments
enable/disable online settlement search for address delivery
enable/disable online street search for address delivery
setting sender parameters: sender, contact person, region, city, department, or shipping address
setting recipient parameters: recipient, contact person, phone, EDRPOU, region, city, department, address, street, house, apartment, desired delivery date and time
setting shipment parameters:
enable/disable auto-determination of shipment type
selecting default shipment type
enable/disable volume accounting
selecting the volume accounting option
ability to set the default number of seats
selecting components for the declared shipment value
ability to set the default declared value
ability to set the minimum declared value
ability to set the default shipment description using order and product macros
ability to set additional shipment information using order and product macros
enable/disable general parameters
enable/disable manual processing
enable/disable air delivery
selecting how default parameters are applied
ability to set the default weight
ability to set the minimum weight
ability to set default dimensions
ability to set size tolerances for the shipment
enable/disable packaging accounting
selecting packaging type
enable/disable auto-determination of packaging type
setting payment parameters:
selecting the default payer for delivery
selecting a third party
selecting the default payment form
selecting the payment method for cash on delivery
setting cash on delivery calculation
setting commission accounting for the declared value
selecting default reverse delivery
selecting the default reverse delivery payer
selecting components for payment control
setting TTN integration:
enable/disable display of all account waybills
selecting displayed information in the waybill list
setting printing
selecting a compatible delivery method for creating waybills
enable/disable creating, editing, deleting, and assigning waybills to the order
ability to set multilingual menu items for working with waybills in the order
Cron jobs:
ability to set a security key for Cron commands
automatic update of the module database (regions, cities, departments, directories)
automatic tracking of shipments, order status change, and notification sending
selecting order statuses for tracking
setting dependencies for each shipment status and store order status
ability to set execution delay for each shipment status
enable/disable notifications for the administrator and the customer
ability to set a multilingual message template for e-mail and SMS notifications using order, product, and waybill macros
and other standard delivery module options
Waybill capabilities
When viewing an order in the admin panel, if the client has selected a compatible delivery method, a button for working with the waybill appears. It is possible to create a waybill based on the order or assign an existing one. When switching to creation, the module maximally auto-fills the form. If a waybill is already created for the viewed order, the editing and deleting items will be available. Also, when viewing orders, you can go to the list of all waybills. Available functionalities:
creating, editing, and deleting waybills
working with registries
setting up waybill printing
downloading waybill and labels in PDF format for one or multiple orders
printing waybill and labels in the browser for one or multiple orders
viewing waybills by departure dates with the possibility of filtering by type and number
automatic sender information completion according to module settings with the possibility to change data directly before creating the waybill
automatic recipient parameter completion according to order data, including the following functions:
selecting delivery type (department, address, and postal locker)
searching for recipients
selecting a region
searching for a city, settlement
searching for a department
searching for a street
entering house and apartment numbers
automatic shipment parameter completion:
type
total weight
total volume
total volumetric weight
packaging
number of seats with the possibility to specify parameters for each shipment place
declared value with the possibility to adjust components
description
automatic payment parameter completion:
delivery payer
selecting a third party
payment form
reverse delivery
reverse delivery amount if cash on delivery is selected
reverse delivery payer
payment control
additional shipment parameters:
selecting the shipping date
selecting the desired delivery date
selecting the desired delivery time
filling in the "Internal Customer Order Number" field
entering the packaging number
filling in the additional shipment information field
floor delivery
elevator
air delivery
fields are automatically filled in or selected by the module settings
field validation during editing and before sending data to the postal company's server
automatic contact person existence check in the recipient database, if not found, a new one is created
automatic contact person adjustment
automatic recipient address search and new address creation if necessary
highlighting printed and deleted waybills in the list
Upon successful creation or editing, you will be redirected to the created waybill, highlighted in the general list.
Client capabilities
selecting the delivery type:
delivery to the department
courier delivery to the address
delivery to the postal locker
selecting the receiving city:
drop-down list
search by city name
selecting a department or postal locker:
drop-down list
search by department name, address, or number
selecting a settlement for courier delivery
selecting a street for courier delivery
entering additional data for courier delivery
delivery cost information
delivery time information
Supported Languages
Ukrainian
English
Russian
In some methods of the Nova poshta API, support for Ukrainian, English, and Russian languages is declared. In practice, only 100% support for the Ukrainian language is implemented. The names of cities and Nova poshta departments are available in Ukrainian and Russian. The module automatically displays the necessary translation depending on OpenCart settings or the buyer's preferences during order placement.
Compatibility
OpenCart v. 1.5.x.x, 2.x.x.x, 3.x.x.x (as well as OpenCart-based builds of corresponding versions)
order forms: One Page Checkout - Simple Order Form, Simple checkout & registration, OCTemplates Smart Checkout - maximum functionality. Standard order processing, Ajax Quick Checkout - only city and department selection
message sending modules: standard email sending, SmsFly order
Adaptation for specific versions may be required. Adaptation for other modules and templates will be performed upon request for an ADDITIONAL FEE.
License
by purchasing the addition, 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 a license is available after installing the module
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
Instruction
(installation, configuration, update, and removal)
Installation
Before installing on a working online store, we recommend installing and testing the module on a test site or subdomain!
Perform all actions step by step, following the sequence!
To save time, yours and the developer's, carefully read the instructions. If you encounter problems during the module installation or usage process - you can use the FAQ section, maybe there is already a solution to your problem.
Upload the contents of the upload folder to the root of the site using an FTP manager.
Go to the store's admin panel and navigate to the Extensions → Shipping section, and click the "Install" button next to the module.
Navigate to the Extensions → Extension Installer section and upload the necessary modifier from the modification folder. Navigate to the Extensions → Modification Manager section and click the "Refresh" button. For versions 1.5.x.x, the necessary modifiers need to be uploaded to the vqmod/xml/ folder on the server. More about modifiers in the Configuration section.
Navigate to the module settings editing and activate the license.
After sending the purchase data, a message should appear stating that the data was successfully sent!
After license activation, a confirmation message should appear!
On the "General" tab, in the "API Key" field, insert the access key to the Nova poshta API, which you can find in your personal account on the Nova poshta company website (novaposhta.ua) in the Settings → Security → My API Keys section.
Open the drop-down list next to the settings save button and load the basic settings.
Set the necessary settings on all tabs.
Save by clicking "Save". The module is ready to use.
Configuration
This module provides flexible compatibility with almost all order forms and OpenCart templates thanks to the corresponding modifiers. All addresses are loaded only when the delivery method is selected. For the full functionality of the module on the order page, the minimum requirements for address fields must be met:
City (city) - regular text field
Address/Nova poshta department (address_1) - regular text field
city field change should trigger delivery method update to display cost and delivery time
Modifier descriptions:
Install only the necessary modifiers!
shippingdata_admin - required modifier necessary to extend functionality in the admin panel.
shippingdata_ajax_quick_checkout - the modifier ensures compatibility with the Ajax Quick Checkout order form module. No additional configuration is required. Adaptation for specific versions may be needed.
shippingdata_default_checkout - the modifier ensures compatibility with the standard order form. No additional configuration is required. The modifier replaces the "Company" field in the address with a checkbox allowing pre-selection of delivery. If the checkbox is checked, city and address fields load city and department lists, respectively.
shippingdata_octemplates_smart_checkout - the modifier ensures compatibility with the Smart Checkout order form module of the Deals template. No additional configuration is required. Adaptation for specific versions may be needed.
shippingdata_simple - the modifier ensures compatibility with the Simple order form and registration module. There are two configuration options:
Displaying city and department as simple text fields with drop-down lists loading. To configure, for the city and address_1 fields in the Simple module settings, enable reload and display the corresponding fields in the delivery address block
Displaying city and department as drop-down lists select. This compatibility option is available for Simple versions where it is possible to configure value retrieval by calling a method from catalog/model/tool/simpleapimain.php or catalog/model/tool/simpleapicustom.php.
Configuration:
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)
Method name in the module API - getShippingCities
Pass the value of another field to the method - Region
for the department 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)
Method name in the module API - getShippingDepartments
Pass the value of another field to the method - City
for the Nova poshta postal locker 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)
Method name in the module API - getShippingPoshtomats
Pass the value of another field to the method - City
all other settings are standard. Field names may vary
for the fields, you also need to enable block reloads 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 order form module of the corresponding versions. For city and address_1 fields, enable reload in the settings. Adaptation for specific versions may be needed.
Update
Before updating, make a backup of the module settings and files!
The list of regions, cities, departments, and directories is updated at any convenient time and any number of times through the module's admin panel
Updating from version 4.1.0 to 4.1.1:
Go to the store's admin panel
Navigate to the module editing and export the settings (drop-down menu next to the "Save" button)
Navigate to the Extensions → Shipping section and click the "Uninstall" button next to the module
Upload the contents of the upload folder to the root of the site using an FTP manager, replacing the existing files
Upload new modifiers first deleting all old ones (Shipping Data ...) and refresh the modifier cache (click "Refresh"). More about modifiers in the Configuration section
Navigate to the Extensions → Shipping section and click the "Install" button next to the module
Navigate to the module settings editing and on the "General" tab, in the "API Key" field, insert the access key to the Nova poshta API
After loading the database, import the previously saved settings (drop-down menu next to the "Save" button)
Check the correctness of all settings and click the "Save" button
Updating from version 4.0.2 to 4.1.0:
Upload the contents of the upload folder to the root of the site using an FTP manager, replacing the existing files
Upload new modifiers first deleting all old ones (Shipping Data ...) and refresh the modifier cache (click "Refresh"). More about modifiers in the Configuration section
Check the correctness of all settings and click the "Save" button
Updating from any version to the latest:
Go to the store's admin panel
Navigate to the module editing and export the settings (drop-down menu next to the "Save" button)
Navigate to the Extensions → Shipping section and click the "Uninstall" button next to the module
Upload the contents of the upload folder to the root of the site using an FTP manager, replacing the existing files
Upload new modifiers first deleting all old ones (Shipping Data ...) and refresh the modifier cache (click "Refresh"). More about modifiers in the Configuration section
Navigate to the Extensions → Shipping section and click the "Install" button next to the module
Navigate to the module settings editing and on the "General" tab, in the "API Key" field, insert the access key to the Nova poshta API
After loading the database, import the previously saved settings (drop-down menu next to the "Save" button)
Check the correctness of all settings and click the "Save" button
Removal
Go to the store's admin panel
Navigate to the Extensions → Modification Manager section and delete the installed module modifiers (check and click "Delete"), then refresh the modifier cache (click "Refresh")
Navigate to the Extensions → Shipping section and click the "Uninstall" button next to the module (module information will be deleted from the database)
Delete the module files from the server using an FTP manager
Support
(FAQ, changelog, contacts)
FAQ
Follow the instructions to install the extension on the domain for which you want to get a license. Then you need to go to the module settings, fill in and send the purchase information. After purchase verification, an activation key will be sent to your email.
For test sites and subdomains, the key is provided for free. The procedure for obtaining a test site key is the same as for obtaining a key for the main domain.
Check the correctness of the Nova poshta API key entry
The validity period of the Nova poshta API key may have expired
Your server resources may be insufficient or some restrictions may be enabled
There is a possibility that you encountered errors during the first installation, in which case database tables were not created. Solution: click Delete/Install next to the Nova poshta module
You need to do the following (make a backup of the database before all manipulations):
Delete the old module through the store admin panel, also if possible, delete the files of this module from the server
Install the new module according to the instructions
Go to the store's admin panel and navigate to the System → Tools → Backup / Restore section and upload the recovery_zone_and_country_tables_ru.sql or recovery_zone_and_country_tables_ua.sql file, first selecting it in the module archive in the extra folder and clicking "Restore" (note the table prefix in your database, the provided file has the standard prefix - oc_)
Update the ionCube Loader version.
Install/activate the free ionCube Loader library on your server/hosting. If, for example, php_info shows information that the library is installed, but the error does not disappear - it means you incorrectly installed ionCube Loader.
Check if all module files were uploaded to the server to the root directory of your online store
Check if your server parameters meet the module requirements
Check if there are any errors in the modifier logs
Check if the "Delivery Cost" switch is set to "Yes"
Check "Free Delivery from", maybe the amount in your cart is greater than or equal to the amount for free delivery
Check the weight of the product 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 city
Sometimes some postal company API methods are unavailable, in such cases you can enable tariff calculation in the module settings to display approximate delivery cost or wait for the API to be restored
Check if there are any errors in the modifier logs
Check if the "Delivery Time" switch is set to "Yes"
Check the module settings and the correctness of the recipient city
Sometimes some postal company API methods are unavailable, in such cases 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 the correct names for Ukraine, in Ukrainian and Russian languages respectively. They should be uploaded through the store's admin panel in the System → Tools → Backup / Restore section after checking the table prefixes, in the provided files they are oc_
If a compatible delivery method was selected when placing an order, 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 listIntegration with waybills when viewing a specific order
Tracking in the module is carried out through the corresponding API methods of Nova poshta. Everything works on the principle of status changes. For better understanding, let's consider the operation and setup with a specific example. Suppose we need to send a notification to the client with the waybill number when the order is sent and complete the deal by setting the corresponding status "Deal completed".
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/servers. Tracking interval, for example, every hour.
Cron command for tracking
Specify the statuses of your online store that will be tracked. The module will track orders with the statuses you mark and for which a waybill will be created. For our example, this is "Processing" and "Sent".
Set up the correspondence between the statuses of Nova poshta and the statuses of your online store. The module compares the current shipment status 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:
Selects all orders that have a waybill number and status "Processing" and "Sent"
Tracks selected orders by waybill number
If a specific order has the store status "Processing", and the status in the Nova poshta system becomes "Sent", the module changes the store status to "Sent"
If a specific order has the store status "Sent" or "Processing", and the status in the Nova poshta system becomes "Received", the module changes the store status to "Deal completed"
Status settings
Changelog
v. 4.1.1 from 07.07.2026:
Updated API methods
Fixed compatibility errors
Other bug fixes, minor tweaks, and improvements
v. 4.1.0 from 13.05.2023:
Added support for PHP 8.0, 8.1, 8.2
Added support for OpenCart 3.0.3.9
Added dimension filter for departments
Added the ability to send from postomats
Added weight filter for postomats
Added dimension filter for postomats
Added default minimum weight
Added default minimum declared value
Added support for product_id macro for the product
Added tooltip for the specified city and department in the TTN form
Optimized loading of city and department lists
Optimized loading of settings and TTN form
Updated API methods
Fixed errors in the TTN form
Fixed error in creating TTN for documents
Fixed error in default number of places
Fixed tracking errors
Fixed compatibility errors
Other bug fixes, minor tweaks, and improvements
v. 4.0.2 from 13.04.2023:
Fixed department loading
Added compatibility with the new version of Ukrposhta
Other bug fixes
v. 4.0.1 from 14.02.2023:
Added department search by number in the admin panel
Improved search for cities, settlements, and streets in the cart
Fixed saving values in the tracking status table for OpenCart 3
Fixed modifier errors
Other bug fixes
v. 4.0.0 from 10.02.2023:
Added work with registries
Added calculation of cash on delivery
Added online search for settlements and streets for address delivery
Added the ability to work with multiple shipment places
Added manual processing in TTN
Added air delivery in TTN
Added packaging selection in TTN
Added the ability to add legal entities as recipients
Added department filter by work status
Added the ability to enable/disable insurance accounting in delivery cost calculation
Added support for PHP 7.4
Added support for macros in the shipment description
Optimized database operations
Updated printed forms
Updated API methods
Fixed compatibility errors
Other bug fixes, minor tweaks, and improvements
v. 3.5.0 from 14.11.2020:
Added delivery to postomats as a delivery method
Added the ability to configure cURL timeouts
Added multistore support when creating TTN
Optimized database updates
Updated and added modifiers
Updated summary calculation
Fixed pagination error in the waybill list
Fixed city loading without names
Fixed department selection errors
Fixed free delivery calculation error
Fixed directory errors
Fixed compatibility errors
Other bug fixes, minor tweaks, and improvements
v. 3.4.1 from 27.07.2019:
Added the ability to print "Zebra" 100x100 labels
Added zone_id macro
Increased limits for cURL requests
Improved compatibility with various extensions
Fixed errors when updating cities and departments
Fixed tariff calculation errors for delivery cost
Fixed volume validation when creating TTN
Other bug fixes, minor tweaks, and improvements
v. 3.4.0 from 09.04.2019:
Added multistore support
Added automatic recipient change when changing the API key
Added support for the redBOX service
Added auto-completion of the payment control field
Added delivery to the floor and elevator option
Added product options macro
Added waybill filter by number
Added the ability to link third-party waybills to orders
Added the ability to link own waybills without time limits
Added status code to the description in the waybill list
Added multilingual search for cities and departments in the cart
Added delivery time calculation for tariff calculation
Updated tracking status list
Updated all API requests
Updated database structure
Redesigned waybill creation and editing
Redesigned database updates
Redesigned tariff calculation
Redesigned shipment parameter calculation
Redesigned tracking delay execution
Refined all modifiers
Fixed error with patronymic when creating TTN for address
Fixed error in determining street type when creating TTN for address
Fixed cashless payment error
Fixed TTN form validation errors
Fixed delivery method header error when they are not available
Fixed numeric operation errors in PHP 7.1 and above
Fixed several errors in the OpenCart 3 version
Fixed several errors in the OpenCart 1.5 version
Fixed shipment tracking errors
Other bug fixes, minor tweaks, and improvements
v. 3.3.1 from 04.07.2018:
Added compatibility with OpenCart 3
Added printing settings
Added support for the SMS sending module "OCHELP - SMS notifications for admin, client"
Added log for tracking shipments
Added cURL error log
Added setting minimum shipment parameters
Added city name assignment when placing an order from the session for compatibility with some extensions
Duplicated delivery status codes in the title
Refined order integration modifier
Moved addition table creation and deletion to the model
Fixed errors related to uninstalled payment, delivery, and accounting modules in the order
Fixed error with selecting cashless payment when creating TTN
Fixed shipment parameter calculation error when creating TTN
Fixed default declared value error
Fixed error if tariffs are not set
Fixed packaging cost calculation
Fixed some macros when tracking
Other bug fixes, minor tweaks, and improvements
v. 3.3.0 from 12.12.2017:
Redesigned settings saving
Redesigned tariff calculation
Added settings export/import
Added basic settings loading
Redesigned admin interface
Fixed errors when editing waybill
Optimized and updated database
Fixed errors when applying API key
Added the ability to select multiple payment methods for cash on delivery
Added automatic https protocol detection
Added new macros for order, products, and waybills
Refined e-mail notification sending
Redesigned weight and dimension conversion
Added weight accounting from options
Fixed error in standard cart modifier
Fixed errors when creating waybill
Added free delivery text for each delivery method (to department and by courier)
Added the ability to use additional fields (street, house, apartment) for address delivery
Added auto-determination of shipment type (document, package, cargo) and the ability to enable/disable this option
Added the ability to select shipment volume calculation method
Added calculation of shipment places quantity
Added the ability to set default shipment places quantity
Added the ability to set default declared value
Added auto-completion for shipment description in settings
Added the ability to set size tolerances for shipment (+\- cm)
Added packaging accounting
Added selection of shipment packaging type
Added auto-determination of packaging type based on shipment parameters (weight, dimensions)
Added payment settings tab (payer, payment form, cash on delivery payment method, reverse delivery payer, money transfer method, payment card)
Added the ability to display all account waybills or only linked to orders
Added the ability to select displayed information in the waybill list
Added the ability to select compatible delivery method for creating waybills
Added the ability to set arbitrary payment method, delivery, or final module
Added the ability to select menu items and set their names when integrating waybills in orders
Added cron command copy buttons
Added manual shipment tracking button
Added execution delay for order status changes
Added option to enable/disable standard customer notification about order status change
Added multilingual message templates
Added separate template for SMS notifications
Added visual editor for e-mail notifications
Redesigned waybill integration with orders
Added waybill linking to the order
Added waybill deletion from the order
Added auto-address search for sender
Redesigned recipient address type determination
Redesigned waybill creation for address
Redesigned recipient settlement and street search
Added cash on delivery receipt method selection when creating waybill
Added payment card selection when creating waybill
Added the ability to specify packaging number when creating waybill
Added selection of allowable weight when creating waybill for document shipment
Fixed error in creating legal entity recipients
Fixed error in creating waybills for packages with delivery to postomats
Added filter for unclaimed and reverse delivery waybills in the list
Added highlighting of printed and deleted waybills in the list
Redesigned waybill and label printing
Added multilingual errors returned by the postal company
Added loading of error and counterparty type directories
Added the ability to select city without specifying region when placing an order
Added initial loading of large cities if region is not specified
Redesigned city and department search when placing an order
Many other bug fixes, minor tweaks, and improvements
v. 3.2 from 30.10.2016:
Added compatibility with OpenCart 2.3
Added separate settings for department and courier delivery
Added debug mode
Added API key check when adding/changing settings
Added automatic initial database loading when entering API key for the first time
Added automatic sender data loading when changing API key
Added loading of postal company logo and the ability to specify display location
Added the ability to set multilingual text to display instead of cost in case of free delivery
Added the ability to set upper and lower cart amount limit for delivery method availability
Added macro to determine recipient region
Added the ability to set different fields for address and department delivery
Added the ability to set desired delivery date and time for the client
Added shipment type selection in settings
Added declared value components selection for the shipment
Added waybill viewing for a specific time period
Added manual delivery type selection when creating TTN, in addition to automatic
Added region selection when creating TTN for address
Added settlement search when creating TTN for address
Added convenient department search when creating TTN
Added street search when creating TTN
Added the ability to create TTN for discs and tires
Added the ability to adjust declared value components right before creating TTN
Added the ability to specify desired delivery date and time when creating TTN
Added loading of recipient counterparty parameters
Added optional display and application of payment control, third party, and cashless payment (depending on specific sender settings)
Added phased tracking, allowing processing of more than 100 TTN
Added compatibility with the "Club Program" cumulative discount module
Added support for Simple custom fields
Added support for regular drop-down lists when placing an order in Simple
Added support for two phone number formats (with 38 and without) when creating TTN
Added support for different Ukrainian language codes
Fixed tariff calculation according to the latest changes of Nova poshta
Completely redesigned delivery model
Redesigned delivery time display with proper endings
Redesigned default parameter application
Redesigned shipment tracking according to the latest changes of Nova poshta
Fixed sender settings selection for private individuals
Fixed errors in the waybill list
Fixed cron errors
Changed PHP version requirements, now 5.3 and above
Admin interface improvements and refinements
v. 2.0 from 23.04.2016:
Added support for OpenCart v 2.2.0.0
Added automatic shipment tracking
Added automatic update of regions, cities, departments, and directories of Nova poshta
Added recording of express waybill number and Ref in the order
Added editing of express waybills from the module
Added deletion of express waybills from the module
Added creation of express waybills from scratch
Added the ability to set multilingual name for the delivery method
Added choice of delivery cost calculation method (API or tariff) and independent operation of these methods
Added the ability to set a tariff table for determining delivery cost
Added selection of different department types (previously only 1 could be selected)
Added the ability to set a template with order and product variables for the additional shipment description field
Added the choice of default parameter application method (to the whole order or to products with incomplete data)
Added the ability to enable shipment volume accounting for volumetric weight calculation
Added automatic volume conversion
Added volumetric weight accounting for preliminary delivery cost calculation
Added sender data accounting for preliminary delivery cost calculation (personal discount, etc.)
Added convenient error output returned by Nova poshta when working with express waybills
Added linking of express waybills to store orders when viewing the waybill list
Данный модуль по праву считается лучшим решением для организации доставки Новой почтой в Вашем интернет-магазине. Дополнение решает практически все задачи, которые возникают при работе с Новой почтой и является отличным помощником на любом этапе работы с заказами. Кроме стандартных функций модуля доставки имеются инструменты для работы с Экспресс Накладными. Также доступны две функции калькулятора: расчет стоимости и срока доставки. Все расчеты происходят при помощи API, что гарантирует получение самых точных данных.
Дополнение также имеет ряд функций, которые за Вас в автоматическом режиме выполняют ежедневную рутинную работу: рассылка уведомлений с номером накладной, смена статусов заказа, напоминание о не забранных посылках и т.д.
Модуль не перезаписывает и не удаляет стандартные файлы и таблицы базы OpenCart. В работе модуля используется API «Новой почты», что позволяет всегда иметь актуальную информацию о городах, отделениях, отправлениях и т.д., а также взаимодействовать непосредственно с Новой почтой используя большое количество готовых решений, предоставляемых компанией. И это не все возможности модуля, функционал постоянно расширяется и улучшается. Приобретая модуль Вы будете экономить уйму времени и значительные денежные средства на обработке заказов и разработке аналогичного функционала.
Дополнение является авторской разработкой и защищено соответствующими правами
По ссылкам, предоставленным ниже, можно перейти на демонстрационный сайт. Для доступа в админ-панель используйте следующие данные: логин и пароль - demo
настройки доставки в отделение, на адрес и в почтомат:
вкл/выкл способ доставки
редактируемое и мультиязычное название доставки
выбор географической зоны
выбор налогового класса
возможность задать минимальную сумму заказа при которой доставка будет доступной
возможность задать максимальную сумму заказа при которой доставка будет доступной
возможность задать минимальную сумму заказа при которой доставка будет бесплатной
редактируемый и мультиязычный текст бесплатной доставки
вкл/выкл расчет стоимости доставки
вкл/выкл API расчет стоимости доставки
вкл/выкл тарифный расчет стоимости доставки
вкл/выкл расчет срока доставки в днях
вкл/выкл фильтр отделений по весу
вкл/выкл фильтр отделений по габаритам
выбор типа отделения
выбор статуса отделения
настройка тарифного расчета
настройка расчета наложенного платежа
работа с базой:
загрузка/обновление справочников компании «Новая почта»
загрузка/обновление областей Украины
загрузка/обновление городов компании «Новая почта»
загрузка/обновление отделений компании «Новая почта»
Вкл/Выкл онлайн поиск населенных пунктов для адресной доставки
Вкл/Выкл онлайн поиск улиц для адресной доставки
настройка параметров отправителя: отправитель, контактное лицо, область, город, отделение или адрес отправки
настройка параметров получателя: получатель, контактное лицо, телефон, ЕГРПОУ, область, город, отделение, адрес, улица, дом, квартира, желаемые дата и время доставки
настройка параметров отправления:
вкл/выкл автоопределение типа отправления
выбор типа отправления по умолчанию
вкл/выкл учет объёма
выбор варианта учета объёма отправления
возможность задать количество мест по умолчанию
выбор составляющих для объявленной стоимости отправления
возможность задать объявленную стоимость по умолчанию
возможность задать минимальную объявленную стоимость
возможность задать описание отправления по умолчанию с использованием макросов заказа и товара
возможность задать дополнительную информацию об отправлении по умолчанию с использованием макросов заказа и товара
вкл/выкл общие параметры
вкл/выкл ручную обработку
вкл/выкл авиадоставку
выбор способа применения параметров по умолчанию
возможность задать вес по умолчанию
возможность задать минимальный вес
возможность задать размеры по умолчанию
возможность задать допуски к размерам отправления
вкл/выкл учет упаковки
выбор типа упаковки
вкл/выкл автоопределение типа упаковки
настройка параметров оплаты:
выбор плательщика доставки по умолчанию
выбор третьего лица
выбор формы оплаты по умолчанию
выбор метода оплаты для наложенного платежа
настройка расчета наложенного платежа
настройка учета комиссии за объявленную стоимость
выбор обратной доставки по умолчанию
выбор плательщика обратной доставки по умолчанию
выбор составляющих для контроля оплаты
настройка интеграции ТТН:
вкл/выкл отображение всех накладных аккаунта
выбор отображаемой информации в списке накладных
настройка печати
выбор совместимого способа доставки для создания накладных
вкл/выкл создание, редактирование, удаление и присвоения накладной в заказе
возможность задать мультиязычные названия пунктов меню для работы с накладными в заказе
задания Cron:
возможность задать ключ безопасности выполнения Cron команд
автоматическое обновление базы данных модуля (области, города, отделения, справочники)
автоматическое отслеживание отправлений, смена статуса заказа и отправка уведомлений
выбор статусов заказа, для которых необходимо отслеживание
настройка зависимостей для каждого статуса отправления и статуса заказа в магазине
возможность задать задержку выполнения по каждому статусу отправления
вкл/выкл уведомления для администратора и покупателя
возможность задать мультиязычный шаблон сообщения для e-mail и sms уведомлений используя макросы заказа, товара и накладной
и другие стандартные опции модуля доставки
Возможности для работы с накладными
При просмотре заказа в админ-панели, если клиент выбрал совместимый способ доставки, появляется кнопка для работы с накладной. Возможно создать накладную на основе заказа или присвоить уже существующую. При переходе к созданию, модуль максимально заполняет форму в автоматическом режиме. Если для просматриваемого заказа накладная уже создана, то будет доступен пункт редактирования и удаления. Также при просмотре заказов можно перейти к списку всех накладных. Доступные функциональности:
создание, редактирование и удаление накладной
работа с реестрами
настройка печати накладных
скачивание накладной и маркировок в формате PDF для одного или нескольких заказов
печать в браузере накладной и маркировок для одного или нескольких заказов
просмотр накладных по числам отправки с возможностью фильтра по типу и номеру
автоматическое заполнение информации отправителя согласно выбранным настройкам модуля с возможностью смены данных непосредственно перед созданием накладной
автоматическое заполнении параметров получателя согласно данным из заказа, в том числе доступны следующие функции:
выбор типа доставки (отделение, адрес и почтомат)
поиск получателей
выбор области
поиск города, населенного пункта
поиск отделения
поиск улицы
ввод номера дома и квартиры
автоматическое заполнение параметров отправления:
тип
общий вес
общий объем
общий объемный вес
упаковка
количество мест с возможностью указать параметры каждого места отправления
объявленная стоимость с возможностью корректировки составляющих
описание
автоматическое заполнение параметров оплаты:
плательщик доставки
выбор третьего лица
форма оплаты
обратная доставка
сумма обратной доставки, если выбран наложенный платеж
плательщик обратной доставки
контроль оплаты
дополнительные параметры отправления:
выбор даты отправки
выбор желаемой даты доставки
выбор желаемого времени доставки
заполнение поля "Внутренний номер заказа клиента"
ввод номера упаковки
заполнение поля дополнительной информации об отправлении
подъем на этаж
лифт
авиадоставка
поля автоматически, по мере возможности, заполняются или выбираются модулем согласно настроек
валидация полей во время редактирования и перед передачей данных на сервер почтовой компании
автоматическая проверка существования контактного лица в базе получателей, если не будет найден, то создается новый
автоматическая корректировка контактного лица
автоматический поиск адресов получателя и создание новых в случае необходимости
подсветка распечатанных и удаленных накладных в списке
При успешном создании или редактировании будет выполнена переадресация к созданной накладной и ее подсветкой в общем списке.
Возможности для клиента
выбор типа доставки:
доставка в отделение
доставка курьером на адрес
доставка в почтомат
выбор города получения:
выпадающий список
поиск по названию города
выбор отделения или почтомата:
выпадающий список
поиск по названию, адресу или номеру отделения
выбор населенного пункта для курьерской доставки
выбор улицы для курьерской доставки
ввод дополнительных данных для курьерской доставки
информация о стоимости доставки
информация о сроке доставки
Поддерживаемые языки
украинский
английский
русский
В некоторых методах API Новой почты заявлена поддержка украинского, английского и русских языков. На практике реализована 100% поддержка только украинского языка. Названия городов и отделений Новой почты доступны на украинском и русском языках. Модуль автоматически показывает нужный перевод в зависимости от настроек OpenCart или предпочтений покупателя во время оформления заказа.
Совместимость
OpenCart v. 1.5.x.x, 2.x.x.x, 3.x.x.x (а также сборки на базе OpenCart соответствующих версий)
формы заказа: One Page Checkout - Простое оформление заказа, OCTemplates Smart Checkout, Simple checkout & registration - максимальный функционал. Стандартное оформление заказов, Ajax Quick Checkout - только выбор города и отделения
модули отправки сообщений: стандартная отправка e-mail, SmsFly order
Возможно потребуется адаптации для конкретных версий. Адаптацию для других модулей и шаблонов выполним по запросу за ДОПОЛНИТЕЛЬНУЮ ПЛАТУ.
Лицензия
приобретая дополнение Вы получаете пожизненный доступ к бесплатным обновлениям и бесплатную техническую поддержку в течении года
лицензия действует только на один домен и на все его поддомены, и тестовые сайты
информация о порядке получения лицензии доступна после установки модуля
активация лицензии происходит в течение нескольких часов после покупки
Требования
ionCube Loader версии 5.0 и выше
PHP библиотека cURL
PHP версии 5.6 и выше
Инструкция
(установка, настройка, обновление и удаление)
Установка
Перед установкой на работающем интернет-магазине рекомендуем выполнить установку и тестирование модуля на тестовом сайте или поддомене!
Выполняйте все действия пошагово, придерживаясь последовательности!
Чтобы не тратить время, свое и разработчика, внимательно прочитайте инструкцию. Если возникли проблемы во время установки модуля или в процессе использования - можно воспользоваться разделом Вопросы/Ответы, возможно там уже есть решение вашей проблемы.
Загрузить содержимое папки upload в корень сайта, используя FTP-менеджер.
Зайти в админ-панель магазина и перейти в раздел Дополнения → Доставка, и напротив модуля нажать кнопку «Установить».
Перейти в раздел Дополнения → Установка дополнений и загрузить необходимый модификатор из папки modification. Перейти в раздел Дополнения → Менеджер дополнений и нажать кнопку «Обновить». Для версий 1.5.x.x загрузить необходимые модификаторы нужно на сервер в папку vqmod/xml/. Подробнее о модификаторах в разделе Настройка.
Перейти к редактированию настроек модуля и активировать лицензию.
После отправки данных о покупке должно появиться сообщение о том, что данные были успешно отправлены!
После активации лицензии должно появиться подтверждающее сообщение!
На вкладке «Основные» в поле «Ключ API» вставьте ключ доступа к API Новой почты, который вы можете найти в личном кабинете на сайте компании «Новая почта» (novaposhta.ua) в разделе Настройки → Безопасность → Мои ключи API.
Откройте выпадающий список рядом с кнопкой сохранения настроек и загрузите базовые настройки.
Задайте необходимые настройки на всех вкладках.
Сохраните, нажав "Сохранить". Модуль готов к использованию.
Настройка
Данный модуль позволяет обеспечить гибкую совместимость практически со всеми модулями оформления заказов и шаблонами OpenCart благодаря соответствующим модификаторам. Подгрузка всех адресов происходит лишь при выбранном способе доставки. Для полноценной работы модуля на странице оформления заказа должны выполняться минимальные требования для полей адреса доставки:
Город (city) - обычное текстовое поле
Адрес/Отделение Новой почты (address_1) - обычное текстовое поле
изменение поля город должно вызывать обновление способа доставки для отображения стоимости и срока доставки
Описание модификаторов:
Ставьте только необходимые модификаторы!
shippingdata_admin – обязательный модификатор необходимый для расширения функционала в админ-панеле.
shippingdata_ajax_quick_checkout – модификатор обеспечивает совместимость с модулем оформления заказов Ajax Quick Checkout. Дополнительная настройка не требуется. Возможно потребуется адаптация для конкретных версий.
shippingdata_default_checkout – модификатор обеспечивает совместимость со стандартной формой заказа. Дополнительная настройка не требуется. Модификатор заменяет поле "Компания" в адресе на checkbox с возможностью выбрать заранее доставку. Если checkbox отмечен, то в полях город и адрес подгружаются списки городов и отделений соответственно.
shippingdata_octemplates_smart_checkout – модификатор обеспечивает совместимость с модулем оформления заказов Smart Checkout шаблона Deals. Дополнительная настройка не требуется. Возможно потребуется адаптация для конкретных версий.
shippingdata_simple – модификатор обеспечивает совместимость с модулем оформления заказов и регистрации Simple. Возможны два варианта настройки:
Отображение города и отделения в виде простых текстовых полей с подгрузкой выпадающих списков. Чтобы настроить достаточно для полей city и address_1 в настройках модуля Simple включить перезагрузку и вывести соответствующие поля в блоке адрес доставки
Отображение города и отделения в виде выпадающих списков 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
Передавать в метод значение другого поля – Город
для поля выбора почтомата Новой почты установите следующие настройки:
тип – select
Список значений – Получать вызовом метода в API модуля (catalog/model/tool/simpleapimain.php) или (catalog/model/tool/simpleapicustom.php)
Название метода в API модуля – getShippingPoshtomats
Передавать в метод значение другого поля – Город
все остальные настройки являются стандартными. Названия полей могут отличаться
для полей также нужно включить перезагрузку блоков при изменении полей в настройках блока адреса доставки
shippingdata_simple_v_2.X.X / shippingdata_simple_v_3.X.X – модификатор обеспечивает совместимость с модулем оформления заказов Simple соответствующих версий. Для полей city и address_1 в настройках нужно включить перезагрузку. Возможно потребуется адаптация для конкретных версий.
Обновление
Перед обновлением сделайте бэкап настроек и файлов модуля!
Список областей, городов, отделений и справочников обновляется в любое удобное время и необходимое количество раз через админ-панель модуля
Обновление с версии 4.1.0 на 4.1.1:
Зайти в админ-панель магазина
Перейти к редактированию модуля и сделать экспорт настроек (выпадающее меню возле кнопки «Сохранить»)
Перейти в раздел Дополнения → Доставка и напротив модуля нажмите кнопку «Удалить»
Загрузить используя FTP менеджер содержимое папки upload в корень сайта с заменой
Загрузить новые модификаторы предварительно удалив все старые (Shipping Data ...) и обновить кэш модификаторов (нажать «Обновить»). Подробнее о модификаторах в разделе Настройка
Перейти в раздел Дополнения → Доставка и напротив модуля нажмите кнопку «Установить»
Перейти к редактированию настроек модуля и на вкладке «Основные» в поле «Ключ API» вставьте ключ доступа к API Новой почты
После загрузки базы данных сделать импорт ранее сохраненных настроек (выпадающее меню возле кнопки «Сохранить»)
Проверить коректность всех настроек и нажать кнопку «Сохранить»
Обновление с версии 4.0.2 на 4.1.0:
Загрузить используя FTP менеджер содержимое папки upload в корень сайта с заменой
Загрузить новые модификаторы предварительно удалив все старые (Shipping Data ...) и обновить кэш модификаторов (нажать «Обновить»). Подробнее о модификаторах в разделе Настройка
Проверить корректность всех настроек и нажать кнопку «Сохранить»
Обновление с любой версии на последнюю:
Зайти в админ-панель магазина
Перейти к редактированию модуля и сделать экспорт настроек (выпадающее меню возле кнопки «Сохранить»)
Перейти в раздел Дополнения → Доставка и напротив модуля нажмите кнопку «Удалить»
Загрузить используя FTP менеджер содержимое папки upload в корень сайта с заменой
Загрузить новые модификаторы предварительно удалив все старые (Shipping Data ...) и обновить кэш модификаторов (нажать «Обновить»). Подробнее о модификаторах в разделе Настройка
Перейти в раздел Дополнения → Доставка и напротив модуля нажмите кнопку «Установить»
Перейти к редактированию настроек модуля и на вкладке «Основные» в поле «Ключ API» вставьте ключ доступа к API Новой почты
После загрузки базы данных сделать импорт ранее сохраненных настроек (выпадающее меню возле кнопки «Сохранить»)
Проверить корректность всех настроек и нажать кнопку «Сохранить»
Удаление
Зайти в админ-панель магазина
Перейти в раздел Дополнения → Менеджер дополнений и удалить установленные модификаторы модуля (отметить и нажать «Удалить»), после чего необходимо обновить кэш модификаторов (нажать «Обновить»)
Перейти в раздел Дополнения → Доставка и напротив модуля нажать кнопку «Удалить» (произойдет удаление информации о модуле с базы)
Удалить файлы модуля с сервера используя FTP менеджер
Поддержка
(вопросы/ответы, список изменений, контакты)
Вопросы/Ответы
Следуя инструкции, установите расширение на домен для которого хотите получить лицензию. Далее Вам необходимо зайти в настройки модуля, заполнить и отправить информацию о покупке. После проверки покупки Вам на почту придет ключ активации.
Для тестовых сайтов и поддоменов ключ предоставляется бесплатно. Процедура получения для тестового сайта такая же, как и при получении ключа для основного домена.
проверьте правильность ввода ключа API Новой почты
возможно, закончился срок действия ключа API Новой почты
возможно, не хватает ресурсов Вашего сервера или включены какие-то ограничения
есть вероятность того, что во время первой установки у Вас возникли ошибки, в таком случае таблицы в базе данных не создались. Решение: нажать Удалить/Установить напротив модуля Новой почты
Нужно сделать следующие действия (перед всеми манипуляциями необходимо сделать backup базы данных):
Удалить старый модуль через админ-панель магазина, также при возможности нужно удалить файлы этого модуля с сервера
Установить новый модуль согласно инструкции
Зайти в админ-панель магазина и перейти в раздел Система → Инструменты → Бэкап / Восстановление и загрузить файл recovery_zone_and_country_tables_ru.sql или recovery_zone_and_country_tables_ua.sql, предварительно выбрав его в архиве модуля в папке extra и нажав "Восстановить" (обратите внимание на префикс для таблиц в Вашей базе, в предоставленном файле префикс для таблиц стандартный - oc_)
Обновите версию ionCube Loader.
Установите/активируйте бесплатную библиотеку ionCube Loader на своем сервере/хостинге. Если, к примеру в php_info, будет отображаться информация о том что библиотека установлена, а ошибка не пропадет - значит Вы не правильно установили ionCube Loader.
проверьте, загрузились ли все файлы модуля на сервер в корневую директорию Вашего интернет-магазина
проверьте, соответствуют ли параметры Вашего сервера требованиям модуля
проверьте, нет ли ошибок в логах модификаторов
проверьте, установлен ли переключатель "Стоимость доставки" в положение "Да"
проверьте "Бесплатную доставку от", возможно сумма в вашей корзине больше или равна чем сумма для бесплатной доставки
проверьте вес товара в корзине. Если вес отсутствует в карточке товара, то можно задать значение по умолчанию в настройках модуля
проверьте настройки модуля, а также корректность города получателя
иногда некоторые методы API почтовой компании не доступны, в таком случае можно включить тарифный расчет в настройках модуля для отображения примерной стоимости доставки или подождать восстановления работоспособности API
проверьте, нет ли ошибок в логах модификаторов
проверьте, установлен ли переключатель "Срок доставки" в положение "Да"
проверьте настройки модуля, а также корректность города получателя
иногда некоторые методы API почтовой компании не доступны, в таком случае нужно подождать восстановления работоспособности API
В папке extra есть дамп стран и областей recovery_zone_and_country_tables_ru.sql и recovery_zone_and_country_tables_ua.sql с правильными названиями для Украины, на украинском и русском языках соответственно. Загружать их необходимо через админ-панель магазина в разделе Система → Инструменты → Бэкап / Восстановление предварительно проверив префиксы таблиц, в файлах они oc_
Если при оформлении заказа был выбран совместимый способ доставки, то при просмотре списка заказов или конкретного заказа будет доступна кнопка для работы с накладной. Также при просмотре списка заказов будет кнопка для перехода к списку накладных.
Интеграция с накладными при просмотре списка заказовИнтеграция с накладными при просмотре конкретного заказа
Отслеживание в модуле осуществляется через соответствующие методы API интерфейса Новой почты. Всё работает по принципу смены статусов. Для лучшего понимания рассмотрим работу и настройку на конкретном примере. Допустим нам необходимо отправлять уведомление клиенту с номером накладной когда заказ будет отправлен и завершить сделку установив соответствующий статус "Сделка завершена".
Для начала необходимо настроить Cron используя команду в модуле. Команда Cron дана для примера и для разных хостингов/серверов может отличаться. Интервал отслеживания, к примеру, каждый час.
Команда Cron для отслеживания
Укажите статусы Вашего интернет-магазина которые будут отслеживаться. Модуль будет отслеживать заказы с теми статусами, которые Вы отметите и для которых будет создана накладная. Для нашего примера это "В обработке" и "Отправлено".
Настройте соответствие между статусами Новой почты и статусами Вашего интернет-магазина. Модуль сверяет текущий статус отправления с соответствующим ему статусом интернет-магазина, если статус заказа не совпадает - модуль меняет на новый. Для нашего примера модуль будет работать следующий образом:
Выбирает все заказы у которых присутствует номер накладной и статус соответствует "В обработке" и "Отправлено"
Отслеживает выбранные заказы по номеру накладной
Если у конкретного заказа статус интернет-магазина "В обработке", а статус в системе Новой почты стал "Відправлено", то модуль меняет статус в интернет-магазине на "Отправлено"
Если у конкретного заказа статус интернет-магазина "Отправлено" или "В обработке", а статус в системе Новой почты стал "Одержаний", то модуль меняет статус в интернет-магазине на "Сделка завершена"
Настройка статусов
Список изменений
v. 4.1.1 от 07.07.2026:
актуализация методов АПИ
исправлены ошибки совместимости
другие исправления ошибок, мелкие правки и улучшения
v. 4.1.0 от 13.05.2023:
добавлена поддержка PHP 8.0, 8.1, 8.2
добавлена поддержка OpenCart 3.0.3.9
добавлен фильтр по габаритам для отделений
добавлена возможность отправки с почтоматов
добавлен фильтр по весу для почтоматов
добавлен фильтр по габаритам для почтоматов
добавлен минимальный вес по умолчанию
добавлена минимальная объявленная стоимость по умолчанию
добавлена поддержка макроса product_id для товара
добавлена всплывающая подсказка указанного города и отделения в форме ТТН
оптимизация загрузки списков городов и отделений
оптимизация загрузки настроек и формы ТТН
актуализация методов АПИ
исправлены ошибки заполнения формы ТТН
исправлена ошибка создания ТТН на документы
исправлена ошибка количества мест по умолчанию
исправлены ошибки трекинга
исправлены ошибки совместимости
другие исправления ошибок, мелкие правки и улучшения
v. 4.0.2 от 13.04.2023:
исправлена загрузка отделений
добавлена совместимость с новой версией Укрпочты
другие исправления ошибок
v. 4.0.1 от 14.02.2023:
добавлен поиск отделений по номеру в панеле администратора
улучшен поиск гороов, населенных пунктов и улиц в корзине
исправлено сохранение значение в таблице статусов трекинга для OpenCart 3
исправлены ошибки в модификаторах
другие исправления ошибок
v. 4.0.0 от 10.02.2023:
добавлена работа с реестрами
добавлен расчет наложенного платежа
добавлен онлайн поиск населенных пунктов и улиц для адресной доставки
добавлена возможность работы с несколькими местами отправлений
добавлена ручная обработка в ТТН
добавлена авиадоставка в ТТН
добавлен выбор упаковки в ТТН
добавлена возможность добавления юридических лиц в качестве получателя
добавлен фильтр отделений по статусу работы
добавлена возможность вкл/выкл учета страховки в расчете стоимости доставки
добавлена поддержка PHP 7.4
добавлена поддержка макросов в описании отправления
оптимизирована работа с базой данных
актуализация печатных форм
актуализация методов АПИ
исправлены ошибки совместимости
другие исправления ошибок, мелкие правки и улучшения
v. 3.5.0 от 14.11.2020:
добавлена доставка в почтомат, как способ доставки
добавлена возможность настройки cURL таймаутов
добавлена поддержка мультимагазинов при создании ТТН
оптимизировано обновление базы данных
обновлены и добавлены модификаторы
обновлен подсчет итогов
исправлена ошибка постраничной навигации в списке накладных
исправлена ошибка загрузки городов без названий
исправлена ошибка выбора некоторых отделений
исправлена ошибка подсчета бесплатной доставки
исправлены ошибки в справочниках
исправлены ошибки совместимости
другие исправления ошибок, мелкие правки и улучшения
v. 3.4.1 от 27.07.2019:
добавлена возможность печати маркировок типа "Зебра" 100х100
добавлен макрос zone_id
увеличены лимиты на выполнение cURL запросов
улучшена совместимость с рядом дополнений
исправлены ошибки при обновлении городов и отделений
исправлены ошибки при выполнении тарифного расчета стоимости доставки
исправлена валидация объема при создании ТТН
другие исправления ошибок, мелкие правки и улучшения
v. 3.4.0 от 09.04.2019:
добавлена поддержка мультимагазинов
добавлена автоматическая смена получателя при смене ключа АПИ
добавлена поддержка услуги redBOX
добавлено автозаполнение поля контроль оплаты
добавлена доставка на этаж и опция лифта
добавлен макрос опций товара
добавлен фильтр накладных по номеру
добавлена возможность привязки сторонних накладных к заказам
добавлена возможность привязки своих накладных без временных ограничений
добавлен код статуса к oписанию в списке накладных
добавлен мультиязычный поиск городов и отделений в корзине
добавлен расчет срока доставки для тарифного расчета
обновлен список статусов отслеживания
актуализированы все запросы к АПИ
актуализирована структура базы данных
переработано создание и редактирование накладных
переработано обновление базы данных
переработан тарифный расчет
переработан расчет параметров отправления
переработана задержка выполнения при трекинге отправлений
доработаны все модификаторы
исправлена ошибка с отчеством при создании ТТН на адрес
исправлена ошибка определения типа улицы при создании ТТН на адрес
исправлена ошибка оплаты безналом
исправлены ошибки валидации формы ТТН
исправлена ошибка вывода заголовка способов доставки когда они не доступны
исправлены ошибки операций с числами в PHP 7.1 и выше
исправлен ряд ошибок в версии для OpenCart 3
исправлен ряд ошибок в версии для OpenCart 1.5
исправлен ряд ошибок отслеживания отправлений
другие исправления ошибок, мелкие правки и улучшения
v. 3.3.1 от 04.07.2018:
добавлена совместимость с OpenCart 3
добавлена настройка печати
добавлена поддержка модуля отправки смс "OCHELP - СМС уведомления для админа, клиента"
добавлено присвоение названия города при оформлении заказа из сессии для совместимости с некоторыми дополнениями
продублированы коды статусов доставки в названии
доработан модификатор интеграции с заказами
создание и удаление таблиц дополнения вынесено в модель
исправлены ошибки связанные с неустановленными модулями оплаты, доставки и модулями учета в заказе
исправлена ошибка с выбором оплаты по безналу при создании ТТН
исправлена ошибка с расчетом параметров отправления при создании ТТН
исправлена ошибка с объявленной стоимостью по умолчанию
исправлена ошибка если не заданы тарифы
исправлен расчет стоимости упаковки
исправлены некоторые макросы при отслеживании
другие исправления ошибок, мелкие правки и улучшения
v. 3.3.0 от 12.12.2017:
переработано сохранение настроек
переработан тарифный расчет
добавлен экспорт/импорт настроек
добавлена загрузка базовых настроек
переработан интерфейс администратора
исправлены ошибки при редактировании накладной
оптимизированы и приведены в актуальное состояние базы данных
исправлены ошибки при применении ключа API
добавлена возможность выбора нескольких способов оплаты наложенным платежом
добавлено автоматическое определение протокола https
добавлены новые макросы для заказа, товаров и накладных
доработана отправка e-mail уведомлений
переработана конвертация веса и размеров отправления
добавлен учет веса из опций
исправлена ошибка в модификаторе для стандартной корзины
исправлены ошибки при создании накладной
добавлен текст бесплатной доставки для каждого способа доставки (в отделение и курьером)
добавлена возможность использовать дополнительные поля (улица, дома, квартира) для адресной доставки
добавлено автоопределение типа отправления (документ, посылка, груз) и возможность вкл/выкл эту опцию
добавлена возможность выбрать способ расчета объема отправления
добавлен расчет количества мест отправления
добавлена возможность задать количество мест отправления по умолчанию
добавлена возможность задать объявленную стоимость по умолчанию
добавлено автозаполнение для описания отправления в настройках
добавлена возможность задать допуски для размеров отправления (+\- см)
добавлен учет упаковки отправления
добавлен выбор типа упаковки отправления
добавлено автоопределение типа упаковки на основе параметров отправления (вес, размеры)
добавлена вкладка с настройками оплаты (плательщик, форма оплаты, метод оплаты наложенным платежом, плательщик обратной доставки, способ получения денежного перевода, платежная карта)
добавлена возможность выбора отображения всех накладных аккаунта или только привязанных к заказам
добавлена возможность выбора отображаемой информации в списке накладных
добавлена возможность выбора совместимого способ доставки для создания накладных
добавлена возможность задать произвольный способ оплаты, доставки или итоговый модуль
добавлена возможность выбора пунктов меню и задание их названий при интеграции накладных в заказах
