Перенос магазина с Хорошоп и Prom в WooCommerce

Перенос магазина с Хорошоп и Prom — плагин для WooCommerce, который переносит в ваш магазин каталог, фото, клиентов и историю заказов со старого магазина на Хорошопе или на Prom.ua. Плагин обращается к официальному API старого магазина, читает из него данные и пишет их в WooCommerce. Старый магазин при этом только читается — в нём ничего не меняется и не удаляется.

Переносятся не только названия и цены. Категории приходят с вложенностью, товары — с описаниями, акционными ценами, остатками, артикулом, штрихкодом, брендом, SEO-полями и фотографиями, которые загружаются в вашу медиатеку, а не остаются ссылками на чужой сервер. В Pro добавляются характеристики, вариации, клиенты и история заказов.

Зачем это магазину

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

Плагин делает эту работу сам и повторяемо. Вы запускаете перенос, смотрите на результат в своём магазине, при необходимости меняете настройки и запускаете ещё раз — товары обновятся, а не продублируются. Так можно спокойно готовить новый магазин, пока старый ещё продаёт.

Отдельно о заказах: они пишутся именно как история. Без писем покупателям, без списания остатков и без влияния на статистику продаж. Оригинальный номер заказа, способ оплаты, доставка и ТТН сохраняются в примечании к заказу, поэтому старые заказы можно найти по их прежнему номеру.

Что получает админ

Один пункт меню «WooCommerce → Перенос с Хорошоп / Prom» с четырьмя вкладками: Перенос, Настройки, История и Лицензия. На вкладке настроек вы указываете, откуда переносить, что именно переносить и по каким правилам.

Откуда переносим. Хорошоп — адрес магазина, логин и пароль API (в админке Хорошопа это «Настройки → Админы», где добавляется отдельный администратор для API). Prom.ua — API-токен из кабинета продавца и, по желанию, ссылка на YML-экспорт, из которого плагин берёт характеристики. Пароль и токен хранятся в базе зашифрованными.

Что переносить. Каждый блок данных включается отдельно: категории, товары, фото, характеристики, модификации, клиенты, история заказов. То, что доступно только в Pro, помечено прямо в интерфейсе, поэтому видно, что вы получите сейчас, а что — с лицензией.

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

Статусы заказов. Пять состояний источника — новый, в обработке, доставляется, доставлен, отменён — вы сопоставляете со своими статусами WooCommerce, чтобы перенесённые заказы не попали все в одну корзину.

Как это работает — шаг за шагом

1. Считать. Плагин последовательно вызывает читающие методы API старого магазина и складывает всё полученное в собственную промежуточную таблицу. В магазин на этом шаге не пишется ничего, поэтому прервать чтение безопасно.

2. Проверить. После чтения вы видите счётчики (сколько категорий, товаров, клиентов, заказов найдено) и образцы строк: как именно плагин понял название, цену, артикул. Ошибки отдельных записей показываются здесь, а не прячутся в лог.

3. Записать. Запись идёт партиями по несколько секунд, а не одним длинным запросом, поэтому большой каталог не упирается в лимит времени выполнения на хостинге. Каждую созданную запись плагин запоминает в своей карте «источник → магазин».

4. Повторить, если нужно. Второй запуск находит уже перенесённые товары по этой карте и обновляет их. Если товар с таким артикулом уже был в вашем магазине до переноса, плагин обновит его, а не создаст дубль. Заказы повторно не переносятся никогда.

Что именно переносится

Категории. Разделы Хорошопа и группы Prom становятся категориями товаров WooCommerce с той же вложенностью и описаниями. Категории, которые уже были в вашем магазине, плагин не переименовывает — обновляет он только те, что создал сам.

Товары. Название, полное и краткое описание, цена, акционная цена, наличие и остаток, артикул, штрихкод (GTIN), бренд, SEO-поля. Скрытый в старом магазине товар можно создавать черновиком.

Фото. Загружаются в вашу медиатеку, первое становится главным изображением товара, остальные — галереей. Битые ссылки не валят весь запуск: такая строка помечается ошибкой, а перенос идёт дальше.

Характеристики (Pro). Становятся атрибутами товаров. API Хорошопа отдаёт характеристики кодами, а не названиями — распространённые коды плагин знает, остальные вы задаёте строкой «код = Название» прямо в настройках. Для Prom характеристики берутся из YML-экспорта магазина.

Модификации (Pro). Товары с общим родительским артикулом в Хорошопе или из одной группы вариаций в Prom становятся одним вариативным товаром WooCommerce: у каждой вариации свой артикул, цена, акция и остаток.

Клиенты (Pro). Зарегистрированные пользователи Хорошопа и клиенты Prom создаются без пароля и без единого письма — покупатель задаст пароль сам через «Забыли пароль». Если аккаунт с таким e-mail уже есть в вашем магазине, он привязывается, а не перезаписывается.

История заказов (Pro). Заказы переносятся с датой из источника, с составом товаров, суммами, скидкой и доставкой. Остатки не списываются, total_sales не меняется, письма не отправляются. Можно взять не всю историю, а заказы с определённой даты.

Почему перенесённые заказы не запускают ваши интеграции

Обычный импорт заказов сохраняет их через смену статуса — и сайт реагирует так, будто заказ только что оформили: фискализация ставит в очередь старые чеки, CRM забирает их как новые, покупателю летит письмо. Плагин ставит статус перенесённому заказу без перехода, сразу помечает его как тот, где остатки уже списаны и продажа уже учтена, а на время записи глушит почту. Поэтому история ложится в базу тихо.

Отмена запуска

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

Отмена привязана к конкретному запуску. Если вы делали несколько запусков, отменять нужно каждый из них — через «Историю», где видны дата, источник и итоги каждого.

Персональные данные покупателей

Клиенты и заказы — это персональные данные. Плагин только переносит их между двумя вашими системами и никуда больше не передаёт: ни в CatCode, ни третьим сторонам. Ответственным за эти данные остаётся продавец, поэтому переносите их только в том объёме, который нужен вам для работы, и только если у вас есть основание их обрабатывать. Блоки «Клиенты» и «История заказов» выключаются отдельно — можно перенести один каталог и не трогать покупателей.

Что под капотом

Считанные данные ложатся в промежуточную таблицу cc_hpm_item, а связь «запись в старом магазине → запись в вашем» — в таблицу cc_hpm_map. Именно через эту карту работают и повторный запуск, и отмена, и привязка заказов к уже перенесённым товарам и вариациям.

Запись идёт партиями по несколько секунд через обычный AJAX админки, поэтому ни длинный каталог, ни медленный ответ старого магазина не упираются в max_execution_time. Количество записей за один запрос настраивается — если старый магазин отвечает медленно, его уменьшают.

Ключи подключения хранятся в базе зашифрованными. На витрине плагин ничего не добавляет: это инструмент администратора, покупатель его не видит, и после завершения переезда плагин можно просто выключить.

Как установить

1. «Плагины → Добавить новый → Загрузить плагин», выберите архив и активируйте.

2. Откройте «WooCommerce → Перенос с Хорошоп / Prom».

3. Укажите данные старого магазина и нажмите «Сохранить и проверить соединение».

4. Выберите, что переносить, и пройдите три шага: «Считать» → проверка счётчиков → «Записать в этот магазин».