Укрпочта - это национальный оператор почтовой связи Украины. Рассмотрим основные преимущества, опираясь на которые можно предложить этот способ доставки Вашим клиентам:
расширение географии продаж - 11000+ точек выдачи ваших товаров и привлечения аудитории небольших городов и сел
пересылка посылок весом от 250 граммов - только в Укрпочте можно отправлять посылки массой от 250 граммов по выгодной цене
оформление посылок без учета объемного веса - учитывается только фактический вес и размер самой длинной стороны
тарифы - до 30% ниже среднерыночных
Данный модуль является самым функциональным решением для организации доставки Укрпочтой в Вашем интернет-магазине, который использует в работе API для E-COMMERCE. Дополнение является отличным помощником во время работы с заказами, для которых клиент выбрал доставку Укрпочтой. Кроме стандартных функций модуля доставки имеются инструменты для работы с Накладными. Также доступны два калькулятора: расчет стоимости и срока доставки. Расчет стоимости происходит на основе API, что гарантирует получение точных данных. Дополнение имеет ряд функций, которые за Вас в автоматическом режиме выполняют ежедневную рутинную работу: рассылка уведомлений с номером накладной, смена статусов заказа, напоминание о не забранных посылках и другие. Возможности постоянно расширяются и улучшаются
Дополнение является авторской разработкой и защищено соответствующими правами
По ссылкам, предоставленным ниже, можно перейти на демонстрационный сайт. Для доступа в админ-панель используйте следующие данные: логин и пароль - demo
ввод значений eCom Bearer, StatusTracking Bearer и User token Укрпочты
загрузка логотипа транспортной компании
выбор места отображения логотипа
настройка cURL тайм-аут подключения и выполнения
настройки способов доставки (Экспресс в отделение, Экспресс курьером, Стандарт в отделение, Стандарт курьером):
вкл/выкл способ доставки
редактируемое мультиязычное название доставки
выбор географической зоны
выбор налогового класса
возможность задать минимальную сумму заказа при которой доставка будет доступной
возможность задать максимальную сумму заказа при которой доставка будет доступной
возможность задать минимальную сумму заказа при которой доставка будет бесплатной
редактируемый мультиязычный текст бесплатной доставки
вкл/выкл расчет стоимости доставки
вкл/выкл API расчет стоимости доставки (используемая информация для расчета: тип доставки, индекс отправителя и получателя, стоимость товара, вес товара, максимальная сторона, заказное письмо)
вкл/выкл тарифный расчет стоимости доставки (может использоваться как самостоятельно, так и в случае недоступности API. Используемая информация для расчета: область отправителя и получателя, тип доставки, стоимость товара, вес товара)
вкл/выкл расчет срока доставки в днях (используемая информация для расчета: область отправителя и получателя, тип доставки)
выбор типа отделения
выбор статуса отделения
возможность настроить тарифы и сроки доставки
работа с базой:
загрузка/обновление справочников почтовой компании
загрузка/обновление областей Украины
загрузка/обновление населенных пунктов компании «Укрпочта»
загрузка/обновление отделений компании «Укрпочта»
настройка параметров отправителя: отправитель, тип отправителя, ИНН, ЕГРПОУ, код банка, расчетный счет, e-mail, телефон, область, город, улица, дом, квартира, индекс, адресный забор
настройка параметров получателя: получатель, тип получателя, ИНН, ЕГРПОУ, телефон, область, город, адрес, улица, дом, квартира, индекс
настройка параметров отправления:
вкл/выкл учет объёма
выбор варианта учета объёма отправления
возможность задать количество мест по умолчанию
выбор составляющих для объявленной стоимости отправления
возможность задать объявленную стоимость по умолчанию
возможность задать минимальную объявленную стоимость
возможность задать описание отправления по умолчанию в виде шаблона с использованием макросов заказа и товара
вкл/выкл заказное письмо
вкл/выкл отправку смс о прибытии посылки клиенту
вкл/выкл осмотр при вручении
выбор действия в случае невручения посылки
выбор способа применения параметров по умолчанию
возможность задать вес по умолчанию
возможность задать минимальный вес
возможность задать размеры по умолчанию
возможность задать допуски к размерам отправления
настройка параметров оплаты:
выбор плательщика доставки по умолчанию
выбор метода оплаты для наложенного платежа
настройка расчета наложенного платежа
настройка учета комиссии за объявленную стоимость
выбор плательщика обратной доставки по умолчанию
выбор способа получения денежного перевода
настройка интеграции ТТН:
вкл/выкл по умолчанию бонусные отправления
выбор отображаемой информации в списке накладных
настройка печати
выбор совместимого способа доставки для создания накладных
вкл/выкл создание, редактирование, удаление и присвоения накладной в заказе
возможность задать мультиязычные названия пунктов меню для работы с накладными в заказе
задания Cron:
возможность задать ключ безопасности выполнения Cron команд
автоматическое обновление базы данных модуля (справочники, области, города, отделения)
автоматическое отслеживание отправлений, смена статуса заказа и отправка уведомлений
выбор статусов заказа, для которых необходимо отслеживание
настройка зависимостей для каждого статуса отправления и статуса заказа в магазине
возможность задать задержку выполнения по каждому статусу отправления
вкл/выкл уведомления для администратора и покупателя
возможность задать мультиязычный шаблон сообщения для e-mail и sms уведомлений используя макросы заказа, товара и накладной
и другие стандартные опции модуля доставки
Возможности для работы с накладными
При просмотре заказа в админ-панели, если клиент выбрал совместимый способ доставки, появляется кнопка для работы с накладной. Возможно создать накладную на основе заказа или присвоить уже существующую. При переходе к созданию, модуль максимально заполняет форму в автоматическом режиме. Если для просматриваемого заказа накладная уже создана, то будет доступен пункт редактирования и удаления. Также при просмотре заказов можно перейти к списку всех накладных. Доступный функционал:
создание, редактирование и удаление накладной
добавление/удаление накладных в группу
настройка печати накладных
скачивание накладной и других сопроводительных документов в формате PDF
просмотр списка накладных с возможностью фильтра по номеру накладной и заказа
автоматическое заполнение информации отправителя согласно выбранным настройкам модуля с возможностью смены данных непосредственно перед созданием накладной
автоматическое заполнении параметров получателя согласно данным из заказа, в том числе доступны следующие функции:
вкл/выкл бонусное отправление
выбор способа доставки (экспресс или стандарт)
выбор типа доставки (отделение или адрес)
загрузка данных получателя по номеру телефона
выбор типа получателя
ввод ИНН
ввод кода ЕГРПОУ
ввод адреса доставки (область, город, отделение, улица, дом, квартира и индекс)
автоматическое заполнение параметров отправления:
вес
габариты
возможностью задать несколько мест
объявленная стоимость с возможностью корректировки составляющих
описание
автоматическое заполнение параметров оплаты:
плательщик доставки
сумма обратной доставки, если выбран наложенный платеж
плательщик обратной доставки
способ получения денежного перевода
дополнительные параметры отправления:
заказное письмо
осмотр при вручении
СМС сообщение клиенту о прибытии отправления
действие в случае невручения
поля автоматически, по мере возможности, заполняются модулем согласно настроек
валидация полей во время редактирования и перед передачей данных на сервер почтовой компании
автоматическая проверка существования клиента в базе и создание в случае отрицательного результата
автоматическое редактирование данных клиента
автоматический поиск адресов получателя и создание новых в случае необходимости
При успешном создании или редактировании будет выполнена переадресация к накладной и ее подсветкой в общем списке.
Возможности для клиента
выбор типа доставки:
Укрпочта Экспресс. Доставка в отделение
Укрпочта Экспресс. Доставка курьером на адрес
Укрпочта Стандарт. Доставка в отделение
Укрпочта Стандарт. Доставка курьером на адрес
указание адреса доставки
выбор населенного пункта получения:
выпадающий список
поиск по названию города
выбор отделения:
выпадающий список
поиск по индексу
поиск индекса
информация о стоимости доставки
информация о сроке доставки
Поддерживаемые языки
украинский
русский
английский
В методах API реализована поддержка украинского языка и частично английского. Модуль автоматически использует нужный язык в зависимости от настроек OpenCart или предпочтений покупателя во время оформления заказа.
Совместимость
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 в корень сайта
Перейти в раздел Дополнения → Установка дополнений и загрузить необходимый модификатор из папки modification. Перейти в раздел Дополнения → Менеджер дополнений и нажать кнопку «Обновить». Подробнее о модификаторах в разделе Настройка
Зайти в админ-панель магазина и перейти в раздел Дополнения → Доставка и напротив модуля нажать кнопку «Установить»
Перейти к редактированию настроек модуля и активировать лицензию
После отправки данных о покупке должно появиться сообщение о том, что данные были успешно отправлены!
После активации лицензии должно появиться подтверждающее сообщение!
На вкладке «Основные» в поле «eCom Bearer», «StatusTracking Bearer» и «User token» вставьте соответствующие значения, которые сгенерируют и предоставят Вам после подписания договора с «Укрпочтой»
Откройте выпадающий список рядом с кнопкой сохранения настроек и загрузите базовые настройки
Задайте необходимые настройки на всех вкладках
Сохраните настройки нажав "Сохранить". Модуль готов к использованию
Настройка
Модуль совместим практически со всеми популярными модулями оформления заказов и шаблонами OpenCart благодаря соответствующим модификаторам. Для полноценной работы на странице оформления заказа должны выполняться минимальные требования для полей адреса доставки:
Область (zone_id) - стандартное поле OpenCart типа "select"
Город (city) - стандартное текстовое поле OpenCart
Адрес (address_1/address_2) - стандартное текстовое поле OpenCart для ввода адреса через запятую
Индекс (postcode) - стандартное текстовое поле Opencart
Если используемый модуль оформления заказов позволяет создавать пользовательские поля для адреса доставки, то возможно использовать для улицы, дома и квартиры отдельные поля
Описание модификаторов:
Ставьте только необходимые модификаторы!
shippingdata_admin – обязательный модификатор необходимый для расширения функционала в админ-панеле.
shippingdata_ajax_quick_checkout – модификатор обеспечивает совместимость с модулем оформления заказов Ajax Quick Checkout. Дополнительная настройка не требуется. Возможно потребуется адаптация для конкретных версий.
shippingdata_default_checkout – модификатор обеспечивает совместимость со стандартной формой заказа. Дополнительная настройка не требуется. Модификатор заменяет поле "Компания" в адресе на checkbox с возможностью выбрать заранее доставку. Если checkbox отмечен, то в полях город и адрес подгружаются списки городов и отделений соответственно.
shippingdata_octemplates_smart_checkout – модификатор обеспечивает совместимость с модулем оформления заказов Smart Checkout шаблона Deals. Дополнительная настройка не требуется. Возможно потребуется адаптация для конкретных версий.
shippingdata_simple – модификатор обеспечивает совместимость с модулем оформления заказов и регистрации Simple. Есть два варианта настройки:
Отображение города и отделения в виде простых текстовых полей с подгрузкой выпадающих списков. Чтобы настроить достаточно для полей 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
Передавать в метод значение другого поля – Город
все остальные настройки являются стандартными. Названия полей могут отличаться
для полей также нужно включить перезагрузку блоков при изминении полей в настройках блока адреса доставки
shippingdata_simple_v_2.X.X / shippingdata_simple_v_3.X.X – модификатор обеспечивает совместимость с модулем оформления заказов Simple соответствующих версий. Для полей city и address_1 в настройках нужно включить перезагрузку. Возможно потребуется адаптация для конкретных версий.
Обновление
Обновление с любой версии на последнюю:
Зайти в админ-панель магазина
Перейти к редактированию модуля и сделать экспорт настроек (выпадающее меню возле кнопки «Сохранить»)
Перейти в раздел Дополнения → Доставка и напротив модуля нажмите кнопку «Удалить»
Загрузить используя FTP менеджер содержимое папки upload в корень сайта с заменой
Загрузить новые модификаторы предварительно удалив все старые (Shipping Data ...) и обновить кэш модификаторов (нажать «Обновить»). Подробнее о модификаторах в разделе Настройка
Перейти в раздел Дополнения → Доставка и напротив модуля нажмите кнопку «Установить»
Перейти к редактированию настроек модуля и на вкладке «Основные» в полях «eCom Bearer», «StatusTracking Bearer», «User token» вставьте ключи доступа к API Укрпочты
После загрузки базы данных сделать импорт ранее сохраненных настроек (выпадающее меню возле кнопки «Сохранить»)
Проверить корректность всех настроек и нажать кнопку «Сохранить»
Удаление
Зайти в админ-панель магазина
Перейти в раздел Дополнения → Менеджер дополнений и удалить установленные модификаторы модуля (отметить и нажать «Удалить»), после чего необходимо обновить кэш модификаторов (нажать «Обновить»)
Перейти в раздел Дополнения → Доставка и напротив модуля нажать кнопку «Удалить» (произойдет удаление информации о модуле с базы)
Удалить файлы модуля с сервера
Поддержка
(вопросы/ответы, список изменений, контакты)
Следуя инструкции, установите расширение на домен для которого хотите получить лицензию. Далее Вам необходимо зайти в настройки модуля, заполнить и отправить информацию о покупке. После проверки покупки модуль активируется автоматически и Вам на почту придет ключ активации.
Установите/активируйте бесплатную библиотеку ionCube Loader на своем сервере/хостинге. Если, к примеру в php_info, будет отображаться информация о том что библиотека установлена, а ошибка не пропадет - значит Вы не правильно установили ionCube Loader
проверьте, установлен ли переключатель "Стоимость доставки" в положение "Да"
проверьте "Бесплатную доставку от", возможно сумма в вашей корзине больше или равна чем сумма для бесплатной доставки
проверьте вес товара в корзине. Если вес отсутствует в карточке товара, то можно задать значение по умолчанию в настройках модуля
проверьте настройки модуля, а также корректность данных получателя
иногда некоторые методы API почтовой компании не доступны, в таком случае можно включить тарифный расчет в настройках модуля для отображения примерной стоимости доставки или подождать восстановления работоспособности API
В папке extra есть дамп стран и областей recovery_zone_and_country_tables_ru.sql и recovery_zone_and_country_tables_ua.sql с правильными названиями для Украины, на русском и украинском языках соответственно. Загружать их необходимо через админ-панель магазина в разделе Система → Инструменты → Бэкап / Восстановление предварительно проверив префиксы таблиц, в файлах они oc_
Если при оформлении заказа был выбран совместимый способ доставки, то при просмотре списка заказов или конкретного заказа будет доступна кнопка для работы с накладной. Также при просмотре списка заказов будет кнопка для перехода к списку накладных.
Интеграция с накладными при просмотре списка заказовИнтеграция с накладными при просмотре конкретного заказа
Отслеживание в модуле осуществляется через соответствующие методы API интерфейса Укрпочты. Всё работает по принципу смены статусов. Для лучшего понимания рассмотрим работу и настройку на конкретном примере. Допустим нам необходимо отправлять уведомление клиенту с номером накладной когда заказ будет отправлен и завершить сделку установив соответствующий статус "Сделка завершена".
Для начала необходимо настроить Cron используя команду в модуле. Команда Cron дана для примера и для разных хостингов может отличаться. Интервал отслеживания, к примеру, каждый час.
Команда Cron для отслеживания
Укажите статусы Вашего интернет-магазина которые будут отслеживаться. Модуль будет отслеживать заказы с теми статусами, которые Вы отметите и для которых будет создана накладная. Для нашего примера это "В обработке" и "Отправлено".
Настройте соответствие между статусами Укрпочты и статусами Вашего интернет-магазина. Модуль сверяет текущий статус отправления с соответствующим ему статусом интернет-магазина, если статус заказа не совпадает - модуль меняет на новый. Для нашего примера модуль будет работать следующий образом:
Выбирает все заказы у которых присутствует номер накладной и статус соответствует "В обработке" и "Отправлено"
Отслеживает выбранные заказы по номеру накладной
Если у конкретного заказа статус интернет-магазина "В обработке", а статус в системе Укрпочты стал "Відправлення", то модуль меняет статус в интернет-магазине на "Отправлено"
Если у конкретного заказа статус интернет-магазина "Отправлено" или "В обработке", а статус в системе Укрпочты стал "Вручення", то модуль меняет статус в интернет-магазине на "Сделка завершена"
Настройка статусов
Список изменений
v. 2.3.0 от 17.07.2024:
добавлена поддержка PHP 8.0, 8.1, 8.2
добавлена поддержка OpenCart 3.0.3.9
добавлена печать нескольких документов
добавлен тарифный расчет наложенного платежа
добавлен минимальный вес по умолчанию
добавлена минимальная объявленная стоимость по умолчанию
добавлена возможность вкл/выкл учета страховки в расчете стоимости доставки
добавлена поддержка макроса product_id для товара
добавлена всплывающая подсказка указанного города и отделения в форме ТТН
оптимизация загрузки настроек и формы ТТН
актуализация методов АПИ
справлены ошибки загрузки баз городов и отделений
исправлены ошибки заполнения формы ТТН
исправлена ошибка количества мест по умолчанию
исправлены ошибки совместимости
другие исправления ошибок, мелкие правки и улучшения
v. 2.2.0 от 21.11.2023:
добавлена настройка типа отделений
добавлена настройка статусов отделений
добавлен поиск индексов
обновлен тарифный расчет
оптимизирована работа со списком накладных
исправлены ошибки при создании и редактировании ТТН
исправлены ошибки совместимости
другие исправления ошибок, мелкие правки и улучшения
v. 2.1.0 от 09.04.2023:
добавлена поддержка бонусных отправлений
добавлен поиск населенных пунктов
добавлен поиск отделений
добавлена возможность настройки cURL таймаутов
добавлена поддержка PHP 7.4
доработан тарифный расчет
оптимизирована работа со списком накладных
оптимизирована работа с базой данных
актуализация методов АПИ
исправлены ошибки при создании и редактировании ТТН
исправлена ошибка сортировки способа доставка
исправлены ошибки совместимости
другие исправления ошибок, мелкие правки и улучшения
v. 2.0.0 от 02.01.2020:
добавлена поддержка OpenCart 3
добавлена работа с группами почтовых отправлений
добавлена печать формы 103а
добавлена печать адресных ярлыков для группы отправлений
добавлена опция заказного письма
добавлена настройка осмотра при вручении посылки
добавлена настройка действий в случае невручения посылки
добавлена возможность ручного создания/редактирования отправителя
добавлен поиск получателя и отправителя по номеру телефона
добавлена валидация API расчета стоимости доставки
добавлена поддержка номера расчетного счета в формате IBAN
добавлена поддержка мультимагазина при создании ТТН
добавлена поддержка макросов опций товара
добавлена поддержка более ранних версий cURL
добавлено кеширование для ряда API запросов
оптимизирован вывод списка накладных
полностью изменен функционал работы с клиентами
все API методы приведены в актуальное состояние
увеличены лимиты на выполнение cURL запросов
обновлен список статусов для трекинга отправлений
расширены настройки печати сопроводительных документов
исправлена ошибка парсера адреса получателя
исправлена ошибка определения наложенного платежа при создании накладной
исправлены ошибки режима отладки
исправлены ошибки операций с числами в PHP 7.1 и выше
исправлена ошибка сохранения настроек для мультимагазинов
исправлены ошибки валидации формы накладной
исправлены ошибки определения бесплатной доставки и мин./макс. корзины при различных настройках валюты
исправлены ошибки тарифного расчета
исправлены ошибки определения параметров посылки
исправлены различные ошибки при оформлении заказа
исправлены ошибки совместимости с разными сборками OpenCart
улучшена совместимость с рядом дополнений
другие исправления ошибок, мелкие правки и улучшения
v. 1.1.0 от 29.11.2018:
добавлен API расчет стоимости доставки
добавлено получение наложенного платежа на банковский счет
добавлено автоматическое редактирование данных клиента
добавлены поля клиентов (ИНН, банковский код, расчетный счет, e-mail)
добавлена поддержка OpenCart v 2.0.0.0-2.2.0.0
добавлена адаптация для OpenCart v 1.5.X.X
исправлен расчет параметров отправления
исправлена проверка StatusTracking Bearer
другие исправления ошибок, мелкие правки и улучшения
