Перенесення магазину з Хорошоп і 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. Оберіть, що переносити, і пройдіть три кроки: «Зчитати» → перевірка лічильників → «Записати в цей магазин».