Modulo Integrazioni

Collega il tuo negozio WooCommerce
a GSE-Web

Il tuo catalogo e il tuo stock disponibile vanno al negozio. Gli ordini pagati arrivano in GSE-Web come buoni di uscita confermati, con stock riservato.

Home / Documentazione / Connettore WooCommerce

In breve

Il connettore WooCommerce collega un negozio WooCommerce a un magazzino di GSE-Web. GSE-Web pubblica lo stock, il negozio invia i suoi ordini. Lo configura un amministratore dell'organizzazione, nel menu ADMIN › «Integrazioni».

  • Cosa va al negozio: le schede dei prodotti semplici, dei kit e dei prodotti con varianti (nome, riferimento, prezzo, codice a barre), se lo richiedi, e lo stock disponibile del magazzino pubblicato.
  • Cosa arriva in GSE-Web: ogni ordine selezionato diventa un buono di uscita confermato, con stock riservato; l'acquirente diventa un cliente «Privato». Se lo richiedete, anche la descrizione e le foto dei prodotti collegati vengono riprese dal negozio.
  • Quando: lo stock parte verso il negozio pochi secondi dopo ogni modifica in GSE-Web, e un ordine arriva subito tramite webhook. Ogni 5 minuti un passaggio completo recupera ciò che fosse mancato.
  • Cosa non viene mai fatto: nulla viene eliminato nel negozio, e GSE-Web non scrive mai le righe di un ordine del negozio. Ne cambia solo lo stato, «completato» o «annullato», se lo richiedi.
  • Interruzione: pausa, disconnessione o chiusura del modulo in qualsiasi momento, senza perdere nulla; alla ripresa, gli ordini effettuati nel frattempo vengono recuperati.
Prima di iniziare

Requisiti

Verifica questi punti prima di aprire la schermata del connettore: il test di connessione li controlla e dice chiaramente cosa non va.

✓

WooCommerce 7.0 o successivo

Il negozio deve essere servito in HTTPS. Il codice a barre (GTIN) dei prodotti viene pubblicato a partire da WooCommerce 9.2.

✓

Una chiave API REST in lettura e scrittura

In WooCommerce: Impostazioni › Avanzate › REST API › Aggiungi chiave, permessi «Lettura/Scrittura». Annota la chiave e il segreto: WooCommerce non mostra più il segreto.

✓

I moduli attivi per la tua organizzazione

«Integrazioni», poi «WooCommerce». La loro apertura si richiede a KLS-Concept. Senza «Integrazioni», la voce di menu non compare; senza «WooCommerce», la sua scheda indica «Non disponibile per la tua organizzazione».

✓

Un account ADMIN con autenticazione a due fattori

L'inserimento delle credenziali del negozio è rifiutato finché l'autenticazione a due fattori non è attiva sul tuo account, in «Le mie informazioni».

✓

Un magazzino reale

Il suo stock disponibile è pubblicato nel negozio e gli ordini vi diventano buoni di uscita. Un magazzino di esercitazione è rifiutato.

✓

La stessa valuta

La valuta del negozio deve essere quella della tua organizzazione.

✓

Lo stesso regime dei prezzi

La scelta «Prezzi pubblicati» (IVA esclusa o inclusa) deve corrispondere all'impostazione «Prezzi inseriti con tasse» del negozio.

Configurazione passo passo

Sei passaggi, nell'ordine della schermata.

1

Aprire la schermata del connettore

Menu ADMIN › «Integrazioni». La scheda WooCommerce si trova nella categoria «E-commerce». Fai clic su «Configura» (il pulsante diventa «Gestisci» una volta salvato il negozio).

2

Scheda «Negozio»

Compila «Indirizzo del negozio» (indirizzo completo, che inizia con https://), «Chiave client (consumer key)» e «Segreto client (consumer secret)», poi scegli il «Magazzino pubblicato».

La chiave e il segreto sono in sola scrittura: una volta salvati, non vengono più mostrati. La schermata mostra solo alcuni caratteri della chiave per riconoscerla. Per conservarla, lascia vuoti i due campi; per sostituirla, inserisci una nuova chiave e il suo segreto.

3

Scheda «Impostazioni»

Ogni impostazione ha un valore predefinito:

  • «Prezzi pubblicati»: «IVA esclusa» per impostazione predefinita, oppure «IVA inclusa».
  • «Crea e aggiorna le schede prodotto nel negozio»: non selezionata per impostazione predefinita. In questo caso GSE-Web non crea nessuna scheda: collega solo i prodotti già presenti nel negozio con lo stesso riferimento (SKU).
  • «Pubblica lo stock disponibile»: selezionata per impostazione predefinita.
  • «Ricevi gli ordini»: selezionata per impostazione predefinita.
  • «Segnalare consegne e annullamenti al negozio»: selezionata per impostazione predefinita. Buono consegnato: ordine «completato», con corriere e n. di tracciamento in una nota al cliente. Buono annullato in GSE-Web: ordine annullato nel negozio.
  • «Stati d'ordine importati»: «In lavorazione» per impostazione predefinita. Puoi aggiungere «In attesa di pagamento», «In sospeso» e «Completato».
  • «Età massima di un ordine recuperato (giorni)»: 30 per impostazione predefinita, da 1 a 90.
  • «Riprendere descrizione e foto dal negozio»: non selezionata per impostazione predefinita. Il negozio resta il master di descrizione e foto, che GSE-Web non gli invia mai; se selezionata, vengono copiate sulla scheda del prodotto collegato. Una descrizione vuota nel negozio non cancella mai quella di GSE-Web, e una foto aggiunta in GSE-Web non viene mai rimossa.
4

Salvare

Fai clic su «Salva». «Prova la connessione» e «Attiva» usano la configurazione salvata: finché una modifica non è salvata, la schermata lo ricorda e questi due pulsanti restano in attesa.

5

Provare la connessione

«Prova la connessione» interroga il negozio e verifica quattro punti: la versione di WooCommerce, i permessi di scrittura della chiave, la valuta e il regime dei prezzi. Un rifiuto è mostrato chiaramente, con ciò che non va (vedi la risoluzione dei problemi più in basso).

6

Attivare

«Attiva» ripete il test, poi crea quattro webhook «GSE-Web» in WooCommerce. Lo stato diventa «Attiva — stock inviato appena cambia, sincronizzazione completa ogni 5 minuti» («Attiva — sincronizzazione ogni 5 minuti» se lo stock non è pubblicato). Gli ordini ricevuti prima dell'attivazione non vengono importati.

Cosa si sincronizza, e chi fa fede

Ogni campo ha un solo proprietario. In un ordine del negozio, GSE-Web scrive solo il suo stato e una nota di consegna, mai le sue righe.

📦 Fa fede GSE-Web

  • ✓Nome del prodotto
  • ✓Riferimento (SKU nel negozio)
  • ✓Prezzo di vendita, IVA esclusa o inclusa secondo l'impostazione
  • ✓Codice a barre (GTIN, WooCommerce 9.2 o successivo)
  • ✓Pubblicato o bozza
  • ✓Stock

🛒 Fa fede il negozio

  • ✓Descrizione (ripresa in GSE-Web in opzione)
  • ✓Foto (riprese in GSE-Web in opzione)
  • ✓Categorie
  • ✓Classe d'imposta
  • ✓Ordini

Le regole

  • Prodotti semplici, kit e prodotti con varianti. Un kit viene pubblicato come un prodotto semplice, con come stock il numero di kit assemblabili con i componenti del magazzino pubblicato. Un prodotto con varianti viene pubblicato come un prodotto variabile, senza prezzo né stock propri; ogni variante ne è una variazione, con il suo riferimento, il suo prezzo e il suo stock.
  • Un prodotto ritirato dalla vendita in GSE-Web passa in bozza nel negozio. Non vi viene mai eliminato.
  • Una scheda modificata nel negozio su un campo per cui fa fede GSE-Web viene riscritta alla successiva modifica del prodotto in GSE-Web.
  • Stock pubblicato = stock disponibile del magazzino pubblicato (fisico meno riservato), arrotondato all'unità inferiore, mai negativo. Parte verso il negozio pochi secondi dopo ogni modifica: entrata, uscita, trasferimento, inventario, prenotazione posta o liberata su un buono. Il passaggio completo lo rilegge anche ogni 5 minuti.
  • Un ordine = un buono di uscita confermato del magazzino pubblicato, con «Riserva i prodotti per questo buono.» spuntato: tutta la quantità ordinata viene riservata, anche oltre lo stock (la parte mancante si legge «In attesa di ricezione» sul buono), e lo stock pubblicato nel negozio scende subito. L'indirizzo di consegna viene ripreso. Mai un buono parziale: se una riga crea problemi (prodotto sconosciuto, variazione sconosciuta, kit non pubblicabile, e-mail assente, altra valuta), nessun buono viene creato e un punto da gestire ne spiega il motivo.
  • Un acquirente = un cliente «Privato», ritrovato tramite la sua e-mail da un ordine all'altro (codice che inizia con WEB-). Un soggetto già presente in GSE-Web non viene abbinato: viene creato un cliente «Privato».
  • Ordine annullato nel negozio (annullato, rimborsato, non riuscito, spostato nel cestino o eliminato): il buono viene annullato e le sue riserve liberate, a meno che qualcuno non lo stia già gestendo. In quel caso, un punto da gestire lascia la decisione al team.
  • Ordine modificato nel negozio dopo l'importazione: la modifica non viene riportata sul buono; un punto da gestire ti invita a verificarlo.
  • Un ordine di un kit diventa un buono di uscita sui suoi componenti (quantità × numero di kit); la nota del buono cita il kit. Un ordine di una variazione dà un buono sulla variante, come per qualsiasi prodotto.
  • Segnalazione di consegne e annullamenti (impostazione selezionata per impostazione predefinita): un buono consegnato o chiuso in GSE-Web porta il suo ordine nel negozio a «completato»; se è partito in una spedizione, il corriere e il n. di tracciamento vengono aggiunti in una nota al cliente, che WooCommerce invia all'acquirente. Un buono annullato in GSE-Web annulla il suo ordine nel negozio. Un ordine che il negozio ha già chiuso non viene annullato: lo segnala un punto da gestire. Consegnato in parte o in preparazione: nulla finché il buono non è completo.
  • Ripresa di descrizione e foto (impostazione non selezionata per impostazione predefinita): a ogni passaggio, per ogni prodotto collegato, la descrizione del negozio (la versione breve se quella lunga è vuota) viene copiata in testo semplice sulla scheda. Le foto vengono aggiunte nell'ordine del negozio, la prima è quella principale, e rimosse quando spariscono dal negozio. Una descrizione vuota nel negozio non cancella mai quella di GSE-Web, e una foto aggiunta in GSE-Web non viene mai rimossa. Al massimo 20 foto per prodotto.
  • Cosa non viene ripreso: le categorie, la classe IVA, nonché descrizione e foto proprie di ogni variante (vengono riprese solo quelle del prodotto principale). Anche i nomi, i prezzi e i codici a barre modificati nel negozio non risalgono: GSE-Web fa fede.

Nel quotidiano

La schermata del connettore si legge dall'alto in basso: lo stato, il negozio, le impostazioni, i pulsanti, poi i punti da gestire e il registro.

La scheda «Stato»

Indica a che punto è la connessione, la versione di WooCommerce e la valuta del negozio, la data dell'ultima sincronizzazione, l'ultimo errore e il numero di punti da gestire. Sulla scheda della pagina «Integrazioni», lo stato sta in un'etichetta.

  • Da attivare «Configurata, non ancora attivata».
  • Connesso «Attiva — stock inviato appena cambia, sincronizzazione completa ogni 5 minuti». Se lo stock non è pubblicato: «Attiva — sincronizzazione ogni 5 minuti».
  • In pausa «In pausa — nulla viene inviato né importato».
  • Interrotto — da verificare «Interrotta dal server — verifica la chiave e prova».

«Sincronizza ora»

Lo stock viene inviato automaticamente al negozio, pochi secondi dopo ogni modifica, e gli ordini arrivano appena vengono effettuati: la schermata lo ricorda sotto il pulsante. Questo pulsante serve solo ad avviare subito la sincronizzazione completa (schede prodotto, stock, ordini mancanti, consegne), che altrimenti avviene ogni 5 minuti. Il messaggio dice se il passaggio è terminato, se ha rilevato punti da gestire o perché non è stato avviato.

La scheda «Cosa passa tra GSE-Web e il negozio»

Sotto le impostazioni, una scheda chiusa per impostazione predefinita indica, per ogni scambio, in quale senso va: da GSE-Web al negozio (schede, stock, kit, varianti, consegne e annullamenti), dal negozio a GSE-Web (ordini, annullamenti, descrizione e foto) e ciò che non passa mai (righe di un ordine, categorie e classe IVA, nomi, prezzi e codici a barre modificati nel negozio). Una riga legata a un'impostazione non selezionata è contrassegnata «Disattivato».

Il «Registro»

Ogni passaggio vi compare con il suo tipo e il suo esito. Tipi: «Schede prodotto», «Stock», «Stock in tempo reale» (invio appena uno stock cambia, registrato solo se una quantità è cambiata), «Ripresa dal negozio», «Recupero ordini», «Ritorno dei buoni», «Ordine ricevuto», «Controllo webhook», «Test di connessione». Esiti: «Riuscito», «Parziale», «Non riuscito», «In corso», «Interrotto». Un clic su un passaggio ne apre il dettaglio, elemento per elemento: prodotto creato o aggiornato, stock pubblicato, ordine importato o annullato, foto ripresa, webhook riattivato… (al massimo 200 elementi per passaggio; oltre, viene indicato il numero di elementi non dettagliati). I passaggi che non hanno cambiato nulla possono essere nascosti.

I «Punti da gestire»

Una riga che non passa non blocca mai la sincronizzazione: diventa un punto da gestire e il resto continua. I punti delle schede e dello stock spariscono da soli quando la loro causa è corretta. I punti degli ordini hanno due pulsanti.

  • «Riprova» rilegge l'ordine nel negozio e ritenta l'importazione, qualunque sia la sua età.
  • «Ignora» archivia il punto: un punto ignorato non torna nell'elenco. «Ignora tutto», in cima all'elenco, archivia in una volta tutti i punti aperti, compresi quelli non visualizzati, dopo una conferma.

Schede prodotto

Prodotto …: tipo di prodotto non supportato dal negozio

Causa
Questo prodotto è di un tipo che il connettore non pubblica. Vengono pubblicati i prodotti semplici, i kit e i prodotti con varianti.
Cosa fare
Nulla da fare in GSE-Web. Gestisci questo prodotto direttamente nel negozio.

Prodotto …: nessun prezzo di vendita — non pubblicato

Causa
Il prodotto non ha un prezzo di vendita in GSE-Web.
Cosa fare
Inserisci il suo prezzo di vendita. Il punto sparisce al passaggio successivo.

Prodotto …: aliquota IVA mancante, prezzo IVA inclusa non calcolabile

Causa
I prezzi sono pubblicati IVA inclusa e il prodotto non ha un'aliquota IVA.
Cosa fare
Inserisci l'aliquota IVA del prodotto.

Prodotto …: il riferimento è già usato nel negozio da un altro prodotto

Causa
Il prodotto del negozio con questo riferimento è già collegato a un altro prodotto di GSE-Web, non è dello stesso tipo (prodotto semplice, prodotto variabile o variazione) oppure è una variazione di un altro prodotto variabile. Anche un riferimento che contiene una virgola non può essere cercato nel negozio.
Cosa fare
Fai in modo che un riferimento indichi un solo prodotto, da entrambe le parti.

Prodotto rifiutato dal negozio (…)

Causa
WooCommerce ha rifiutato la scheda; il codice di rifiuto è mostrato.
Cosa fare
Verifica il prodotto nel negozio a partire da questo codice.

Prodotto eliminato nel negozio: da ricreare o scollegare

Causa
Il prodotto collegato non esiste più nel negozio.
Cosa fare
Ricrealo nel negozio con lo stesso riferimento. Se non deve più comparirvi, scrivici.

Kit …: distinta non pubblicabile (motivo)

Causa
Il kit non ha alcun componente, uno di essi è archiviato o inattivo, oppure la quantità di un componente è inserita in un'unità diversa dalla sua unità di base. Il kit non viene messo in vendita.
Cosa fare
Correggi la distinta del kit. Il punto sparisce al passaggio successivo.

Prodotto variabile …: nessuna variazione attiva — non pubblicato

Causa
Un prodotto con varianti si vende tramite le sue varianti: senza variante attiva, non viene messo in vendita.
Cosa fare
Crea una variante o riattivane una. Il punto sparisce al passaggio successivo.

Variazione …: non pubblicata (motivo)

Causa
La variante non può essere pubblicata: il suo prodotto padre è introvabile, archiviato o non ancora pubblicato nel negozio, oppure i suoi assi e valori non sono validi. Il motivo è indicato tra parentesi.
Cosa fare
Correggi la causa indicata, sul prodotto padre o sulla variante. Il punto sparisce al passaggio successivo.

Prodotto …: foto non ripresa dal negozio (motivo)

Causa
Una foto del negozio non ha potuto essere copiata sulla scheda. Motivi possibili: immagine non trovata, formato non supportato (sono accettati JPEG, PNG, WebP e GIF), oltre 5 MB o illeggibile, negozio non raggiungibile (nuovo tentativo al passaggio successivo), indirizzo immagine non sicuro (HTTPS pubblico richiesto), più di 20 foto (le successive non vengono riprese).
Cosa fare
Correggi la foto nel negozio, oppure rimuovila. Il punto scompare quando tutto è importato; il resto del prodotto viene ripreso comunque.

Stock

Stock frazionario arrotondato all'unità inferiore nel negozio

Causa
Lo stock disponibile ha dei decimali; il negozio vende solo unità intere.
Cosa fare
Solo informativo: il negozio mostra l'unità inferiore.

Stock rifiutato dal negozio (…)

Causa
WooCommerce ha rifiutato la quantità; il codice di rifiuto è mostrato.
Cosa fare
Verifica la scheda del prodotto nel negozio a partire da questo codice.

Ordini

Ordine …: prodotto sconosciuto (SKU …) — nessun buono creato

Causa
Una riga dell'ordine porta un riferimento che non esiste in GSE-Web.
Cosa fare
Crea il prodotto con lo stesso riferimento, poi «Riprova».

Ordine …: variazione non importabile (SKU …, motivo) — nessun buono creato

Causa
Una riga indica una variazione che GSE-Web non conosce, oppure il prodotto con varianti stesso, ordinato senza variazione.
Cosa fare
Variazione sconosciuta: crea la variante con lo stesso riferimento della variazione, poi «Riprova». Prodotto ordinato senza variazione: gestisci l'ordine a mano.

Ordine …: senza e-mail dell'acquirente

Causa
Senza e-mail, l'acquirente non può essere ritrovato né creato come cliente.
Cosa fare
Aggiungi l'e-mail di fatturazione all'ordine nel negozio, poi «Riprova».

Ordine …: il cliente è archiviato in GSE-Web

Causa
Il cliente che corrisponde a questo acquirente è stato archiviato.
Cosa fare
Nessun buono viene creato. Gestisci questo ordine a mano.

Ordine …: valuta … diversa da …

Causa
L'ordine è in una valuta diversa da quella della tua organizzazione.
Cosa fare
Gestisci questo ordine a mano.

Ordine …: troppo vecchio per essere importato automaticamente (oltre … giorni)

Causa
Al recupero, l'ordine supera l'«Età massima di un ordine recuperato».
Cosa fare
«Riprova» lo importa comunque.

Ordine … annullato nel negozio, ma il buono è già in lavorazione: da gestire dal team

Causa
Il buono è già in preparazione: GSE-Web non lo annulla da solo.
Cosa fare
Decidi con il team. Se il buono deve essere annullato, liberalo, poi «Riprova».

Ordine … modificato nel negozio dopo l'importazione: verifica il buono

Causa
L'ordine è cambiato nel negozio dopo la creazione del buono; la modifica non viene riportata.
Cosa fare
Confronta l'ordine e il buono, e correggi il buono se necessario.

Ordine …: importazione impossibile (…)

Causa
L'importazione non è riuscita; il motivo è indicato tra parentesi.
Cosa fare
Correggi la causa indicata, poi «Riprova».

Ordine …: kit … non pubblicabile (motivo) — nessun buono creato

Causa
L'ordine contiene un kit la cui distinta non è valida: nessun componente, un componente archiviato o inattivo, oppure un'unità diversa dall'unità di base. Nessun buono viene creato.
Cosa fare
Correggi la distinta del kit, poi «Riprova».

Ordine …: il negozio rifiuta lo stato (codice)

Causa
WooCommerce ha rifiutato di portare l'ordine a «completato» o «annullato»; il suo codice di rifiuto è indicato.
Cosa fare
Verifica l'ordine nel negozio a partire da questo codice e cambia il suo stato a mano se necessario.

Ordine …: buono annullato, ma l'ordine è già chiuso nel negozio

Causa
Il buono è stato annullato in GSE-Web, ma il negozio aveva già portato l'ordine a «completato»: GSE-Web non lo annulla.
Cosa fare
Risolvi la situazione con il cliente (rimborso, reso) direttamente nel negozio.

Webhook

Webhook disattivati dal negozio: riattivati, ordini recuperati

Causa
WooCommerce disattiva un webhook dopo diversi invii non riusciti, oppure un webhook «GSE-Web» è stato eliminato nel negozio.
Cosa fare
Nulla da fare: il controllo dei webhook, ogni 6 ore, li ricrea e recupera gli ordini.

Pausa, ripresa e modifiche

Il connettore si spegne e si riaccende in qualsiasi momento. Tre modifiche seguono una regola, che la schermata ricorda e che il server fa rispettare.

«Metti in pausa»

Nulla viene più inviato né importato, e nulla va perso. Lo stock mostrato nel negozio resta quello dell'ultimo invio.

«Riprendi»

Il negozio viene verificato di nuovo (versione, chiave, valuta, regime dei prezzi), poi parte il recupero: gli ordini effettuati durante la pausa vengono importati se hanno meno di N giorni («Età massima di un ordine recuperato», 30 per impostazione predefinita, da 1 a 90). Quelli più vecchi diventano punti da gestire.

Cambiare chiave o regime dei prezzi

Con una connessione attiva, l'indirizzo, la chiave, il segreto e «Prezzi pubblicati» sono bloccati. Segui quest'ordine: «Metti in pausa», modifica, «Salva», «Prova la connessione», «Riprendi».

Cambiare negozio

Prima «Disconnetti»: i webhook del negozio precedente vengono rimossi. Poi inserisci il nuovo negozio.

Ricollegare lo stesso negozio

I prodotti, gli ordini e i clienti già collegati vengono ritrovati: nessun secondo buono viene creato per un ordine già importato.

Cambiare un'impostazione delle schede

Dopo una modifica di «Prezzi pubblicati» o di «Crea e aggiorna le schede prodotto nel negozio», il passaggio successivo rilegge tutto il catalogo.

«Disconnetti»

I webhook vengono rimossi dal negozio e le credenziali cancellate. Nulla viene eliminato nel negozio né in GSE-Web: i buoni e i clienti già importati restano. Se il negozio non risponde, la schermata ti chiede di eliminare tu stesso i webhook «GSE-Web» in WooCommerce.

Chiusura del modulo

Se KLS-Concept chiude il modulo per la tua organizzazione, tutto si ferma senza eliminare nulla. Alla riapertura, il passaggio successivo recupera gli ordini e ripubblica lo stock.

Sicurezza e dati

Cosa conserva il connettore, e come.

Credenziali cifrate

La chiave e il segreto del negozio sono cifrati sul server (AES-256-GCM). Non vengono mai più mostrati né scritti nei log.

Autenticazione a due fattori

È obbligatoria per inserire o sostituire le credenziali di un negozio.

Solo HTTPS

L'indirizzo del negozio deve usare HTTPS ed essere raggiungibile su Internet; un indirizzo di rete privata è rifiutato.

Webhook firmati

Ogni webhook ricevuto è firmato dal negozio, e la sua firma viene verificata prima di qualsiasi elaborazione. Il suo contenuto non viene conservato.

Dati dell'acquirente

I suoi dati vengono ripresi nella sua scheda cliente e l'indirizzo di consegna sul buono. Il collegamento con il negozio conserva solo un'impronta della sua e-mail.

Nulla nell'esportazione

Le credenziali cifrate non compaiono nell'esportazione di portabilità dell'organizzazione.

Risoluzione dei problemi

Il messaggio mostrato dalla schermata, la sua causa e cosa fare. Il codice tra parentesi quadre aiuta l'assistenza a ritrovare il caso. L'app mostra questi messaggi in inglese (o in francese); la traduzione in questa pagina serve a capirli e il codice tra parentesi quadre li identifica.

Interrotto — da verificare

«Interrotta dal server — verifica la chiave e prova»

Dopo cinque rifiuti di autenticazione consecutivi, il server interrompe la connessione per non insistere. Verifica la chiave in WooCommerce, inseriscine una nuova se necessario, «Salva», «Prova la connessione», poi «Attiva».

Indirizzo del negozio non valido: è atteso un indirizzo HTTPS, senza credenziali né parametri

Cosa fare
Inserisci l'indirizzo completo del negozio, che inizia con https://, senza nulla dopo il nome del sito.
[WOOCOMMERCE_SHOP_URL_INVALID]

L'indirizzo del negozio punta a una rete privata: deve essere raggiungibile su Internet

Cosa fare
Usa l'indirizzo pubblico del negozio.
[WOOCOMMERCE_SHOP_URL_PRIVATE_HOST]

Il negozio rifiuta la chiave API: verifica la chiave, il segreto e i loro permessi

Cosa fare
Verifica la chiave e il segreto in WooCommerce (Impostazioni › Avanzate › REST API), oppure creane una nuova.
[WOOCOMMERCE_SHOP_AUTH_FAILED]

La chiave API è in sola lettura: crea una chiave in lettura/scrittura in WooCommerce

Cosa fare
Crea una chiave con i permessi «Lettura/Scrittura» e inseriscila.
[WOOCOMMERCE_SHOP_READ_ONLY_KEY]

Versione di WooCommerce non supportata (…, almeno …)

Cosa fare
Aggiorna WooCommerce (almeno 7.0), poi prova di nuovo.
[WOOCOMMERCE_SHOP_VERSION_UNSUPPORTED]

La valuta del negozio (…) è diversa da quella dell'organizzazione (…)

Cosa fare
Il connettore collega solo un negozio nella valuta della tua organizzazione.
[WOOCOMMERCE_SHOP_CURRENCY_MISMATCH]

Il negozio pubblica i prezzi IVA esclusa, ma la connessione è impostata su IVA inclusa (o viceversa)

Cosa fare
In «Impostazioni», scegli per «Prezzi pubblicati» il regime del negozio, che deve corrispondere a «Prezzi inseriti con tasse». Metti prima la connessione in pausa se è attiva, salva, poi prova.
[WOOCOMMERCE_SHOP_PRICE_MODE_MISMATCH]

Il negozio non è raggiungibile (…)

Cosa fare
Verifica che il negozio risponda, poi riprova.
[WOOCOMMERCE_SHOP_UNREACHABLE]

Il negozio non ha risposto in tempo

Cosa fare
Riprova un po' più tardi.
[WOOCOMMERCE_SHOP_TIMEOUT]

Il negozio limita le chiamate: riprova più tardi

Cosa fare
Attendi: il passaggio successivo riprende da solo.
[WOOCOMMERCE_SHOP_RATE_LIMITED]

Risposta del negozio illeggibile

Cosa fare
Verifica che l'indirizzo porti al negozio WooCommerce e che la sua REST API sia attiva.
[WOOCOMMERCE_SHOP_RESPONSE_INVALID]

Metti in pausa la connessione prima di cambiare negozio o chiave API

Cosa fare
«Metti in pausa», modifica, «Salva», «Prova la connessione», «Riprendi».
[WOOCOMMERCE_CONNECTION_ACTIVE_CHANGE_REFUSED]

Disconnetti prima il negozio attuale (i suoi webhook sono ancora attivi) prima di inserirne un altro

Cosa fare
«Disconnetti», poi inserisci il nuovo negozio.
[WOOCOMMERCE_SHOP_CHANGE_REQUIRES_DISCONNECT]

Il regime dei prezzi (IVA esclusa/inclusa) si cambia con la connessione in pausa: metti in pausa, salva, prova, poi riprendi

Cosa fare
Segui quest'ordine; il regime viene verificato con il negozio al test e alla ripresa.
[WOOCOMMERCE_PRICE_MODE_CHANGE_REQUIRES_PAUSE]

La chiave e il segreto dell'API WooCommerce sono richiesti insieme

Cosa fare
Inseriscili entrambi, oppure lasciali entrambi vuoti per conservare la chiave salvata.
[WOOCOMMERCE_CREDENTIALS_REQUIRED]

Attiva l'autenticazione a due fattori sul tuo account prima di inserire le credenziali di un negozio

Cosa fare
Attivala in «Le mie informazioni» (la schermata propone «Apri «Le mie informazioni»»), poi salva di nuovo.
[WOOCOMMERCE_CONNECTION_TWO_FACTOR_REQUIRED]

Un magazzino di esercitazione non può essere collegato a un negozio online

Cosa fare
Scegli un magazzino reale come «Magazzino pubblicato».
[WOOCOMMERCE_WAREHOUSE_EXERCISE_REFUSED]

Le credenziali salvate non possono più essere lette su questo server: inseriscile di nuovo

Cosa fare
Inserisci di nuovo la chiave e il segreto, prova, poi attiva.
[INTEGRATIONS_CREDENTIALS_UNREADABLE]

Una sincronizzazione è già in corso per questa connessione: riprova tra qualche istante

Cosa fare
Attendi la fine del passaggio in corso.
[INTEGRATIONS_CONNECTION_BUSY]

Domande frequenti

I prodotti con varianti sono supportati?

Sì. Un prodotto con varianti viene pubblicato come un prodotto variabile, e ciascuna delle sue varianti come una variazione, con il suo riferimento, il suo prezzo e il suo stock. Un ordine di una variazione dà un buono sulla variante.

Si possono collegare più negozi o più magazzini?

No. Un'organizzazione collega un negozio, e un negozio è collegato a un solo magazzino, il «Magazzino pubblicato».

Le consegne vengono comunicate al negozio?

Sì, se «Segnalare consegne e annullamenti al negozio» è selezionata, come avviene per impostazione predefinita. Un buono consegnato porta il suo ordine a «completato»; se è partito in una spedizione, il corriere e il n. di tracciamento vengono aggiunti in una nota al cliente. Un buono annullato in GSE-Web annulla il suo ordine nel negozio. GSE-Web non scrive mai le righe di un ordine.

Le immagini e la descrizione dei prodotti vengono scambiate?

Non partono mai da GSE-Web: foto e descrizione si gestiscono nel negozio. Se invece selezionate «Riprendere descrizione e foto dal negozio», vengono copiate in GSE-Web sui prodotti collegati. Foto e descrizione proprie di ogni variante non vengono riprese.

Le categorie e la classe IVA del negozio vengono riprese?

No. Restano gestite nel negozio e GSE-Web non le riprende.

Cosa succede se metto in pausa o se il modulo viene chiuso?

Nulla viene inviato né importato, e nulla viene eliminato. Lo stock nel negozio resta quello dell'ultimo invio. Alla ripresa, gli ordini effettuati nel frattempo vengono recuperati se hanno meno di 30 giorni (regolabile da 1 a 90).

Dopo quanto tempo un ordine compare in GSE-Web?

Subito, tramite webhook. Se un webhook va perso, il passaggio successivo, ogni 5 minuti, recupera l'ordine.

Il negozio può vendere un prodotto che non è più in stock?

Il rischio si riduce a pochi secondi, senza sparire. Lo stock parte verso il negozio pochi secondi dopo ogni uscita, entrata o prenotazione registrata in GSE-Web, e ogni ordine del negozio riserva subito tutta la sua quantità. Una vendita nel negozio nel momento esatto di un'uscita in magazzino resta possibile: diventa un buono la cui parte mancante si legge «In attesa di ricezione», o un punto da gestire.

Un acquirente già presente tra i miei soggetti viene riconosciuto?

No. Il connettore crea un cliente «Privato» per acquirente e lo ritrova tramite la sua e-mail negli ordini successivi, ma non lo abbina a un soggetto già inserito in GSE-Web.

Gli ordini effettuati prima dell'attivazione vengono importati?

No. Vengono importati solo gli ordini ricevuti dopo l'attivazione.

Come ottengo il connettore?

I moduli «Integrazioni» e «WooCommerce» vengono aperti da KLS-Concept organizzazione per organizzazione. Scrivici dalla pagina dei contatti.

Collega il tuo negozio WooCommerce

Chiedi l'apertura del connettore per la tua organizzazione, oppure inviaci le tue domande sul tuo caso.