Інтеграція з WooCommerce
Інтеграція з WooCommerce дозволяє вивантажувати товари зі Skynum у магазин на WordPress/WooCommerce, оновлювати ціни, залишки, категорії, фото, атрибути і завантажувати замовлення назад у Skynum.
Інтеграція створюється в Налаштування → Інтеграції → Інтернет-магазини.
Перед першим масовим вивантаженням протестуйте інтеграцію на невеликій категорії товарів. Так легше перевірити категорії, фото, атрибути, варіації і не створити зайві позиції в магазині.
Що потрібно підготувати в WooCommerce
Перед підключенням перевірте магазин WooCommerce:
- бажано оновити WooCommerce до актуальної версії;
- у Permalinks не має бути вибрано режим Simple;
- у WooCommerce → Settings → Advanced → REST API потрібно створити API-ключ;
- для ключа потрібні права читання та запис;
- після генерації потрібно скопіювати Ключ і Секрет до закриття сторінки.
Якщо товари вже є в WooCommerce, перевірте SKU/артикул. Саме він часто використовується для зіставлення товарів із Skynum.
Як створити інтеграцію
- Відкрийте Налаштування → Інтеграції → Інтернет-магазини.
- Натисніть Додати інтеграцію.
- Виберіть WooCommerce.
- Заповніть Назва магазину.
- У полі Хост вкажіть адресу магазину.
- Вставте Ключ.
- Вставте Секрет.
- Збережіть інтеграцію.
- Натисніть Перевірити підключення.
У картці інтеграції є вкладки Налаштування інтеграції, 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-мапінг і протестувати синхронізацію на невеликій групі товарів.