Интеграция Eofferix с 1C-Bitrix переносит каталог из внешних источников на сайт под управлением 1C-Bitrix. Источником может быть файл, ссылка, FTP/SFTP, Google-таблица, обмен 1С / CommerceML, XML, JSON, CSV, XLSX, YML или выгрузка, которую поставщик даёт в своём личном кабинете. Источник можно запускать вручную или по расписанию, если это настроено в Eofferix.
Eofferix не просто отправляет файл на сайт. Сервис разбирает данные, показывает их в снапшоте, применяет преобразования, условия загрузки и выбранные пользователем правила. Модуль на сайте остаётся тонким адаптером: он принимает уже подготовленные разделы, товары, торговые предложения, свойства, цены, остатки, изображения и файлы и записывает их в 1C-Bitrix.
Эта статья ведёт по основному сценарию первого импорта. Детали разобраны отдельно: установка модуля, настройка профиля, запуск выгрузки, периодичность профиля и периодичность источника.
Короткая схема
- Установите модуль Eofferix на сайт 1C-Bitrix.
- Создайте или выберите источник данных.
- На шаге Шаблон выберите 1C-Bitrix, проверьте подключение к сайту, выберите каталог и правила загрузки.
- На шаге Снапшот отметьте разделы, товары, торговые предложения и поля.
- Сделайте тестовую выгрузку.
- После проверки запустите полный обмен.
- При необходимости используйте паузу, продолжение или откат.
- Включите Периодичность загрузки, если обмен должен выполняться сам.
Как пользоваться этой инструкцией
Если вы делаете выгрузку впервые, идите по шагам сверху вниз и не включайте удаление до теста. Если модуль уже установлен, начните с шага 2. Если профиль уже настроен, переходите к шагу 5 и сделайте тестовую выгрузку.
Главная проверка простая: после теста в 1C-Bitrix должны появиться товары в выбранном каталоге, варианты товара должны быть во вкладке Торговые предложения, свойства товара и предложения должны лежать в разных списках, а повторный запуск без изменений не должен создавать дубли.
1. Подготовьте сайт 1C-Bitrix
Сначала сайт должен научиться принимать каталог из Eofferix. Для этого установите модуль и проверьте подключение. Подробная инструкция: установка модуля Eofferix для 1C-Bitrix.
После установки не нужно вручную менять базу сайта. Дальше всё настраивается в профиле Eofferix.
2. Создайте источник и профиль
Источник — это файл, ссылка, данные из 1С, таблица или другой канал, откуда Eofferix получает каталог. В профиле можно загрузить новый файл или выбрать уже созданный источник.
В блоке В какой формат выгружать? откройте вкладку Приложения и выберите 1C-Bitrix. На скриншоте показан учебный источник и выбранный шаблон для 1C-Bitrix.
3. Настройте 1C-Bitrix на шаге Шаблон
На том же шаге Шаблон укажите адрес сайта, логин администратора и нажмите Проверить подключение. После успешной проверки выберите каталог в 1C-Bitrix, куда нужно загружать товары, и задайте правила загрузки.
Для первого запуска обычно достаточно таких правил: товары и торговые предложения искать по внешнему ID, разделы искать по полному пути, очистку не включать до тестовой проверки. Подробно все настройки описаны в статье настройки выгрузки в 1C-Bitrix.
4. Разметьте структуру источника
На шаге Снапшот Eofferix показывает структуру исходных данных. Здесь нужно указать, что является товаром, что является торговым предложением, а что относится к разделам и характеристикам.
Минимальный набор для первого запуска: название товара, цена, остаток, путь раздела, картинка, внешний ID товара и внешний ID торгового предложения. Если в источнике есть размеры, цвета или другие варианты, отметьте их как торговые предложения.
Если непонятно, какую роль выбрать, ориентируйтесь на смысл данных, а не на название узла в файле.
| Что вы видите в источнике | Что выбрать в снапшоте | Что получится в 1C-Bitrix |
|---|---|---|
Название группы вроде Одежда / Мужская / Брюки | Раздел или поле пути раздела | Разделы каталога. Если отдельное поле поиска раздела не выбрано, Eofferix сопоставляет разделы по полному пути. |
| Карточка товара без размеров и цветов | Товар | Обычный товар в выбранном каталоге. |
| Один товар и внутри размеры, цвета, комплектации | Товар для общей карточки и Торговое предложение для каждого варианта | Один родительский товар и отдельные предложения во вкладке торговых предложений. |
| Цена или остаток отличаются по размеру, цвету или комплектации | Поле торгового предложения | Цена и остаток записываются в предложение, а не в родительский товар. |
| Бренд, материал, состав, описание общей карточки | Свойство товара | Свойство появится у товара. |
| Размер, цвет, штрихкод или артикул конкретного варианта | Свойство торгового предложения | Свойство появится у предложения. |
| Описание или картинка раздела | Свойство раздела | Значение попадёт в раздел каталога. |
| Ссылка на картинку или файл | Картинка или файл | Файл будет загружен на сайт, если он доступен в источнике или архиве. |
Обратите внимание на условия загрузки. Если у товара или предложения стоит условие, например “остаток больше 0”, объекты, которые не прошли условие, не будут отправлены на сайт. Это нормальная работа фильтра, а не ошибка модуля.
5. Сделайте тестовую выгрузку
Тестовая выгрузка отправляет небольшую часть каталога. После неё зайдите в админку 1C-Bitrix и проверьте, что товары попали в правильный каталог, торговые предложения лежат отдельно, характеристики записались в нужные места, а картинки открываются.
Проверьте результат в админке 1C-Bitrix
Откройте в админке 1C-Bitrix выбранный каталог. В списке товаров должна появиться тестовая выборка. Если товар в источнике имеет варианты, в списке Bitrix он должен быть типом товар с предложениями.
Откройте один из таких товаров и перейдите во вкладку Торговые предложения. Варианты должны быть в этой таблице: размер, цвет, отдельная цена или остаток относятся к предложению.
Проверьте свойства отдельно. Свойства товара находятся в списке Свойства товаров, а свойства вариантов — в списке Свойства торговых предложений. Это разные места в 1C-Bitrix.
| Если видите | Что это обычно значит | Что сделать |
|---|---|---|
| Товары создались, но предложений нет | В снапшоте варианты не отмечены как торговые предложения или их отфильтровало условие загрузки. | Проверьте роль узла варианта и условия загрузки по цене, остатку или активности. |
| Один и тот же товар появился несколько раз | Выбрано ненадёжное поле поиска существующих товаров. | В настройках 1C-Bitrix выберите внешний ID или другое стабильное поле, которое не меняется между запусками. |
| Разделы перемешались | Разделы сопоставляются не по полному пути или путь раздела собран неверно. | Проверьте поле пути раздела в снапшоте и не выбирайте поиск раздела только по последнему названию, если такие названия повторяются. |
| Картинки не появились | В источнике нет файла, ссылка недоступна или картинка лежит в архиве, который не был передан. | Проверьте поле картинки и убедитесь, что исходный файл или архив доступен в источнике. |
Если в тесте что-то не так, исправьте разметку в Снапшоте или настройки 1C-Bitrix на шаге Шаблон. Подробный порядок запуска есть в статье запуск выгрузки в 1C-Bitrix.
6. Запустите полный обмен
Когда тест прошёл правильно, нажмите Запустить. Eofferix отправляет большой каталог частями, показывает состояние задачи и позволяет остановить или продолжить обмен без повторного создания уже обработанных товаров.
Повторный запуск того же каталога должен быть быстрее: если итоговые данные не изменились, Eofferix пропускает такие товары, предложения и разделы без лишней записи на сайт.
7. Пауза, продолжение и откат
Во время полного обмена задачу можно остановить. Сервис показывает, что остановка запрошена, и не оставляет пользователя без понятного состояния. После остановки или ошибки импорт можно продолжить с последней подтверждённой точки: уже обработанные товары, торговые предложения и разделы не должны создаваться повторно.
Если после импорта нужно вернуть изменения, используйте доступную точку отката на экране результата. Откат относится к текущему обмену и текущему источнику: он не должен удалять чужие товары или ручные изменения, которые не связаны с этим профилем.
8. Настройте периодический обмен
Если каталог должен обновляться без ручного запуска, откройте профиль и найдите блок Периодичность загрузки. Выберите По расписанию, задайте время и сохраните профиль. Если сначала должен обновляться сам источник, настройте расписание источника отдельно.
Подробнее: периодичность загрузки профиля и периодичность загрузки источника.