🧭 mxDadata — DaData (Suggest, Clean, Party) и чекаут для MODX Revolution 3 + MiniShop3. Подсказки по адресу, организациям, ФИО, e-mail, банкам, нормализация (Clean), карточка организации по ИНН (Party), геолокация и версия справочников с единой точкой вызова API: защищённый connector в менеджере и публичный connector-web для сайта. В админке — дашборд (статус API, баланс), настройки, кэш, логи с ротацией, раздел Party и интеграция с MiniShop3 (валидация/маппинг адреса, сниппеты и демо-чанк оформления заказа).

Кому подойдёт

• Нужны подсказки DaData на чекауте MS3 без «самописного» к фронтенду и с контролем лимитов и кэша на бэкенде
• Важны логи запросов к API и ротация записей (по умолчанию хранение логов 30 суток)
• Планируется универсальная форма на JSON (mxDadataForm) с полями NAME / EMAIL / ADDRESS / PARTY / BANK, геолокацией и блоком версии справочников
• Нужны три языка интерфейса в менеджере: RU, EN, UA (лексиконы компонента)

✨ Возможности

• API DaData: Suggest (адрес, party, name, e-mail, bank), Clean, Party/FindById, Geolocate/Address, Tools/Version; обработка ответов и ошибок в едином стиле (лексикон + разбор тела ответа API)
• Кэш и ограничение частоты запросов к внешнему API; таблица mxdadata_cache
• Логи в БД, просмотр в админке, ротация (в т.ч. через Scheduler — опционально)
• Плагины и интеграция MS3: валидация/нормализация адреса, маппинг полей; событие mxdadata:order-address-updated для сторонних виджетов (например доставок) после обновления адреса
• Сниппеты: mxDadataAddressSuggest, mxDadataPartySuggest, mxDadataForm; скрипты address-suggest.js, party-suggest.js, dadata-form.js
• Чанк заказа tpl.mxdadata.msOrder с демо-панелью подсказок при непустой корзине; тестовый чанк JSON для QA — chunk.mxdadata.demoFormSugTest
• Админка на Vue 3 и PrimeVue: дашборд, настройки, API, кэш, логи, Party, мини-раздел MiniShop3

🛒 Связка с MiniShop3

• В системных настройках namespace mxdadata задаются токен, секрет (для Party), режимы кэша/логов и др. (mxdadata_*)
• Оформление заказа: чанк tpl.mxdadata.msOrder + сниппеты подсказок по документации; универсальная форма — отдельно через mxDadataForm и JSON
• Службы доставки (в т.ч. msRussianPost на modstore) можно подписать на обновление адреса через событие mxdadata:order-address-updated

📌 На что обратить внимание

• Без токена DaData публичные подсказки и Clean не заработают — для Party/FindById нужен секрет в настройках

📷 Скриншоты








📋 Требования

• MODX Revolution 3.0+ (версия 2.x не поддерживается)
• PHP 8.2+
• MiniShop3 3.x (для сценариев заказа и чанка tpl.mxdadata.msOrder)
• VueTools (для UI в менеджере)
• Scheduler (опционально) — фоновая ротация логов

Документация по компоненту: mxDadata.

Официальные материалы DaData: dadata.ru — тарифы, лимиты и условия использования API.