linkUkrposhta
linkOverview
linkFeatures
linkОбщая информация
Обеспечивает самую полную интеграцию национальной почтовой службы Украины Укрпошты с доставками CS-Cart. Модуль входит в пакет модулей Украина (поставляется бесплатно владельцам пакета).
Модуль для работы требует стандартный для CS-Cart Русская сборка модуль Города + модуль Города Украины (поставляется также в пакет модулей Украина).
linkCompatibility
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:
- Log in with your order owner account on https://cs-cart.alexbranding.com;
- Go to the page My Account → Orders;
- Find the corresponding order with the problem add-on in the orders list and pass to its details;
- Find the “Support” link next to the corresponding add-on name (near you can find Documentation link also) and click on it;
- 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);
- 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.
link Demo
You can test the addon work with admin access using our demo server Demos for CS-Cart solutions from Alexbranding by choosing it in Addons list or just follow the link.
linkRestrictions and warnings
We recommend to note general restrictions:
- 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;
- Addon files may have a closed (encoded) part, in which only a license check is located;
- 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;
- 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:
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).
linkSettings
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.
linkGeneral settings
link"General" tab
link2. Token
linkНаполнение справочников
Модуль содержит различные справочники, которые можно актуализировать и дополнять. Чтобы обновить справочники перейдите на страницу Панель администратора → Модули → Управление модулями, у названия модуля АВ: Укрпошта в меню шестерёнки выберите Управление данными. Нажмите кнопку Обновить справочник напротив соответствующего справочника: Почтовые отделения, Улицы. Рекомендуем обновлять информацию по Cron-у, используя команду на странице, для автоматического обновления.
Shipping method Ukrposhta consists of two shipment services:
- Ukrposhta Standard;
- Ukrposhta Express.
Чтобы перейти к настройкам способа доставки перейдите на страницу Панель администратора → Администрирование → Доставка и налоги → Способы доставки → [название способа доставки Укрпошты] → вкладка "Настроить".
link1. Общие [CLONE]
link3. Отправитель
linkОтслеживание статусов ЭН
Модуль предусматривает возможность автоматизации процесса отслеживания статусов ЭН. Для этого выполните следующие шаги:
- Перейдите на страницу Панель администратора → Модули → Управление модулями, у названия модуля АВ: Укрпошта в меню шестерёнки выберите Общие настройки. В открывшейся странице, во вкладке Отслеживание статусов ЭН выберите из доступных полей необходимые статусы заказов для автоматического отслеживания. Также на этой странице задайте срок, за который будут отслеживаться статусы заказов ЭН по Cron-заданию.
- Перейдите на страницу Панель администратора → Модули → Управление модулями, у названия модуля АВ: Укрпошта в меню шестерёнки выберите Отслеживание статусов. Для обновления устаревшей информации по Cron-у используйте команду на странице.
linkПоиск отгрузок по статусу ЭН
Чтобы найти отгрузки по их статусу ЭН, перейдите на страницу Панель администратора → Заказы → Отгрузки, нажмите Расширенный поиск и в блоке AB: Новая Почта PRO установите чекбоксы напротив необходимых статусов ЭН, после чего нажмите Найти.
linkIntegrations
- Extended SMS notifications (for Ukraine only)Максимальная версия: 1.10.2
- Ukrposhta
Дополнительные настройки модуля позволяют заблокировать отправку на момент создания отгрузки (так как пока не создана электронная накладная нет и номера ТТН для отправки) и отправить сообщение пользователю непосредственно после создания ЭН и получения номера отслеживания.
Модуль Ukrainian cities является обязательным модулем, который предоставляет справочники городов.
linkHow to update
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.
To make updates procedure:
- Go to the Administration panel → Administration → Upgrade center;
- Find the appropriate update among the available updates and click the Update button;
- Follow all the instructions, that will be shown during the upgrade procedure;
- Clear CS-Cart cache and start using new add-on version.
linkFAQ
linkПолный список и расшифровка возможных ошибок при работе с API "Укрпошты". Документация "Укрпошты"
При работе с API Новой Почты могут возникнуть ошибки или уведомления. Полный список и расшифровку ошибок Вы можете увидеть в документации Новой Почты.
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