Частые вопросы

Как пользоваться разделом

Ниже собраны типовые ситуации, с которыми сталкиваются пользователи модуля. Если ни один вариант не помог — включите логирование и пришлите лог в техподдержку: modul@ipromo.ru.

Подключение к Bitrix24

«URL вебхука не может быть пустым»

Поле «URL вебхука Bitrix24» пустое. Получите URL в Bitrix24: Настройки → Разработчикам → Вебхуки → Создать вебхук.

«Webhook должен использовать HTTPS»

Указан HTTP-адрес. Bitrix24 принимает только HTTPS. Замените протокол в URL.

«Webhook не может указывать на IP-адрес»

Указан IP вместо домена. Используйте адрес портала Bitrix24, например https://ваш-портал.bitrix24.ru/rest/1/xxxxx/.

«Webhook не может указывать на приватный IP-адрес»

Это защита от SSRF. Адрес попадает в приватный диапазон (10.x, 172.x, 192.168.x, 127.x и т. п.). Укажите публичный домен Bitrix24.

«URL вебхука должен содержать путь /rest/»

Скопирован неполный URL. Адрес вебхука Bitrix24 всегда содержит сегмент /rest/. Скопируйте значение целиком из карточки вебхука.

«Ошибка при тестировании соединения»

Проверьте:

• у вебхука есть права crm и user;
• портал Bitrix24 доступен с сервера;
• URL сохранён в настройках модуля.

«Код ошибки: …» при проверке соединения

Это ответ API Bitrix24. Расшифровку кода можно найти в документации Bitrix24. Частые причины: нет прав у вебхука, истёк токен, неверный портал.

Настройки

«Размер партии должен быть от 1 до 100»

Значение вышло за границы. Поставьте число от 1 до 100. Оптимально:

• до 500 товаров — 10–20;
• 500–5000 — 30–50;
• больше 5000 — 50–100.

«Выберите инфоблок по умолчанию»

Не выбран инфоблок-источник. Откройте «Настройки» и выберите инфоблок из списка.

«Не удалось инициализировать каталог и корневой раздел в Bitrix24»

Вебхук не может создать корневой раздел в CRM Bitrix24. Пересоздайте вебхук, убедившись, что включено право crm.

Экспорт

Экспорт не запускается

Проверьте:

• сохранён ли URL вебхука;
• выбран ли инфоблок по умолчанию;
• пройдена ли проверка соединения — должна показать «Соединение успешно установлено»;
• не активен ли демо-режим с исчерпанным лимитом.

Экспорт прерывается на середине

Посмотрите лог в «Журнале событий». Типовые причины:

• таймаут запроса к Bitrix24 — уменьшите размер партии;
• ошибка сети — проверьте соединение с порталом;
• превышен лимит API Bitrix24 — увеличьте интервал или уменьшите партию.

Экспортируются только 3 товара

Включён режим отладки. Он специально ограничивает выгрузку первыми 3 товарами. Отключите отладку в настройках.

Экспортируются только 25 товаров

Активен демо-режим. Лимит — 25 товаров до покупки лицензии.

Все товары выгружаются повторно при каждом запуске

Так работает полная синхронизация. Если нужно выгружать только изменённые товары — включите «Автоматический экспорт при изменении» и отключите «Автоматическую синхронизацию».

Остановил экспорт — как начать заново

Нажмите «Сбросить прогресс» на странице «Экспорт товаров» и подтвердите действие. После этого можно запустить выгрузку с нуля.

Автоматизация

Автоматический экспорт не срабатывает при изменении товара

Проверьте:

• включена ли опция «Автоматический экспорт при изменении» в настройках;
• работает ли агент «Обработчик очереди» в разделе «Экспорт товаров» — статус, последний запуск;
• включены ли агенты в главном модуле Битрикса;
• есть ли ошибки в «Журнале событий» по этому товару.

Периодическая синхронизация не запускается

Проверьте агент «Синхронизация» в блоке «Статус агентов». Если статус «Неактивен» — включите агенты в главном модуле Битрикса или пересоздайте агент через раздел «Настройки».

Следующий запуск агента в прошлом

Агент не отрабатывает. Проверьте, что на хостинге работает cron или встроенный агент Битрикса. Нажмите «Обновить статус» — модуль перечитает данные.

Логирование

Где посмотреть логи

Раздел «Журнал событий» в меню модуля. При включённом логировании записываются все запросы и ответы API, процесс создания разделов и товаров. При выключенном — только ошибки и критические события.

Логи быстро растут

Включено детальное логирование. После настройки модуля отключите его в разделе «Настройки» — так снижается нагрузка на систему.

В логах «Ошибка сети»

Модуль не смог обратиться к порталу Bitrix24. Проверьте:

• исходящие соединения по HTTPS с сервера;
• доступность домена портала curl -I https://ваш-портал.bitrix24.ru/;
• не блокирует ли фаервол хостинга запросы к внешним адресам.

Демо-режим

«Демо-период истёк»

Закончился демонстрационный период или исчерпан лимит в 25 товаров. Для продолжения работы приобретите полную версию модуля. Контакты — на странице модуля в Маркетплейс.

«Включён демо-режим. Осталось дней: N»

Демо-период активен. Ограничения: 25 товаров, 3 дня. Все функции модуля доступны в полном объёме, но не более лимита.

Как отключить демо-режим

Оформите покупку модуля на Маркетплейс, активируйте лицензию — демо-режим снимется автоматически.

Куда обращаться

Если проблему не удалось решить самостоятельно:

• Email: modul@ipromo.ru
• Часы работы: Пн–Пт, 10:00–19:00 (MSK, UTC+3)
• Ответ направляется в течение одного рабочего дня.

В письме укажите:

1. Версию модуля.
2. Версию 1С-Битрикс и PHP.
3. Описание проблемы и шаги воспроизведения.
4. Фрагмент журнала событий (при включённом логировании).
5. ID товара или раздела, если проблема с конкретной записью.