CommerceBridge 1C
Обмен каталогом, ценами, остатками и заказами между 1С и miniShop3 по CommerceML 2
Системные настройки
Основные параметры доступны в панели Компоненты → CommerceBridge 1C. Те же значения можно найти в системных настройках MODX по префиксу commerceml_.
После ручного изменения системных настроек очистите кеш MODX.
Подключение и размещение каталога
| Ключ | По умолчанию | Назначение |
|---|---|---|
commerceml_username | exchange | Логин HTTP Basic Auth для 1С |
commerceml_password_hash | Пусто | Хеш пароля обмена; не записывайте сюда открытый пароль вручную |
commerceml_catalog_parent | 0 | ID родительского ресурса каталога |
commerceml_product_template | 0 | ID шаблона новых товаров |
commerceml_category_template | 0 | ID шаблона новых категорий |
commerceml_context | web | Контекст создаваемых ресурсов |
commerceml_source_id | 1 | ID Media Source изображений miniShop3 |
commerceml_published_default | Да | Публиковать новые объекты по умолчанию |
Пароль следует изменять только через панель CommerceBridge 1C. Компонент проверяет формат логина и сохраняет результат password_hash().
Файлы и ограничения обмена
| Ключ | По умолчанию | Назначение |
|---|---|---|
commerceml_max_file_size | 268435456 | Максимальный размер входящего файла в байтах |
commerceml_file_limit | 10485760 | Размер части файла, объявляемый 1С, в байтах |
commerceml_cleanup_days | 7 | Срок хранения временных данных обмена |
Фактический размер загрузки дополнительно ограничивается настройками PHP и веб-сервера: upload_max_filesize, post_max_size, client_max_body_size или их аналогами.
Отбор данных
| Ключ | По умолчанию | Назначение |
|---|---|---|
commerceml_warehouse_ids | Пусто | GUID складов через запятую; пусто — суммировать все склады |
commerceml_category_ids | Пусто | GUID разрешённых категорий; пусто — все категории |
commerceml_product_ids | Пусто | GUID разрешённых товаров; пусто — все товары |
GUID указываются через запятую. Пробелы удаляются при сохранении, повторяющиеся значения исключаются.
Цены
| Ключ | По умолчанию | Назначение |
|---|---|---|
commerceml_primary_price_id | Пусто | GUID типа цены для поля price; пусто — первая цена предложения |
commerceml_create_price_tvs | Да | Создавать TV для дополнительных типов цен |
TV дополнительных цен создаются с короткими именами на основе названия типа цены и привязываются к шаблону импортированного товара.
Публикация и остатки
| Ключ | По умолчанию | Назначение |
|---|---|---|
commerceml_publish_by_stock | Нет | Снимать товар с публикации при нулевом остатке |
commerceml_hidemenu_by_stock | Нет | Устанавливать hidemenu товару без остатка |
commerceml_hide_empty_categories | Нет | Снимать с публикации категории без товаров |
Настройки публикации применяются во время обработки торговых предложений. Перед включением проверьте поведение на тестовой категории.
Заказы
| Ключ | По умолчанию | Назначение |
|---|---|---|
commerceml_order_statuses | Пусто | ID статусов miniShop3 для выгрузки; пусто — без ограничения |
commerceml_order_status_map | Пусто | Соответствие названий статусов 1С и ID miniShop3 |
commerceml_auto_order_status | Нет | Автоматически применять входящие статусы 1С |
commerceml_order_limit | 100 | Максимальное количество заказов в одном ответе |
Подробнее см. раздел Заказы и статусы.
Журнал
| Ключ | По умолчанию | Назначение |
|---|---|---|
commerceml_debug | Нет | Записывать подробности запросов и обработанных сущностей |
Обычный режим записывает начало и итог обмена, предупреждения и ошибки. Режим отладки заметно увеличивает объём файла core/cache/logs/commerceml.log, поэтому после диагностики его следует отключить.