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

Інтеграція з 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.

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

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

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

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

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

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

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

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

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

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

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

Підсумок​

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

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