Integrare WooCommerce

Integrarea WooCommerce vă permite să conectați magazinul dumneavoastră online WooCommerce la Gem Logic. Odată conectat, puteți trimite produse din Gem Logic către magazinul dumneavoastră WooCommerce și puteți prelua comenzi din WooCommerce în Gem Logic. Astfel, catalogul de produse și managementul comenzilor rămân sincronizate pe ambele platforme.

Configurare

Generați chei API în WooCommerce

Înainte de a conecta WooCommerce la Gem Logic, trebuie să generați chei API în magazinul dumneavoastră WooCommerce.

  1. Conectați-vă la panoul de administrare WordPress.

  2. Navigați la WooCommerce ‣ Setări ‣ Avansat ‣ REST API.

  3. Faceți clic pe Adaugă cheie.

  4. Completați detaliile:

    • Descriere: introduceți un nume pentru a identifica această cheie (de exemplu Integrare Gem Logic).

    • Utilizator: selectați utilizatorul WordPress care va fi folosit pentru conexiunea API.

    • Permisiuni: selectați Read/Write. Acest lucru este necesar pentru ca Gem Logic să poată atât să citească comenzile, cât și să creeze/actualizeze produse în magazinul dumneavoastră.

  5. Faceți clic pe Generate API key.

  6. Copiați Consumer key și Consumer secret. Acestea vor fi afișate o singură dată, așa că asigurați-vă că le salvați într-o locație sigură.

Important

Consumer secret este afișat o singură dată. Dacă îl pierdeți, va trebui să revocați cheia și să generați una nouă.

Conectați WooCommerce la Gem Logic

  1. În Gem Logic, accesați Configuration ‣ Sales channels.

  2. Deschideți canalul de vânzări pe care doriți să îl conectați la WooCommerce sau creați unul nou.

  3. Activați caseta de selectare WooCommerce.

  4. Completați următoarele câmpuri:

    • URL: URL-ul complet al magazinului dumneavoastră WooCommerce (de exemplu https://www.magazinuldumneavoastra.com). Nu includeți o bară oblică la final.

    • WooCommerce Key: inserați Consumer key pe care l-ați generat anterior.

    • WooCommerce Secret: inserați Consumer secret pe care l-ați generat anterior.

  5. Dacă utilizați plugin-ul Perfect WooCommerce Brands în magazinul dumneavoastră WooCommerce, activați caseta de selectare WooCommerce brands plugin. Aceasta permite Gem Logic să sincronizeze mărcile de produse cu WooCommerce.

  6. Salvați canalul de vânzări.

Sfat

Asigurați-vă că magazinul dumneavoastră WooCommerce utilizează HTTPS. Credențialele API sunt criptate și stocate în siguranță în Gem Logic.

Atribuirea produselor la canalul de vânzări

Pentru ca produsele să fie trimise către WooCommerce, acestea trebuie atribuite canalului de vânzări WooCommerce.

  1. Accesați Products.

  2. Deschideți un produs și accesați secțiunea sales channels.

  3. Adăugați canalul de vânzări WooCommerce la produs.

  4. Asigurați-vă că produsul are o pricing rule configurată pentru acel canal de vânzări, astfel încât să aibă un preț atunci când este trimis către WooCommerce.

Trimiterea produselor

Puteți trimite produse din Gem Logic către magazinul dumneavoastră WooCommerce. Aceasta creează sau actualizează produse în WooCommerce pe baza datelor din Gem Logic.

Trimiterea unui singur produs

Pentru a trimite un singur produs, deschideți produsul în Gem Logic și utilizați acțiunea de trimitere din secțiunea canale de vânzări a produsului. Produsul va fi creat în WooCommerce dacă nu există încă sau actualizat dacă are deja un ID WooCommerce.

Trimiterea tuturor produselor

Pentru a trimite dintr-o dată toate produsele atribuite unui canal de vânzări WooCommerce:

  1. Accesați Configuration ‣ Sales channels.

  2. Deschideți canalul de vânzări WooCommerce.

  3. Faceți clic pe Push all products to WooCommerce.

Aceasta rulează ca o sarcină în fundal. Puteți urmări progresul pe pagina push history.

Ce este trimis

Când un produs este trimis către WooCommerce, următoarele date sunt sincronizate:

  • SKU (folosit pentru a potrivi produsele între cele două sisteme)

  • Nume și descriere (pe baza limbii canalului de vânzări)

  • Preț normal și preț promoțional (din regula de tarifare pentru acel canal de vânzări)

  • Imagini (reîncărcate numai dacă există modificări)

  • Categorii și colecții (create în WooCommerce dacă nu există)

  • Atribute (create ca atribute globale WooCommerce)

  • Etichete

  • Cantitate în stoc

  • Mărci (dacă plugin-ul WooCommerce brands este activat)

  • Tip de produs: simplu sau variabil (cu variante)

Produse variabile și variante

Dacă un produs în Gem Logic este marcat ca produs părinte, acesta este trimis ca produs variabil în WooCommerce. Toate produsele copil (variantele) sunt trimise ca variații de produs. Fiecare variantă include propriul preț, SKU, imagine și valori de atribute (de exemplu mărime, culoare).

Dezactivarea produsului

Puteți dezactiva un produs în WooCommerce din Gem Logic. Aceasta setează statusul produsului la ciornă în WooCommerce, făcându-l invizibil în magazin fără a-l șterge.

Istoric trimiteri

Fiecare operațiune de trimitere este înregistrată. Puteți vizualiza istoricul trimiterilor din pagina de detalii a canalului de vânzări. Fiecare înregistrare din istoric afișează:

  • Ora de început și de final

  • Status (început, finalizat, eșuat sau succes parțial)

  • Total produse, număr de succese și eșecuri

  • Rată de succes și durată

  • Rezultate detaliate pe produs (faceți clic pe Vizualizați detalii pentru a vedea care produse au reușit sau au eșuat)

Extragerea produselor

Puteți extrage produse din magazinul dumneavoastră WooCommerce în Gem Logic. Acest lucru este util pentru importul inițial atunci când conectați pentru prima dată magazinul.

  1. Accesați Configuration ‣ Sales channels.

  2. Deschideți canalul de vânzări WooCommerce.

  3. Faceți clic pe Extrageți produse din WooCommerce.

Aceasta rulează ca o sarcină în fundal și importă următoarele date pentru fiecare produs:

  • SKU, nume și descriere

  • Preț normal și preț promoțional

  • Categorii și mărci

  • Imagini (descărcate și stocate în Gem Logic)

  • Etichete

  • Cantități în stoc

  • Atribute și metale

  • Variante de produs (pentru produse variabile)

Notă

Produsele care există deja în Gem Logic (identificate prin ID WooCommerce sau SKU) sunt omise în timpul importului. Sunt create numai produse noi.

Extragerea comenzilor

Puteți extrage comenzile finalizate din WooCommerce în Gem Logic.

Extrageți comenzile manual

  1. Accesați Configuration ‣ Sales channels.

  2. Deschideți canalul de vânzări WooCommerce.

  3. Faceți clic pe Extrageți comenzile din WooCommerce.

Aceasta rulează ca o sarcină de fundal. Veți fi redirecționat către pagina istoric de extrageri unde puteți urmări progresul în timp real.

Extragere automată a comenzilor

Comenzile pot fi extrase și automat conform unui program utilizând sistemul de sarcini de fundal. Acest lucru asigură că noile comenzi finalizate sunt importate regulat fără intervenție manuală.

Ce se importă

Când comenzile sunt extrase din WooCommerce, sunt importate următoarele date:

  • Cheia comenzii (utilizată ca identificator unic al comenzii)

  • Informații de contact client (nume, adresă, email, telefon) — un contact este creat sau actualizat în CRM

  • Data comenzii și moneda

  • Linii de comandă: fiecare linie de comandă include produsul (asociat după ID-ul WooCommerce sau SKU), cantitatea, prețurile (fără TVA și cu TVA) și cota de TVA

  • Deducerea stocului: stocul este dedus automat pentru fiecare linie de comandă

Notă

Sunt importate doar comenzile cu statusul finalizat. Comenzile cu alte statusuri (de exemplu, în procesare, în așteptare, pendinte) sunt omise.

Notă

Comenzile care au fost deja importate (asociate după cheia comenzii) sunt omise pentru a evita duplicatele.

Istoric de extrageri

Fiecare operațiune de extragere este înregistrată. Puteți vizualiza istoricul de extrageri din pagina de detalii a canalului de vânzări. Fiecare înregistrare afișează:

  • Ora de început și de final

  • Status (început, finalizat, eșuat sau succes parțial)

  • Total comenzi procesate, comenzi noi create, omise și eșuate

  • Durata și mesajele de eroare