Кейс: Перенос каталога с Wildberries в WooCommerce: автоматический YML-импорт с вариациями

Задача и требования к решению

Когда ассортимент магазина вырастает до тысяч позиций со сложной структурой вариаций (размеры, цвета, составы ткани, материалы), ручное управление каталогом становится крайне неэффективным. Цены, остатки и характеристики меняются ежедневно, а каждое обновление требует времени, внимания и ресурсов. Мы поставили задачу создать полностью автоматическую систему переноса и синхронизации каталога с Wildberries на собственный сайт, которая работает без участия человека, сохраняет удобную структуру для покупателей и идеально подходит для поисковых систем.

В техническом плане это означало решение сразу нескольких сложных задач одновременно. Во-первых, нужно было обеспечить 100% автоматический импорт всех товаров без ручного создания карточек. Во-вторых, сохранить правильную структуру вариаций: одна модель товара должна представляться одной карточкой с удобным переключателем размеров и цветов, а не множеством дублирующихся страниц. В-третьих, обеспечить регулярную синхронизацию цен и остатков по расписанию — от 5 минут и выше. В-четвёртых, гарантировать полную защиту уже оптимизированных SEO-текстов, мета-описаний и изображений от случайной перезаписи при обновлениях. И наконец — дать возможность работать с несколькими фидами от разных поставщиков одновременно, с индивидуальными настройками для каждой задачи.

Расширяя контекст, важно отметить, что такая система должна быть не просто техническим инструментом, а полноценной инфраструктурой, которая позволяет масштабировать бизнес без дополнительных затрат на персонал. Мы учли все нюансы: от отказоустойчивости (если API недоступен, система продолжает работать на кэше) до детальной диагностики (логи фиксируют каждый шаг).

Ключевые требования, которые мы реализовали:

• Полностью автоматический импорт всех товаров без ручного вмешательства
• Автоматическая склейка вариаций в одну карточку (Variable Product WooCommerce)
• Синхронизация цен и остатков по гибкому расписанию
• Надёжная защита SEO-контента (Smart Update)
• Поддержка нескольких задач импорта с индивидуальными настройками
• Максимальная отказоустойчивость и подробное логирование

2024 год: генератор YML + Webasyst Shop-Script

В 2024 году мы разработали первый инструмент: генератор YML-фида по официальному API Wildberries. Он автоматически собирал товары с актуальными остатками и ценами, формировал файл /wb/file.yml и передавал данные в Webasyst Shop-Script. Решение работало стабильно: цены и остатки обновлялись по расписанию, каталог синхронизировался без ручного труда. Однако вариации (размеры, цвета) оставались отдельными карточками — требовалась ручная связка атрибутов внутри CMS. Это было хорошим стартом, но для больших каталогов не хватало автоматизации.

Основной скрипт auto_generate.php подключался к API по токену, использовал шаблон template.xml, сохранял готовый фид в file.yml. Админка secure-admin/admin.php позволяла ввести токен, URL API, категории, сохранить настройки и запустить генерацию вручную. Cron запускал скрипт каждые 3 часа (команда /usr/local/bin/php7.4 /home/…/auto_generate.php). Лог module.log фиксировал всё: запуски, количество товаров, ошибки (401, 500, timeout). Права на запись требовались только для file.yml и module.log. Чек-лист развертывания был прост: копируем папку /wb/, вставляем токен, генерируем, проверяем лог, добавляем cron.

Расширяя, в первой версии мы фокусировались на базовой синхронизации, но уже тогда заложили основу для будущих улучшений, таких как group_id. Это позволило быстро перейти к версии 2026 года, когда потребовалась полная автоматизация вариаций.

2026 год: эволюция в плагин SeoUsluga YML Importer 2.0

В 2026 году мы вернулись к генератору, значительно его улучшили (добавили автоматическое присвоение group_id для группировки моделей) и разработали новый профессиональный плагин для WooCommerce — SeoUsluga YML Importer 2.0. Это был полный рефакторинг: современный интерфейс на Bootstrap 5, полная адаптивность, индивидуальные настройки для каждой задачи, батчинг по 50 товаров, умное кэширование изображений и расширенное логирование последних 50 импортов. Структура плагина продумана до мелочей: главный файл seousluga-yml-importer.php, папки assets/ с CSS/JS, includes/admin с class-admin-page.php, class-forms.php, class-table.php, core с class-settings.php, class-task-manager.php, import с class-importer.php, class-xml-parser.php, class-product-importer.php, class-image-handler.php.

Теперь связка работает как единая система: генератор создаёт YML-фид → плагин парсит его и автоматически создаёт Variable Product с правильными вариациями. Это позволило полностью избавиться от дублей страниц, улучшить юзабилити и SEO-структуру сайта.

Расширяя, версия 2.0.0 включает полный рефакторинг, новый интерфейс на Bootstrap 5, индивидуальные настройки задач, улучшенную производительность, расширенную статистику и безопасность. Всё это делает плагин не просто инструментом, а полноценной системой для автоматизации каталога.

Почему YML-фид остаётся основой

Мы выбрали архитектуру «API → промежуточный YML-фид → WooCommerce», потому что YML (Yandex Market Language) — это проверенный, универсальный XML-стандарт. Он даёт множество преимуществ:

• Универсальность и омниканальность: один настроенный фид можно отдавать WooCommerce, Яндекс.Маркету, VK Товарам, Google Merchant параллельно
• Абсолютный контроль: фид формируется и хранится на вашем сервере, мы можем фильтровать и обогащать его до того, как он попадёт на витрину
• Отказоустойчивость: если API Wildberries временно «упадёт» (что бывает нередко), сайт продолжает работу на последней сохранённой версии YML-файла
• Простота отладки: XML легко читать, проверять и редактировать

Расширяя, YML позволяет легко масштабировать систему, добавляя новые каналы продаж без изменений в коде. Это делает решение будущезащищённым и гибким для любого бизнеса.

Архитектура современного решения

Наш программный комплекс состоит из двух независимых компонентов, которые общаются друг с другом по защищенной внутренней ссылке:

Этап 1 — Генератор YML-фида

На стороне сервера мы развернули легковесный обработчик — YML Generator. Он подключается к кабинету продавца через официальный API-токен. В панели генератора можно тонко настроить выгрузку: выбрать нужные склады, бренды или конкретные категории из словаря WB.

Генератор запрашивает массив данных у Wildberries и «на лету» формирует правильный XML-документ. Главная технологическая фишка генератора — он анализирует товары и присваивает позициям одной модели единый идентификатор group_id. Посмотрите на фрагмент реально сгенерированного кода:

<offers>
  <!-- Размер 42 -->
  <offer id="1230098787" group_id="821225556" available="true">
    <price>6000</price>
    <stock>4</stock>
    <name>Медицинский костюм с брюками палаццо</name>
    <param name="Размер">42</param>
    <picture>https://.../images/big/1.webp</picture>
  </offer>
  <!-- Размер 44 -->
  <offer id="1230098788" group_id="821225556" available="true">
    <price>6000</price>
    <stock>5</stock>
    <name>Медицинский костюм с брюками палаццо</name>
    <param name="Размер">44</param>
    <picture>https://.../images/big/1.webp</picture>
  </offer>
</offers>

Этап 2 — Плагин SeoUsluga YML Importer 2.0

Второй этап магии происходит уже внутри WordPress. Мы разработали мощный плагин-комбайн SeoUsluga YML Importer (версия 2.0.0) с современным интерфейсом на Bootstrap 5. Он забирает созданный фид и правильно раскладывает данные по таблицам базы данных магазина.Ключевые фишки нашего импортера:

• Пошаговый импорт (Батчинг): Загрузка 10 000 товаров не «положит» ваш хостинг. Плагин обрабатывает фид умными частями (например, по 50 товаров за такт), исключая ошибки таймаута (502/504 Gateway Time-out).
• Умное кэширование изображений: Если у 8 размеров одного костюма загружены одинаковые 10 фотографий на WB, наш плагин скачает их в медиатеку WordPress только один раз, привязав ко всем вариациям. Это колоссальная экономия дискового пространства сервера.
• Индивидуальные настройки задач и разные наценки: Вы можете создать неограниченное количество задач импорта (например, для разных фидов от разных поставщиков или для дропшиппинга). Каждая задача имеет свой uid и свои настройки. В одной задаче вы можете задать наценку +15% к цене WB, а в другой (от другого поставщика) — фиксированную наценку +500 рублей с красивым округлением.

Умное обновление существующих товаров (Smart Update)

Частый вопрос от SEO-специалистов: «А как плагин понимает, какие поля товаров не нужно обновлять? Вдруг он затрет мои уникальные SEO-тексты?»

Мы предусмотрели это. В настройках каждой задачи есть блок оптимизации. Вы можете принудительно отключить обновление названий, описаний, изображений и категорий для уже созданных товаров. Плагин будет сопоставлять товары по offer_id в базе данных (в таблице postmeta) и обновлять только цены и остатки. Ваши SEO-оптимизированные тексты останутся в полной безопасности!

Магия под капотом: как склеиваются вариации

Это технологическое сердце нашего решения. Как только импортер парсит фид и видит тег group_id="821225556", он запускает специальный алгоритм объединения:

1. Вместо создания простых товаров, он создает в WooCommerce один родительский Вариативный товар (Variable Product).
2. Он сканирует все теги <param> и автоматически регистрирует глобальные атрибуты (Размер, Пол, Состав, Тип посадки).
3. Находит атрибут «Размер», проставляет ему внутреннюю галочку «Используется для вариаций».
4. Затем он складывает все 8 размеров внутрь родительского товара как дочерние вариации (Child Products), жестко привязывая к каждой свой уникальный offer_id, точный остаток (stock) и штрихкод.

Автоматизация, Cron и ручной запуск

Загрузить товары один раз недостаточно. Цены и остатки на маркетплейсе — это «живой» организм. Наш менеджер задач глубоко интегрирован во встроенный планировщик WP-Cron.

В панели администратора вы просто задаете интервал (каждые 15 минут, раз в час, раз в сутки). Плагин сам стучится по защищенной ссылке генератора, скачивает свежий XML, сопоставляет идентификаторы и точечно обновляет наличие. Товары, которых больше нет на складе WB, могут автоматически скрываться или удаляться с сайта.

Можно ли запустить обновление вручную, не дожидаясь Cron?

Да, безусловно. Если вы только что поменяли цены на Wildberries и хотите, чтобы они моментально применились на вашем сайте (например, перед запуском контекстной рекламы), вам не нужно ждать расписания. В интерфейсе плагина напротив каждой задачи есть кнопка «Запустить принудительно». Также быструю ручную генерацию можно инициировать прямо из скрипта-генератора.

Кроме того, плагин ведет подробный логгинг (историю последних 50 импортов). Вы всегда видите: сколько позиций было добавлено, сколько обновлено, а сколько пропущено, и не было ли ошибок со стороны API маркетплейса.

Результаты на практике

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

Выводы и применимость

Разработка связки «YML Generator Wildberries  +  SeoUsluga YML Importer 2.0.0» доказала, что перенос бизнеса с маркетплейса— это не хаос из тысяч дублей, а предсказуемый инженерный процесс. Это не просто скрипт выгрузки, а надежная товарная инфраструктура для масштабирования.

Кому жизненно необходимо такое решение:

1. Успешным селлерам WB/Ozon, которые уперлись в «потолок» маркетплейсов и хотят растить собственный бренд (D2C).
2. Продавцам одежды, обуви, косметики и любых товаров с размерными/цветовыми сетками (вариациями).
3. Владельцам бизнеса, которые не хотят раздувать ФОТ и нанимать людей для ручного ведения каталога.
4. Специалистам по SEO, которым нужна чистая структура сайта без каннибализации запросов и дублей страниц.