Cosa chiede Billbee
Secondo il suo centro assistenza, in tedesco, l'API di Billbee richiede la chiave API dell'applicazione e, in più, il tuo nome utente Billbee e una password API speciale che ti identifica come commerciante. Questa password deve avere almeno 12 caratteri e non può contenere i due punti. Billbee aggiunge che l'accesso all'API non ha restrizioni di accesso.
Dal 1° novembre 2025, secondo la sua pagina sul prezzo dell'API, le prime 100.000 chiamate al mese restano gratuite per ogni connessione o strumento. Ogni strumento ha esattamente una chiave API, e la fattura va sempre al titolare della connessione.
La chiave è di FlexigoTech e le tue credenziali vanno a FlexigoTech Cloud
Poiché Billbee rilascia una chiave per strumento, la chiave del connettore è di FlexigoTech. Ogni chiamata dal tuo Odoo a Billbee passa per FlexigoTech Cloud, sui nostri server in Germania, che aggiunge il tuo nome utente e la tua password API, conservati cifrati, insieme a quella chiave. Una chiamata parte solo se c'è una prova o un abbonamento a FlexigoTech Cloud attivo.
Il campo Password API è di sola scrittura e non si conserva in Odoo. Quando lo salvi nell'account in Billbee › Configurazione › Account, il tuo nome utente, che resta nella scheda, e la password vanno insieme a FlexigoTech Cloud. Prima, spunti che accetti che FlexigoTech Cloud conservi le tue credenziali Billbee e che le chiamate passino da lì. L'aiuto del campo ricorda che è la password API, separata da quella di accesso, di almeno 12 caratteri e senza due punti.

Billbee › Configurazione › Account: l'account collegato, con le credenziali salvate in FlexigoTech Cloud e la data dell'ultima prova.Provare la connessione
Verifica connessione legge una pagina con un solo ordine da Billbee. Se Billbee risponde, l'account passa a Connesso, salva la data della prova e la scheda si ricarica da sola. Se risponde 401 o 403, l'account passa a Errore di autenticazione e ti chiede di controllare il nome utente e la password API.
Solo un amministratore di Odoo può chiamare Billbee con quelle credenziali. Le attività pianificate, l'avviso degli ordini e la spedizione inviata quando si convalida una consegna chiamano come sistema. Se archivi l'account, Odoo smette di chiamare Billbee con quell'account: è l'interruttore che ferma tutto.
La quota di chiamate: chiedere solo ciò che è cambiato
Per usare poche chiamate, ogni passata degli ordini chiede solo gli ordini cambiati dalla precedente, e l'attività delle giacenze invia solo i prodotti il cui numero è cambiato, fino a 100 per chiamata. Il connettore non conta le chiamate: la chiamata di consumo di Billbee è nel suo codice, ma nessuna schermata e nessuna attività la usa. Le chiamate vengono comunque scritte in Billbee › Registro di sincronizzazione, con il metodo, il percorso, il codice di risposta e i millisecondi.
Quando qualcosa non va
Se Billbee risponde 429, troppe chiamate, Odoo riprova fino a 5 volte, aspettando quanto chiede Billbee o un'attesa che raddoppia a ogni tentativo, al massimo 300 secondi ogni volta. Un errore 5xx di Billbee si riprova fino a 3 volte. Una pausa di FlexigoTech Cloud non si riprova.
Odoo non segue i reindirizzamenti: se Billbee ne rispondesse uno, la chiamata viene rifiutata con un errore, così le credenziali non finiscono altrove.
Ogni errore nel registro crea un'attività per il responsabile dell'account (se non c'è, per chi stava lavorando). La pulizia giornaliera cancella le righe del registro più vecchie di 90 giorni.

L'avviso degli ordini
Con Registra webhook su Billbee (best-effort), nell'account, Odoo registra in Billbee l'avviso dei nuovi ordini. Prima di accettarlo, Billbee controlla l'indirizzo, e Odoo risponde con lo stesso testo solo se l'indirizzo porta il segreto dell'account. Da lì in poi, ogni avviso fa leggere a Odoo quell'ordine o, se non lo trova, avvia subito la passata degli ordini. Anche se l'avviso non è registrato, gli ordini arrivano con l'attività ogni 15 minuti.
Quello che fa ogni passata con gli ordini è in gli ordini di Billbee in Odoo, e il vocabolario di Billbee in cos'è Billbee.
L'abbiamo provato con un account Billbee
Il 17-11-2026, con un account di prova da commerciante di Billbee e il servizio di prova di FlexigoTech Cloud, abbiamo provato da cima a fondo la connessione, lo stock, gli ordini e la spedizione su Odoo 20, senza errori. Il 18-11-2026, con la versione 1.2.11 su Odoo 17, 18, 19 e 20, abbiamo registrato l'avviso degli ordini, e Billbee ha controllato prima l'indirizzo. Su Odoo 17, 18 e 20, un ordine creato dopo in Billbee è entrato in Odoo.
Domande sull'API di Billbee e Odoo
Mi serve una mia chiave API di Billbee?
No. La chiave è dell'integrazione, ed è di FlexigoTech. Inserisci il tuo nome utente Billbee e una password API, che crei in Billbee separata dalla password di accesso.
Dove si conserva la mia password API?
In FlexigoTech Cloud, cifrata. Nel tuo Odoo il campo è di sola scrittura: puoi cambiarla, ma non leggerla.
Quanto costa?
Il modulo costa 9 € per ogni versione di Odoo su Odoo Apps. Funziona con FlexigoTech Cloud, da 49 €/mese: piano Connettore Standard a 49 €/mese o 490 €/anno, oppure Pro a 98 €/mese o 980 €/anno, IVA esclusa. La prova dura 14 giorni, è gratuita e senza carta. Include 2 mesi di supporto per l'avviamento e, finché resti abbonato, gli aggiornamenti e il supporto, secondo le condizioni di vendita 2.2. Trovi tutto nella pagina del connettore Billbee.
Con quali versioni di Odoo funziona?
Con Odoo 17, 18, 19 e 20, su Odoo.sh o sul tuo server. Non funziona su Odoo Online. Il tuo account Billbee, con il nome utente e una password API, e il suo piano sono a parte.
Continua a leggere
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate
Fonti
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:172
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:103
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:110
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:541
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:230
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:215
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:196
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:153
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:148
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:265
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_sync_log.py:76
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_sync_log.py:117
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:144
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:96
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:582
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:237
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:124
- Codice del modulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:342
- hilfe.billbee.io/article/1505-nutzung-der-billbee-api
- hilfe.billbee.io/article/1506-preisgestaltung-der-billbee-api
- Test reale di FlexigoTech con un account di prova Billbee (17 e 18-11-2026)
- flexigotech.com/it/connettore-billbee-odoo.html
- www.billbee.io/
- www.billbee.io/en
