Настройка профиля WooCommerce в Eofferix

Профиль WooCommerce говорит Eofferix, какие данные брать из источника и как отправлять их в магазин. Пользователь сам выбирает, что в снапшоте является категорией, товаром, торговым предложением, характеристикой, картинкой и полем WooCommerce.

Цель настройки

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

Где находится настройка

Откройте раздел Интерпретатор.
Создайте новый профиль или откройте уже созданный профиль.
На шаге Шаблон выберите источник данных и приложение WooCommerce.
На шаге Снапшот отметьте роли узлов и полей.
На шаге Преобразование проверьте расчет и запустите выгрузку.

Источник данных

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

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

Что подготовить до настройки

Файл, ссылку, таблицу или другой источник каталога.
Доступ администратора WordPress для первичной проверки подключения.
Понимание, по какому полю можно узнавать один и тот же товар при повторном импорте: внешний ID, SKU, артикул или другой стабильный код.
Решение, что делать с позициями, которых больше нет у поставщика: оставить, отключить или удалить в рамках текущего профиля.

Подключение сайта

Создайте или откройте профиль с целевой системой WooCommerce.
В блоке подключения укажите адрес сайта WordPress/WooCommerce.
Введите логин и пароль администратора WordPress для первичной проверки.
Запустите проверку подключения.
После успешной проверки сохраните профиль.

Если адрес сайта или пользователь WordPress меняется, подключение нужно проверить заново. Если меняется только шаблон снапшота, повторная установка плагина не нужна.

Зеленое сообщение означает, что установленный плагин отвечает и сайт готов принимать импорт.

Роли в снапшоте

Роль отвечает на вопрос "чем является этот узел или поле для WooCommerce". Если источник пришел из 1С, Google-таблицы или XML поставщика, структура может быть любой. Поэтому Eofferix не угадывает все молча: пользователь отмечает, какие данные станут категориями, товарами, вариациями, характеристиками и изображениями.

Категория - узел или строка, из которой создается раздел каталога WooCommerce.
Товар - родительская карточка товара.
Торговое предложение - вариант товара, который в WooCommerce станет вариацией.
Характеристика - повторяющийся блок с названием и значением свойства.
Изображение - ссылка или файл, который нужно передать в WooCommerce.

Как выбирать роль, если структура источника непривычная

Смотрите не на название узла, а на смысл данных. Если строка содержит цену, остаток, размер и цвет конкретного варианта, это торговое предложение. Если блок содержит общее название карточки, описание и категорию, это товар. Если строка только группирует товары, это категория.

На узлах снапшота видны роли товара, характеристики и связанные поля WooCommerce. Значения источника скрыты, чтобы показать настройку без данных поставщика.

Поля идентификации

Поля идентификации нужны, чтобы Eofferix обновлял существующие объекты, а не создавал дубли. Для источников 1С внешний идентификатор 1С используется по умолчанию для товаров и торговых предложений, если пользователь явно не выбрал другое поле.

Как работают «И» и «ИЛИ». Отдельные плашки идентификации соединяются условием И. Внутри одной плашки кнопка «или …» добавляет альтернативные поля, которые проверяются слева направо. Например: (Артикул ИЛИ Внешний код ИЛИ Штрихкод) И Поставщик И (Бренд ИЛИ Производитель).

Eofferix останавливается на первой полной комбинации, по которой найдены существующие объекты. Если она нашла несколько объектов, весь найденный набор обрабатывается выбранным правилом дублей: поиск не переходит к следующей альтернативе. Значение каждой обязательной группы должно быть заполнено. Пользователь может выбрать любые доступные поля, а дополнительные альтернативы не расходуют дополнительные кредиты.

Объект	Что выбрать
Товар	Внешний идентификатор, артикул или другое стабильное поле, которое не меняется от запуска к запуску.
Вариация	Внешний идентификатор торгового предложения и связь с родительским товаром.
Категория	Отдельный идентификатор категории или полный путь категории. Если поле не выбрано, используется полный путь.

Для товаров, вариаций и категорий можно выбрать отдельные поля сопоставления.

Почему без идентификации опасно запускать импорт

Если у товара нет стабильного признака для поиска, сервис не сможет надежно понять, что это тот же товар из прошлого запуска. Тогда повторная загрузка может создать дубли. Для 1С обычно используйте внешний идентификатор, для прайсов поставщика - SKU или артикул, для категорий - ID категории или полный путь.

Привязка полей

После выбора ролей привяжите значения источника к полям WooCommerce: название товара, артикул, цену, остаток, описание, категорию, параметры вариации, характеристики и изображения. Поля товара связываются с товаром, поля вариации - с вариацией, поля категории - с категорией.

Если в источнике есть новое свойство, его не нужно заранее вручную создавать в WooCommerce. При правильной привязке Eofferix передает свойство в нужное место: товарное свойство в товар, свойство вариации в вариацию, свойство категории в категорию.

Что есть в источнике	Куда связать в WooCommerce	Что проверить после теста
Название товара	Поле названия товара.	В списке товаров WooCommerce карточка называется так же, как в источнике после преобразований.
SKU, артикул или внешний ID товара	Поле SKU или поле идентификации товара.	Повторный импорт обновляет ту же карточку, а не создает новую.
Цена и остаток торгового предложения	Поля цены и остатка вариации.	У каждой вариации своя цена и свой остаток.
Размер, цвет, материал вариации	Атрибуты, которые используются для вариаций.	Вариация показывает конкретный размер и цвет, а не значение "с любым".
Общие характеристики товара	Атрибуты или свойства товара.	Характеристики видны у товара и не копируются в каждую вариацию без необходимости.
Картинка вариации	Изображение вариации.	При выборе вариации в WooCommerce видно ее собственное изображение.
Путь категории	Категория товара.	Товар попадает в правильную вложенную категорию.

Если кнопка "Далее" не активна

Обычно это значит, что в шаблоне не заполнено обязательное поле для выбранной роли. Например, для вариаций может требоваться SKU или другое поле идентификации. Вернитесь к началу снапшота, найдите красное сообщение с причиной, заполните указанное поле и сохраните шаблон. После сохранения кнопка продолжения снова становится доступной.

Условия загрузки

В шаблоне можно ограничить, какие объекты попадут в импорт. Например, загружать только торговые предложения, у которых остаток больше 0 и цена больше 100000. Такие условия применяются в Eofferix до отправки данных в WooCommerce.

Задача	Пример условия	Что произойдет
Не загружать отсутствующие предложения	Остаток торгового предложения больше `0`.	В WooCommerce попадут только варианты, которые есть в наличии.
Не загружать дешевые позиции	Цена больше `100000`.	Позиции ниже выбранной цены не будут отправлены на сайт.
Загрузить только нужный бренд	Бренд равен выбранному значению.	В импорт попадут только товары этого бренда.
Исключить технические строки	Название не пустое и SKU не пустой.	Сервис не отправит строки, которые не являются реальными товарами.

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

Что проверить перед запуском

Источник выбран и показывает актуальные данные.
WooCommerce подключен, проверка подключения успешна.
Для товаров и вариаций выбраны стабильные поля идентификации.
Категории сопоставляются по идентификатору или полному пути.
Поля товара, вариации и категории не перепутаны между собой.
Условия загрузки не отсекают нужные товары случайно.