MS: Модуль доставки MEASoft
Описание
Модуль ms_courierexe реализует интеграцию с курьерской службой MEASoft (CourierExe) для расчета стоимости доставки и автоматической отправки заказов в курьерскую службу. Модуль поддерживает доставку курьером до двери и доставку в пункты выдачи заказов (ПВЗ).
Основные возможности
- Расчет стоимости доставки: Автоматический расчет стоимости доставки на основе веса, габаритов и адреса доставки
- Интеграция с MEASoft API: Полная интеграция с API курьерской службы MEASoft для отправки заказов и получения статусов
- Доставка курьером: Поддержка доставки курьером до двери с возможностью выбора даты и времени доставки
- Доставка в ПВЗ: Поддержка доставки в пункты выдачи заказов с выбором ПВЗ на карте
- Автоматическая отгрузка: Возможность автоматической отправки заказа в курьерскую службу при достижении определенного статуса заказа
- Отслеживание статусов: Автоматическое обновление статусов доставки из API MEASoft
- Работа с габаритами: Поддержка расчета доставки на основе веса и габаритов товаров (длина, ширина, высота)
Как работает модуль
Модуль использует следующие механизмы:
- Сервис доставки (
Tygh/Shippings/Services/MsCourierexe.php): Реализует интерфейс сервиса доставки CS-Cart для расчета стоимости доставки через API MEASoft.
- Расчет габаритов (
hooks.func.php):
fn_ms_courierexe_shippings_get_package_info()- рассчитывает общий вес и габариты посылки на основе веса и размеров товаров- Поддерживает получение веса и размеров из характеристик товаров или параметров доставки товара
- Автоматически конвертирует единицы измерения (граммы в килограммы, сантиметры)
- Отправка заказа (
func.php):
fn_ms_courierexe_shipment_order()- формирует XML-запрос и отправляет заказ в MEASoft API- Включает информацию о отправителе, получателе, товарах, способе оплаты, тарифе
- Сохраняет результат отправки в базу данных
- Получение статусов (
func.php):
fn_ms_courierexe_get_statuses_api()- запрашивает статусы доставки из API MEASoftfn_ms_courierexe_change_order_status()- автоматически изменяет статус заказа в CS-Cart на основе статуса доставки
- Автоматическая отгрузка (
hooks.func.php):
fn_ms_courierexe_change_order_status_post()- автоматически отправляет заказ в курьерскую службу при достижении настроенного статуса заказа
- Работа с ПВЗ (
controllers/frontend/ms_courierexe.php): Обрабатывает выбор пункта выдачи заказов и отображает карту с ПВЗ.
- Работа с курьером (
controllers/frontend/ms_courierexe.php): Обрабатывает выбор даты и времени доставки курьером.
- Миграции базы данных: При установке модуль добавляет поля в таблицы
ordersиshipping_servicesдля хранения данных о доставке.
Где находится функциональность
- Административная панель:
- Настройки модуля (префикс заказа, отправка артикула, размеры карты ПВЗ, настройки веса и габаритов, сопоставление статусов)
- Настройка способов доставки с параметрами MEASoft (код службы, логин, пароль, тариф, тип доставки)
- Просмотр статуса доставки в заказе
- Ручная отправка заказа в курьерскую службу
- Витрина:
- Страница оформления заказа с выбором способа доставки MEASoft
- Выбор ПВЗ на карте (если выбран тип доставки "ПВЗ")
- Выбор даты и времени доставки курьером (если выбран тип доставки "Курьером")
Настройки модуля
Общие настройки:
- Префикс для номера заказа (
order_prefix): Префикс, который будет добавлен к номеру заказа при отправке в MEASoft - Отправлять код товара (артикул) (
send_article): Включать ли артикул товара в данные отправки - Ширина карты с ПВЗ, px (
pvz_map_width): Ширина карты с пунктами выдачи заказов - Высота карты с ПВЗ, px (
pvz_map_height): Высота карты с пунктами выдачи заказов - Использовать внешнюю js библиотеку для карты с ПВЗ (
pvz_map_lib): Использовать ли внешнюю библиотеку для карты
Настройки габаритов:
- ID характеристики веса товара (
weight_feature): ID характеристики товара, содержащей вес - Граммов в заданной единице веса (
weight_feature_grams): Коэффициент перевода единицы веса в граммы - ID характеристики размеров товара (ДxШxВ) (
dimensions_feature_lwh): ID характеристики с размерами в формате "ДлинаxШиринаxВысота" - Разделитель (
dimensions_feature_lwh_separator): Разделитель между размерами (по умолчанию "x") - ID характеристики длины/ширины/высоты товара (
dimensions_feature_l/w/h): Отдельные характеристики для каждого размера - Сантиметров в заданной единице размера (
dimensions_feature_cm): Коэффициент перевода единицы размера в сантиметры
Настройки статусов:
- Сопоставление статусов заказа: Настройка соответствия статусов доставки MEASoft статусам заказов CS-Cart
- Автоматическая отгрузка: Настройка автоматической отправки заказа при достижении определенного статуса
Технические детали
- Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
- При установке создает сервис доставки
measoftв системе CS-Cart - Добавляет поля
ms_courierexe_status,ms_courierexe_shipment_result,ms_courierexe_pvz_code,ms_courierexe_courier_date,ms_courierexe_courier_min_time,ms_courierexe_courier_max_timeв таблицуorders - Использует XML для обмена данными с API MEASoft
- Поддерживает работу с характеристиками товаров для получения веса и размеров
- Автоматически конвертирует единицы измерения в требуемые форматы
- Интегрируется с системой способов оплаты для определения типа оплаты доставки
Локализации:
- English
- Русский
Совместимость:
- 4.18.X
- 4.17.X
Оформление подписки
Мы переходим на новую подписную систему, открывая для вас полный доступ ко всем нашим модулям. Подробную информацию об условиях подписки и часто задаваемых вопросах вы можете найти здесь.
Обратите внимание, что приобретение модулей по отдельности теперь недоступно — воспользоваться ими возможно исключительно в рамках подписки.
За единую стоимость подписки - 2000 руб/мес. Вы получаете доступ ко всем модулям.
Как оформить подписку у нас на сайте
Зарегистрируйтесь или авторизуйтесь на нашем сайте и выберите интересующий вас модуль
Нажмите кнопку Запросить триал доступ
Введите в поле URL сайта ваш домен в формате domain.com, без www и https://
Далее в личном кабинете в разделе загрузки вы сможете скачать нужный вам модуль и менеджер модулей для удобного управления модулями и оформления подписки.
Далее у вас есть 7 дней для тестирования выбранного модуля.
По истечении строка триала, для продолжения работы необходимо оплатить подписку.
Сделать это можно из менеджера модулей.
На выбор вы можете оплатить:
для зарубежных карт - PayPal
для РФ карт - Robokassa
Или на странице на сайте https://makeshop.pro/subscription/
При оплате нужно указать электронную почту с которой вы оформляли триал доступ.
При покупке на маркетплейсе CS-Cart
При покупке любого модуля зарубежной картой или картой РФ
Так как система при оформлении подписки не спрашивает дополнительных вопросов (на какой домен подписка оформляется) желательно вводить электронную почту ту же что и ваша учетная запись у нас на сайте (если она есть), тогда ваши учётки свяжутся между собой.
Выберите интересующий модуль и нажмите кнопку “Оформить подписку“
Далее после оплаты подписки вы сможете скачать модуль перейдя в раздел “Загрузки“, там выберите свой заказ и в нем будет ссылка на скачивание.
В дальнейшем, для получения новых модулей по подписке рекомендуем пользоваться нашим сайтом.
Всё что вам будет нужно сделать это на интересующем вас модуле (после авторизации) нажать кнопку “Запросить модуль по подписке“ и после одобрения скачать его в разделе загрузки.
Если что-то пойдет не так - проверьте выписалась ли лицензия
Найдите заказ с датой оформления подписки
Убедитесь что у вас прописался URL сайта в заказ
Если URL сайта неправильный и вам нужно обновить его: переходите в пункт меню “Мои модули”
Ищите модуль и проверьте URL магазина для которого выписана подписка
# Инструкция по использованию модуля MS: Модуль доставки MEASoft
Установка
- Убедитесь, что модуль активирован в разделе Администрирование → Модули → Скачанные модули
- Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
- При установке модуль создает сервис доставки и добавляет необходимые поля в базу данных
Настройка
1. Настройка модуля
- Перейдите в Администрирование → Модули → Скачанные модули → MS: Модуль доставки MEASoft
- Общие настройки:
- Префикс для номера заказа: Укажите префикс, который будет добавляться к номеру заказа (опционально)
- Отправлять код товара (артикул): Включите для отправки артикула товара в MEASoft
- Ширина/Высота карты с ПВЗ: Настройте размеры карты с пунктами выдачи заказов
- Использовать внешнюю js библиотеку для карты с ПВЗ: Включите при необходимости
- Настройки габаритов:
- ID характеристики веса товара: Укажите ID характеристики товара, содержащей вес (если вес не указан в параметрах доставки товара)
- Граммов в заданной единице веса: Укажите коэффициент перевода (например, 1000, если вес указан в килограммах)
- ID характеристики размеров товара (ДxШxВ): Укажите ID характеристики с размерами в формате "ДлинаxШиринаxВысота"
- Разделитель: Укажите разделитель между размерами (по умолчанию "x")
- ID характеристики длины/ширины/высоты: Альтернативно укажите отдельные характеристики для каждого размера
- Сантиметров в заданной единице размера: Укажите коэффициент перевода (например, 1, если размеры указаны в сантиметрах)
- Настройки статусов:
- Выберите витрину для настройки статусов
- Сопоставьте статусы доставки MEASoft со статусами заказов CS-Cart
- Настройте автоматическую отгрузку: выберите статус заказа, при достижении которого заказ будет автоматически отправлен в MEASoft
2. Настройка способа доставки
- Перейдите в Администрирование → Доставка → Способы доставки
- Создайте или отредактируйте способ доставки:
- Выберите сервис "MEASoft"
- Заполните параметры:
- Код курьерской службы: Код службы, полученный от MEASoft
- Логин: Логин для доступа к API MEASoft
- Пароль: Пароль для доступа к API MEASoft
- Код клиента: Код клиента в системе MEASoft (можно получить через кнопку "Получить код клиента")
- Тариф: Выберите тариф доставки (можно обновить через кнопку "Обновить тарифы")
- Тип доставки: Выберите "Курьером до двери" или "ПВЗ"
- Тип оплаты: Настройте соответствие способов оплаты типам оплаты MEASoft
- Мин./Макс. время доставки: Укажите временные рамки доставки
- Множитель/Наценка для стоимости доставки: Настройте корректировку стоимости доставки
Использование
Для администратора
- Отправка заказа в MEASoft:
- Перейдите в заказ
- Если настроена автоматическая отгрузка, заказ будет отправлен автоматически при достижении настроенного статуса
- Или нажмите кнопку "Отгрузить" для ручной отправки
- Проверьте результат отправки в поле "Статус доставки"
- Просмотр статуса доставки:
- В заказе отображается текущий статус доставки MEASoft
- Статус автоматически обновляется при запросе статусов из API
- Обновление статусов:
- Статусы доставки обновляются автоматически при изменении статуса заказа
- Или можно настроить cron-задачу для периодического обновления статусов
Для покупателя
- Выбор способа доставки:
- При оформлении заказа выберите способ доставки MEASoft
- Если выбран тип "ПВЗ":
- На карте выберите пункт выдачи заказов
- Убедитесь, что выбранный ПВЗ доступен для доставки
- Если выбран тип "Курьером до двери":
- Выберите желаемую дату доставки
- Выберите временной интервал доставки (с ... до ...)
- Оформление заказа:
- Заполните адрес доставки
- Выберите способ оплаты
- Завершите оформление заказа
Проверка работы
- Проверка расчета доставки:
- Добавьте товары в корзину
- Перейдите к оформлению заказа
- Выберите способ доставки MEASoft
- Убедитесь, что стоимость доставки рассчитывается корректно
- Проверка отправки заказа:
- Оформите тестовый заказ
- Дождитесь автоматической отправки или отправьте вручную
- Проверьте результат отправки в заказе
- Проверка статусов:
- Отследите изменение статуса доставки в заказе
- Убедитесь, что статус заказа автоматически изменяется согласно настройкам
Устранение неполадок
- Ошибка расчета доставки: Проверьте настройки веса и габаритов товаров, убедитесь, что данные корректны
- Ошибка отправки заказа: Проверьте логин, пароль и код курьерской службы в настройках способа доставки
- ПВЗ не отображаются на карте: Проверьте настройки карты и убедитесь, что используется правильная библиотека карт
- Статусы не обновляются: Проверьте настройки сопоставления статусов и убедитесь, что API MEASoft доступен
Ключевые файлы
app/addons/ms_courierexe/addon.xml- конфигурация модуляapp/addons/ms_courierexe/Tygh/Shippings/Services/MsCourierexe.php- сервис расчета доставкиapp/addons/ms_courierexe/func.php- функции отправки заказов и получения статусовapp/addons/ms_courierexe/hooks.func.php- хуки расчета габаритов и автоматической отгрузкиapp/addons/ms_courierexe/controllers/frontend/ms_courierexe.php- контроллер выбора ПВЗ и курьераdesign/themes/responsive/templates/addons/ms_courierexe/hooks/checkout/shipping_method.post.tpl- шаблон выбора способа доставки
**v1.8.12** от 15.05.2024 [+] Обновлена xml схема калькулятора **v1.8.12** от 15.05.2024 [+] Обновлена библиотека js для карты на странице оформления заказа **v1.8.11** от 17.03.2024 [+] Добавлена настройка для способа доставки с типом Курьером до двери, позволяющая показывать данный способ доставки, если нет рассчитанной цены, т.к. для Яндекс Доставки требуется указать точный адрес для расчёта [\*] Унифицирована языковая переменная, которая отображается, если не рассчитана цена для способа доставки, под все типы доставки **v1.8.10** от 01.03.2024 [\*] Изменены языковые переменные **v1.8.9** от 27.12.2023 [+] Передача минимальной даты доставки курьером в заказ [!] В заказ не передавалась желаемая дата доставки курьером, если поле было заполнено автоматически минимальной датой. Исправлено **v1.8.8** от 11.12.2023 [\*] Настройка, позволяющая скрыть временные интервалы на странице оформления заказа, теперь так же скрывает поле выбора желаемой даты доставки [!] Настройка, позволяющая задать текст-заглушку, когда нет рассчитанной цены, теперь выводится только для типа доставки ПВЗ **v1.8.7** от 24.11.2023 [+] В настройки способа доставки добавлена настройка, позволяющая скрыть временные интервалы на странице оформления заказа [+] В настройки способа доставки добавлена настройка, позволяющая задать текст-заглушку, когда нет рассчитанной цены. Поддерживает мультиязычность [!] Исправлена ошибка, когда при уже выбранном типе доставки курьером, при загрузке страницы настроек способа доставки, отображалось поле Показывать всегда **v1.8.6** от 30.10.2023 [+] Добавлена поддержка страницы оформления заказа новой версии для автоопределения города на карте [\*] Стандартизация кода **v1.8.5** от 29.06.2023 [+] В настройки модуля добавлена возможность переключения между внешней и внутренней js библиотеками для карты с ПВЗ **v1.8.4** от 29.06.2023 [!] Ошибка карты при повторном выборе ПВЗ на странице оформления заказа. Исправлено **v1.8.3** от 30.05.2023 [!] Ошибка при составлении списка тарифов, если приходил один тариф в настройках способа оплаты **v1.8.2** от 28.11.2022 [+] На странице оформления заказа, если способ доставки отображается всегда и при расчёте не было стоимости, то вместо Бесплатно отображается надпись Выберите ПВЗ для расчёта стоимости **v1.8.1** от 25.11.2022 [\*] Увеличен размер числа для кода ПВЗ, которое можно хранить в БД **v1.8.0** от 21.11.2022 [+] В настройках способа доставки, при выборе типа доставки ПВЗ, добавлен функционал получения кода клиента [+] При инициализации карты с ПВЗ на странице оформления заказа, добавлена отправка кода клиента [+] В настройках способа доставки, при выборе типа доставки ПВЗ, добавлена настройка, при выборе которой на странице оформления заказа данный способ доставки отображается всегда [!] Добавлены двоеточия для подсказок к настройкам способа доставки **v1.7.1** от 22.10.2022 [\*] При выборе ПВЗ, если доставка на данный момент времени в него не возможна, то выводится уведомление пользователю об этом, а данные о выбранном ПВЗ сбрасываются на значения по умолчанию [!] Исправлена орфографическая ошибка в языковых переменных **v1.7.0** от 15.10.2022 [+] Отправка кода ПВЗ на странице оформления заказа и пересчёт стоимости доставки при выборе конкретного ПВЗ, если в настройках способа доставки выбран тип доставки ПВЗ [!] Почтовый индекс и адрес доставки при расчёте стоимости доставки отправляются теперь только для тех способов доставки, в дополнительных настройках которых выбрано, что покупатель должен указать свой адрес [!] Совместимость с новой версией MEASoft map.js при отображении кнопки "Выбрать другой пункт выдачи" после выбора ПВЗ на карте [!] Совместимость с CS-Cart 4.15.2 учёта скидок на заказ при калькуляции стоимости доставки **v1.6.3** от 23.07.2022 [+] Модуль адаптирован под работу функционала проверки расчёта тарифа в настройках способа доставки **v1.6.2** от 01.07.2022 [!] Исправлена ошибка уровня Notice в пустой корзине [!] Исправлена опечатка в новом функционале (лишняя скобка) **v1.6.1** от 01.07.2022 [!] Исправлена ошибка, когда при сохранённом Типе доставки ПВЗ в настройках способа оплаты отображались настройки минимального и максимального времени доставки курьером **v1.6.0** от 01.07.2022 [\*] Настройки пользователя перенесены из настройки модуля оплаты в настройки способа оплаты [\*] Настройка тарифов перенесена со вкладки Общее на вкладку Настроить, и теперь зависит от кода курьерской службы в настройках способа оплаты [+] Добавлена кнопка обновить тарифы, которая позволяет обновить тарифы без предварительного сохранения кода службы доставки [!] Исправлена ошибка уровня Notice при оформлении заказа (обработка ещё одного ответа курьерской службы, который возвращает ошибку) **v1.5.1** от 21.06.2022 [!] Исправлено обновление списка служб доставки, когда настройки модуля вводились для отдельной витрины **v1.5.0** от 17.06.2022 [\*] Настройки пользователя перенесены из настроек способа оплаты в настройки модуля [+] Обновление списка служб доставки при обновлении кода курьерской службы в настройках модуля [\*] Обновлена иконка модуля [\*] Стандартизация файла CHANGELOG.md [!] Исправлена ошибка уровня Notice при оформлении заказа (обработка ответа курьерской службы, который возвращает ошибку) **v1.4.0** от 09.06.2021 [+] Добавлена настройка способа доставки: множитель для стоимости доставки [+] Добавлена настройка способа доставки: наценка для стоимости доставки **v1.3.4** от 28.04.2021 [!] Заблокированные настройки модуля для статусов **v1.3.3** от 28.04.2021 [!] Ошибка 401 для настроек модуля при выборе витрин MVE **v1.3.2** от 12.04.2021 [+] Автоподстановка минимальной даты в соответствующее поле на странице оформления заказа **v1.3.1** от 09.05.2021 [\*] Исправлено сохранение дополнительных данных в заказ (ПВЗ, дата и время) [\*] Исправлена передача пустых примечаний [\*] Ошибка в языковых переменных **v1.3.0** от 29.04.2021 [+] Отправка комментариев покупателя и администратора при отгрузке заказа [+] Время и дата доставки курьером [+] Отправка типа оплаты при калькуляции стоимости доставки и отгрузке заказа [+] Учёт скидок на заказ при калькуляции стоимости доставки и отгрузке заказа [+] Отправка габаритов товара, при калькуляции стоимости доставки и отгрузке заказа [+] Возможность указать размеры (ДxШxВ) как общую или раздельные характеристики товара [+] Возможность указать вес как характеристику товара [+] Конвертация любой единицы измерения размера в см при калькуляции стоимости доставки и отгрузке заказа [+] Конвертация любой единицы измерения веса в кг при калькуляции стоимости доставки и отгрузке заказа [\*] Адаптирована карта ПВЗ для мобильной версии CS-Cart **v1.2.1** от 11.02.2021 [\*] Настройки модуля открываются в отдельном окне [\*] Изменены логотип, название и описание к модулю **v1.2.0** от 01.02.2021 [+] Сопоставление статусов CS-Cart и MEASoft [+] Автоматическая отгрузка при указанном статусе [+] Добавлены статусы CUSTOMSFINISHED, CUSTOMSPROCESS [+] Настройка модуля, позволяющая указать префикс для номера заказа [+] Настройка модуля, определяющая нужно ли отправлять код товара в MEASoft [+] Отправка данных с версиями CS-Cart и модуля MEASoft [+] Отправка города для карты ПВЗ на странице "Оформить заказ" [+] Добавлены английские языковые переменные [\*] Статус доставки теперь обновляется при отгрузке заказа без перезагрузки страницы [!] Ошибка отображения статуса отгрузки [!] Ошибка работы с обновлением статусов доставки, если он был один **v1.1.1** от 04.12.2020 [+] Добавлены параметры расчета стоимости доставки [\*] Ошибки отображения в заказе **v1.1.0** от 04.12.2020 [+] Поддержка ПВЗ [+] Настройки карты **v1.0.0** от 13.11.2020 [+] Первое издание *** [+] Добавлено [-] Удалено [\*] Изменено [!] Исправлена ошибка
Запросить доработку
Ваш запрос отправлен!
Ваш запрос на доработку модуля отправлен в техническую поддержку. Мы изучим ваши пожелания и дадим обратную свзязь.
Вам придет уведомление на указанный Email.
Отзывы
Здесь можно поделиться своим мнением и оценить нашу работу.
Ваши отзывы помогают нам стать лучше и предлагать вам еще более качественный сервис.