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.
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 (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».
- Quando: 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 negli ordini del negozio.
- Interruzione: pausa, disconnessione o chiusura del modulo in qualsiasi momento, senza perdere nulla; alla ripresa, gli ordini effettuati nel frattempo vengono recuperati.
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.
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).
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.
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.
- «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.
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.
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).
Attivare
«Attiva» ripete il test, poi crea quattro webhook «GSE-Web» in WooCommerce. Lo stato diventa «Attiva — sincronizzazione ogni 5 minuti». Gli ordini ricevuti prima dell'attivazione non vengono importati.
Cosa si sincronizza, e chi fa fede
Ogni campo ha un solo proprietario. GSE-Web non scrive mai un ordine del negozio: nessun ciclo è possibile.
📦 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
- ✓Immagini
- ✓Categorie
- ✓Classe d'imposta
- ✓Ordini
Le regole
- Solo prodotti semplici. I prodotti con varianti e i kit non vengono pubblicati.
- 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. Viene riletto a ogni passaggio e inviato se è cambiato.
- Un ordine = un buono di uscita confermato del magazzino pubblicato, stock riservato, indirizzo di consegna ripreso. Mai un buono parziale: se una riga crea problemi (prodotto sconosciuto, variante, 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.
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 — 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»
Avvia un passaggio senza attendere i 5 minuti: schede, stock e recupero degli ordini. Il messaggio dice se il passaggio è terminato, se ha rilevato punti da gestire o perché non è stato avviato.
Il «Registro»
Ogni passaggio vi compare con il suo tipo e il suo esito. Tipi: «Schede prodotto», «Stock», «Recupero ordini», «Ordine ricevuto», «Controllo webhook», «Test di connessione». Esiti: «Riuscito», «Parziale», «Non riuscito», «In corso», «Interrotto».
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.
Schede prodotto
- Causa
- Solo i prodotti semplici vengono pubblicati nel negozio.
- Cosa fare
- Nulla da fare in GSE-Web. Gestisci questo prodotto direttamente nel negozio.
- 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.
- Causa
- I prezzi sono pubblicati IVA inclusa e il prodotto non ha un'aliquota IVA.
- Cosa fare
- Inserisci l'aliquota IVA del prodotto.
- Causa
- Il prodotto del negozio con questo riferimento è già collegato a un altro prodotto di GSE-Web, oppure non è un prodotto semplice. 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.
- Causa
- WooCommerce ha rifiutato la scheda; il codice di rifiuto è mostrato.
- Cosa fare
- Verifica il prodotto nel negozio a partire da questo codice.
- Causa
- Il prodotto collegato non esiste più nel negozio.
- Cosa fare
- Ricrealo nel negozio con lo stesso riferimento. Se non deve più comparirvi, scrivici.
Stock
- Causa
- Lo stock disponibile ha dei decimali; il negozio vende solo unità intere.
- Cosa fare
- Solo informativo: il negozio mostra l'unità inferiore.
- 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
- 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».
- Causa
- L'ordine contiene una variante di prodotto, che il connettore non gestisce ancora.
- Cosa fare
- Gestisci questo ordine a mano.
- 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».
- Causa
- Il cliente che corrisponde a questo acquirente è stato archiviato.
- Cosa fare
- Nessun buono viene creato. Gestisci questo ordine a mano.
- Causa
- L'ordine è in una valuta diversa da quella della tua organizzazione.
- Cosa fare
- Gestisci questo ordine a mano.
- Causa
- Al recupero, l'ordine supera l'«Età massima di un ordine recuperato».
- Cosa fare
- «Riprova» lo importa comunque.
- 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».
- 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.
- Causa
- L'importazione non è riuscita; il motivo è indicato tra parentesi.
- Cosa fare
- Correggi la causa indicata, poi «Riprova».
Webhook
- 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.
«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».
- Cosa fare
- Inserisci l'indirizzo completo del negozio, che inizia con https://, senza nulla dopo il nome del sito.
[WOOCOMMERCE_SHOP_URL_INVALID]
- Cosa fare
- Usa l'indirizzo pubblico del negozio.
[WOOCOMMERCE_SHOP_URL_PRIVATE_HOST]
- Cosa fare
- Verifica la chiave e il segreto in WooCommerce (Impostazioni › Avanzate › REST API), oppure creane una nuova.
[WOOCOMMERCE_SHOP_AUTH_FAILED]
- Cosa fare
- Crea una chiave con i permessi «Lettura/Scrittura» e inseriscila.
[WOOCOMMERCE_SHOP_READ_ONLY_KEY]
- Cosa fare
- Aggiorna WooCommerce (almeno 7.0), poi prova di nuovo.
[WOOCOMMERCE_SHOP_VERSION_UNSUPPORTED]
- Cosa fare
- Il connettore collega solo un negozio nella valuta della tua organizzazione.
[WOOCOMMERCE_SHOP_CURRENCY_MISMATCH]
- Cosa fare
- Allinea «Prezzi pubblicati» all'impostazione «Prezzi inseriti con tasse» del negozio, salva, prova.
[WOOCOMMERCE_SHOP_PRICE_MODE_MISMATCH]
- Cosa fare
- Verifica che il negozio risponda, poi riprova.
[WOOCOMMERCE_SHOP_UNREACHABLE]
- Cosa fare
- Riprova un po' più tardi.
[WOOCOMMERCE_SHOP_TIMEOUT]
- Cosa fare
- Attendi: il passaggio successivo riprende da solo.
[WOOCOMMERCE_SHOP_RATE_LIMITED]
- Cosa fare
- Verifica che l'indirizzo porti al negozio WooCommerce e che la sua REST API sia attiva.
[WOOCOMMERCE_SHOP_RESPONSE_INVALID]
- Cosa fare
- «Metti in pausa», modifica, «Salva», «Prova la connessione», «Riprendi».
[WOOCOMMERCE_CONNECTION_ACTIVE_CHANGE_REFUSED]
- Cosa fare
- «Disconnetti», poi inserisci il nuovo negozio.
[WOOCOMMERCE_SHOP_CHANGE_REQUIRES_DISCONNECT]
- Cosa fare
- Segui quest'ordine; il regime viene verificato con il negozio al test e alla ripresa.
[WOOCOMMERCE_PRICE_MODE_CHANGE_REQUIRES_PAUSE]
- Cosa fare
- Inseriscili entrambi, oppure lasciali entrambi vuoti per conservare la chiave salvata.
[WOOCOMMERCE_CREDENTIALS_REQUIRED]
- Cosa fare
- Attivala in «Le mie informazioni» (la schermata propone «Apri «Le mie informazioni»»), poi salva di nuovo.
[WOOCOMMERCE_CONNECTION_TWO_FACTOR_REQUIRED]
- Cosa fare
- Scegli un magazzino reale come «Magazzino pubblicato».
[WOOCOMMERCE_WAREHOUSE_EXERCISE_REFUSED]
- Cosa fare
- Inserisci di nuovo la chiave e il segreto, prova, poi attiva.
[INTEGRATIONS_CREDENTIALS_UNREADABLE]
- Cosa fare
- Attendi la fine del passaggio in corso.
[INTEGRATIONS_CONNECTION_BUSY]
Domande frequenti
I prodotti con varianti sono supportati?
Non ancora. Vengono pubblicati solo i prodotti semplici. Un ordine che contiene una variante non viene importato: compare tra i punti da gestire.
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 spedizioni vengono comunicate al negozio?
No. GSE-Web non scrive mai negli ordini del negozio. La comunicazione delle spedizioni è prevista in una prossima versione.
Le immagini dei prodotti vengono inviate?
No. Le immagini, come la descrizione e le categorie, restano gestite nel negozio.
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?
Lo stock viene riletto a ogni passaggio, ogni 5 minuti, e inviato se è cambiato. Tra due passaggi, il negozio mostra l'ultimo stock inviato: un'uscita registrata in GSE-Web in questo breve intervallo vi è visibile solo al passaggio successivo.
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.
E Shopify, Sage o Odoo?
Compaiono nella pagina «Integrazioni», come connettori in arrivo. Nessuna data è annunciata.
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.