WooCommerce интеграция

WooCommerce интеграцията Ви позволява да свържете Вашия онлайн магазин в WooCommerce с Gem Logic. След свързване можете да изпращате продукти от Gem Logic към Вашия магазин в WooCommerce и да изтегляте поръчки от WooCommerce в Gem Logic. Това поддържа синхронизирани Вашия продуктов каталог и управлението на поръчки между двете платформи.

Конфигурация

Генериране на API ключове в WooCommerce

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

  1. Влезте във Вашия административен панел на WordPress.

  2. Навигирайте до WooCommerce ‣ Settings ‣ Advanced ‣ REST API.

  3. Кликнете върху Add key.

  4. Попълнете данните:

    • Description: въведете име за идентифициране на този ключ (напр. Gem Logic Integration).

    • User: изберете потребителя на WordPress, който ще се използва за API връзката.

    • Permissions: изберете Read/Write. Това е необходимо, за да може Gem Logic едновременно да чете поръчки и да създава/актуализира продукти във Вашия магазин.

  5. Кликнете върху Generate API key.

  6. Копирайте Consumer key и Consumer secret. Те ще бъдат показани само веднъж, затова задължително ги запазете на сигурно място.

Important

Consumer secret се показва само веднъж. Ако го загубите, ще трябва да оттеглите ключа и да генерирате нов.

Свързване на WooCommerce с Gem Logic

  1. В Gem Logic отидете на Configuration ‣ Sales channels.

  2. Отворете канала за продажби, който искате да свържете с WooCommerce, или създайте нов.

  3. Активирайте квадратчето WooCommerce.

  4. Попълнете следните полета:

    • URL: пълният URL адрес на Вашия WooCommerce магазин (напр. https://www.vashmagazin.com). Не включвайте наклонена черта в края.

    • WooCommerce Key: поставете Consumer key, който генерирахте по-рано.

    • WooCommerce Secret: поставете Consumer secret, който генерирахте по-рано.

  5. Ако използвате приставката Perfect WooCommerce Brands във Вашия WooCommerce магазин, активирайте квадратчето WooCommerce brands plugin. Това позволява на Gem Logic да синхронизира марките на продуктите с WooCommerce.

  6. Запазете канала за продажби.

Tip

Уверете се, че Вашият WooCommerce магазин използва HTTPS. API удостоверенията се криптират и съхраняват сигурно в Gem Logic.

Назначаване на продукти към канал за продажби

За да бъдат изпратени продуктите към WooCommerce, те трябва да бъдат назначени към канала за продажби WooCommerce.

  1. Отидете на Products.

  2. Отворете продукт и отидете на секция sales channels.

  3. Добавете канала за продажби WooCommerce към продукта.

  4. Уверете се, че продуктът има конфигурирано правило за ценообразуване за този канал за продажби, така че да има цена при изпращане към 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)

  • Тагове

  • Количества на склад

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

  • Варианти на продукт (за променливи продукти)

Note

Продуктите, които вече съществуват в Gem Logic (съпоставени по WooCommerce ID или SKU), се пропускат по време на импорта. Създават се само нови продукти.

Изтегляне на поръчки

Можете да изтегляте завършени поръчки от WooCommerce в Gem Logic.

Изтегляне на поръчки ръчно

  1. Отидете на Configuration ‣ Sales channels.

  2. Отворете канала за продажби WooCommerce.

  3. Натиснете Изтегли поръчки от WooCommerce.

Това се изпълнява като фонова задача. Ще бъдете пренасочени към страницата история на изтегляния, където можете да следите напредъка в реално време.

Автоматично изтегляне на поръчки

Поръчките могат да се изтеглят автоматично по график с помощта на системата за фонови задачи. Това гарантира, че нови завършени поръчки се импортират редовно без ръчна намеса.

Какво се импортира

Когато поръчките се изтеглят от WooCommerce, се импортират следните данни:

  • Ключ на поръчката (използва се като уникален идентификатор на поръчката)

  • Контактна информация на клиента (име, адрес, имейл, телефон) — контакт се създава или актуализира в CRM

  • Дата на поръчката и валута

  • Редове на поръчката: всеки ред включва продукта (съпоставен по WooCommerce ID или SKU), количество, цени (без и с ДДС) и данъчна ставка

  • Приспадане на наличност: наличността се приспада автоматично за всеки ред на поръчката

Note

Импортират се само поръчки със статус завършена. Поръчки с други статуси (напр. в обработка, на изчакване, чакащи) се пропускат.

Note

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

История на изтегляния

Всяка операция по изтегляне се записва. Можете да видите историята на изтеглянията от страницата с детайли на канала за продажби. Всеки запис показва:

  • Начална и крайна дата

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

  • Общ брой обработени поръчки, създадени нови поръчки, пропуснати и неуспешни броячи

  • Продължителност и евентуални съобщения за грешки