docs.modx.pro
msYandexDelivery
msYandexDelivery
Доставка через Yandex Delivery Platform API (other-day) для MiniShop3 — расчёт, ПВЗ, заявки в менеджере
  • MODX 3
  • PHP 8.2
  • miniShop3
  • Vue 3
Зависимости
  1. Компоненты
  2. msYandexDelivery

msYandexDelivery ​

Вкладка Yandex Delivery на карточке заказа

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 (через запятую). Активные способы оплаты связываются автоматически. Способы оплаты пакет не создаёт.

Установка ​

  1. Установите MiniShop3 и VueTools.
  2. Установите пакет msYandexDelivery.
  3. Очистите кэш MODX.
  4. В Системные настройки → msyandexdelivery задайте обязательный base_url, токен и склад отправителя.
  5. Включите msyandexdelivery_enabled и способы доставки в MiniShop3.
  6. На странице чекаута вызовите сниппеты и контейнер виджета — см. Чекаут.

Если transport зашифрован через EncryptedVehicle, в «Управление пакетами» нужен провайдер modstore.pro. Иначе установка падает с Package provider not found.

Разделы ​

СтраницаСодержание
Быстрый стартКлючи API, чекаут, проверка заказа
Системные настройкиВсе ключи msyandexdelivery_*
Чекаут и сниппетыmsYandexDelivery, msydLexiconScript, виджет
Заявки и менеджерCreate / Confirm / Refresh / Cancel, опрос статусов
FAQЧастые ошибки и ограничения