Решения

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

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

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

«Не подключена библиотека CURL»

В PHP на сервере отключено расширение curl. Обратитесь к хостингу — нужно включить расширение. Без него модуль не сможет обращаться к API Яндекс.Маркета.

«Не указаны настройки подключения. Заполните ID кампании и API ключ»

В настройках модуля не заполнено одно из полей:

ID кампании — числовой идентификатор кампании в кабинете Яндекс.Маркета.
API ключ — токен авторизации из раздела «API и модули → Токены авторизации».

«Не удалось определить ID кабинета»

ID кампании указан неверно, либо у токена нет доступов к этой кампании. Проверьте ID в кабинете Маркета и убедитесь, что токен выдан для нужного магазина.

«Ошибка подключения к Яндекс.Маркет»

Возможные причины:

сервер не может достучаться до api.partner.market.yandex.ru — проверьте исходящие соединения и фаервол;
токен отозван или истёк — выпустите новый в кабинете;
у токена недостаточно прав — должны быть доступы:
- Обработка заказов и учёт товаров;
- Просмотр информации о заказах;
- Управление товарами и карточками;
- Просмотр товаров и карточек;
- Управление ценами;
- Просмотр цен.

Как проверить соединение

В настройках модуля нажмите «Проверить соединение». При успехе появится «Подключение успешно». При ошибке — текст с причиной.

Экспорт каталога

Товары не выгружаются

Модуль всегда пишет причину пропуска в лог. Включите режим отладки и откройте «Журнал событий». Типовые сообщения и что делать:

Сообщение в логе	Что делать
«раздел #SECTION_ID# не привязан к категории Яндекс.Маркета»	Настройте маппинг категорий на странице «Настройка категорий экспорта».
«не удалось получить offerId»	Проверьте настройку «Идентификатор товаров (offer_id)» — выбранное поле должно быть заполнено у всех товаров.
«цена не задана (поле #PRICE_FIELD#)»	В профиле экспорта выбрана цена, которая не заполнена у товара. Проверьте тип цены или свойство.
«итоговая цена равна нулю»	Цена товара после наценки/акции обнулилась. Проверьте настройки цен в профиле.
«Товар #ID# пропущен: пустой offerId или basicPrice»	То же — проверьте offer_id и цену.

«Инфоблок не выбран»

В настройках модуля не указан каталог товаров. Откройте настройки и выберите инфоблок.

Экспорт идёт слишком долго

Возможные причины и решения:

Слишком много категорий в профиле — разделите выгрузку на несколько профилей по категориям.
Большие изображения — модуль выгружает их в Маркет, это занимает время. В настройках синхронизации можно включить «Не обновлять изображения» — тогда при повторных выгрузках они не будут перезаливаться.
Слишком частый интервал агента — увеличьте интервал в разделе «Агенты и cron», чтобы выгрузки не накладывались друг на друга.
Ошибки чанков — в логе будут строки «Чанк #CHUNK#: #MESSAGE#». Если ошибка повторяется, пришлите лог в техподдержку.

«Ошибка фильтрации товаров»

Условия фильтра в профиле исключают все товары. Откройте профиль и проверьте блок «Фильтр элементов для экспорта на Яндекс.Маркет»:

убедитесь, что логика «все условия / любое из условий» выбрана верно;
проверьте значения и операторы в каждом условии;
временно уберите условия и запустите экспорт повторно.

«Экспорт уже выполняется»

Предыдущая выгрузка не завершилась. Дождитесь её окончания или проверьте в разделе «Агенты и cron», не завис ли агент. Если агент висит — остановите его и запустите заново.

Лог пустой

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

Импорт заказов

Заказы не приходят

Проверьте по порядку:

Включён ли импорт заказов на странице «Импорт заказов».
Работает ли агент — откройте «Агенты и cron», убедитесь, что статус «Активен» и есть отметка последнего запуска.
Если используется режим API-уведомлений — включены ли они в кабинете Яндекс.Маркета.
Есть ли ошибки в журнале событий.
Запустите ручной импорт кнопкой «Выполнить импорт сейчас» — если заказы появились, значит проблема в агенте или вебхуке.

Заказы дублируются

Включите опцию «Отправлять номер заказа из Битрикс в Яндекс.Маркет» на вкладке «Автоматические действия». После создания заказа модуль сообщит Маркету его ID, и повторный импорт не создаст дубль.

Статусы заказов не меняются

Заполните таблицу «Сопоставление статусов». Если для статуса Маркета не задан соответствующий статус Битрикса — заказ остаётся в текущем состоянии.

Доставка и оплата в заказе — «по умолчанию»

Для типа доставки или способа оплаты Маркета не найдено соответствие. Заполните таблицы «Типы доставок Яндекс.Маркета» и «Сопоставление способов оплаты».

Заказ создан без товаров или с нулевой суммой

Скорее всего, товары из заказа не сопоставлены с товарами каталога по offer_id. Проверьте настройку «Идентификатор товаров (offer_id)» и убедитесь, что значения в каталоге совпадают с теми, что уходят в Маркет.

«Ошибка импорта заказа #ORDER_ID#: #ERROR#»

Конкретная ошибка по конкретному заказу. Причины: не хватает обязательных полей, некорректный адрес, не найдена служба доставки. Пришлите лог в техподдержку с указанием ID заказа.

Уведомления о смене статуса не приходят

Проверьте:

включён ли чекбокс «Уведомлять при изменении статуса»;
работает ли отправка почты на сайте (тестовое письмо из настроек главного модуля);
есть ли адрес получателя в настройках.

Возвраты

Возврат не отражается в заказе

Проверьте, что импорт заказов работает и что статус RETURNED сопоставлен в таблице статусов. Модуль добавляет в заказ комментарий с типом возврата и (при включённой опции) автоматически отменяет заказ.

Заказ не отменяется при возврате

Включите опцию «Автоматически отменять заказ при возврате» на вкладке «Автоматические действия».

Агенты и Cron

Агенты не запускаются

Проверьте:

включены ли агенты в настройках главного модуля: Настройки → Настройки продукта → Настройки модулей → Агенты;
статус агента в разделе «Агенты и cron» — должен быть «Активен»;
есть ли отметка последнего запуска;
если используется Cron — работает ли он на хостинге (проверьте в панели хостинга).

Задание Cron не создаётся

Причины:

не найден путь к PHP — укажите его вручную, например /usr/bin/php;
некорректное cron-выражение в режиме эксперта — проверьте синтаксис: минуты часы день_месяца месяц день_недели;
нет прав на запись в файл crontab — обратитесь к хостингу.

PHP «НЕ найден» в таблице Cron

Модуль не смог автоматически определить путь к интерпретатору. Укажите полный путь вручную — обычно это /usr/bin/php, /usr/local/bin/php или /opt/php/bin/php.

Лог Cron не создаётся

Задание ещё ни разу не запускалось. Дождитесь первого срабатывания по расписанию либо запустите задание вручную через панель хостинга.

Какой интервал выбрать

Каталог	Рекомендация
до 1000 товаров	Агент Bitrix с интервалом 2–6 часов
1000–10000 товаров	Агент с интервалом 1 час или Cron ежечасно
больше 10000 товаров	Только Cron, ночной запуск
Часто меняющиеся остатки	Агент или Cron каждые 15–30 минут

Логи и отладка

Где включить режим отладки

В настройках модуля — чекбокс «Включить отладку?». Пока он выключен, журнал событий недоступен: модуль показывает сообщение «Журнал событий доступен только при включённой отладке».

Где смотреть журнал

Раздел «Журнал событий» в меню модуля. Записи можно фильтровать по типу, сообщению, ID пользователя и дате. Типы записей:

Информация, Предупреждение, Ошибка, Критическая ошибка, Отладка;
Экспорт каталога, Экспорт профиля, Импорт заказов, Экспорт заказов;
API, Вебхук, Уведомления, Производительность, Безопасность, Система.

«Демо-режим модуля истёк»

Закончился демонстрационный период. Приобретите лицензионный ключ и активируйте его — после этого все функции модуля возобновятся.

«Лицензия модуля недействительна»

Обратитесь к разработчику за актуальной версией лицензии: modul@ipromo.ru.

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

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

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

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

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