FAQ

Краткие ответы. Справочник всех name полей формы и сценарий демо — в Подключение на сайте (таблицы полей, демо-чанк). Пошаговая установка — Быстрый старт, админка — Админка в MODX.

Подсказки не появляются

1. Заполнены mxdadata_api_token (и Secret для Clean/Party).
2. mxdadata_enabled = «Да».
3. Сниппет вызван некэшированно ([[!…]] или Fenom !snippet).
4. Селектор поля совпадает с разметкой: задайте input для адреса / innInput для ИНН.
5. Во вкладке Network запросы к connector-web.php возвращают JSON без 403/500, а баланс DaData не исчерпан.
6. Поле для подсказки уже в DOM в момент инициализации скрипта (порядок сниппетов и AJAX-вставка формы).

429, лимиты и баланс DaData

• HTTP 429 (Too Many Requests) — превышен лимит запросов к DaData или внутренняя защита: увеличьте mxdadata_throttle_rpm только осознанно, проверьте, что с одной страницы не срабатывают лишние вызовы (дубли сниппетов, автокомплит в цикле).
• Баланс — в личном кабинете и на Dashboard в Extras → mxDadata. Исчерпание квоты DaData тоже даёт отказы — смотрите Network и Логи.
• Рост нагрузки: кэш в mxdadata_cache снижает повторы. При пиках трафика согласуйте тариф с условиями DaData.

«Payment is not configured» / ошибки не о том

Такой текст относится к платёжным модулям, не к mxDadata. Ищите в ответе API и в логе MODX строки с mxDadata / DaData.

Заказ не создаётся после подсказки

Проверьте mxdadata_strict_validation, mxdadata_block_order_on_error, обязательный FIAS / индекс на вкладке miniShop3 или в системных настройках. Временно ослабьте настройки и повторите тест. Сообщение об ошибке приходит в ответе JSON API оформления заказа.

Админка не открывается

Установите VueTools. На витрину это не влияет.

Логи раздуваются

В Extras → mxDadata → Логи доступны фильтры по типу запроса, статусу и дате, просмотр пары request/response в модальном окне и ротация записей старше N дней (по mxdadata_log_retention_days).

В проде держите mxdadata_log_level = error или warning. Ротацию настройте вручную или через Scheduler, если пакет установлен. Срок хранения уменьшайте по mxdadata_log_retention_days, если таблица растёт.

Нужна универсальная форма без MS3

Сниппет mxDadataForm с suggestions или suggestionsChunk — см. mxDadataForm. В Fenom для большого JSON удобнее чанк с чистым JSON, чем длинный inline. В шаблонах с {extends} / {block} чаще передают suggestionsChunk, чтобы JSON не «терялся» при рендере.

Нужен список полей name и демо

См. Имена полей формы MiniShop3 и Демо чанка на той же странице.