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

Інтеграція з 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 як Ідентифікатор товара.

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

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

Основні налаштування товарів:

  • Інтервал синхронізації — задає період автоматичного вивантаження товарів;
  • Ідентифікатор товара — визначає, за яким полем Skynum зіставляє товар із товаром WooCommerce;
  • Ідентифікатор модифікації — визначає ключ зіставлення для варіацій;
  • Вивантажувати категорії — керує створенням або оновленням категорій у 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.

Основні налаштування замовлень:

  • Синхронізація замовлень активна — вмикає завантаження замовлень з WooCommerce;
  • Інтервал синхронізації — задає період автоматичного завантаження замовлень;
  • Резервувати товари після створення замовлення — резервує товари після імпорту замовлення;
  • Імпортувати повторно змінені замовлення — дозволяє повторно оновлювати замовлення, які змінилися у WooCommerce;
  • Спосіб оновлення замовлень — визначає, які дані Skynum оновлює при повторному імпорті;
  • Заборонити оновлення замовлень у статусі — захищає вибрані статуси від змін через інтеграцію;
  • Створити пов'язаний платіж на суму оплати — вмикає створення окремого платежу за переданою сумою оплати;
  • Фіскалізація платежу — запускає фіскалізацію автоматично створеного платежу;
  • ПРРО для фіскалізації — визначає фіскальний сервіс для автоматичного чека;
  • Експорт замовлень — визначає, чи передавати зміни зі Skynum назад у WooCommerce;
  • Склад за замовчуванням — використовується для резервування та обліку товарів із замовлення;
  • Канал продажів — позначає джерело продажу в аналітиці;
  • Група контрагента — задає групу для нових покупців.

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

Оплата і фіскалізація​

Для автоматичної оплати замовлень у блоці Замовлення увімкніть Створити пов'язаний платіж на суму оплати. Коли WooCommerce передає суму оплати, а зовнішній спосіб оплати зіставлений зі способом оплати Skynum на вкладці API мапінг, Skynum створює пов'язаний платіж до замовлення.

Для автофіскалізації увімкніть Фіскалізація платежу і виберіть ПРРО для фіскалізації. Після створення платежу Skynum запускає фіскалізацію цього платежу. Спосіб оплати Skynum має бути пов'язаний із касою або банківським рахунком.

Докладніше:

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

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

Доступні варіанти:

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

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

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

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

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

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

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

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

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

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

Підсумок​

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

Останнє оновлення