Integrácia s WooCommerce

Integrácia s WooCommerce Vám umožňuje prepojiť Váš online obchod WooCommerce so systémom Gem Logic. Po prepojení môžete prenášať produkty z Gem Logic do Vášho obchodu WooCommerce a sťahovať objednávky z WooCommerce do Gem Logic. Takto udržíte Váš katalóg produktov a správu objednávok synchronizované naprieč oboma platformami.

Konfigurácia

Vygenerovanie API kľúčov vo WooCommerce

Pred pripojením WooCommerce k Gem Logic musíte vo Vašom obchode WooCommerce vygenerovať API kľúče.

  1. Prihláste sa do Vášho administračného panela WordPress.

  2. Prejdite na WooCommerce ‣ Settings ‣ Advanced ‣ REST API.

  3. Kliknite na Add key.

  4. Vyplňte podrobnosti:

    • Description: zadajte názov na identifikáciu tohto kľúča (napr. Gem Logic Integration).

    • User: vyberte používateľa WordPress, ktorý sa použije na pripojenie API.

    • Permissions: vyberte Read/Write. To je potrebné, aby Gem Logic mohol čítať objednávky a zároveň vytvárať/aktualizovať produkty vo Vašom obchode.

  5. Kliknite na Generate API key.

  6. Skopírujte Consumer key a Consumer secret. Tieto sa zobrazia len raz, preto sa uistite, že ich uložíte na bezpečnom mieste.

Dôležité

Consumer secret sa zobrazuje len raz. Ak ho stratíte, budete musieť kľúč odvolať a vygenerovať nový.

Pripojenie WooCommerce k Gem Logic

  1. V Gem Logic prejdite na Configuration ‣ Sales channels.

  2. Otvorte predajný kanál, ktorý chcete pripojiť k WooCommerce, alebo vytvorte nový.

  3. Zaškrtnite políčko WooCommerce.

  4. Vyplňte nasledujúce polia:

    • URL: úplná URL adresa Vašej WooCommerce predajne (napr. https://www.vasapredaln.com). Neuvádzajte koncové lomítko.

    • WooCommerce Key: vložte Consumer key, ktorý ste vygenerovali skôr.

    • WooCommerce Secret: vložte Consumer secret, ktorý ste vygenerovali skôr.

  5. Ak vo Vašej WooCommerce predajni používate plugin Perfect WooCommerce Brands, zaškrtnite políčko WooCommerce brands plugin. To umožňuje Gem Logic synchronizovať značky produktov s WooCommerce.

  6. Uložte predajný kanál.

Tip

Uistite sa, že Vaša WooCommerce predajňa používa HTTPS. API prihlasovacie údaje sú šifrované a bezpečne uložené v Gem Logic.

Priradenie produktov k predajnému kanálu

Aby mohli byť produkty odoslané do WooCommerce, musia byť priradené k predajnému kanálu WooCommerce.

  1. Prejdite na Products.

  2. Otvorte produkt a prejdite do sekcie sales channels.

  3. Pridajte predajný kanál WooCommerce k produktu.

  4. Uistite sa, že má produkt pre tento predajný kanál nakonfigurované pricing rule, aby mal pri odoslaní do WooCommerce definovanú cenu.

Odosielanie produktov

Môžete odosielať produkty z Gem Logic do Vašej WooCommerce predajne. Týmto sa vytvoria alebo aktualizujú produkty vo WooCommerce na základe údajov v Gem Logic.

Odoslanie jedného produktu

Ak chcete odoslať jeden produkt, otvorte ho v Gem Logic a použite akciu odoslania zo sekcie predajných kanálov produktu. Produkt bude vytvorený vo WooCommerce, ak ešte neexistuje, alebo aktualizovaný, ak už má WooCommerce ID.

Odoslanie všetkých produktov

Ak chcete naraz odoslať všetky produkty priradené k predajnému kanálu WooCommerce:

  1. Prejdite na Configuration ‣ Sales channels.

  2. Otvorte predajný kanál WooCommerce.

  3. Kliknite na Push all products to WooCommerce.

Táto operácia prebieha na pozadí. Postup môžete sledovať na stránke push history.

Čo sa odosiela

Pri odoslaní produktu do WooCommerce sa synchronizujú tieto údaje:

  • SKU (používa sa na párovanie produktov medzi oboma systémami)

  • Name a description (na základe jazyka predajného kanála)

  • Regular price a sale price (z cenového pravidla pre daný predajný kanál)

  • Obrázky (znova nahraté len pri zmenách)

  • Kategórie a kolekcie (vytvorené vo WooCommerce, ak neexistujú)

  • Atribúty (vytvorené ako globálne atribúty WooCommerce)

  • Štítky

  • Množstvo na sklade

  • Značky (ak je zásuvný modul WooCommerce brands aktivovaný)

  • Typ produktu: jednoduchý alebo variabilný (s variantmi)

Variabilné produkty a varianty

Ak je produkt v Gem Logic označený ako nadradený produkt, je odoslaný ako variabilný produkt do WooCommerce. Všetky jeho podriadené produkty (varianty) sú odoslané ako varianty produktu. Každá varianta zahŕňa svoju vlastnú cenu, SKU, obrázok a hodnoty atribútov (napr. veľkosť, farba).

Deaktivácia produktu

Produkt vo WooCommerce môžete deaktivovať z Gem Logic. Tým sa stav produktu nastaví na koncept vo WooCommerce, čím sa stane neviditeľným na predajnej ploche bez jeho odstránenia.

História odoslaní

Každá operácia odoslania je zaznamenávaná. Históriu odoslaní môžete zobraziť na detailnej stránke predajného kanála. Každý záznam histórie zobrazuje:

  • Čas začiatku a konca

  • Stav (začaté, dokončené, zlyhané alebo čiastočný úspech)

  • Celkový počet produktov, úspešných a neúspešných

  • Miera úspešnosti a trvanie

  • Podrobné výsledky pre každý produkt (kliknite na Zobraziť podrobnosti, aby ste videli, ktoré produkty boli úspešné alebo zlyhali)

Sťahovanie produktov

Produkty z Vášho obchodu WooCommerce môžete stiahnuť do Gem Logic. Je to užitočné pri počiatočnom importe, keď prvýkrát pripájate Váš obchod.

  1. Prejdite na Configuration ‣ Sales channels.

  2. Otvorte predajný kanál WooCommerce.

  3. Kliknite na Stiahnuť produkty z WooCommerce.

Toto sa spustí ako úloha na pozadí a importuje nasledujúce údaje pre každý produkt:

  • SKU, názov a popis

  • Bežná cena a predajná cena

  • Kategórie a značky

  • Obrázky (stiahnuté a uložené v Gem Logic)

  • Štítky

  • Množstvá na sklade

  • Atribúty a kovy

  • Varianty produktu (pre variabilné produkty)

Poznámka

Produkty, ktoré už v Gem Logic existujú (identifikované podľa WooCommerce ID alebo SKU), sú počas importu preskočené. Vytvorené sú len nové produkty.

Sťahovanie objednávok

Môžete vyťahovať dokončené objednávky z WooCommerce do Gem Logic.

Manuálne vyťahovanie objednávok

  1. Prejdite na Configuration ‣ Sales channels.

  2. Otvorte predajný kanál WooCommerce.

  3. Kliknite na Vyťahovať objednávky z WooCommerce.

Táto úloha beží na pozadí. Budete presmerovaný na stránku história výdajov, kde môžete sledovať priebeh v reálnom čase.

Automatické vyťahovanie objednávok

Objednávky je možné vyťahovať automaticky podľa plánu pomocou systému úloh na pozadí. To zabezpečuje, že nové dokončené objednávky sú pravidelne importované bez manuálneho zásahu.

Čo sa importuje

Pri vyťahovaní objednávok z WooCommerce sa importujú nasledujúce dáta:

  • Kľúč objednávky (používa sa ako jedinečný identifikátor objednávky)

  • Kontaktné informácie zákazníka (meno, adresa, e-mail, telefón) — v CRM sa vytvorí alebo aktualizuje kontakt

  • Dátum objednávky a mena

  • Riadkové položky: každý riadok objednávky zahŕňa produkt (spárovaný podľa WooCommerce ID alebo SKU), množstvo, ceny (bez DPH a s DPH) a sadzbu DPH

  • Odpočet zásob: zásoby sa automaticky odpočítajú pre každú riadkovú položku objednávky

Poznámka

Importujú sa iba objednávky so stavom dokončené. Objednávky s inými stavmi (napr. spracováva sa, pozastavené, čakajúce) sa preskočia.

Poznámka

Objednávky, ktoré už boli importované (spárované podľa kľúča objednávky), sa preskočia, aby sa predišlo duplikátom.

História výdajov

Každá operácia vyťahovania je zaznamenávaná. Históriu výdajov môžete zobraziť na detailnej stránke predajného kanála. Každý záznam histórie zobrazuje:

  • Čas začiatku a konca

  • Stav (začaté, dokončené, zlyhané alebo čiastočný úspech)

  • Celkový počet spracovaných objednávok, vytvorených nových objednávok, preskočených a neúspešných

  • Trvanie a prípadné chybové hlásenia