Диагностика

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

Панель CommerceBridge 1C содержит:

• историю сеансов обмена;
• количество файлов и обработанных объектов;
• количество ошибок;
• краткое итоговое сообщение;
• просмотр и очистку файла журнала.

Основной журнал компонента:

core/cache/logs/commerceml.log

Критические ошибки также могут попадать в журнал MODX:

core/cache/logs/error.log

Режим отладки

Включите commerceml_debug, повторите минимальный проблемный обмен и сохраните относящийся к нему фрагмент журнала. После диагностики отключите режим: он записывает запросы и каждую обработанную сущность.

Не передавайте в поддержку пароли, ключи API, cookie и персональные данные покупателей.

Не проходит авторизация

Проверьте:

1. URL заканчивается на /assets/components/CommerceBridge1C/connector.php;
2. логин совпадает с commerceml_username;
3. пароль был задан через панель компонента;
4. запрос доходит до PHP с заголовком Authorization;
5. прокси или CDN не удаляет Basic Auth;
6. endpoint доступен по HTTPS без циклических редиректов.

Если пароль неизвестен, задайте новый в панели CommerceBridge 1C и обновите узел обмена в 1С.

Предложение ссылается на неизвестный товар

Сообщение означает, что товар с указанным GUID ещё не связан с ресурсом MODX.

Основные причины:

• 1С отправила offers.xml раньше import.xml;
• идентификаторы товара в каталоге и предложениях отличаются;
• товар исключён настройкой commerceml_product_ids;
• категория исключена настройкой commerceml_category_ids;
• предыдущий импорт каталога завершился ошибкой.

Сначала выполните полный импорт каталога, затем повторите импорт предложений.

Артикул пустой

Компонент использует следующий порядок:

1. артикул из CommerceML;
2. код товара 1С;
3. штрихкод.

Если все три значения отсутствуют, поле article останется пустым.

Не обновились цена или остаток

Проверьте:

• предложение связано с товаром по GUID;
• нужный склад включён в commerceml_warehouse_ids;
• GUID основной цены соответствует commerceml_primary_price_id;
• offers.xml содержит цену и количество;
• в журнале нет ошибок сохранения товара.

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

Не появились дополнительные цены

Убедитесь, что включена commerceml_create_price_tvs, а в CommerceML передано несколько типов цен.

TV создаётся во время синхронизации и привязывается к шаблону импортируемого товара. Очистите кеш MODX и повторно откройте товар после первого импорта.

Нет изображения или миниатюры

Проверьте:

• расширение файла входит в список разрешённых изображений;
• Media Source существует и доступен на запись;
• GD или Imagick установлены;
• конфигурация миниатюр miniShop3 корректна;
• PHP и веб-сервер разрешают размер загружаемого файла.

PDF, XLS, DOC и другие документы намеренно не импортируются как изображения.

Ошибка загрузки большого ZIP

Согласуйте ограничения на всех уровнях:

• commerceml_max_file_size;
• commerceml_file_limit;
• upload_max_filesize и post_max_size в PHP;
• client_max_body_size в nginx;
• лимиты прокси или CDN.

Автоматическая загрузка поддерживает передачу файла частями. Не очищайте core/cache/commerceml/ во время активного обмена.

Категория или товар скрылись

Проверьте настройки:

• commerceml_publish_by_stock;
• commerceml_hidemenu_by_stock;
• commerceml_hide_empty_categories.

Отключите спорную настройку, повторите offers.xml и проверьте результат на тестовом товаре.

Не меняется статус заказа

Проверьте, что:

• включена commerceml_auto_order_status;
• название статуса 1С присутствует в сопоставлении;
• справа указан существующий ID статуса miniShop3;
• переход между текущим и новым статусом разрешён miniShop3.

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

Данные для обращения в поддержку

Подготовьте:

• версии MODX, miniShop3, PHP и CommerceBridge 1C;
• название и версию конфигурации 1С;
• дату и время проблемного сеанса;
• краткий итог обмена;
• небольшой обезличенный XML, на котором воспроизводится ошибка;
• фрагмент commerceml.log за этот сеанс.