Faccia di GSE-Web il WMS del suo
ERP Odoo
Odoo conserva i suoi articoli, i suoi terzi, i suoi ordini e la sua contabilità. GSE-Web prepara, fa uscire, riceve e conta la merce, e fa fede per la giacenza fisica.
Questa documentazione descrive il funzionamento del connettore Odoo. Non è ancora aperto alle organizzazioni: la voce «Odoo» della pagina «Integrazioni» diventa disponibile solo a messa in servizio ultimata. Ci scriva se desidera essere avvisato della sua apertura.
In breve
Il connettore Odoo collega un Odoo (versioni 17, 18 e 19) a un magazzino di GSE-Web. Odoo resta il master dei suoi articoli, dei suoi terzi e dei suoi ordini; GSE-Web fa fede per la giacenza fisica. Lo configura un amministratore dell'organizzazione, nel menu ADMIN › «Integrazioni». Ogni scambio è un'opzione, disattivata per impostazione predefinita: compone lei il connettore che le serve.
- Cosa arriva in GSE-Web: gli ordini di vendita confermati del magazzino collegato, che diventano buoni di uscita confermati, con giacenza riservata; gli ordini di acquisto confermati, che diventano ordini fornitore; in opzione, gli articoli e i terzi di Odoo.
- Cosa parte verso Odoo: ogni entrata, uscita, rettifica, inventario o trasferimento del magazzino collegato, sotto forma di movimento di giacenza (mai una quantità sovrascritta), pochi secondi dopo; le consegne e i ricevimenti convalidati in GSE-Web; in opzione, le schede prodotto di GSE-Web.
- Quando: se spunta «Ricevere le notifiche da Odoo», un ordine arriva non appena Odoo avvisa GSE-Web. Un passaggio periodico (5 minuti per impostazione predefinita, da 1 a 15) fa da rete di sicurezza e recupera ciò che fosse mancato.
- Cosa non viene mai fatto: nessuna quantità viene convertita, nessun buono parziale viene creato, nulla viene eliminato in Odoo, e una differenza di giacenza non viene mai corretta in silenzio. La fatturazione e la contabilità restano a Odoo.
- Interruzione: pausa, disconnessione o chiusura del modulo in qualsiasi momento, senza perdere nulla; alla ripresa, gli ordini effettuati nel frattempo vengono recuperati.
Requisiti
Verifichi questi punti prima di aprire la schermata del connettore: il test di connessione li controlla e rifiuta in modo esplicito ciò che non va.
Odoo 17, 18 o 19
Le tre versioni sono supportate. GSE-Web legge la versione di Odoo e sceglie il protocollo di scambio: JSON-RPC fino a Odoo 18, JSON-2 a partire da Odoo 19. Un'altra versione viene rifiutata in modo esplicito.
Un utente di integrazione e la sua chiave API
Crei in Odoo un utente riservato a GSE-Web e gli generi una chiave API (Preferenze › Sicurezza dell'account › Nuova chiave API). Diritti utili: «Inventario / Utente» per scrivere i movimenti, «Vendite / Utente» e «Acquisti / Utente» per leggere gli ordini, «Impostazioni tecniche» solo per attivare il tempo reale.
Un Odoo raggiungibile da Internet, in HTTPS
L'indirizzo del server deve essere pubblico e in HTTPS, senza credenziali né parametri. Un indirizzo di rete privata viene rifiutato. Su Odoo Online, l'accesso esterno esiste solo con i piani «Custom».
I moduli attivi per la sua organizzazione
«Integrazioni», poi «Odoo». La loro apertura si richiede a KLS-Concept. Senza «Integrazioni», la voce di menu non compare; senza «Odoo», la sua scheda indica «Non disponibile per la tua organizzazione».
Un account ADMIN con autenticazione a due fattori
L'inserimento della chiave API viene rifiutato finché l'autenticazione a due fattori non è attiva sul suo account, in «Le mie informazioni».
Un magazzino reale e un magazzino Odoo
Il connettore collega un magazzino di Odoo a un magazzino reale di GSE-Web. Un magazzino di esercitazione viene rifiutato. Un solo magazzino per connessione.
La stessa valuta
La valuta della società Odoo deve essere quella della sua organizzazione. Se Odoo ha più società, sceglie quella da collegare.
Per il tempo reale: «Azioni automatizzate»
Perché gli ordini arrivino non appena Odoo avvisa GSE-Web, il modulo «Azioni automatizzate» deve essere installato in Odoo. In caso contrario funziona solo il passaggio periodico, e un punto da trattare glielo segnala.
Configurazione passo passo
Sei passaggi, nell'ordine della schermata.
Aprire la schermata del connettore
Menu ADMIN › «Integrazioni». La scheda Odoo si trova nella categoria «ERP». Faccia clic su «Configura» (il pulsante diventa «Gestisci» una volta salvata la connessione).
Scheda «Server Odoo»
Compili l'«Indirizzo del server» (ad esempio https://miaazienda.odoo.com), il «Database», l'«Utente di integrazione» (di solito il suo indirizzo e-mail in Odoo), la «Chiave API» e il «Magazzino GSE-Web» da collegare. Il «Protocollo di scambio» resta su «Automatico» salvo esigenze precise.
La chiave API è in sola scrittura: una volta salvata, non viene più mostrata, la schermata ne mostra solo alcuni caratteri. Per conservarla, lasci vuoto il campo; per sostituirla, ne inserisca una nuova. Se cambia l'indirizzo del server o il database, la chiave deve essere inserita di nuovo: non segue mai un altro bersaglio.
Provare la connessione, poi scegliere la società e il magazzino Odoo
Salvi, poi «Prova la connessione»: GSE-Web interroga Odoo, verifica la chiave, i diritti, la versione e la valuta, e la schermata mostra, ad esempio, «Odoo 18.0 · protocollo JSON-RPC». Odoo dichiara allora le sue società e i suoi magazzini: scelga la «Società Odoo» (obbligatoria non appena ce n'è più di una) e il «Magazzino Odoo» collegato al magazzino GSE-Web, poi «Salva». Anche in caso di rifiuto, il test conserva ciò che Odoo ha dichiarato, così da permetterle di correggere.
Comporre le opzioni
La scheda «Cosa passa tra GSE-Web e Odoo» raggruppa le opzioni per tema. Tutto è deselezionato per impostazione predefinita: spunti solo ciò che le serve.
- Vendite › «Importare gli ordini di vendita di Odoo»: con gli «Stati dell'ordine di vendita importati» («Confermato» per impostazione predefinita, «Bloccato» in aggiunta se lo desidera).
- Vendite › «Convalidare le consegne in Odoo»: un buono consegnato convalida la consegna dell'ordine in Odoo.
- Giacenza › «Inviare i movimenti di giacenza a Odoo in tempo reale»: ogni movimento del magazzino collegato parte verso Odoo.
- Giacenza › «Misurare ogni notte le differenze di giacenza»: GSE-Web confronta la propria giacenza con quella di Odoo.
- Acquisti › «Importare gli ordini di acquisto di Odoo»: con gli «Stati dell'ordine di acquisto importati» («Confermato» per impostazione predefinita, «Bloccato» in aggiunta se lo desidera).
- Acquisti › «Convalidare i ricevimenti in Odoo»: un ricevimento effettuato in GSE-Web viene convalidato in Odoo.
- Articoli e terzi › «Riprendere gli articoli da Odoo» oppure «Inviare le schede prodotto di GSE-Web a Odoo»: si escludono a vicenda, un solo master degli articoli; spuntarne una deseleziona l'altra. La «Corrispondenza delle unità di misura» associa l'identificativo di un'unità di Odoo al codice dell'unità GSE-Web.
- Articoli e terzi › «Riprendere i terzi da Odoo»: indirizzo, IVA e condizioni di pagamento dei clienti.
- Tempo reale › «Ricevere le notifiche da Odoo»: gli ordini arrivano non appena Odoo avvisa GSE-Web.
- Tempo reale › «Cadenza della scansione di riserva (minuti)»: 5 per impostazione predefinita, da 1 a 15. «Età massima di un ordine recuperato (giorni)»: 30 per impostazione predefinita, da 1 a 90; un ordine più vecchio diventa un punto da trattare invece di essere importato d'ufficio.
Salvare e provare
Faccia clic su «Salva». «Prova la connessione» e «Attiva» agiscono sulla configurazione salvata: finché una modifica non è salvata, la schermata lo ricorda. Se è spuntata un'opzione che scrive in Odoo mentre l'utente di integrazione non ha il diritto di scrittura, il test lo segnala.
Attivare
«Attiva» ripete il test (a questo punto è richiesto un magazzino Odoo). Se «Ricevere le notifiche da Odoo» è spuntata, GSE-Web crea in Odoo azioni automatizzate «GSE-Web» che lo avvisano a ogni modifica. Lo stato diventa «Attiva — scansione di riserva ogni N minuti». Ciò che precede l'attivazione non viene mai rigiocato: né ordini, né movimenti di giacenza precedenti.
Cosa si sincronizza, e chi fa fede
Ogni dato ha un solo master. GSE-Web non impone a Odoo i suoi articoli né i suoi ordini; Odoo non impone mai a GSE-Web una quantità fisica.
📦 Fa fede GSE-Web
- ✓Giacenza fisica: quantità e movimenti
- ✓Consegne: ciò che è effettivamente partito
- ✓Ricevimenti: ciò che è effettivamente arrivato
- ✓Articoli, se sceglie «Inviare le schede prodotto di GSE-Web a Odoo»
🏢 Fa fede Odoo
- ✓Ordini di vendita
- ✓Ordini di acquisto
- ✓Terzi (clienti)
- ✓Articoli, per impostazione predefinita o se sceglie «Riprendere gli articoli da Odoo»
- ✓Fatturazione
- ✓Contabilità
Le regole
- Un solo master degli articoli. «Riprendere gli articoli da Odoo» e «Inviare le schede prodotto di GSE-Web a Odoo» si escludono a vicenda. Gli articoli sono abbinati per riferimento (codice interno di Odoo = riferimento GSE-Web); non vengono mai eliminati in Odoo, un prodotto ritirato vi viene archiviato.
- Un ordine di vendita = un buono di uscita confermato del magazzino collegato, sulla quantità ancora da consegnare, con «Riserva i prodotti per questo buono» spuntato: tutta la quantità viene riservata, anche oltre la giacenza (la parte mancante si legge «In attesa di ricezione» sul buono).
- Mai un buono parziale. Se una riga crea problemi — articolo sconosciuto, unità diversa dall'unità di giacenza, articolo tracciato per lotto o numero di serie, valuta diversa, cliente archiviato — nessun buono viene creato e un punto da trattare ne spiega il motivo. «Ripeti» riprende l'importazione una volta corretta la causa. Nessuna quantità viene mai convertita.
- Un cliente = un terzo con il codice di Odoo. Il codice del terzo è il riferimento (
ref) del cliente in Odoo, oppureODOO-seguito dal suo identificativo se non ne ha. Non viene mai abbinato tramite e-mail. - Ordine annullato in Odoo: il buono viene annullato e le sue riserve liberate, a meno che qualcuno non lo abbia già in carico; in quel caso un punto da trattare lascia la decisione al team. Ordine modificato dopo l'importazione: la modifica non viene riportata sul buono, un punto da trattare la invita a verificarlo. Ordine già consegnato al di fuori di GSE-Web: nessun buono, un punto da trattare lo segnala.
- Consegna convalidata in Odoo: un buono consegnato o chiuso convalida la consegna con le quantità realmente preparate. Se è partito meno di quanto richiesto, il residuo resta aperto in Odoo. GSE-Web non annulla mai un ordine in Odoo.
- Giacenza in movimenti, mai in valore sovrascritto. Ogni entrata, rettifica, inventario o trasferimento del magazzino collegato diventa un movimento di giacenza in Odoo, pochi secondi dopo la modifica. Uno stesso movimento non viene mai inviato due volte. Nulla di precedente all'attivazione viene rigiocato. La valorizzazione (costo) resta a Odoo.
- Nessun doppio conteggio. Un'uscita derivata da un ordine importato da Odoo viene scalata in Odoo dalla sua consegna, e un ricevimento di un ordine di acquisto importato dal suo ricevimento: questi movimenti non partono in aggiunta come movimenti di giacenza.
- Differenze misurate, mai corrette in silenzio. Ogni notte, GSE-Web confronta la propria giacenza con quella di Odoo, articolo per articolo. Una differenza diventa un punto da trattare con le due quantità; nulla viene scritto, in nessuna direzione. «Allinea Odoo a GSE-Web» è un gesto dell'ADMIN: invia a Odoo una rettifica datata, la giacenza di GSE-Web non viene modificata.
- Un ordine di acquisto = un ordine fornitore confermato del modulo Acquisti, al terzo fornitore con lo stesso codice, al prezzo netto della riga, con la sua data prevista. Stessi rifiuti delle vendite: mai un ordine parziale. Un ordine modificato o annullato in Odoo dopo l'importazione non viene riportato: un punto da trattare lo segnala.
- Ricevimento convalidato in Odoo: un ricevimento effettuato in GSE-Web su un ordine importato convalida il ricevimento dell'ordine in Odoo con la quantità ricevuta; ciò che resta da ricevere resta aperto.
- Tempo reale e rete di sicurezza. Con «Ricevere le notifiche da Odoo», Odoo avvisa GSE-Web a ogni modifica; GSE-Web raggruppa le notifiche (2 secondi di quiete, 10 al massimo) poi rilegge i record in Odoo. Senza questa opzione, o se Odoo non può chiamare, basta il passaggio periodico. Le varianti di Odoo vengono riprese come prodotti semplici indipendenti.
Nel quotidiano
La schermata del connettore si legge dall'alto in basso: lo stato, il server, le opzioni, i pulsanti, poi i punti da trattare e il registro.
La scheda «Stato»
Indica a che punto è la connessione, la versione di Odoo e il protocollo scelto, la data dell'ultima sincronizzazione, l'ultimo errore e il numero di punti da trattare. Sulla scheda della pagina «Integrazioni», lo stato sta in un'etichetta.
- Da attivare «Configurata, non ancora attivata».
- Connesso «Attiva — scansione di riserva ogni N minuti».
- In pausa «In pausa — nulla viene inviato né importato».
- Interrotto — da verificare «Fermata dal server — verifichi la chiave e provi».
«Sincronizza ora»
Gli ordini arrivano non appena Odoo avvisa GSE-Web, o al più tardi alla scansione successiva, e la giacenza parte verso Odoo pochi secondi dopo ogni movimento: la schermata lo ricorda sotto il pulsante. Questo pulsante serve solo ad avviare subito un passaggio completo. Il messaggio dice se il passaggio è terminato, se ha rilevato punti da trattare o perché non è stato avviato.
La scheda «Cosa passa tra GSE-Web e Odoo»
Elenca le opzioni per tema — Vendite, Giacenza, Acquisti, Articoli e terzi, Tempo reale — indicando, per ciascuna, cosa fa. Le opzioni che scrivono in Odoo riportano la dicitura «Scrive in Odoo: l'utente di integrazione deve avere il diritto di scrittura». Se Odoo non può avvisare GSE-Web, la schermata lo indica e funziona solo la scansione di riserva.
Il «Registro»
Ogni passaggio vi compare con il suo tipo e il suo esito. Tipi: «Invio delle schede prodotto», «Ripresa degli articoli da Odoo», «Ripresa dei terzi da Odoo», «Invio della giacenza (recupero)», «Giacenza in diretta», «Recupero degli ordini di vendita», «Ordine ricevuto da Odoo», «Consegne convalidate in Odoo», «Recupero degli ordini di acquisto», «Ricevimenti convalidati in Odoo», «Misurazione delle differenze di giacenza», «Controllo delle azioni automatizzate», «Test di connessione». Esiti: «Riuscito», «Parziale», «Fallito», «In corso», «Interrotto». Un clic su un passaggio ne apre il dettaglio, elemento per elemento: ordine importato, consegna convalidata, movimento inviato o già presente in Odoo, articolo creato, aggiornato o collegato… (al massimo 200 elementi per passaggio). I passaggi che non hanno cambiato nulla possono essere nascosti.
I «Punti da trattare»
Una riga che non passa non blocca mai la sincronizzazione: diventa un punto da trattare e il resto prosegue. Corregga la causa in Odoo o in GSE-Web, poi «Ripeti»; altrimenti «Ignora».
- «Ripeti» è proposto per gli ordini di vendita e di acquisto, le consegne e i ricevimenti: rilegge il record in Odoo e ritenta. Gli altri punti scompaiono da soli una volta corretta la causa.
- «Ignora» archivia il punto: un punto ignorato non ricompare finché la sua causa non sia sparita e ricomparsa. «Ignora tutto», in cima all'elenco, archivia in una volta tutti i punti aperti dopo una conferma; per questo non viene importato alcun ordine.
Notifiche da Odoo
- Causa
- «Ricevere le notifiche da Odoo» è spuntata, ma il modulo «Azioni automatizzate» non è installato in Odoo, oppure l'utente di integrazione non ha i diritti tecnici per creare le azioni.
- Cosa fare
- Installi il modulo in Odoo e conceda all'utente di integrazione il diritto «Impostazioni tecniche», poi provi di nuovo. Nel frattempo, il passaggio periodico importa gli ordini.
- Causa
- Qualcuno ha disattivato o eliminato in Odoo un'azione «GSE-Web»; il controllo, ogni 6 ore, l'ha rilevato.
- Cosa fare
- GSE-Web la riattiva o la ricrea quando può, e il registro lo riporta. Altrimenti, verifichi in Odoo che le azioni «GSE-Web» siano attive.
Articoli e terzi
- Causa
- I movimenti di giacenza vengono inviati, ma nessun articolo stoccabile di Odoo ha il riferimento di questo prodotto.
- Cosa fare
- Crei l'articolo in Odoo con lo stesso riferimento (stoccabile), oppure spunti «Inviare le schede prodotto di GSE-Web a Odoo». Il punto scompare quando il movimento parte.
- Causa
- Odoo ha rifiutato la scheda inviata da GSE-Web; il suo codice di rifiuto è mostrato.
- Cosa fare
- Verifichi, a partire da questo codice, i diritti dell'utente di integrazione e la scheda dell'articolo in Odoo.
- Causa
- L'articolo collegato non esiste più in Odoo.
- Cosa fare
- Lo ricrei in Odoo con lo stesso riferimento. Se non deve più comparirvi, ci scriva.
- Causa
- Il connettore non gestisce gli articoli tracciati per lotto o per numero di serie di Odoo.
- Cosa fare
- Nulla da fare in GSE-Web: questo articolo non viene ripreso. Lo gestisca direttamente in Odoo.
- Causa
- L'unità di misura dell'articolo in Odoo non è nella «Corrispondenza delle unità di misura».
- Cosa fare
- Aggiunga l'identificativo dell'unità di Odoo e il codice dell'unità GSE-Web corrispondente, salvi, poi rilanci la sincronizzazione.
- Causa
- Il riferimento di questo prodotto è portato da più articoli in Odoo, oppure da un articolo già collegato a un altro prodotto di GSE-Web.
- Cosa fare
- Faccia in modo che un riferimento indichi un solo articolo, da entrambe le parti.
- Causa
- La scheda del terzo non ha potuto essere creata o aggiornata in GSE-Web.
- Cosa fare
- Verifichi la scheda del terzo in Odoo (nome, indirizzo), poi rilanci la sincronizzazione; se il punto ricompare, ci scriva.
Ordini di vendita
- Causa
- Una riga dell'ordine porta un riferimento che non esiste in GSE-Web.
- Cosa fare
- Crei il prodotto con lo stesso riferimento (oppure spunti «Riprendere gli articoli da Odoo»), poi «Ripeti».
- Causa
- La riga è espressa in un'unità diversa dall'unità di giacenza dell'articolo (ad esempio dozzine). Nessuna quantità viene mai convertita.
- Cosa fare
- Corregga la riga in Odoo perché sia nell'unità di giacenza, poi «Ripeti».
- Causa
- Una riga porta un articolo tracciato per lotto o per numero di serie in Odoo.
- Cosa fare
- Tratti questo ordine direttamente in Odoo; il connettore non supporta questi articoli.
- Causa
- La valuta dell'ordine non è quella della sua organizzazione.
- Cosa fare
- Utilizzi la valuta dell'organizzazione per questo ordine in Odoo, poi «Ripeti».
- Causa
- L'ordine risale a più giorni dell'«Età massima di un ordine recuperato» (30 per impostazione predefinita), ad esempio dopo una lunga pausa.
- Cosa fare
- Se desidera comunque trattarlo, «Ripeti» lo importa; altrimenti «Ignora».
- Causa
- Il terzo corrispondente al cliente è archiviato in GSE-Web.
- Cosa fare
- Riattivi il terzo in GSE-Web, poi «Ripeti».
- Causa
- Il buono è già in carico a qualcuno: GSE-Web non lo annulla sotto gli occhi del team.
- Cosa fare
- Decida con il team se annullare il buono o evaderlo, poi «Ripeti» o «Ignora».
- Causa
- GSE-Web non scrive in un buono già creato le modifiche apportate in seguito all'ordine.
- Cosa fare
- Verifichi il buono e lo corregga a mano se necessario, poi «Ignora».
- Causa
- Odoo ha già consegnato questo ordine quando arriva: un buono farebbe uscire la merce una seconda volta.
- Cosa fare
- Registri in GSE-Web l'uscita di giacenza corrispondente se non c'è, poi «Ignora».
- Causa
- Il buono non ha potuto essere creato; il motivo è mostrato.
- Cosa fare
- Corregga la causa indicata, poi «Ripeti»; se il punto ricompare, ci scriva.
- Causa
- GSE-Web non annulla mai un ordine in Odoo.
- Cosa fare
- Annulli l'ordine in Odoo se necessario, poi «Ignora».
Consegne e giacenza
- Causa
- Odoo non ha accettato la convalida: ordine eliminato in Odoo, riga del buono assente dall'ordine, oppure nessuna quantità preparata.
- Cosa fare
- Corregga la causa indicata in Odoo o in GSE-Web, poi «Ripeti».
- Causa
- Odoo ha rifiutato il movimento; il motivo è mostrato.
- Cosa fare
- Verifichi i diritti «Inventario / Utente» dell'utente di integrazione e l'articolo in Odoo. Il punto scompare quando il movimento parte.
- Causa
- La giacenza di GSE-Web e quella di Odoo differiscono per questo articolo. Nulla è stato scritto.
- Cosa fare
- Cerchi l'origine della differenza. Se GSE-Web ha ragione, «Allinea Odoo a GSE-Web» invia a Odoo una rettifica datata, dopo conferma delle due quantità.
Acquisti e ricevimenti
- Causa
- Una riga dell'ordine di acquisto porta un riferimento assente da GSE-Web.
- Cosa fare
- Crei il prodotto con lo stesso riferimento, poi «Ripeti».
- Causa
- La riga è espressa in un'unità diversa dall'unità di giacenza. Nessuna quantità viene convertita.
- Cosa fare
- Corregga la riga in Odoo, poi «Ripeti».
- Causa
- Nessun terzo fornitore di GSE-Web ha il codice del fornitore dell'ordine.
- Cosa fare
- Crei il fornitore con lo stesso codice (oppure spunti «Riprendere i terzi da Odoo»), poi «Ripeti».
- Causa
- La valuta dell'ordine non è quella della sua organizzazione.
- Cosa fare
- Utilizzi la valuta dell'organizzazione in Odoo, poi «Ripeti».
- Causa
- Una riga porta un articolo tracciato per lotto o per numero di serie in Odoo.
- Cosa fare
- Tratti questo ordine direttamente in Odoo.
- Causa
- L'ordine risale a più giorni dell'«Età massima di un ordine recuperato».
- Cosa fare
- «Ripeti» lo importa nonostante la sua età; altrimenti «Ignora».
- Causa
- GSE-Web non riporta in un ordine fornitore già creato le modifiche apportate in seguito in Odoo.
- Cosa fare
- Verifichi l'ordine fornitore e lo corregga a mano se necessario, poi «Ignora».
- Causa
- L'ordine fornitore non ha potuto essere creato; il motivo è mostrato.
- Cosa fare
- Corregga la causa indicata, poi «Ripeti»; se il punto ricompare, ci scriva.
- Causa
- Odoo non ha accettato la convalida del ricevimento; il motivo è mostrato.
- Cosa fare
- Corregga la causa indicata in Odoo o in GSE-Web, poi «Ripeti».
Pausa, ripresa e modifiche
Il connettore si spegne e si riaccende in qualsiasi momento. Alcune 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.
«Riprendi»
Il recupero parte: gli ordini effettuati durante la pausa vengono importati se hanno meno di N giorni («Età massima di un ordine recuperato», 30 per impostazione predefinita). Quelli più vecchi diventano punti da trattare.
Cambiare server, database, chiave, magazzino o negozio
Con una connessione attiva, queste impostazioni sono bloccate. Segua quest'ordine: «Metti in pausa», modifica, «Salva», «Prova la connessione», «Riprendi». Per cambiare server, prima «Disconnetti»: le azioni automatizzate del vecchio Odoo vengono rimosse. La chiave API va inserita di nuovo non appena cambia il server o il database.
«Disconnetti»
Dopo conferma, le azioni automatizzate «GSE-Web» vengono rimosse da Odoo e la chiave API viene cancellata. Nulla viene eliminato, né in Odoo né in GSE-Web: i buoni, i terzi e gli ordini già creati restano. Se Odoo non risponde, la schermata le chiede di eliminare lei stesso le azioni «GSE-Web» da Odoo.
Ricollegare lo stesso server
Gli ordini, gli articoli e i terzi già collegati vengono ritrovati: nessun secondo buono viene creato per un ordine già importato.
Ciò che precede l'attivazione
Gli ordini e i movimenti di giacenza precedenti all'attivazione non vengono mai rigiocati. Il passaggio periodico rilegge il giornale di giacenza un po' all'indietro per non perdere nulla, senza mai risalire prima dell'attivazione.
Scegliere chi è il master degli articoli
«Riprendere gli articoli da Odoo» e «Inviare le schede prodotto di GSE-Web a Odoo» non si spuntano insieme: spuntarne una deseleziona l'altra. Ci rifletta prima di attivare, per evitare che un lato riscriva l'altro.
Chiusura del modulo
Se KLS-Concept chiude il modulo per la sua organizzazione, tutto si ferma senza eliminare nulla. Alla riapertura, il passaggio successivo recupera gli ordini; i buoni, i terzi e gli ordini già creati restano ordinari.
Sicurezza e dati
Cosa conserva il connettore, e come.
Chiave API cifrata
La chiave API è cifrata sul server (AES-256-GCM). È in sola scrittura: non viene mai più mostrata, né scritta nei log, e va inserita di nuovo non appena cambia il server o il database.
Autenticazione a due fattori
È obbligatoria per inserire o sostituire la chiave API di un Odoo.
Solo HTTPS pubblico
Il connettore chiama solo l'indirizzo HTTPS inserito, su un host pubblico; nessun reindirizzamento viene seguito e un indirizzo di rete privata viene rifiutato.
Notifiche con indirizzo segreto
Odoo non firma le proprie notifiche. Ogni notifica arriva su un indirizzo segreto e il suo contenuto non viene mai considerato attendibile: GSE-Web rilegge il record in Odoo prima di agire.
Movimenti senza duplicati
Ogni movimento di giacenza porta un riferimento che permette a GSE-Web di verificare, prima di scrivere, che non sia già in Odoo. Nessuna quantità viene mai sovrascritta, nulla viene eliminato in Odoo.
Tracciabilità
Chi ha collegato Odoo, cambiato la chiave, sospeso la sincronizzazione, e ogni scrittura di GSE-Web in Odoo (consegna, ricevimento, movimento, allineamento) figurano nel registro di audit dell'organizzazione, senza mai il valore della chiave.
Risoluzione dei problemi
Il messaggio mostrato dalla schermata e cosa fare. Il codice tra parentesi quadre aiuta l'assistenza a ritrovare il caso.
«Fermata dal server — verifichi la chiave e provi»
Dopo cinque rifiuti di autenticazione consecutivi (chiave revocata, utente eliminato, password cambiata), il server interrompe la connessione per non insistere. Verifichi la chiave in Odoo, ne inserisca una nuova se necessario, «Salva», «Prova la connessione», poi «Attiva».
- Cosa fare
- Inserisca l'indirizzo completo, che inizia con https://, senza credenziali né parametri.
[ODOO_SERVER_URL_INVALID]
- Cosa fare
- Il connettore chiama solo server pubblici. Utilizzi l'indirizzo pubblico del suo Odoo.
[ODOO_SERVER_URL_PRIVATE_HOST]
- Cosa fare
- Compili il nome del database a cui si collega l'utente di integrazione, salvi, poi provi.
[ODOO_DATABASE_REQUIRED]
- Cosa fare
- Verifichi il database, l'utente e la chiave API, e che l'utente di integrazione sia attivo. Generi una nuova chiave se necessario.
[ODOO_SERVER_AUTH_FAILED]
- Cosa fare
- Il connettore non si collega a un'altra versione di Odoo.
[ODOO_SERVER_VERSION_UNSUPPORTED]
- Cosa fare
- Gli conceda i diritti «Inventario / Utente», oppure deselezioni l'opzione che scrive in Odoo.
[ODOO_SERVER_READ_ONLY]
- Cosa fare
- «Prova la connessione», scelga la «Società Odoo», poi «Salva».
[ODOO_COMPANY_REQUIRED]
- Cosa fare
- Provi di nuovo la connessione e scelga una società dall'elenco proposto.
[ODOO_COMPANY_UNKNOWN]
- Cosa fare
- Il connettore collega solo una società nella valuta della sua organizzazione.
[ODOO_SERVER_CURRENCY_MISMATCH]
- Cosa fare
- Scelga il «Magazzino GSE-Web» da collegare, poi «Salva».
[ODOO_WAREHOUSE_REQUIRED]
- Cosa fare
- Scelga un magazzino reale.
[ODOO_WAREHOUSE_EXERCISE_REFUSED]
- Cosa fare
- «Prova la connessione», scelga il «Magazzino Odoo», «Salva», poi «Attiva».
[ODOO_REMOTE_WAREHOUSE_REQUIRED]
- Cosa fare
- Provi di nuovo la connessione e scelga un magazzino della società selezionata.
[ODOO_REMOTE_WAREHOUSE_UNKNOWN]
- Cosa fare
- Verifichi che il suo Odoo risponda da Internet, poi riprovi.
[ODOO_SERVER_UNREACHABLE]
- Cosa fare
- Riprovi un po' più tardi.
[ODOO_SERVER_TIMEOUT]
- Cosa fare
- Attenda: il passaggio successivo riprende da solo.
[ODOO_SERVER_RATE_LIMITED]
- Cosa fare
- Riprovi; se il messaggio ricompare, ci scriva indicando il codice qui sotto.
[ODOO_SERVER_RESPONSE_INVALID]
- Cosa fare
- Legga il messaggio di Odoo: di solito dice cosa manca (diritto, record, campo). Lo corregga in Odoo, poi riprovi.
[ODOO_REMOTE_ERROR]
- Cosa fare
- «Metti in pausa», modifica, «Salva», «Prova la connessione», «Riprendi».
[ODOO_CONNECTION_ACTIVE_CHANGE_REFUSED]
- Cosa fare
- «Disconnetti», poi inserisca il nuovo server.
[ODOO_SERVER_CHANGE_REQUIRES_DISCONNECT]
- Cosa fare
- Inserisca la chiave API. Va inserita di nuovo non appena cambia l'indirizzo del server o il database.
[ODOO_CREDENTIALS_REQUIRED]
- Cosa fare
- La attivi in «Le mie informazioni» (la schermata propone «Apri «Le mie informazioni»»), poi salvi di nuovo.
[ODOO_CONNECTION_TWO_FACTOR_REQUIRED]
- Cosa fare
- Il più delle volte: «Riprendere gli articoli da Odoo» e «Inviare le schede prodotto di GSE-Web a Odoo» sono spuntate insieme. Ne tenga una sola.
[ODOO_SETTINGS_INVALID]
- Cosa fare
- Nulla da fare: la differenza è già stata assorbita.
[ODOO_STOCK_ALIGN_NOTHING_TO_DO]
- Cosa fare
- Inserisca di nuovo la chiave API, provi, poi attivi.
[INTEGRATIONS_CREDENTIALS_UNREADABLE]
- Cosa fare
- Attenda la fine del passaggio in corso.
[INTEGRATIONS_CONNECTION_BUSY]
Domande frequenti
Il connettore Odoo è disponibile?
È in fase di messa in servizio: questa pagina ne descrive il funzionamento, ma non è ancora aperto alle organizzazioni. Ci scriva dalla pagina dei contatti se desidera essere avvisato della sua apertura.
Quali versioni di Odoo sono supportate?
Odoo 17, 18 e 19. GSE-Web legge la versione e sceglie il protocollo: JSON-RPC fino a Odoo 18, JSON-2 a partire da Odoo 19. Un'altra versione viene rifiutata in modo esplicito, senza passaggi silenziosi.
Chi fa fede: GSE-Web o Odoo?
GSE-Web fa fede per la giacenza fisica, le consegne e i ricevimenti. Odoo conserva gli articoli (o GSE-Web, se lo sceglie), i terzi, gli ordini di vendita e di acquisto, la fatturazione e la contabilità. Odoo non scrive mai una quantità fisica in GSE-Web: la sua giacenza viene solo letta, per misurare le differenze.
La giacenza di GSE-Web sovrascrive quella di Odoo?
No. Ogni entrata, rettifica, inventario o trasferimento parte verso Odoo sotto forma di movimento di giacenza, mai come quantità sovrascritta. Un movimento già presente in Odoo non viene rinviato. Una differenza viene misurata ogni notte e mai corretta in silenzio: «Allinea Odoo a GSE-Web» è un gesto dell'ADMIN.
Bisogna attivare tutto?
No. Ogni scambio è un'opzione, disattivata per impostazione predefinita: vendite, consegne, giacenza, differenze, acquisti, ricevimenti, articoli, terzi, notifiche. Spunta solo ciò che le serve, ad esempio gli ordini di vendita, la giacenza e le consegne senza gli acquisti, o viceversa.
Cosa succede se una riga d'ordine crea problemi?
Nessun buono viene creato, mai un buono parziale, e un punto da trattare spiega il motivo: articolo sconosciuto, unità diversa dall'unità di giacenza, articolo tracciato per lotto o numero di serie, valuta diversa. Corregga la causa, poi «Ripeti». Nessuna quantità viene mai convertita.
Gli articoli con lotto o numero di serie sono gestiti?
No. Gli articoli tracciati per lotto o per numero di serie in Odoo vengono rifiutati, con un punto da trattare. Anche la fatturazione e la contabilità non rientrano nel perimetro del connettore.
Le varianti di Odoo vengono riprese?
Sì, come prodotti semplici indipendenti. La gerarchia padre e figlio delle varianti di GSE-Web non viene ripresa per il momento.
Dopo quanto tempo un ordine arriva in GSE-Web?
Subito se «Ricevere le notifiche da Odoo» è spuntata e se Odoo può chiamare GSE-Web (modulo «Azioni automatizzate» installato). Altrimenti, al più tardi al passaggio periodico successivo (5 minuti per impostazione predefinita, regolabile da 1 a 15).
E la giacenza verso Odoo?
Pochi secondi dopo ogni modifica nel magazzino collegato, se «Inviare i movimenti di giacenza a Odoo in tempo reale» è spuntata. Il passaggio periodico recupera un invio che si fosse perso.
Il mio Odoo non è raggiungibile da Internet. È possibile?
No. Il connettore chiama solo server pubblici in HTTPS. Su Odoo Online, l'accesso esterno esiste solo con i piani «Custom».
Cosa succede se metto in pausa o se disconnetto?
In pausa, nulla viene inviato né importato e nulla va perso; alla ripresa, gli ordini effettuati nel frattempo vengono recuperati. Alla disconnessione, le azioni automatizzate «GSE-Web» vengono rimosse da Odoo e la chiave viene cancellata; i buoni, i terzi e gli ordini già creati restano, e ricollegare lo stesso server non crea alcun secondo buono.
Colleghi il suo Odoo a GSE-Web
Chieda di essere avvisato dell'apertura del connettore per la sua organizzazione, oppure ci invii le sue domande sul suo caso.