Документация eShopLogistic

Требования к модулям

При разработке модулей для CMS или для кастомных систем обратите внимание на следующие важные моменты.

Результаты запросов к api должны кэшироваться на стороне сайта/приложения.
Это необходимо для:
- удобства пользователей, которым не придётся снова пусть недолго, но ждать пока ваш сайт снова получит те же данные;
- уменьшения количества повторных запросов к api-серверам.
Необходимо выносить в настройки время кэширования (по умолчанию 24-48 часов) и кнопку сброса кэша (для применения обновлённых настроек в ЛК eShopLogistic).
Запрос на расчёт параметров доставки (https://api.eshoplogistic.ru/api/delivery/[service]) должен содержать массив offers.
Не стоит отправлять только вес или вес и габариты - в личном кабинете могут быть настроены правила, которые используют такие параметры как: количество товаров в корзине, сумма корзины, способ оплаты и другие.
Ваш модуль должен принимать заказы из виджета.
Логично, что один и тот же модуль должен реализовывать максимально полную функциональность.
Так вы сможете предоставить своим клиентам максимально удобный сервис и, возможно, избавить себя от дублирования процессов или кода.
Об отправке данных из виджета подробнее тут.
Ваш модуль должен отображать комментарии к службам доставки / способам доставки и способам оплаты.
В личном кабинете могут быть указаны комментарии - их нужно отображать в соответствующих местах на сайте.
Способы оплаты на сайте должны быть связаны со способами оплаты в нашей системе.
На данный момент доступно: card, cash, cashless.
В запросе к api должет присутствовать нужный вариант payment - от этого зависит правильность расчёта параметров доставки.

MODX Revolution

Версия 2 (рекомендуется)

Максимально простая настройка. Расчёт доставки в корзине на базе виджета. В комплекте 2 виджета для карточки товара.

Демонстрационный сайт: modx-v2.eshoplogistic.ru

Как подключить: modx-v2.eshoplogistic.ru/documentation.html

Скачать пакет для локальной установки

Модуль в modstore.pro

Версия 1

Демонстрационный сайт: modx.eshoplogistic.ru

Как подключить: modx.eshoplogistic.ru/documentation.html

Скачать пакет

Исходный код на GitHub: https://github.com/eshoplogistic/modx_revolution

Простой тест в Console:


$eShopLogistic = $modx->getService('eshoplogistic', 'eShopLogistic',
$modx->getOption('core_path').'components/eshoplogistic/model/eshoplogistic/', []);

# тест подключения
$init = $eShopLogistic->Query();
print_r($init);

# тест СДЭК
$query = [
    'from' => 44, // Тверь
    'to' => 430, // Самара
    'weight' => 1
];

$sdek = $eShopLogistic->Query('delivery/sdek', $query);

print_r($sdek,1);

Bitrix

Демонстрационный сайт: bitrix.eshoplogistic.ru

Маркетплейс: marketplace.1c-bitrix.ru/solutions/eshoplogistic.delivery/

Исходный код на GitHub: https://github.com/eshoplogistic/bitrix

Установка: положить в папку /bitrix/modules/, далее распаковать и установить из меню как обычный модуль.
Описание настройки модуля доступно после установки в панели управления Bitrix.