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

Інтеграція з WooCommerce дозволяє підключити Ваш інтернет-магазин WooCommerce до Gem Logic. Після підключення Ви можете передавати продукти з Gem Logic у Ваш магазин WooCommerce і отримувати замовлення з WooCommerce у Gem Logic. Це підтримує синхронізацію Вашого каталогу продуктів та управління замовленнями між обома платформами.

Налаштування

Створення ключів API у WooCommerce

Перш ніж підключати WooCommerce до Gem Logic, Вам потрібно створити ключі API у Вашому магазині WooCommerce.

  1. Увійдіть до адміністративної панелі WordPress.

  2. Перейдіть до WooCommerce ‣ Налаштування ‣ Розширені ‣ REST API.

  3. Натисніть Додати ключ.

  4. Заповніть деталі:

    • Опис: введіть назву для ідентифікації цього ключа (наприклад, Інтеграція з Gem Logic).

    • Користувач: виберіть користувача WordPress, який буде використовуватися для API-з’єднання.

    • Дозволи: виберіть Читання/Запис. Це необхідно, щоб Gem Logic міг як читати замовлення, так і створювати/оновлювати продукти у Вашому магазині.

  5. Натисніть Створити ключ API.

  6. Скопіюйте Ключ споживача та Секрет споживача. Вони будуть показані лише один раз, тому обов’язково збережіть їх у безпечному місці.

Важливо

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

Підключення WooCommerce до Gem Logic

  1. У Gem Logic перейдіть до Configuration ‣ Sales channels.

  2. Відкрийте канал продажів, який бажаєте підключити до WooCommerce, або створіть новий.

  3. Увімкніть прапорець WooCommerce.

  4. Заповніть наступні поля:

    • URL: повна URL-адреса Вашого магазину WooCommerce (наприклад, https://www.yourstore.com). Не додавайте завершальний слеш.

    • WooCommerce Key: вставте Consumer key, який Ви згенерували раніше.

    • WooCommerce Secret: вставте Consumer secret, який Ви згенерували раніше.

  5. Якщо Ви використовуєте плагін Perfect WooCommerce Brands у Вашому магазині WooCommerce, увімкніть прапорець WooCommerce brands plugin. Це дозволить Gem Logic синхронізувати бренди товарів із WooCommerce.

  6. Збережіть канал продажів.

Порада

Переконайтеся, що Ваш магазин WooCommerce використовує HTTPS. Облікові дані API зашифровані та безпечно зберігаються в Gem Logic.

Призначення товарів до каналу продажів

Щоб товари передавалися до WooCommerce, їх необхідно призначити до каналу продажів WooCommerce.

  1. Перейдіть до Products.

  2. Відкрийте товар і перейдіть до його розділу sales channels.

  3. Додайте канал продажів WooCommerce до товару.

  4. Переконайтеся, що для товару налаштовано pricing rule для цього каналу продажів, щоб він мав ціну при передачі до WooCommerce.

Передача товарів

Ви можете передавати товари з Gem Logic до Вашого магазину WooCommerce. Це створює або оновлює товари в WooCommerce на основі даних із Gem Logic.

Передача одного товару

Щоб передати один товар, відкрийте товар у Gem Logic і скористайтеся дією передачі з розділу каналів продажів товару. Товар буде створено в WooCommerce, якщо він ще не існує, або оновлено, якщо у нього вже є ідентифікатор WooCommerce.

Передача всіх товарів

Щоб передати всі товари, призначені до каналу продажів WooCommerce, одночасно:

  1. Перейдіть до Configuration ‣ Sales channels.

  2. Відкрийте канал продажів WooCommerce.

  3. Натисніть Push all products to WooCommerce.

Це виконується як фонова задача. Ви можете відстежувати прогрес на сторінці push history.

Що передається

Коли товар передається до WooCommerce, синхронізуються наступні дані:

  • SKU (використовується для співставлення товарів між двома системами)

  • Назва та опис (на основі мови каналу продажів)

  • Звичайна ціна та акційна ціна (із правила ціноутворення для цього каналу продажів)

  • Зображення (повторно завантажуються лише за наявності змін)

  • Категорії та колекції (створюються у WooCommerce, якщо не існують)

  • Атрибути (створюються як глобальні атрибути WooCommerce)

  • Теги

  • Кількість на складі

  • Бренди (якщо плагін WooCommerce brands увімкнено)

  • Тип продукту: простий або варіативний (з варіантами)

Варіативні продукти та варіанти

Якщо продукт у Gem Logic позначено як батьківський продукт, він передається як варіативний продукт у WooCommerce. Усі його дочірні продукти (варіанти) передаються як варіації продукту. Кожен варіант включає власну ціну, SKU, зображення та значення атрибутів (наприклад, розмір, колір).

Деактивація продукту

Ви можете деактивувати продукт у WooCommerce з Gem Logic. Це встановлює статус продукту як чернетка у WooCommerce, роблячи його невидимим у вітрині без видалення.

Історія передач

Кожна операція передачі реєструється. Ви можете переглянути історію передач на сторінці деталей каналу продажів. Кожен запис історії показує:

  • Час початку та завершення

  • Статус (розпочато, завершено, невдало або частковий успіх)

  • Загальна кількість продуктів, успішних і невдалих

  • Відсоток успіху та тривалість

  • Детальні результати по кожному продукту (натисніть Переглянути деталі, щоб побачити, які продукти успішні або невдалі)

Завантаження продуктів

Ви можете завантажити продукти з Вашого магазину WooCommerce до Gem Logic. Це корисно для початкового імпорту, коли Ви вперше підключаєте свій магазин.

  1. Перейдіть до Configuration ‣ Sales channels.

  2. Відкрийте канал продажів WooCommerce.

  3. Натисніть Завантажити продукти з WooCommerce.

Це виконується як фонова задача та імпортує наступні дані для кожного продукту:

  • SKU, назва та опис

  • Звичайна ціна та ціна зі знижкою

  • Категорії та бренди

  • Зображення (завантажені та збережені в Gem Logic)

  • Теги

  • Кількості на складі

  • Атрибути та метали

  • Варіанти продукту (для варіативних продуктів)

Примітка

Продукти, які вже існують у Gem Logic (зіставлені за ідентифікатором WooCommerce або SKU), пропускаються під час імпорту. Створюються лише нові продукти.

Завантаження замовлень

Ви можете завантажити завершені замовлення з WooCommerce до Gem Logic.

Завантажити замовлення вручну

  1. Перейдіть до Configuration ‣ Sales channels.

  2. Відкрийте канал продажів WooCommerce.

  3. Натисніть Завантажити замовлення з WooCommerce.

Це виконується як фонове завдання. Вас буде перенаправлено на сторінку історія видач, де Ви зможете стежити за прогресом у реальному часі.

Автоматичне завантаження замовлень

Замовлення також можуть завантажуватися автоматично за розкладом за допомогою системи фонових завдань. Це забезпечує регулярний імпорт нових завершених замовлень без ручних дій.

Що імпортується

Коли замовлення завантажуються з WooCommerce, імпортуються такі дані:

  • Ключ замовлення (використовується як унікальний ідентифікатор замовлення)

  • Контактна інформація клієнта (ім’я, адреса, електронна пошта, телефон) — контакт створюється або оновлюється в CRM

  • Дата замовлення та валюта

  • Рядки замовлення: кожен рядок містить товар (зіставлений за ID WooCommerce або SKU), кількість, ціни (без ПДВ та з ПДВ) і податкову ставку

  • Списання запасів: запаси автоматично списуються для кожного рядка замовлення

Примітка

Імпортуються лише замовлення зі статусом завершено. Замовлення з іншими статусами (наприклад, в обробці, очікує, призупинено) пропускаються.

Примітка

Замовлення, які вже були імпортовані (зіставлені за ключем замовлення), пропускаються для уникнення дублікатів.

Історія видач

Кожна операція завантаження реєструється. Ви можете переглянути історію видач на сторінці деталей каналу продажів. Кожен запис історії показує:

  • Час початку та завершення

  • Статус (розпочато, завершено, невдало або частковий успіх)

  • Загальна кількість оброблених замовлень, створених нових замовлень, пропущених і невдалих

  • Тривалість і будь-які повідомлення про помилки