Integrace WooCommerce

Integrace WooCommerce Vám umožňuje propojit Váš online obchod WooCommerce s Gem Logic. Po připojení můžete posílat produkty z Gem Logic do Vašeho obchodu WooCommerce a stahovat objednávky z WooCommerce do Gem Logic. Tím zajistíte synchronizaci Vašeho produktového katalogu a správy objednávek mezi oběma platformami.

Konfigurace

Vygenerování API klíčů ve WooCommerce

Před propojením WooCommerce s Gem Logic musíte vygenerovat API klíče ve Vašem obchodě WooCommerce.

  1. Přihlaste se do administračního panelu WordPress.

  2. Přejděte na WooCommerce ‣ Nastavení ‣ Pokročilé ‣ REST API.

  3. Klikněte na Přidat klíč.

  4. Vyplňte podrobnosti:

    • Popis: zadejte název pro identifikaci tohoto klíče (např. Integrace Gem Logic).

    • Uživatel: vyberte uživatele WordPress, který bude použit pro API připojení.

    • Oprávnění: vyberte Čtení/Zápis. To je nutné, aby Gem Logic mohl jak číst objednávky, tak vytvářet a aktualizovat produkty ve Vašem obchodě.

  5. Klikněte na Vygenerovat API klíč.

  6. Zkopírujte Consumer key a Consumer secret. Budou zobrazeny pouze jednou, proto se ujistěte, že je uložíte na bezpečném místě.

Důležité

Consumer secret se zobrazí pouze jednou. Pokud ho ztratíte, budete muset klíč zrušit a vygenerovat nový.

Připojení WooCommerce k Gem Logic

  1. V Gem Logic přejděte do Configuration ‣ Sales channels.

  2. Otevřete prodejní kanál, který chcete propojit s WooCommerce, nebo vytvořte nový.

  3. Zaškrtněte políčko WooCommerce.

  4. Vyplňte následující pole:

    • URL: kompletní URL adresa Vašeho obchodu WooCommerce (např. https://www.vasObchod.com). Neuvádějte koncové lomítko.

    • WooCommerce Key: vložte Consumer key, který jste dříve vygenerovali.

    • WooCommerce Secret: vložte Consumer secret, který jste dříve vygenerovali.

  5. Pokud ve svém obchodě WooCommerce používáte plugin Perfect WooCommerce Brands, zaškrtněte políčko WooCommerce brands plugin. To umožní Gem Logic synchronizovat značky produktů s WooCommerce.

  6. Uložte prodejní kanál.

Tip

Ujistěte se, že Váš obchod WooCommerce používá HTTPS. Přihlašovací údaje API jsou šifrovány a bezpečně uloženy v Gem Logic.

Přiřazení produktů k prodejnímu kanálu

Aby mohly být produkty odeslány do WooCommerce, musí být přiřazeny k prodejnímu kanálu WooCommerce.

  1. Přejděte do Products.

  2. Otevřete produkt a přejděte do sekce sales channels.

  3. Přidejte k produktu prodejní kanál WooCommerce.

  4. Ujistěte se, že má produkt nakonfigurované pricing rule pro daný prodejní kanál, aby měl při odeslání do WooCommerce nastavenou cenu.

Odesílání produktů

Můžete odesílat produkty z Gem Logic do Vašeho obchodu WooCommerce. To vytvoří nebo aktualizuje produkty ve WooCommerce na základě dat v Gem Logic.

Odeslání jednoho produktu

Pro odeslání jednoho produktu otevřete produkt v Gem Logic a použijte akci odeslání ze sekce prodejních kanálů produktu. Produkt bude vytvořen ve WooCommerce, pokud ještě neexistuje, nebo aktualizován, pokud již má WooCommerce ID.

Odeslání všech produktů

Pro odeslání všech produktů přiřazených k prodejnímu kanálu WooCommerce najednou:

  1. Přejděte do Configuration ‣ Sales channels.

  2. Otevřete prodejní kanál WooCommerce.

  3. Klikněte na Push all products to WooCommerce.

To běží jako úloha na pozadí. Průběh můžete sledovat na stránce push history.

Co se odesílá

Když je produkt odeslán do WooCommerce, synchronizují se následující data:

  • SKU (používá se pro spárování produktů mezi oběma systémy)

  • Název a popis (podle jazyka prodejního kanálu)

  • Běžná cena a akční cena (z pravidla ocenění pro daný prodejní kanál)

  • Obrázky (znovu nahrány pouze v případě změn)

  • Kategorie a kolekce (vytvořeny ve WooCommerce, pokud neexistují)

  • Atributy (vytvořeny jako globální WooCommerce atributy)

  • Štítky

  • Skladové množství

  • Značky (pokud je povolen plugin WooCommerce brands)

  • Typ produktu: jednoduchý nebo variabilní (s variantami)

Variabilní produkty a varianty

Pokud je produkt v Gem Logic označen jako nadřazený produkt, je do WooCommerce odeslán jako variabilní produkt. Všechny jeho podřízené produkty (varianty) jsou odeslány jako produktové variace. Každá varianta obsahuje svou vlastní cenu, SKU, obrázek a hodnoty atributů (např. velikost, barva).

Deaktivace produktu

Můžete deaktivovat produkt ve WooCommerce z Gem Logic. Tím se nastaví stav produktu na koncept ve WooCommerce, čímž se stane neviditelným na výloze obchodu, aniž by byl smazán.

Historie odesílání

Každá operace odesílání je zaznamenána. Historii odesílání můžete zobrazit na stránce detailu prodejního kanálu. Každý záznam historie zobrazuje:

  • Čas zahájení a ukončení

  • Stav (zahájeno, dokončeno, selhalo nebo částečný úspěch)

  • Celkový počet produktů, úspěšných a neúspěšných

  • Míra úspěšnosti a doba trvání

  • Podrobné výsledky pro jednotlivé produkty (klikněte na Zobrazit podrobnosti a zjistěte, které produkty byly úspěšné nebo selhaly)

Stahování produktů

Produkty z Vašeho WooCommerce obchodu můžete stáhnout do Gem Logic. To je užitečné pro počáteční import při prvním připojení obchodu.

  1. Přejděte do Configuration ‣ Sales channels.

  2. Otevřete prodejní kanál WooCommerce.

  3. Klikněte na Stáhnout produkty z WooCommerce.

Tato operace běží na pozadí a pro každý produkt importuje následující data:

  • SKU, název a popis

  • Běžná cena a výprodejová cena

  • Kategorie a značky

  • Obrázky (staženy a uloženy v Gem Logic)

  • Štítky

  • Skladová množství

  • Atributy a kovy

  • Produktové varianty (pro variabilní produkty)

Poznámka

Produkty, které již v Gem Logic existují (spárované podle WooCommerce ID nebo SKU), jsou při importu přeskočeny. Vytvářeny jsou pouze nové produkty.

Stahování objednávek

Dokončené objednávky můžete importovat z WooCommerce do Gem Logic.

Ruční import objednávek

  1. Přejděte do Configuration ‣ Sales channels.

  2. Otevřete prodejní kanál WooCommerce.

  3. Klikněte na Importovat objednávky z WooCommerce.

Tato operace běží na pozadí. Budete přesměrováni na stránku historie importů, kde můžete sledovat průběh v reálném čase.

Automatický import objednávek

Objednávky lze také importovat automaticky podle plánu pomocí systému úloh na pozadí. To zajišťuje, že nové dokončené objednávky jsou pravidelně importovány bez nutnosti ručního zásahu.

Co se importuje

Při importu objednávek z WooCommerce se importují následující údaje:

  • Klíč objednávky (používá se jako jedinečný identifikátor objednávky)

  • Kontaktní údaje zákazníka (jméno, adresa, e-mail, telefon) — kontakt se vytvoří nebo aktualizuje v CRM

  • Datum objednávky a měna

  • Položky: každý řádek objednávky obsahuje produkt (spárovaný podle WooCommerce ID nebo SKU), množství, ceny (bez DPH a s DPH) a sazbu DPH

  • Snížení stavu zásob: zásoby se automaticky odečtou pro každou položku objednávky

Poznámka

Importují se pouze objednávky se stavem dokončeno. Objednávky s jinými stavy (např. zpracovává se, pozastaveno, čeká) jsou přeskočeny.

Poznámka

Objednávky, které již byly importovány (spárovány podle klíče objednávky), jsou přeskočeny, aby se předešlo duplicitám.

Historie importů

Každá operace importu je zaznamenána. Historii importů můžete zobrazit na detailní stránce prodejního kanálu. Každý záznam historie zobrazuje:

  • Čas zahájení a ukončení

  • Stav (zahájeno, dokončeno, selhalo nebo částečný úspěch)

  • Celkový počet zpracovaných objednávek, nově vytvořených, přeskočených a neúspěšných objednávek

  • Trvání a případné chybové zprávy