Імпорт каталогу з WooCommerce через API

WooCommerce — найпоширеніший рушій інтернет-магазинів на WordPress. Якщо ваш магазин на ньому, каталог уже є на сайті, і Elbuz забирає його напряму через REST API WooCommerce — без вивантаження файлів. Далі товари живуть у вашому базовому каталозі Elbuz, звідки ви керуєте цінами й наявністю та роздаєте асортимент на інші канали продажу.

Ця стаття — про підключення саме WooCommerce. Загальний порядок для будь-якого API-джерела описано в огляді імпорту каталогу через API; тут — особливості WooCommerce: які ключі потрібні, де їх узяти і що приходить у каталог. Про завантаження даних загалом дивіться огляд завантаження.

Де це у програмі

У вікні імпорту створіть шаблон і оберіть тип «WooCommerce». Це API-джерело: файл не потрібен, підключення відбувається за адресою магазину й парою ключів. Один шаблон — одне підключення до одного сайту. Якщо магазинів кілька, під кожен заведіть окремий шаблон.

1

Адреса магазину

2

Consumer key

3

Consumer secret

4

Кнопка «Перевірити підключення»

1. Адреса магазину — посилання на ваш сайт WooCommerce, наприклад https://store.com.
2. Consumer key — публічний ключ REST API з розділу «WooCommerce → Налаштування → Додатково → REST API».
3. Consumer secret — секретний ключ тієї ж пари API-ключів.
4. Кнопка «Перевірити підключення» — перевіряє введені дані без запуску завантаження.

Що потрібно для підключення

WooCommerce не має «застосунку розробника» чи коду прив'язки — підключення відбувається за трьома значеннями, які потрібні всі три:

• Адреса магазину — повний URL вашого сайту, наприклад https://store.com. Обов'язково через https.
• Consumer key — ключ доступу, починається з ck_.
• Consumer secret — секрет, починається з cs_.

Де взяти ключі: крок за кроком

Після створення WooCommerce одразу покаже consumer key і consumer secret — скопіюйте обидва, бо секрет показується лише раз. Якщо ключ загубився, його не відновлюють, а створюють новий і відкликають старий.

Як підключити крок за кроком

Створіть шаблон типу «WooCommerce». У картці «Підключення» введіть адресу магазину, consumer key і consumer secret. Скористайтесь кнопкою «Перевірити підключення» — вона одразу скаже, чи приймає сайт ваші ключі, ще до першого завантаження. Потім у картці «Вибір даних для завантаження» увімкніть потрібне — товари, а за потреби й замовлення — збережіть і запустіть. Перше підключення забирає каталог, наступні оновлюють його.

Що потрапляє в картку: маппінг полів

WooCommerce віддає найбагатший набір даних серед усіх джерел — Elbuz розкладає товар у поля картки так:

Кілька нюансів, які пояснюють «чому в картці саме така цифра». Ціна: якщо на сайті стоїть акційна ціна, вона й стає ціною картки, а звичайна перетворюється на «стару ціну» — так знижка видно в Elbuz так само, як на вітрині. Залишок: коли в товару ввімкнено облік складу, переноситься точна кількість; якщо облік вимкнено, WooCommerce знає лише «є / немає» — і в картку приїжджає 1 або 0. Штрихкод: WooCommerce не має власного поля GTIN, тому Elbuz шукає його в додаткових полях, які створюють популярні плагіни, і залишає з нього лише цифри.

Окремо варто відзначити SEO: якщо на сайті стоїть Yoast SEO або Rank Math, заголовок і опис сторінки товару теж переїжджають у картку. Це рідкість серед джерел — зазвичай SEO-тексти доводиться писати заново, а тут вони зберігаються разом із товаром.

Категорії, бренди й варіації

Категорії приходять не пласким списком, а повним шляхом: Elbuz окремо читає дерево категорій магазину й відновлює вкладеність, тож структура каталогу на сайті повторюється в базовому каталозі. Бренд береться з відповідного поля товару й стає виробником. Варіації (розміри, кольори, комплектації) WooCommerce зберігає як окремі позиції всередині товару: кожна приходить своєю карткою з назвою на кшталт «Назва товару — S / Black», зі своєю ціною, залишком і артикулом, а всі варіації одного товару зв'язуються в сім'ю. Осі варіації (Розмір, Колір) стають опціями, а звичайні атрибути товару — характеристиками.

Варто розуміти й обсяг завантаження. WooCommerce віддає товари, варіації та категорії окремими наборами й сторінками фіксованого розміру, тож для великого магазину повний прохід забирає більше часу — програма послідовно збирає всі сторінки. Це не зависання, а звичайний хід. Але коротшими наступні прогони не стають: добору «тільки те, що змінилося» для каталогу в цьому підключенні немає, і кожне оновлення заново проходить усі сторінки. Точні числа — у розділі про обсяг одного прогону.

Що робить повторний прогін із вашими правками

Кожен запуск — це повне дзеркало каталогу сайту. Прогін проходить усі сторінки товарів WooCommerce і перезаписує ними картки, тож виправлення, зроблені в Elbuz, живуть рівно до наступного оновлення. Попередження при цьому не буває.

Значеннями з сайту перезаписуються: назва, повний і короткий опис, ціна, стара ціна, кількість і наявність, артикул, штрихкод, вага, виробник, мітки, SEO-заголовок і опис, а також активність картки. Наявність рахується з кількості: більше нуля — статус «В наявності», нуль — «Немає на складі».

Чого повторний прогін у вже заведеної картки не чіпає:

• Фото. Галерея заливається лише в момент створення картки. Замінили знімок у Elbuz — оновлення його не зітре; але й нове фото, додане на сайті, до старої картки вже не доїде.
• Характеристики. Наявні значення лишаються як були, а нові атрибути з сайту в стару картку не дописуються.
• Місце в дереві категорій. Перенесли картку у свою категорію — там вона й залишиться.
• Закупівельну ціну. WooCommerce її не віддає, тож прогін її не торкається — усе, що ви рахуєте від закупівельної, лишається вашим.

Закріпити картку цілком можна одним способом — перемикачем «Не оновлювати» в самому товарі (той самий прапорець є колонкою «Не оновлювати (прапор)» у вікні «Товари», і проставити його можна прямо в сітці). Картка з цією позначкою виводиться з-під оновлення повністю: ні назва, ні ціна, ні залишок, ні активність у ній не зміняться. Загальний механізм захисту описано в огляді API-завантаження, а для WooCommerce важлива одна поправка: сусідній перемикач «Фіксована ціна» тут не рятує — завантаження з WooCommerce його не перевіряє й ціну з сайту запише попри нього.

Товар зник із сайту або став чернеткою

Прогін оновлює лише те, що прийшло у відповіді. Товар, який на сайті видалили, у вибірку більше не потрапляє — і картка в Elbuz лишається такою, якою була: з останньою відомою ціною й останнім відомим залишком. Вона не вимикається, залишок не обнуляється, у журналі про неї нічого не пишеться. Галочки «видаляти те, чого немає в джерелі» для WooCommerce не передбачено, тож зняті з продажу позиції прибирають руками — інакше вони тихо їдуть у ваші вивантаження зі старими цифрами.

Інша річ — товар, який лишився на сайті, але змінив стан. Активність картки ставиться рівно за станом WooCommerce: publish — картка ввімкнена, будь-який інший стан (чернетка, приватний, у кошику) — вимкнена. Переведення товару в чернетку гасить картку наступним прогоном, повернення до публікації — вмикає її назад.

Звідси й відповідь на зворотне питання. Якщо ви зняли «Активність» вручну, а на сайті товар опублікований, наступний прогін увімкне картку назад: стан приходить із сайту нарівні з ціною. Утримати картку вимкненою можна лише позначкою «Не оновлювати».

Саме по собі зняття активності нічого не видаляє: картка, її описи, фото, характеристики, прив'язка до сайту й місце в дереві лишаються на місці, і повернути все назад можна тим самим перемикачем. Змінюється відбір — у новому шаблоні вивантаження за замовчуванням стоїть правило p.status = 1, тобто вимкнені картки у вивантаження не потрапляють, доки ви це правило не змінили.

Чия ціна лишиться в картці

Усередині WooCommerce перевагу має акційна ціна — про це вище. Але на ту саму колонку ціни в Elbuz претендують ще два механізми, і порядок між ними жорсткий.

Спочатку прогін записує ціну з сайту. Одразу після того, як усі сторінки зібрані, по щойно створених картках відпрацьовує націнка базового каталогу: вона рахує ціну продажу із закупівельної й кладе результат у ту саму колонку. Спрацьовує вона лише там, де закупівельна більша за нуль. WooCommerce закупівельної не віддає, тому в новій картці вона нульова — правило її не чіпає, і в картці лишається ціна сайту. Карток, які вже були в каталозі, цей крок не торкається взагалі: після завантаження націнка проходить тільки по товарах, створених самим прогоном.

Обидва перемикачі картки виводять її з-під націнки — і «Фіксована ціна», і «Не оновлювати». Різниця в тому, що від запису ціни самим імпортом WooCommerce захищає лише друга.

Останнім кроком прогін перераховує поля за вашими формулами — у журналі це рядок «Оновлення значень на основі формул». Ідуть тільки ті формули, у яких увімкнено застосування під час завантаження; якщо якась із них рахує ціну, останнє слово буде за нею.

Каталог і замовлення

Те саме підключення вміє забирати не лише каталог, а й замовлення магазину. Для цього ключі мають мати права Читання/Запис, а в шаблоні — бути ввімкненим відповідний перемикач. Elbuz забиратиме нові й змінені замовлення, і вони потраплятимуть у ваші документи. Ця стаття — про каталог; хочете тільки товари — лишіть замовлення вимкненими, зайве не завантажуватиметься.

Замовлення з WooCommerce лягає документом «Замовлення покупця» і лягає непроведеним — тобто саме по собі завантаження наявність у каталозі не зрушить: ні залишок, ні резерв не зміняться, поки документ не проведуть. Загальний порядок описано в огляді API-завантаження, а особливостей у WooCommerce чотири:

• Статус документа береться зі стану замовлення WooCommerce — pending, processing, on-hold, completed, cancelled, refunded, failed — через зіставлення статусів у картці шаблону. Незіставлений стан лягає з першим статусом довідника — «Новий».
• Ознака оплати береться не зі статусу замовлення, а з факту дати оплати: є дата оплати — у зіставлення йде код paid, немає — unpaid. Що з цього стане статусом оплати документа, вирішує зіставлення статусів оплати в картці шаблону.
• Служба доставки береться з першого рядка доставки замовлення, разом із її назвою на сайті.
• Рядок замовлення шукає картку за ідентифікатором варіації, якщо покупець узяв варіацію, і за ідентифікатором товару в решті випадків.

Перший прогін забирає всі замовлення в будь-якому стані. Наступні — лише ті, що змінилися після дати останнього завантаженого замовлення (дата рахується за Гринвічем, як її віддає WooCommerce), і саме на цих прогонах уже заведений документ оновлюється новими даними. Дубля не буде в жодному разі: документ шукається за ідентифікатором замовлення в WooCommerce разом із кодом джерела. Кількість отриманих замовлень видно в журналі рядком «Отримано замовлень:».

Службова категорія й довідник виробників

Категорія приходить із сайту повним шляхом, і розкладає товар програма в три кроки: спершу шукає вашу категорію з таким самим повним шляхом, потім — категорію з такою самою назвою будь-де в дереві (перебираючи шлях від листа до кореня), і лише якщо не знайшла жодної — створює нову гілку цілком. Тому дублів на кшталт «Ноутбуки (2)» не з'являється, доки назви збігаються.

Товари, у яких категорії на сайті немає взагалі, підключення складає в окрему службову категорію «Товари - woocommerce». Вона створюється вимкненою і без участі у вивантаженнях, тобто такі товари самі собою на інші канали не поїдуть, поки ви їх не розкладете.

Розкладати картки з неї можна вільно: основну категорію вже заведеної картки повторний прогін не переписує, а в рядках документів категорії немає взагалі — назва, артикул і ціна в уже виписаному замовленні чи накладній зберігаються окремо. Перенесення товару на документи не впливає ніяк.

Виробник заповнюється з бренда товару WooCommerce; якщо брендів у магазині немає, поле лишається порожнім. Новий бренд додається в довідник виробників сам, із позначкою, з якого підключення він прийшов. Перейменовувати такі бренди в Elbuz немає сенсу: наступний прогін не знайде бренд під новою назвою й заведе його ще раз під старою. Назву бренда міняють на боці WooCommerce.

Навіщо зводити каталог WooCommerce в Elbuz

Сам по собі WooCommerce добре тримає вітрину, але не заточений під керування великим асортиментом і зв'язок із постачальниками. Elbuz забирає каталог сайту до себе й дає єдине місце, де ви рахуєте ціни за правилами націнок, стежите за наявністю й наповнюєте картки. Ціни та наявність можна тримати актуальними автоматично: вони тягнуться з прайсів постачальників у Elbuz, а звідти вивантажуються назад на сайт.

Це особливо зручно, коли WooCommerce не єдиний канал: той самий товар живе і на сайті, і на маркетплейсах, а редагуєте ви його в одному місці — в Elbuz — і зміни розходяться туди, куди потрібно.

Оновлення за розкладом

Коли підключення налаштовано й перевірено, поставте шаблон на розклад кнопкою налаштування завдання прямо у формі. Elbuz сам звертатиметься до сайту за свіжими даними: ціни й залишки оновлюватимуться, нові товари додаватимуться. WooCommerce віддає каталог сторінками, тож великі магазини вантажаться поступово — це нормально. Кожен запуск лишає слід у журналі: скільки товарів оновлено, скільки додано, чи були помилки; перші кілька разів варто туди зазирати.

Якщо прогін обірвався посередині

Товари не чекають кінця прогону: вони лягають у каталог пачками по 500 позицій, щойно пачка набереться. Тому обрив ділить каталог надвоє — усе, що встигло дійти, вже оновлене, решта лишилася зі старими даними.

Коротку неприємність на боці сайту програма переживає сама. Якщо магазин відповідає «забагато запитів» чи «сервіс недоступний» або віддає замість даних сторінку захисту, той самий запит виконується до чотирьох разів — із паузою, яку назвав сам сайт (але не довшою за 30 секунд), а якщо не назвав — 2, 4, 6 і 8 секунд. Відповіді на один запит програма чекає 180 секунд, на встановлення з'єднання — 30 секунд. Якщо зв'язок обірвався або сайт так і не відповів, прогін зупиняється й пише в журнал червоний рядок «WooCommerce: помилка API —» з текстом причини від самого магазину.

Негайний повтор безпечний: картка шукається за назвою, тож прогін просто перезапише ті самі позиції й добере ті, до яких не дійшов. Дублів не з'явиться ні в каталозі, ні в замовленнях. Єдине, чого обірваний прогін не встиг, — завершальна націнка: вона йде після того, як зібрані всі сторінки. Наступний успішний прогін доводить до ладу й ті товари, що лишилися від обірваного.

Скільки тягнеться за один прогін

Стелі на кількість товарів немає: скільки віддасть магазин, стільки й приїде. А от розміри порцій жорсткі й від обсягу каталогу не залежать:

• 100 товарів на сторінку — це максимум, який дозволяє сам WooCommerce.
• 100 варіацій на сторінку, і забираються вони окремим запитом на кожен багатоваріантний товар. Тобто магазин із розмірами й кольорами робить до сайту більше звернень, ніж такий самий за розміром магазин простих товарів: на кожен товар з варіаціями іде щонайменше один додатковий запит.
• 100 категорій на сторінку — дерево категорій магазину читається один раз на початку прогону, щоб зібрати повні шляхи.
• 100 замовлень на сторінку, якщо перемикач замовлень увімкнено.
• 500 позицій в одній пачці запису в базовий каталог.

Кожна сторінка лишає в журналі свій рядок — «WooCommerce: сторінка каталогу 3, отримано товарів: 300», — а в кінці стоїть підсумок «WooCommerce: каталог завантажено, товарів: N». За ними й видно, що прогін іде, а не завис.

Вікно можна закривати. Журнал прогону живе в Центрі операцій — правій панелі, яка не блокує роботу, тож картку шаблону можна закрити й стежити за завантаженням із будь-якого місця програми. Скільки триває саме ваш каталог, вигадувати не треба: колонка «Витрачено часу» у списку шаблонів і кнопка «Історія запусків» у шапці картки показують це за фактом.

• Не забирає закупівельні ціни. WooCommerce їх не зберігає. Закупівельна в картку потрапляє з прайсу постачальника, і саме від неї рахуються правила націнки.
• Не прибирає те, чого не стало на сайті. Видалений товар лишається в каталозі зі старими цифрами, доки ви не приберете його самі.
• Не оновлює фото й характеристики вже заведених карток. І те, й інше заливається лише в момент створення картки.
• Не повертає ціни й залишки на сайт. Це вміє те саме підключення, але з боку вікна «Вивантаження даних» — окремим шаблоном і своїм розкладом.

Якщо прогін зробив не те

Картки, які завело це підключення, збираються у вікні «Товари» фільтром по колонках «Джерело: назва» (назва вашого шаблона) і «Джерело: код» (тут це woocommerce). Позначка ставиться в момент створення картки й далі не змінюється: вона показує, хто картку завів, а не хто востаннє її перезаписав. Виділили рядки — і видалили пакетом; тим самим прибирають і дублі, що з'явилися після перейменування товару на сайті.

Картки, які у вас уже були і які прогін лише перезаписав, цей фільтр не покаже — джерело в них лишилося старим. Їх шукають по колонці «Дата оновлення»: програма ставить її автоматично кожній картці, яку прогін змінив, тож усе, що він зачепив, збирається відбором за сьогоднішньою датою.

Повернути старі значення масово в Elbuz нема чим — завантаження журналу правок не веде, тож відкотити його одним рухом не вийде. Але для WooCommerce є свій вихід, якого немає у файлових завантаженнях: кожен прогін дзеркалить сайт, тому правильні дані повертають на боці 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 увімкнено й сайт відповідає на зовнішні запити. Кнопка «Перевірити підключення» допоможе локалізувати проблему.

Чи затре повторний прогін мої правки в картці?

Так. Назву, описи, ціну, залишок, бренд і активність наступне оновлення поверне зі стану сайту, без попередження. Фото й характеристики вже заведених карток воно не чіпає, а місце товару у вашій категорії не змінює. Щоб закріпити картку цілком, поставте в ній перемикач «Не оновлювати»: «Фіксована ціна» від запису ціни з WooCommerce не захищає.

Що буде з товаром, якого не стало на сайті?

Нічого: картка лишається в каталозі з останньою ціною й останнім залишком, не вимикається й у журналі не згадується. Видаляти такі позиції треба самому. А от товар, переведений у чернетку, приїде вимкненим — активність картки завжди повторює стан товару в WooCommerce.

Чи можна видалити категорію «Товари - woocommerce»?

Тільки після того, як перенесете з неї товари: видалення категорії забирає з собою всі товари, у яких вона основна, разом з описами, фото й характеристиками. Перенесення карток у свої категорії безпечне — повторний прогін їх назад не поверне, а на виписані документи це не впливає. Наступний прогін створить службову категорію знову, щойно з сайту прийде товар без категорії.

Чи можна закрити вікно, поки йде завантаження?

Так. Журнал прогону живе в Центрі операцій — правій панелі, яка не блокує роботу. Каталог приходить сторінками по 100 товарів і лягає в базовий каталог пачками по 500 позицій, тож обрив зв'язку лишає вже завантажене на місці, а повтор просто добирає решту.