Интеграция с 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.

Это выполняется как фоновая задача. Вы можете отслеживать прогресс на странице история выдач.

Что отправляется

Когда товар отправляется в 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

  • Дата заказа и валюта

  • Позиции заказа: каждая строка заказа включает товар (сопоставленный по WooCommerce ID или SKU), количество, цены (без НДС и с НДС) и налоговую ставку

  • Списание запасов: запасы автоматически списываются для каждой позиции заказа

Примечание

Импортируются только заказы со статусом завершён. Заказы с другими статусами (например, в обработке, на удержании, ожидающие) пропускаются.

Примечание

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

История выдач

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

  • Время начала и окончания

  • Статус (начато, завершено, не выполнено или частично выполнено)

  • Общее количество обработанных заказов, созданных новых заказов, пропущенных и неудачных

  • Продолжительность и сообщения об ошибках (если есть)