Integrazione WooCommerce

L’integrazione WooCommerce Le consente di connettere il Suo negozio online WooCommerce a Gem Logic. Una volta connessi, può inviare prodotti da Gem Logic al Suo negozio WooCommerce e importare ordini da WooCommerce in Gem Logic. Questo mantiene sincronizzati il catalogo prodotti e la gestione ordini su entrambe le piattaforme.

Configurazione

Generare chiavi API in WooCommerce

Prima di connettere WooCommerce a Gem Logic, deve generare chiavi API nel Suo negozio WooCommerce.

  1. Acceda al Suo pannello di amministrazione WordPress.

  2. Navighi in WooCommerce ‣ Impostazioni ‣ Avanzate ‣ REST API.

  3. Clicchi su Aggiungi chiave.

  4. Compili i dettagli:

    • Descrizione: inserisca un nome per identificare questa chiave (ad es. Integrazione Gem Logic).

    • Utente: selezioni l’utente WordPress che verrà utilizzato per la connessione API.

    • Permessi: selezioni Lettura/Scrittura. Questo è necessario affinché Gem Logic possa sia leggere gli ordini sia creare/aggiornare prodotti nel Suo negozio.

  5. Clicchi su Genera chiave API.

  6. Copi la Chiave consumer e il Segreto consumer. Questi verranno mostrati una sola volta, quindi si assicuri di salvarli in una posizione sicura.

Importante

Il segreto consumer viene visualizzato una sola volta. Se lo perde, dovrà revocare la chiave e generarne una nuova.

Connettere WooCommerce a Gem Logic

  1. In Gem Logic, acceda a Configuration ‣ Sales channels.

  2. Apra il canale di vendita che desidera collegare a WooCommerce oppure ne crei uno nuovo.

  3. Abiliti la casella WooCommerce.

  4. Compili i seguenti campi:

    • URL: l’URL completo del Suo negozio WooCommerce (ad es. https://www.suonegozio.com). Non includa una barra finale.

    • WooCommerce Key: incolli la Consumer key generata in precedenza.

    • WooCommerce Secret: incolli il Consumer secret generato in precedenza.

  5. Se utilizza il plugin Perfect WooCommerce Brands nel Suo negozio WooCommerce, abiliti la casella WooCommerce brands plugin. Questo consente a Gem Logic di sincronizzare le marche dei prodotti con WooCommerce.

  6. Salvi il canale di vendita.

Suggerimento

Si assicuri che il Suo negozio WooCommerce utilizzi HTTPS. Le credenziali API sono crittografate e conservate in modo sicuro in Gem Logic.

Assegnare i prodotti al canale di vendita

Affinché i prodotti vengano inviati a WooCommerce, devono essere assegnati al canale di vendita WooCommerce.

  1. Acceda a Products.

  2. Apra un prodotto e acceda alla sua sezione sales channels.

  3. Aggiunga il canale di vendita WooCommerce al prodotto.

  4. Si assicuri che il prodotto abbia una pricing rule configurata per quel canale di vendita, in modo che abbia un prezzo quando viene inviato a WooCommerce.

Invio dei prodotti

Può inviare i prodotti da Gem Logic al Suo negozio WooCommerce. Questo crea o aggiorna i prodotti in WooCommerce in base ai dati presenti in Gem Logic.

Inviare un singolo prodotto

Per inviare un singolo prodotto, apra il prodotto in Gem Logic e utilizzi l’azione di invio dalla sezione canali di vendita del prodotto. Il prodotto verrà creato in WooCommerce se non esiste ancora, oppure aggiornato se possiede già un ID WooCommerce.

Inviare tutti i prodotti

Per inviare tutti i prodotti assegnati a un canale di vendita WooCommerce in una sola volta:

  1. Acceda a Configuration ‣ Sales channels.

  2. Apra il canale di vendita WooCommerce.

  3. Clicchi su Invia tutti i prodotti a WooCommerce.

Questa operazione viene eseguita come attività in background. Può seguire l’avanzamento nella pagina storico invii.

Cosa viene inviato

Quando un prodotto viene inviato a WooCommerce, vengono sincronizzati i seguenti dati:

  • SKU (utilizzato per associare i prodotti tra i due sistemi)

  • Nome e descrizione (in base alla lingua del canale di vendita)

  • Prezzo normale e prezzo scontato (dalla regola di prezzo per quel canale di vendita)

  • Immagini (ricaricate solo se ci sono modifiche)

  • Categorie e collezioni (create in WooCommerce se non esistono)

  • Attributi (creati come attributi globali WooCommerce)

  • Tag

  • Quantità di stock

  • Marchi (se il plugin WooCommerce brands è abilitato)

  • Tipo di prodotto: semplice o variabile (con varianti)

Prodotti variabili e varianti

Se un prodotto in Gem Logic è contrassegnato come prodotto padre, viene pubblicato come prodotto variabile in WooCommerce. Tutti i suoi prodotti figli (varianti) vengono pubblicati come variazioni di prodotto. Ogni variante include il proprio prezzo, SKU, immagine e valori di attributo (ad esempio taglia, colore).

Disattivazione prodotto

Lei può disattivare un prodotto in WooCommerce da Gem Logic. Questo imposta lo stato del prodotto su bozza in WooCommerce, rendendolo invisibile sul negozio senza eliminarlo.

Storico pubblicazioni

Ogni operazione di pubblicazione viene registrata. Lei può visualizzare lo storico delle pubblicazioni dalla pagina di dettaglio del canale di vendita. Ogni record dello storico mostra:

  • Ora di inizio e fine

  • Stato (avviato, completato, non riuscito o successo parziale)

  • Totale prodotti, conteggio riusciti e non riusciti

  • Tasso di successo e durata

  • Risultati dettagliati per prodotto (clicchi su Visualizza dettagli per vedere quali prodotti sono riusciti o non riusciti)

Importazione prodotti

Lei può importare prodotti dal Suo negozio WooCommerce in Gem Logic. Questo è particolarmente utile per l’importazione iniziale quando connette il Suo negozio per la prima volta.

  1. Acceda a Configuration ‣ Sales channels.

  2. Apra il canale di vendita WooCommerce.

  3. Clicchi su Importa prodotti da WooCommerce.

Questa operazione viene eseguita come attività in background e importa i seguenti dati per ciascun prodotto:

  • SKU, nome e descrizione

  • Prezzo normale e prezzo di vendita

  • Categorie e marchi

  • Immagini (scaricate e archiviate in Gem Logic)

  • Tag

  • Quantità di stock

  • Attributi e metalli

  • Varianti di prodotto (per prodotti variabili)

Nota

I prodotti che già esistono in Gem Logic (identificati tramite ID WooCommerce o SKU) vengono saltati durante l’importazione. Vengono creati solo i nuovi prodotti.

Importazione ordini

Può prelevare gli ordini completati da WooCommerce in Gem Logic.

Prelevare ordini manualmente

  1. Acceda a Configuration ‣ Sales channels.

  2. Apra il canale di vendita WooCommerce.

  3. Clicchi su Prelevare ordini da WooCommerce.

Viene eseguito come attività in background. Verrà reindirizzato alla pagina storico prelievi dove può monitorare l’avanzamento in tempo reale.

Prelievo automatico degli ordini

Gli ordini possono anche essere prelevati automaticamente secondo una pianificazione utilizzando il sistema di attività in background. Ciò garantisce che i nuovi ordini completati vengano importati regolarmente senza intervento manuale.

Cosa viene importato

Quando gli ordini vengono prelevati da WooCommerce, vengono importati i seguenti dati:

  • Chiave ordine (utilizzata come identificatore univoco dell’ordine)

  • Informazioni di contatto del cliente (nome, indirizzo, email, telefono) — viene creato o aggiornato un contatto nel CRM

  • Data ordine e valuta

  • Righe ordine: ogni riga include il prodotto (abbinato per ID WooCommerce o SKU), quantità, prezzi (IVA esclusa e inclusa) e aliquota IVA

  • Decurtazione stock: lo stock viene automaticamente decurtato per ogni riga ordine

Nota

Vengono importati solo gli ordini con lo stato completato. Gli ordini con altri stati (ad es. in elaborazione, in attesa, pendente) vengono saltati.

Nota

Gli ordini già importati (abbinati per chiave ordine) vengono saltati per evitare duplicati.

Storico prelievi

Ogni operazione di prelievo viene registrata. Può visualizzare lo storico prelievi dalla pagina di dettaglio del canale di vendita. Ogni record dello storico mostra:

  • Ora di inizio e fine

  • Stato (avviato, completato, non riuscito o successo parziale)

  • Totale ordini elaborati, nuovi ordini creati, saltati e conteggi falliti

  • Durata ed eventuali messaggi di errore