Перейти до основного вмісту

Інтеграція з WooCommerce

Інтеграція з WooCommerce дозволяє вивантажувати товари зі Skynum у магазин на WordPress/WooCommerce, оновлювати ціни, залишки, категорії, фото, атрибути і завантажувати замовлення назад у Skynum.

Інтеграція створюється в Налаштування → Інтеграції → Інтернет-магазини.

попередження

Перед першим масовим вивантаженням протестуйте інтеграцію на невеликій категорії товарів. Так легше перевірити категорії, фото, атрибути, варіації і не створити зайві позиції в магазині.

Що потрібно підготувати в WooCommerce

Перед підключенням перевірте магазин WooCommerce:

  • бажано оновити WooCommerce до актуальної версії;
  • у Permalinks не має бути вибрано режим Simple;
  • у WooCommerce → Settings → Advanced → REST API потрібно створити API-ключ;
  • для ключа потрібні права читання та запис;
  • після генерації потрібно скопіювати Ключ і Секрет до закриття сторінки.

Якщо товари вже є в WooCommerce, перевірте SKU/артикул. Саме він часто використовується для зіставлення товарів із Skynum.

Як створити інтеграцію

  1. Відкрийте Налаштування → Інтеграції → Інтернет-магазини.
  2. Натисніть Додати інтеграцію.
  3. Виберіть WooCommerce.
  4. Заповніть Назва магазину.
  5. У полі Хост вкажіть адресу магазину.
  6. Вставте Ключ.
  7. Вставте Секрет.
  8. Збережіть інтеграцію.
  9. Натисніть Перевірити підключення.

У картці інтеграції є вкладки Налаштування інтеграції, API мапінг і Журнал синхронізації.

Якщо товари вже є в WooCommerce

Якщо каталог уже створений у WooCommerce, спочатку підготуйте однаковий ідентифікатор товарів.

У WooCommerce можна експортувати товари в Excel, перевірити поле SKU/артикулу і заповнити його для товарів, де воно порожнє. Якщо окремого артикулу немає, можна використати стабільний ID як основу для SKU.

Після цього імпортуйте оновлений файл назад у WooCommerce і використовуйте відповідне поле в Skynum як Ідентифікатор товара.

Синхронізація товарів

У блоці Товари увімкніть Синхронізація товарів активна.

У перевіреній формі є поля:

  • Інтервал синхронізації;
  • Ідентифікатор товара;
  • Ідентифікатор модифікації;
  • Вивантажувати категорії;
  • Тип ціни товарів;
  • Вивантажувати товари без залишків;
  • Кількість залишків замість статусу наявності;
  • Виключити категорії;
  • Тільки товари з категорії;
  • Тільки залишки по складах.

Після налаштування можна натиснути Вивантажити товари і перевірити результат у WooCommerce.

Ідентифікатор товара і модифікації

Поле Ідентифікатор товара визначає, за яким значенням Skynum зіставляє товар з WooCommerce.

У формі доступні варіанти:

  • Внутрішній ID;
  • Зовнішній ID;
  • Код;
  • Артикул.

Для модифікацій доступні:

  • Внутрішній ID;
  • Зовнішній ID;
  • Код.

У WooCommerce кожна варіація може мати власний SKU. Тому для товарів з модифікаціями важливо вибрати правильний ідентифікатор модифікації.

Категорії

Поле Вивантажувати категорії визначає, чи Skynum має створювати або оновлювати категорії в WooCommerce.

У формі доступні варіанти:

  • Ні;
  • За назвою;
  • За зовнішнім ID.

Якщо структура категорій у WooCommerce відрізняється від Skynum, не вивантажуйте категорії без перевірки. Якщо структура має бути однакова, можна передавати категорії зі Skynum.

Ціни і залишки

У полі Тип ціни товарів вибирається ціна, яка потраплятиме в WooCommerce.

Якщо для магазину потрібна окрема ціна, створіть додаткову ціну і виберіть її в інтеграції.

Прапорець Кількість залишків замість статусу наявності визначає, чи передавати в WooCommerce саме кількість залишку, а не тільки ознаку наявності.

Поле Тільки залишки по складах використовується, коли в інтернет-магазин потрібно передавати залишки не з усіх складів, а тільки з вибраних.

Фото, опис і головне фото

Якщо увімкнено вивантаження фото, Skynum передає фото з картки товару.

Головне фото визначається порядком фото в картці товару: перше фото використовується як основне. Якщо потрібно змінити головне фото в WooCommerce, змініть порядок фото в Skynum і повторіть синхронізацію.

Докладніше про картку товару: Картка товару.

API мапінг

На вкладці API мапінг зіставляються атрибути WooCommerce з характеристиками і модифікаціями Skynum.

Наприклад, характеристику матеріалу можна зіставити з атрибутом Material, розмір — з Size, колір — з Color.

Якщо в WooCommerce використовуються виробники, перевірте, чи підтримує це ваша версія WooCommerce і налаштування магазину.

Перше вивантаження товарів

Після налаштування натисніть Вивантажити товари.

Далі перевірте у WooCommerce:

  • категорії;
  • товари;
  • назви;
  • описи;
  • фото;
  • ціни;
  • залишки;
  • варіації;
  • атрибути.

Результат синхронізації перевіряйте у вкладці Журнал синхронізації.

Синхронізація замовлень

У блоці Замовлення налаштовується завантаження замовлень з WooCommerce у Skynum.

У перевіреній формі є:

  • Синхронізація замовлень активна;
  • Інтервал синхронізації;
  • Резервувати товари після завантаження замовлення;
  • Імпортувати повторно змінені замовлення;
  • Спосіб оновлення замовлень;
  • Заборонити оновлення замовлень у статусі;
  • Спосіб автоматичної оплати виконаних замовлень;
  • Експорт замовлень;
  • Склад за замовчуванням;
  • Канал продажів;
  • Група контрагента.

Після завантаження замовлення стає замовленням покупця у Skynum. Далі менеджер працює з ним у стандартному процесі продажу.

Експорт статусів у WooCommerce

Поле Експорт замовлень визначає, чи передавати зміни зі Skynum назад у WooCommerce.

У перевіреній формі доступні варіанти:

  • Ні;
  • Тільки статус.

Якщо вибрано Тільки статус, після обробки замовлення в Skynum статус може передаватися в WooCommerce згідно з API-мапінгом.

Повторне оновлення замовлень

Параметр Імпортувати повторно змінені замовлення використовується, якщо після першого імпорту замовлення в WooCommerce може змінюватися.

У полі Спосіб оновлення замовлень доступні варіанти:

  • Не оновлювати;
  • Тільки статус;
  • Оновити заповнені;
  • Повністю оновити.
попередження

Не використовуйте повне оновлення без потреби. Якщо менеджер уже змінив замовлення в Skynum, повне оновлення з WooCommerce може перезаписати частину даних.

Коротка перевірка

  • у WooCommerce налаштовані постійні посилання не в режимі Simple;
  • REST API-ключ має права читання і запису;
  • Хост, Ключ і Секрет заповнені в Skynum;
  • підключення перевірене;
  • вибраний правильний ідентифікатор товарів і модифікацій;
  • категорії не перезапишуть потрібну структуру WooCommerce;
  • ціна і склади для залишків вибрані правильно;
  • API-мапінг атрибутів і модифікацій налаштований;
  • перше вивантаження товарів перевірене в WooCommerce;
  • тестове замовлення завантажується в Skynum.

Загальний порядок перевірки описаний у статті Перевірка синхронізації інтеграцій. Якщо обмін не працює очікувано, звірте налаштування з чеклистом типових помилок інтеграцій.

Підсумок

Інтеграція з WooCommerce дозволяє вести каталог і обробку замовлень з боку Skynum. Найважливіше перед стартом — підготувати SKU/ідентифікатори, перевірити категорії, налаштувати API-мапінг і протестувати синхронізацію на невеликій групі товарів.