Как самостоятельно провести диагностику и решить проблему с модулями экспорта

Уважаемый пользователь! Прежде чем писать в техническую поддержку, воспользуйтесь этим пошаговым руководством. Статистика показывает, что 80% проблем решаются самостоятельно на первых двух этапах диагностики. Это сэкономит ваше время и поможет быстрее запустить выгрузку.

Если остаток на Ozon не совпадает с сайтом, сразу откройте Остатки Ozon не как на сайте (превью, Stocks (V2), updated, архив). Ниже — общая диагностика для всех площадок.

Блок 1. Первичная диагностика

Шаг 1. Проверьте версии модулей

Самая частая причина проблем — устаревшие версии и не установленные обновления самого модуля, а также модуля служебных инструментов.

Что проверить:

• Установлены ли последние обновления для основного модуля экспорта (например, acrit.exportproplus)?
• Установлены ли последние обновления для служебного модуля acrit.core?

Где смотреть: Админка → Marketplace → Обновления решений. В разделе «Установленные решения» модуль должен числиться активным и не требовать продления, иначе часть функционала не будет работать.

Шаг 2. Проверьте токены и ключи доступа (Wildberries, Ozon, ВК)

Ошибки авторизации — вторая по популярности причина сбоев.

Что проверить для Wildberries:

1. Срок действия токена: токены WB имеют ограниченный срок жизни.
2. Права доступа: у токена должны быть подключены все необходимые возможности: Контент (карточки), Цены и скидки, Маркетплейс (остатки).
3. Как проверить: в настройках профиля нажмите кнопку «Проверить» рядом с полем токена.

Что проверить для Ozon:

• Корректность Client ID и API Key.
• Нажмите кнопку «Проверить доступ» в настройках профиля.

Блок 2. Лог и история выгрузки

Шаг 3. Анализируем логи профиля

Лог — главный источник информации о том, что пошло не так.

Как открыть лог:

1. Перейдите в нужный профиль выгрузки.
2. Откройте вкладку «Лог и история» (или нажмите Alt+L).

Что искать в логе:

• Красные строки — прямые указания на ошибки (например, ошибка выгрузки остатков, product not found).
• Жёлтые предупреждения — информационные сообщения, которые могут быть и не ошибками.

Важно! Отличайте ошибки от информационных сообщений. Например, сообщение от Wildberries «The specified prices and discounts are already set» — это не ошибка, а уведомление о том, что вы отправляете те же данные, что и в прошлый раз. Модуль не может обновить то, что не изменилось.

Для API-площадок (Ozon, WB, Маркет) включите «Режим отладки для данного профиля», нажмите «Применить» и сделайте один прогон. Глобальная отладка в настройках модуля для этого не нужна и засоряет логи других профилей. После разбора галку снимите.

Шаг 4. Изучаем историю задач (для Ozon и других API)

История задач показывает, ушли ли данные на площадку.

Где смотреть: вкладка «История задач» внутри профиля (у Ozon — список задач внизу «Лог и история»).

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

• Если ID задачи = 0, а выгружаются только цены и остатки — это нормально. Полноценная задача создаётся только при выгрузке карточки товара.
• Если задача есть, но статус «Ошибка» — изучите текст ошибки в деталях задачи.

Блок 3. Поля, значения, предпросмотр

Шаг 5. Используйте предпросмотр (Alt+F)

Предпросмотр — ваш лучший друг при настройке профиля. Он показывает, что именно модуль «видит» в товаре и какие данные собраны на сайте. Это позволяет проверить заполнение полей до реального прогона.

Как открыть предпросмотр:

• Нажмите в профиле кнопку «Предпросмотр выгрузки» / «Проверить выгрузку».
• Или используйте горячую клавишу Alt+F — это откроет предпросмотр для первого подходящего товара.
• Кроме того, предпросмотр доступен в карточке каждого товара, если диагностику надо по конкретному товару.

Что проверять в предпросмотре:

1. Зелёная лампочка — товар будет выгружаться.
2. Жёлтая лампочка — товар не подходит под условия фильтра (проверьте настройки фильтра и категорий).
3. Соответствие данных: те ли названия, цены, картинки и атрибуты собираются, которые вы ожидаете.

Как было написано ранее: «какие данные будут отправлены на площадку». Для файловых фидов (YML и т.п.) это близко к правде. Для API (Ozon, WB, Маркет) превью ≠ отправка: нули в «Проверить выгрузку» сами на склад не уходят, пока не будет прогона и строки в логе. Разбор остатков Ozon — в отдельной статье.

Шаг 6. Разберитесь с настройками «Поля» и «Значения»

Очень частая путаница возникает из-за непонимания, где применять настройки: в значении или в поле.

Запомните правило:

• Значение (левая шестерёнка) — это то, откуда берутся данные (конкретное свойство товара, цена, текст).
• Поле (правая шестерёнка) — это контейнер, который объединяет одно или несколько значений и отправляет их на площадку.

Когда применять настройки в ЗНАЧЕНИИ:

• Когда нужно изменить регистр только для одного конкретного свойства (например, бренд привести к верхнему регистру, а название оставить как есть).
• Когда нужно использовать «чистое» значение (ID элемента, а не его название).
• Когда нужно применить схему выборки для конкретного множественного свойства (например, выбрать только 2-ю и 3-ю картинки).

Когда применять настройки в ПОЛЕ:

• Когда нужно применить действие ко всему результату сразу (например, удалить HTML-теги из всего описания, которое собрано из нескольких свойств).
• Когда нужно заменить спецсимволы во всём тексте поля.
• Когда нужно объединить несколько значений с правильным разделителем.

Шаг 7. Проверьте множественные значения (для картинок, размеров)

Если у вас не выгружаются все картинки или размеры, проблема чаще всего в настройках множественности.

Как должно быть настроено для картинок:

1. В поле «Изображения» должно быть несколько значений (например, «Детальная картинка» и «Картинки галереи»).
2. В настройках поля (шестерёнка справа от названия поля) в опции «Режим множественных значений» должно быть выбрано «Оставить множественным».
3. В настройках значения «Картинки галереи» (шестерёнка слева от этого значения) также должно быть выбрано «Оставить множественным».

Если этого не сделать, то все картинки из галереи склеятся в одну строку через запятую.

Шаг 8. Проверьте математические формулы (если используете)

Если вы пытаетесь увеличить цену на процент или применить сложную формулу, а цена выгружается пустой или некорректной:

1. Убедитесь, что в формуле используются корректные макросы (например, {=prices.CATALOG_PRICE_1}).
2. Проверьте, что в настройках значения или поля включена опция «Использовать как математическую формулу».
3. Если формула сложная, попробуйте включить опцию «Использовать php-функцию eval».
4. В предпросмотре проверьте, какие значения подставляются в формулу (не пустые ли они).

Блок 4. Фильтрация товаров

Шаг 9. Почему не выгружается ни одного товара?

Модуль отбирает товары только по двум критериям: категория и фильтр.

Алгоритм проверки:

1. Категории: перейдите на вкладку «Категории». Убедитесь, что выбраны нужные разделы инфоблока и правильно настроен режим (только выбранные / с подразделами).
2. Фильтр: перейдите на вкладку «Фильтр товаров». Проверьте логику фильтра: «все» (И) или «любое» (ИЛИ). Проверьте каждое условие. Возможно, одно из условий жёстко ограничивает выборку (например, Количество > 10, а у всех товаров количество = 5).
3. Фильтр по торговым предложениям: помните, что фильтр на вкладке «Фильтр товаров» фильтрует только товары. Если нужно отфильтровать конкретные торговые предложения (например, только красные размеры), настраивайте фильтр и на вкладке «Настройки ТП».

Блок 5. Инфраструктура

Шаг 10. Почему не работает выгрузка по расписанию и в фоне?

Наиболее частая причина — неверно указан путь к PHP в настройках служебного модуля acrit.core.

Что делать:

1. Перейдите в настройки служебного модуля.
2. Проверьте поле «Путь до PHP (интерпретатора)».
3. Если вы не знаете точный путь, обратитесь в техподдержку хостинга и запросите корректный путь для запуска скриптов из командной строки.
4. После указания пути проверьте работу многопоточной выгрузки или автозапуска.

Чек-лист перед обращением в поддержку

Если вы выполнили все шаги, но проблема не решена, подготовьте максимум информации. Это ускорит ответ.

1. Название профиля, с которым возникает проблема.
2. ID товара (или ссылку на товар в админке), на котором ошибка воспроизводится.
3. Скриншот ошибки или текст из лога профиля (вкладка «Лог и история»). Для Ozon — фрагмент с Stocks (V2) / updated, если речь об остатках.
4. Скриншот предпросмотра (Alt+F) для этого товара.
5. Информацию о версиях модулей (основного и служебного).
6. Краткое описание того, что вы уже сделали для диагностики.

Спасибо, что пользуетесь нашими модулями!

Назад в раздел