Если вы настраиваете обмен впервые, откройте сначала обзор: выгрузка каталога в 1C-Bitrix: полный путь.
Глоссарий терминов
| Слово в интерфейсе | Что это значит |
|---|---|
| Инфоблок | Каталог внутри 1C-Bitrix, куда будут попадать разделы, товары и свойства. |
| Элемент | Обычный товар. |
| Торговое предложение | Вариант товара: размер, цвет, комплектация, отдельная цена или остаток. В подавляющем большинстве случаев торговые предложения в Битриксе лежат в отдельном инфоблоке. |
| ID для сопоставления | Поле, по которому Eofferix находит уже существующий объект и не создаёт дубль. |
| Очистка | Удаление или отключение объектов, которые пропали из текущего источника. |
Подключение и каталог
Укажите адрес сайта, логин/пароль пользователя с правами администратора и нажмите Проверить подключение. После проверки выберите каталог 1C-Bitrix. Именно туда Eofferix будет отправлять разделы, товары и свойства товаров.
Отдельно выбирать инфоблок торговых предложений обычно не нужно. Eofferix получает его из настроек торгового каталога Bitrix: если у выбранного каталога товаров привязан инфоблок предложений, модуль определит его автоматически. Если связи нет, сначала настройте её в Bitrix, иначе предложения не будут загружаться как варианты товара.
Как выбрать поля идентификации
- Для товаров выберите поле или набор полей, которые стабильно определяют одну карточку. Это может быть внешний ID, артикул, название или комбинация названия и артикула.
- Для торговых предложений можно выбрать другой набор полей: артикул предложения, внешний ID предложения, размер, цвет или их комбинацию.
- Отдельная настройка для разделов особенно нужна, когда разделы приходят в источнике отдельным блоком. Если разделы вложены в товар или передаются как путь, часто достаточно полного пути вроде
Одежда / Мужская / Брюки. - Для источников 1С поле внешнего идентификатора 1С обычно подходит как значение по умолчанию для товаров и торговых предложений. Меняйте его только если в старом каталоге уже есть другое стабильное поле для сопоставления.
- Расширенные настройки скорости оставьте по умолчанию, если нет отдельной причины менять размер порции вручную.
Как работают «И» и «ИЛИ». Отдельные плашки идентификации соединяются условием И. Внутри одной плашки кнопка «или …» добавляет альтернативные поля, которые проверяются слева направо. Например: (Артикул ИЛИ Внешний код ИЛИ Штрихкод) И Поставщик И (Бренд ИЛИ Производитель).
Eofferix останавливается на первой полной комбинации, по которой найдены существующие объекты. Если она нашла несколько объектов, весь найденный набор обрабатывается выбранным правилом дублей: поиск не переходит к следующей альтернативе. Значение каждой обязательной группы должно быть заполнено. Пользователь может выбрать любые доступные поля, а дополнительные альтернативы не расходуют дополнительные кредиты.
Пресеты настроек импорта
Пресет — это готовый сценарий для стандартной задачи. Выберите сценарий вверху блока настроек, а отдельные поля ниже меняйте только если нужно отойти от готового варианта.
| Пресет | Когда использовать |
|---|---|
| Бережный обмен | Eofferix создаёт новые товары и обновляет найденные, но не удаляет отсутствующие автоматически. Также не привязывает товары и предложения к конкретному профилю. |
| Полная синхронизация источника | Профиль привязывает все импортируемые товары к себе. Повторный запуск профиля удалит товары и торговые предложения, которые пропали из источника, и добавит новые, которые появились с очередным обновлением. |
| Обновить найденные | Сценарий подходит когда нужно менять цены, остатки, названия или свойства только у уже найденных товаров и предложений. Новые товары не создаются. |
| Добавить только новые | Когда нужно добавить отсутствующие товары и предложения, но не менять то, что уже есть на сайте. |
| Полная перезапись каталога | Сценарий удаляет отсутствующие товары, торговые предложения и разделы в выбранной области, затем создаёт или обновляет объекты из текущего источника. Характеристики и значения справочников сохраняются. |
Поиск существующих объектов
В блоке Идентификация элементов 1C-Bitrix выберите, по каким полям Eofferix будет искать уже созданные товары, предложения и разделы. Если совпадение найдено, объект обновляется на месте, а не создаётся заново.
Для источников 1С обычно оставляют поиск товаров и торговых предложений по внешнему ID из 1С. Менять это поле стоит только если вы точно знаете, что в старом каталоге уже есть другое стабильное поле, по которому нужно найти существующие карточки.
Если сайт будет передавать заказы обратно в 1С, внешний ID из 1С нужно также записывать во внешний код Битрикса. Подробно: интеграция 1С и Битрикс через Eofferix.
| Объект | Лучший выбор для первого запуска | Когда менять |
|---|---|---|
| Товар | Внешний ID товара из источника | Если товары уже есть на сайте и у них заполнен другой стабильный код, который совпадает с источником. |
| Торговое предложение | Внешний ID предложения из источника | Если варианты уже заведены вручную и у них есть свой надёжный артикул или код. |
| Раздел | Полный путь названий, если поле поиска не выбрано | Если у разделов уже есть собственный внешний код и он точно совпадает с источником. |
Правила загрузки
Правила определяют, что делать с новыми товарами, найденными товарами и пустыми значениями. Бережный обмен удобно использовать для обновления цен, остатков, свойств и новых товаров без привязки каталога к конкретному профилю. Например, когда Eofferix работает как прослойка между сайтом и 1С, а 1С отдаёт данные в режиме обмена изменениями.
Если источник считается полным списком своего каталога и сайт должен удалять то, чего больше нет в данных, используйте сценарии синхронизации или ручные правила очистки. Перед первым боевым запуском проверьте их тестовой выгрузкой.
Торговые предложения
Торговые предложения настраиваются отдельно от товаров. Это важно: если у конкретной вариации товара, например чёрной футболки размера S, изменилась цена или остаток, Eofferix обновляет предложение, а не перезаписывает родительский товар.
Очистка и защита
Очистка после загрузки нужна, когда сайт должен убрать товары, предложения или разделы, которых больше нет в текущем источнике. Это не обязательный шаг для каждого обмена: если источник передаёт только изменения, очистку обычно не включают.
Самый безопасный вариант для регулярной синхронизации — область Только текущий источник. В этом режиме Eofferix работает только с объектами, которые были связаны с этим профилем, и не трогает чужие товары на сайте. Режим очистки всего каталога используйте только для отдельного тестового каталога или когда выбранный каталог полностью принадлежит текущему источнику.
Защитные лимиты останавливают опасное удаление и показывают понятную причину. Если лимит сработал, модуль останавливает очистку до следующего удаления сверх лимита: уже проверенные объекты не удаляются просто из-за проверки. Сначала проверьте источник, выбранный сценарий и область очистки, затем при необходимости измените лимит.
Автоматическая очистка отсутствующих данных не удаляет и не отвязывает характеристики и значения справочников, с которыми работал профиль. Если они временно исчезли из следующего источника, они остаются в каталоге; при повторном появлении Eofferix переиспользует сохранённую привязку, когда однозначно найден совместимый объект. Правила для отсутствующих товаров, торговых предложений, разделов и изображений работают отдельно.