How to update
List of releases
menu

linkОбщая информация

Обеспечивает самую полную интеграцию национальной почтовой службы Украины Укрпошты с доставками CS-Cart. Модуль входит в пакет модулей Украина (поставляется бесплатно владельцам пакета).

Модуль для работы требует стандартный для CS-Cart Русская сборка модуль Города + модуль Города Украины (поставляется также в пакет модулей Украина).

linkSupport

General technical support conditions are available at this link (be sure to review these conditions, all solutions from the AlexBranding development team come with limited technical support).

In order to use our technical support, you need to:

  1. Log in with your order owner account on https://cs-cart.alexbranding.com;
  2. Go to the page My Account → Orders;
  3. Find the corresponding order with the problem add-on in the orders list and pass to its details;
  4. Find the “Support” link next to the corresponding add-on name (near you can find Documentation link also) and click on it;
  5. Fill in the data with the problem, provide access to your CS-Cart installation (path to the administration panel, admin mail, admin password + FTP access) and create a ticket (after you will create the ticket, you will receive an e-mail and a special code to track the ticket in the future);
  6. Wait for the specialist answer in accordance with the regulations of the technical support service and the priority of your ticket.

If you didn't receive an answer within the deadlines, according to the chosen ticket priority, send e-mail info@alexbranding.com with the ticket number, for which you did not receive an answer in time, and the team manager will solve the problem in compliance with regulations.

Technical support by telephone calls and direct e-mails is not provided. Any help comes through tickets and helpdesk. Carefully learn documentation and technical support conditions before creating a request.

linkRestrictions and warnings

We recommend to note general restrictions:

  1. All solutions from AlexBranding developers team require pre-installation of the AB: Addons Manager service addon. It is delivered free of charge and is responsible for such services: installation, upgrades, license verifications. Excluding this service addon usage is not possible;
  2. Addon files may have a closed (encoded) part, in which only a license check is located;
  3. The addon will work only on those domains, that are specified in the user's license. If you try to use the solution on CS-Cart installations, whose domains are not included in the license, the addon will be automatically turned off;
  4. Local installation is not possible, so that the addon works on the additional domain (subdomain), enter this domain (subdomain) in the Domain field, when ordering (or write to info@alexbranding.com) - adding technical domains for the developing or for testing is always free.

linkUsage

linkInstallation

After your order has been processed by our manager, it will be transferred to Completed state, you will receive an email to your mailbox with ordered add-ons license numbers (usually it takes from 15 minutes to 8 hours depending on the day time and week day).

Then follow the steps below, which differs depending on your version of the CS-Cart platform:

If you have CS-Cart 4.16.1 and newer version

If you have CS-Cart 4.13.1 and newer version

If you have CS-Cart 4.12. *

If you have CS-Cart 4.11.5 and an earlier version

You can also install the add-on with a standard installation for CS-Cart. To do this, download the appropriate archive with an add-on version compatible with your version of the CS-Cart platform.
Go to the website cs-cart.alexbranding.com, log in under the account of the order holder and go to the page My Profile → Orders → Relevant Order, go to details and you will see a list of available archives for the ordered add-on. Download the version (archive) you need and make the installation (standard for CS-Cart installation: Add-ons → Downloaded add-ons and in the gearwheel menu select Manual installation).

Service add-on AB: Add-ons Manager must be installed and have Active status.

For access to the add-on settings you should go to the page Administration panel → Add-ons → Manage add-ons and at the add-on name in the gearwheel menu select appropriate menu item.

Settings of the "General" tab

Settings of the "Tracking statuses EN" tab

Settings of the "AB: Extended SMS notifications" tab

linkНаполнение справочников

Страница управления данными
Модуль содержит различные справочники, которые можно актуализировать и дополнять. Чтобы обновить справочники перейдите на страницу Панель администратора → Модули → Управление модулями, у названия модуля АВ: Укрпошта в меню шестерёнки выберите Управление данными. Нажмите кнопку Обновить справочник напротив соответствующего справочника: Почтовые отделения, Улицы. Рекомендуем обновлять информацию по Cron-у, используя команду на странице, для автоматического обновления.

Shipping method Ukrposhta consists of two shipment services:

  • Ukrposhta Standard;
  • Ukrposhta Express.

Обновите справочники на странице Управление данными в модуле АВ: Укрпошта, чтобы во вкладке настроек способа доставки отобразились все доступные поля!

Чтобы перейти к настройкам способа доставки перейдите на страницу Панель администратора → Администрирование → Доставка и налоги → Способы доставки → [название способа доставки Укрпошты] → вкладка "Настроить".
Вкладка настроек способа доставки

linkОтслеживание статусов ЭН

Модуль предусматривает возможность автоматизации процесса отслеживания статусов ЭН. Для этого выполните следующие шаги:

  1. Перейдите на страницу Панель администратора → Модули → Управление модулями, у названия модуля АВ: Укрпошта в меню шестерёнки выберите Общие настройки. В открывшейся странице, во вкладке Отслеживание статусов ЭН выберите из доступных полей необходимые статусы заказов для автоматического отслеживания. Также на этой странице задайте срок, за который будут отслеживаться статусы заказов ЭН по Cron-заданию.
  2. Перейдите на страницу Панель администратора → Модули → Управление модулями, у названия модуля АВ: Укрпошта в меню шестерёнки выберите Отслеживание статусов. Для обновления устаревшей информации по Cron-у используйте команду на странице.

Отслеживание статусов

linkПоиск отгрузок по статусу ЭН

Чтобы найти отгрузки по их статусу ЭН, перейдите на страницу Панель администратора → Заказы → Отгрузки, нажмите Расширенный поиск и в блоке AB: Новая Почта PRO установите чекбоксы напротив необходимых статусов ЭН, после чего нажмите Найти.
Поиск отгрузок по статусу ЭН

linkIntegrations

1. Запрет отправки SMS уведомления при создании отгрузки
Relevant for add-ons:

Страница настроек модуля

Дополнительные настройки модуля позволяют заблокировать отправку на момент создания отгрузки (так как пока не создана электронная накладная нет и номера ТТН для отправки) и отправить сообщение пользователю непосредственно после создания ЭН и получения номера отслеживания.

2. Предоставление справочников городов для Укрпошты
Relevant for add-ons:

Модуль Ukrainian cities является обязательным модулем, который предоставляет справочники городов.

linkHow to update

To have possibility to update an add-on, you must have an active subscription period for add-on license.

AB: Add-ons Manager will notify you about available updates (you will see an indicator of new alerts). The recommended way is to update via the CS-Cart Upgrade center (a regular procedure of the platform). This method will allow lossless configuration of the transition to the new add-on version, that is guaranteed to be compatible with your CS-Cart platform version.

Before updating, always make a full database and your store files backup (we recommend backing up using server or hosting tools).

To make updates procedure:

  1. Go to the Administration panel → Administration → Upgrade center;
  2. Find the appropriate update among the available updates and click the Update button;
  3. Follow all the instructions, that will be shown during the upgrade procedure;
  4. Clear CS-Cart cache and start using new add-on version.

If you have an earlier version of the add-on (without the Upgrade center support)

linkFAQ

linkList of releases


Subscribe to our Telegram-channel to get info about new releases.

v1.3.5 from 28 September 2022

New features and improvements:
[+] On the checkout page for mobile warehouses, added display of an inhabited locality on the map.

Bug fixes:
[!] Ukrposhta branches were not updated correctly. Fixed.

v1.3.4 from 30 April 2022

Bug fixes:
[!] API requests finished with an error. Fixed.

v1.3.3 from 13 October 2021

Bug fixes:
[!] Shipping setting "Payment of the post-payment by recipient" worked unproperly. Fixed.

v1.3.2 from 03 September 2021

Bug fixes:
[!] On the checkout page selected post office was not moved to the top of list. Fixed.

v1.3.1 from 26 Jule 2021

Bug fixes:
[!] PHP notice could occur on the checkout page when no city was mentioned. Fixed.
[!] Added shipment seats manually, in the creation of EW form, weren't used when creating document. Fixed.
[!] On the editing order page with created EW, button "Delete EW" was displayed when there were privilages to view and there were no provilages to edit data.

v1.3.0 from 28 May 2021

New features and improvements:
[+] Added possibility to create shipment with multiple slots.

v1.2.1 from 15 April 2021

Bug fixes:
[!] On the checkout page for some localities was no available post offices. Fixed.

v1.2.0 from 15 April 2021

Running Cron-task by http-link has been disabled. If you used such format, change Cron-task into a running console command.

New features and improvements:
[+] Removed the add-on setting "Cron-key". Cron task can be executed at console mode only.

Functionality changes:
[*] Changed API method for updating handbook of post offices.

Bug fixes:
[!] On the checkout page after post office choosing it was unable to scroll the page on mobile devices. Fixed.

v1.1.1 from 11 March 2021

Bug fixes:
[!] Option "Post-payment to card" wasn't displaying in the "Configure" tab, when editing shipping method. Fixed.

v1.1.0 from 04 March 2021

New features and improvements:
[+] Added the "Discount" field in the tab "Configure" of an editing shipping method page. It is needed to take into consideration the counterparty's discount when calculating shipping costs.
[+] Added ability to create EN with post-payment to card.

Bug fixes:
[!] Weight less than 100g was rounding up to 100g. Fixed.
[!] On disabling option "Post-payment" in the creating EN form, the field "Post-payment amount" wasn't disabled. Fixed.
[!] Error occurred when deleting EN. Fixed.

v1.0.1 from 13 January 2021

Release of the "Ukrposhta" add-on

v1.0.0 from 01 December 2020