CommerceBridge 1C
Обмен каталогом, ценами, остатками и заказами между 1С и miniShop3 по CommerceML 2
- MODX 3
- PHP 8.2
- miniShop3
Настройка обмена с 1С
Названия разделов в интерфейсе 1С зависят от конфигурации. Используйте штатный узел обмена с сайтом по протоколу CommerceML 2.
Параметры подключения
Укажите в 1С:
| Параметр | Значение |
|---|---|
| Адрес сайта | https://example.ru/assets/components/CommerceBridge1C/connector.php |
| Пользователь | Логин из настроек CommerceBridge 1C |
| Пароль | Пароль из настроек CommerceBridge 1C |
| Протокол | CommerceML 2 |
Сначала выполните штатную команду проверки соединения. После успешной авторизации настройте состав выгрузки.
Первый обмен
Рекомендуемый порядок:
- включите режим отладки в CommerceBridge 1C;
- ограничьте выгрузку одной категорией и несколькими товарами;
- выполните полную выгрузку каталога и предложений;
- проверьте категории, шаблоны, артикулы, цены, остатки и изображения;
- настройте сопоставление нестандартных свойств;
- повторите тестовый обмен;
- отключите подробную отладку;
- снимите временное ограничение номенклатуры.
Каталог и торговые предложения
Обычно 1С отправляет данные несколькими файлами:
import.xml— группы, товары, описания и свойства;offers.xml— цены, остатки и характеристики предложений;- ZIP — XML и изображения в одном архиве.
После первоначального import.xml можно отправлять только offers.xml. Это обновит цены и остатки без повторного импорта полного каталога.
Изображения
Компонент принимает расширения jpg, jpeg, png, gif и webp. PDF, XLS, DOC и другие присоединённые документы игнорируются.
Изображения добавляются в галерею miniShop3. После импорта запускается стандартное создание миниатюр, а поля изображения и превью товара обновляются сразу.
Склады
Если список складов не задан, остатки всех складов суммируются. Для отбора укажите GUID нужных складов через запятую в commerceml_warehouse_ids.
Пример:
text
7f2a...,b91c...Отбор номенклатуры
Ограничить импорт можно на обеих сторонах:
- средствами узла обмена 1С;
- GUID категорий в
commerceml_category_ids; - GUID товаров в
commerceml_product_ids.
Пустой список означает, что ограничение компонента не применяется.
Автономная работа
После настройки создайте регламентное задание на стороне 1С. Endpoint CommerceBridge 1C не требует открытой панели MODX или вкладки браузера.
Для безопасности используйте HTTPS и, если возможно, разрешите доступ к endpoint только с IP сервера 1С.
Ручной импорт
На вкладке ручного импорта можно загрузить отдельный XML или ZIP. Этот режим подходит для тестирования и диагностики.
Для больших файлов предпочтителен автоматический HTTP-обмен из 1С: при ручной загрузке вкладка браузера должна оставаться открытой до завершения запроса.