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