Order Invoicer
Odoo

Configurare Odoo

Ottenga le credenziali API di Odoo per collegare Order Invoicer

Prerequisiti

Prima di iniziare, si assicuri che:

  • Disponga di un account Odoo (Odoo Online o Odoo.sh, versione 15+)
  • Disponga dell'accesso come amministratore o dei diritti sufficienti per creare chiavi API
  • Conosca l'URL della sua istanza Odoo (ad es. https://mycompany.odoo.com)

Ottenere le credenziali API

Order Invoicer necessita di tre informazioni per collegarsi alla sua istanza Odoo:

  1. L'URL della sua istanza Odoo
  2. Il nome del database
  3. Una chiave API

Identificare l'URL di Odoo

L'URL di Odoo è l'indirizzo che utilizza per accedere alla sua istanza:

  • Odoo Online: https://mycompany.odoo.com
  • Odoo.sh: https://mycompany.odoo.com o un sottodominio personalizzato
  • On-premise: l'URL del suo server (ad es. https://erp.mycompany.com)

L'URL deve iniziare con https://. Se la sua istanza non è su HTTPS, contatti il suo amministratore di sistema.

Trovare il nome del database

Il nome del database dipende dal tipo di hosting:

  • Odoo Online: il nome del database corrisponde generalmente al sottodominio del suo URL (ad es. per https://mycompany.odoo.com, il database è mycompany)
  • Odoo.sh: verifichi il nome esatto nella dashboard di Odoo.sh
  • On-premise: chieda al suo amministratore di sistema

Per verificare il nome del database:

  1. Vada su https://your-odoo-url.com/web/database/manager
  2. Viene visualizzato l'elenco dei database disponibili
  3. Prenda nota del nome esatto del suo database

Se la sua istanza Odoo Online è multi-database, si assicuri di selezionare il database corretto. In caso di dubbio, è il sottodominio presente nel suo URL.

Generare una chiave API

Odoo utilizza chiavi API per un'autenticazione sicura. Ecco come crearne una:

  1. Acceda alla sua istanza Odoo
  2. Clicchi sul suo avatar in alto a destra, poi su Il mio profilo (o Preferenze)
  3. Vada alla scheda Sicurezza dell'account
  4. Nella sezione Chiavi API, clicchi su Nuova chiave API
  5. Inserisca una descrizione (ad es. Order Invoicer)
  6. Se l'autenticazione a due fattori è attiva, inserisca il suo codice TOTP
  7. Copi immediatamente la chiave visualizzata

La sezione Chiavi API nella scheda Sicurezza dell’account del Suo profilo Odoo

La chiave API viene visualizzata una sola volta. Se la perde, dovrà generarne una nuova dalle impostazioni di sicurezza del suo profilo.

Se non vede la sezione "Chiavi API", verifichi che la sua versione di Odoo sia la 14 o superiore. Le chiavi API non sono disponibili nelle versioni precedenti.

Configurare i permessi

L'utente associato alla chiave API deve disporre dei seguenti diritti in Odoo:

Contabilità / Fatturazione

  • ✅ Leggere e creare fatture
  • ✅ Leggere e creare note di credito
  • ✅ Leggere e creare pagamenti

Contatti

  • ✅ Leggere e creare contatti (partner)

Vendite (se sincronizza gli ordini d'acquisto)

  • ✅ Leggere e creare ordini d'acquisto

Prodotti

  • ✅ Leggere i prodotti

Per verificare i diritti dell'utente:

  1. Vada su Impostazioni > Utenti e aziende > Utenti
  2. Selezioni l'utente associato alla chiave API
  3. Verifichi che i diritti sopra indicati siano concessi

Le consigliamo di utilizzare un account amministratore o di creare un utente dedicato con i permessi necessari per evitare errori legati ai diritti.

Inserire le credenziali in Order Invoicer

Dal modulo di connessione a Odoo in Order Invoicer, inserisca:

  • URL Odoo: l'URL completo della sua istanza (ad es. https://mycompany.odoo.com)
  • Nome del database: il nome del suo database Odoo
  • Chiave API: la chiave generata nel passaggio precedente

Il connettore convaliderà automaticamente le sue credenziali interrogando l'API di Odoo e verificherà i permessi del suo account.

Risoluzione dei problemi

Errore "Impossibile raggiungere un server Odoo"

Quasi sempre significa che l'URL non è quello della Sua istanza Odoo:

  • Inserisca l'indirizzo del Suo back-office Odoo — quello mostrato nella barra degli indirizzi del browser quando è connesso a Odoo (es. https://miaazienda.odoo.com).
  • Non inserisca il dominio del Suo negozio online o del punto vendita: sono siti distinti, non Odoo.
  • Rimuova eventuali percorsi /odoo o /web alla fine dell'URL — mantenga solo l'indirizzo di base.
  • Verifichi che l'indirizzo inizi con https:// e che la Sua istanza sia raggiungibile da internet.

Errore "Odoo ha rifiutato le Sue credenziali"

Odoo ha risposto, ma il nome del database o la chiave API è errato:

  • Verifichi che il nome del database sia esatto (sensibile a maiuscole/minuscole)
  • Si assicuri che la chiave API sia completa e non sia stata troncata
  • Rigeneri la chiave API in caso di dubbio (vedi passaggio 4)

Errore "Permessi insufficienti"

  • Verifichi i diritti dell'utente associato alla chiave API (vedere il passaggio 4)
  • Si assicuri che i moduli Contabilità e Contatti siano installati sulla sua istanza

Errore "Connessione non riuscita"

  • Verifichi che la sua istanza Odoo sia raggiungibile da internet
  • Se utilizza un firewall o una VPN, si assicuri che le connessioni API siano consentite
  • Verifichi che la sua istanza non sia in manutenzione

Assistenza

Se incontra difficoltà:

  1. Consulti la sezione sulla risoluzione dei problemi qui sopra
  2. Faccia riferimento alla documentazione ufficiale di Odoo
  3. Contatti la nostra assistenza: contact@orderinvoicer.com

Configurare NetSuite

Configura la Token-Based Authentication (TBA) per collegare Order Invoicer a NetSuite

Regole di corrispondenza delle aliquote IVA

Comprenda come le aliquote IVA vengono associate automaticamente alle imposte di Odoo

In questa pagina

PrerequisitiOttenere le credenziali APIIdentificare l'URL di OdooTrovare il nome del databaseGenerare una chiave APIConfigurare i permessiInserire le credenziali in Order InvoicerRisoluzione dei problemiErrore "Impossibile raggiungere un server Odoo"Errore "Odoo ha rifiutato le Sue credenziali"Errore "Permessi insufficienti"Errore "Connessione non riuscita"Assistenza