
msYandexDelivery

msYandexDelivery подключает Yandex Delivery Platform API («Доставка по России», other-day) к MiniShop3 на MODX 3. Покупатель считает стоимость и выбирает доставку до двери или ПВЗ на чекауте. Менеджер создаёт и подтверждает заявку в Яндексе, обновляет статус опросом API и при необходимости отменяет заявку.
Пространство имён: msyandexdelivery. Класс доставки: msyandexdelivery\Delivery\YandexDelivery. Webhook статусов нет. Статус обновляется опросом request/info (кнопка на вкладке заказа, Scheduler или cron).
С чего начать: Быстрый старт.
Возможности
- Расчёт стоимости через
pricing-calculator(тарифыtime_intervalиself_pickup) - Официальный виджет ПВЗ v2 на чекауте (
widget-pvz.dostavka.yandex.net) - Сохранение выбора в
msOrder.properties.msyandexdeliveryи таблицеmsyandex_requests - Подстановка стоимости через
msOnGetDeliveryCostиYandexDelivery::getCost()(синхронизацияdelivery_costиз цены опции) - Вкладка заказа MiniShop3 на VueTools: create → confirm → refresh → cancel
- Пакетный опрос статусов через Scheduler или
connector.php?action=sync_statuses
Отдельного CMP у пакета нет. Меню ведёт только в системные настройки namespace msyandexdelivery.
Требования
| Требование | Версия |
|---|---|
| MODX Revolution | >= 3.0.3 |
| PHP | >= 8.2 |
| MiniShop3 | >= 1.0.0 |
| VueTools | для вкладки заказа |
Способы доставки при установке
Resolver создаёт два способа с классом msyandexdelivery\Delivery\YandexDelivery:
| Тариф | Название в MS3 |
|---|---|
time_interval | Яндекс Доставка — до двери |
self_pickup | Яндекс Доставка — ПВЗ |
ID записываются в msyandexdelivery_delivery_id (через запятую). Активные способы оплаты связываются автоматически. Способы оплаты пакет не создаёт.
Установка
- Установите MiniShop3 и VueTools.
- Установите пакет msYandexDelivery.
- Очистите кэш MODX.
- В Системные настройки →
msyandexdeliveryзадайте обязательныйbase_url, токен и склад отправителя. - Включите
msyandexdelivery_enabledи способы доставки в MiniShop3. - На странице чекаута вызовите сниппеты и контейнер виджета — см. Чекаут.
Если transport зашифрован через EncryptedVehicle, в «Управление пакетами» нужен провайдер modstore.pro. Иначе установка падает с Package provider not found.
Разделы
| Страница | Содержание |
|---|---|
| Быстрый старт | Ключи API, чекаут, проверка заказа |
| Системные настройки | Все ключи msyandexdelivery_* |
| Чекаут и сниппеты | msYandexDelivery, msydLexiconScript, виджет |
| Заявки и менеджер | Create / Confirm / Refresh / Cancel, опрос статусов |
| FAQ | Частые ошибки и ограничения |
