WooCommerce — найпоширеніший рушій інтернет-магазинів на WordPress. Якщо ваш магазин на ньому, каталог уже є на сайті, і Elbuz забирає його напряму через REST API WooCommerce — без вивантаження файлів. Далі товари живуть у вашому базовому каталозі Elbuz, звідки ви керуєте цінами й наявністю та роздаєте асортимент на інші канали продажу.
Ця стаття — про підключення саме WooCommerce. Загальний порядок для будь-якого API-джерела описано в огляді імпорту каталогу через API; тут — особливості WooCommerce: які ключі потрібні, де їх узяти і що приходить у каталог. Про завантаження даних загалом дивіться огляд завантаження.
Де це у програмі
У вікні імпорту створіть шаблон і оберіть тип «WooCommerce». Це API-джерело: файл не потрібен, підключення відбувається за адресою магазину й парою ключів. Один шаблон — одне підключення до одного сайту. Якщо магазинів кілька, під кожен заведіть окремий шаблон.
Що потрібно для підключення
WooCommerce не має «застосунку розробника» чи коду прив'язки — підключення відбувається за трьома значеннями, які потрібні всі три:
- Адреса магазину — повний URL вашого сайту, наприклад
https://store.com. Обов'язково черезhttps. - Consumer key — ключ доступу, починається з
ck_. - Consumer secret — секрет, починається з
cs_.
Ключі створюються у самому WooCommerce: у налаштуваннях магазину відкрийте розділ «WooCommerce → Налаштування → Додатково → REST API» і додайте новий ключ. Задайте йому права Читання (Read) — цього досить, щоб забирати каталог; для приймання замовлень і зворотного оновлення цін дайте Читання/Запис (Read/Write). WordPress одразу покаже consumer key і consumer secret — скопіюйте обидва, бо секрет показується лише раз.
Як підключити крок за кроком
Створіть шаблон типу «WooCommerce». У картці «Підключення» введіть адресу магазину, consumer key і consumer secret. Скористайтесь кнопкою «Перевірити підключення» — вона одразу скаже, чи приймає сайт ваші ключі, ще до першого завантаження. Потім у блоці «Що завантажувати» увімкніть потрібне — товари, а за потреби й замовлення — збережіть і запустіть. Перше підключення забирає каталог, наступні оновлюють його.
Що потрапляє в каталог
Із WooCommerce у базовий каталог Elbuz переносяться товари з назвами, цінами, залишками, зображеннями, характеристиками й описом, а також дерево категорій, бренди й варіації товарів (розміри, кольори тощо) — WooCommerce зберігає варіації як окремі позиції в межах товару, і Elbuz їх розпізнає. Підтягуються й SEO-поля, якщо вони заповнені на сайті. Що саме брати, ви керуєте чекбоксами шаблону: можна тягнути все, а можна оновлювати лише ціни й наявність, лишивши свій опис недоторканим.
Варто розуміти й обсяг завантаження. WooCommerce віддає товари, варіації та категорії окремими наборами й сторінками фіксованого розміру, тож для великого магазину перший повний прохід забирає більше часу — програма послідовно збирає всі сторінки. Це не зависання, а звичайний хід: наступні оновлення коротші, бо переважно звіряють ціни й наявність, а не тягнуть увесь каталог заново. Якщо товарів справді багато, перше завантаження варто зробити окремо, а регулярні оновлення поставити на зручний розклад.
Каталог і замовлення
Те саме підключення вміє забирати не лише каталог, а й замовлення магазину. Для цього ключі мають мати права Читання/Запис, а в шаблоні — бути ввімкненим відповідний перемикач. Elbuz забиратиме нові й змінені замовлення, і вони потраплятимуть у ваші документи. Ця стаття — про каталог; хочете тільки товари — лишіть замовлення вимкненими, зайве не завантажуватиметься.
Навіщо зводити каталог WooCommerce в Elbuz
Сам по собі WooCommerce добре тримає вітрину, але не заточений під керування великим асортиментом і зв'язок із постачальниками. Elbuz забирає каталог сайту до себе й дає єдине місце, де ви рахуєте ціни за правилами націнок, стежите за наявністю й наповнюєте картки. Ціни та наявність можна тримати актуальними автоматично: вони тягнуться з прайсів постачальників у Elbuz, а звідти вивантажуються назад на сайт.
Це особливо зручно, коли WooCommerce не єдиний канал: той самий товар живе і на сайті, і на маркетплейсах, а редагуєте ви його в одному місці — в Elbuz — і зміни розходяться туди, куди потрібно.
Оновлення за розкладом
Коли підключення налаштовано й перевірено, поставте шаблон на розклад кнопкою налаштування завдання прямо у формі. Elbuz сам звертатиметься до сайту за свіжими даними: ціни й залишки оновлюватимуться, нові товари додаватимуться. WooCommerce віддає каталог сторінками, тож великі магазини вантажаться поступово — це нормально. Кожен запуск лишає слід у журналі: скільки товарів оновлено, скільки додано, чи були помилки; перші кілька разів варто туди зазирати.
Часті труднощі
Найчастіша причина, чому підключення не працює, — ключі або адреса. Потрібні всі три значення: адреса, consumer key і consumer secret. Перевірте, що адреса вказана через https і без зайвого шляху в кінці, а ключі скопійовані повністю, без пробілів. Якщо ви не зберегли consumer secret під час створення — його не переглянути повторно, треба створити новий ключ.
Друга типова ситуація — REST API вимкнено або закрито на боці сайту. Деякі хостинги чи плагіни безпеки блокують зовнішні звернення до WooCommerce REST API; тоді навіть правильні ключі не спрацюють. Якщо кнопка перевірки підключення повертає помилку, а ключі точно вірні — почніть саме з цього: переконайтесь, що REST API увімкнено і сайт відповідає на зовнішні запити.
Створюючи ключі, одразу дайте їм права Читання/Запис, навіть якщо поки що тягнете тільки каталог. Так пізніше, коли захочете приймати замовлення чи вивантажувати ціни назад на сайт, не доведеться перевипускати ключ.
Що далі після завантаження
Завантажити каталог — це лише перший крок. Далі товари з WooCommerce живуть у вашому базовому каталозі Elbuz нарівні з рештою асортименту: їх можна зіставити з позиціями постачальників, порахувати ціни продажу за правилами націнок, налаштувати наявність і стоп-правила, а потім вивантажити на інші канали продажу. Саме заради цього каталог і зводять в одне місце — щоб керувати ним централізовано, а не в адмінці кожного майданчика окремо.
Якщо ви тільки починаєте, орієнтуйтеся на загальну карту дій — з чого почати і куди рухатися. Там по кроках показано весь шлях: від підключення джерела до автооновлення цін, наявності й додавання новинок. Стаття, яку ви читаєте, закриває саме перший крок цього шляху для WooCommerce — підключення й завантаження каталогу.
Коротко порядок такий: після імпорту перевірте кілька карток очима (назви, ціни, картинки, категорії), потім налаштуйте ціноутворення й наявність, і лише коли переконаєтесь, що все рахується правильно, поставте оновлення на розклад. Тоді каталог підтримуватиметься актуальним без вашої участі.
Часті питання
Де створити consumer key і secret?
У самому WooCommerce: «Налаштування → Додатково → REST API», додайте новий ключ і задайте права. WordPress покаже consumer key і consumer secret — скопіюйте обидва одразу, бо секрет показується лише раз.
Чи обов'язкові всі три поля?
Так. Потрібні адреса магазину, consumer key і consumer secret — без будь-якого з них підключення не відбудеться. Це стандартна авторизація WooCommerce REST API.
Які права дати ключу — Читання чи Читання/Запис?
Для завантаження каталогу досить Читання. Якщо плануєте приймати замовлення або вивантажувати ціни й залишки назад на сайт — дайте Читання/Запис.
Як переносяться варіації та категорії?
WooCommerce зберігає варіації як окремі позиції в межах товару, і Elbuz їх розпізнає. Дерево категорій і бренди теж переносяться, тож структура каталогу зберігається.
Ключі правильні, а підключення не працює — чому?
Найчастіше REST API вимкнено або заблоковано плагіном безпеки чи хостингом. Переконайтесь, що адреса через https, REST API увімкнено й сайт відповідає на зовнішні запити. Кнопка «Перевірити підключення» допоможе локалізувати проблему.