Решения

Зачем это нужно

Чтобы товары, цены, остатки и заказы обменивались с Яндекс.Маркетом без ручного запуска, модуль использует два механизма:

Агенты Bitrix — встроенный планировщик Битрикса. Простой вариант, не требует настройки хостинга.
Задания Cron — системный планировщик на сервере. Точный, стабильный, подходит для больших каталогов.

Расписание создаётся отдельно для каждого профиля или задачи. Управление — в разделе АйПромо. Яндекс.Маркет → Агенты и cron.

Вкладка «Агенты Bitrix»

Показывает все агенты, созданные модулем.

Колонка	Значение
ID	Идентификатор агента в Битриксе.
Имя агента	Техническое имя класса и метода, например `\Ipromoagency\YaMarket\CatalogExport::UpdateCatalog(51);` или `\Ipromoagency\YaMarket\Main::RunAgent(1);`.
Профиль	К какому профилю или задаче привязан агент. Например, «[1] Остатки товаров» — профиль, либо «—» для задач каталога.
Следующий запуск	Дата и время следующего срабатывания. Формат: `2026-10-10 11:49:56`.
Интервал (сек.)	Периодичность в секундах: `7200` = 2 часа, `86400` = 24 часа.
Статус	● Активен — агент работает. ● Неактивен — срабатывания не происходят.
Последний запуск	Дата и время последнего срабатывания. «—» означает, что агент ещё не запускался.
Действия	Кнопки «Запустить», «Остановить», «Удалить».

Действия над агентом

Запустить — активировать агент. Подтверждение: «Запустить агент?».
Остановить — деактивировать без удаления. Подтверждение: «Остановить агент?».
Удалить — полностью убрать агент. Подтверждение: «Удалить агент?».

Типы агентов модуля

Класс	Что делает
`Main::RunAgent`	Обмен по профилю: цены, остатки, экспорт товаров.
`CatalogExport::UpdateCatalog`	Полная синхронизация каталога: товары, характеристики, категории.

Вкладка «Задания Cron»

Показывает задания, созданные через системный планировщик. Если заданий нет — выводится сообщение «Нет заданий Cron».

Колонка	Значение
Расписание	Cron-выражение, например `0 /6 * *`.
Расшифровка	Человекочитаемое описание: «Ежедневно», «Каждые 6 часов» и т. п.
Профиль	Профиль, к которому привязано задание.
PHP	Путь к интерпретатору PHP на сервере. Проверяется автоматически: «найден» или «НЕ найден».
Лог	Файл лога задания. Если ещё не создавался — «лог ещё не создавался».
Действия	Кнопка «Удалить».

Настройка расписания

Расписание создаётся из формы профиля — кнопка «Настроить расписание». Открывается попап с выбором типа:

Агент Bitrix

Поле	Описание
Следующий запуск	Дата и время первого срабатывания.
Интервал (сек.)	Варианты: 5 мин (300 сек) 15 мин (900 сек) 30 мин (1800 сек) 1 час (3600 сек) 2 часа (7200 сек) 6 часов (21600 сек) 12 часов (43200 сек) 24 часа (86400 сек)

Задание Cron

Поле	Описание
Периодичность	Ежедневно / Каждые N часов / Произвольное (для экспертов).
Время запуска	Часы (0–23) : Минуты (0–59) — для ежедневного варианта.
Запускать каждые	N часов (1–23) — для варианта «Каждые N часов».
Cron-выражение	Для режима эксперта. Формат: `минуты часы день_месяца месяц день_недели`. Пример: `/15 * * *` — каждые 15 минут.
Путь к PHP	Путь к интерпретатору на сервере. Подставляется автоматически; если PHP не найден, поле нужно заполнить вручную.

Что выбрать: агент или Cron

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

Рекомендация. Если модуль уже создал агента для того же профиля, при сохранении нового расписания старое будет перезаписано. Уведомление: «При сохранении существующее расписание будет перезаписано».

Логи и диагностика

Лог Cron — файл в директории модуля. Ссылка из таблицы заданий. Если файла нет — задание ещё не запускалось.
Журнал событий модуля — отдельный раздел «Журнал событий». Показывает старт и конец работы агентов, экспорт каталога, ошибки API.
Режим отладки — включается в настройках модуля. Без него журнал событий недоступен.