Cosa chiede l'API di B2Brouter
Per usare l'API di B2Brouter ti servono un account B2Brouter e la sua chiave API. La chiave si copia dalla scheda Developers dello stesso ambiente B2Brouter in cui lavorerai. Una chiave di prova non vale in produzione, e viceversa.
Ogni chiamata porta anche la versione dell'API. Il connettore la fissa su tutte le richieste: «X-B2B-API-Version: 2026-06-26». Se cambi questo valore in Odoo, deve essere una data nel formato AAAA-MM-GG. Con un altro formato Odoo non lo salva.
I tre ambienti e i loro indirizzi
B2Brouter ha tre ambienti. Produzione e sandbox usano lo stesso indirizzo, https://api.b2brouter.net. A decidere dove arriva la chiamata è il prefisso della chiave. Lo staging ha un indirizzo proprio, https://api-staging.b2brouter.net.
Il connettore controlla il prefisso quando salvi la chiave e di nuovo prima di ogni richiesta:
- In produzione accetta chiavi che iniziano con prod_ e quelle vecchie senza prefisso.
- In sandbox accetta solo chiavi che iniziano con test_.
- In staging accetta stag_ e test_.
Il motivo è semplice. Una chiave di produzione incollata in sandbox invierebbe fatture vere senza che nessuno se ne accorga. Il connettore lo blocca prima.
In sandbox gli invii sono simulati, i pagamenti sono disattivati e le anteprime PDF portano la filigrana «test invoice». È il posto giusto per provare la configurazione senza inviare nulla davvero.
Come Odoo si collega all'API
Il connettore ha una procedura guidata in B2Brouter › Connetti a B2Brouter. I passi sono Benvenuto, Ambiente, Ottieni la tua chiave API, Connetti e Fatto.
- Installa il connettore su Odoo 17, 18, 19 o 20 e attiva l'abbonamento a FlexigoTech Cloud. Il connettore ne ha bisogno per funzionare.
- Scegli l'ambiente: produzione, sandbox o staging.
- Copia la chiave API dalla scheda Developers di quello stesso ambiente e incollala.
- Come amministratore, dai il tuo consenso. FlexigoTech Cloud conserva la chiave cifrata e la riceve solo dopo quel consenso.
- Prova la connessione. Se manca la chiave, Odoo te lo dice prima di chiamare B2Brouter.

Webhook firmati e attività pianificate
B2Brouter segnala i cambiamenti con i webhook. Il connettore li riceve su un indirizzo proprio di ogni registrazione, con un token che non si può indovinare. Controlla anche la firma HMAC-SHA256 di ogni avviso con il segreto di quella registrazione. Quello che arriva lo vedi in B2Brouter › Documenti › Eventi webhook.
I webhook non sostituiscono i controlli periodici. Il connettore esegue queste attività:
- Inviare la coda dei documenti, ogni 5 minuti.
- Elaborare gli eventi webhook, ogni 5 minuti.
- Interrogare lo stato delle fatture, ogni 15 minuti.
- Aggiornare le liste di codici, ogni settimana.
Le liste di codici arrivano dall'API stessa: schemi, tipi di documento, paesi, valute, stati delle fatture, lingue e tipi di trasporto.
Quando qualcosa va storto: l'ID della richiesta
Ogni risposta di B2Brouter contiene un identificativo della richiesta. Il connettore salva l'ultimo nel campo Ultimo ID richiesta della connessione. Se apri una richiesta al supporto di B2Brouter, dai loro quel valore. Così trovano la tua chiamata senza che tu debba riprodurre l'errore.

Cosa ti serve e cosa non è incluso
Ti servono un tuo account B2Brouter e la sua chiave API. Le tariffe di B2Brouter non sono incluse. Il connettore è su Odoo Apps per Odoo 17, 18, 19 e 20 e funziona con l'abbonamento a FlexigoTech Cloud. I dettagli dell'integrazione sono nella pagina del connettore.
Posso provare l'API di B2Brouter senza inviare fatture vere?
Sì. Scegli l'ambiente sandbox e usa una chiave che inizia con test_. Gli invii sono simulati e i PDF portano la filigrana di fattura di prova.
Dove trovo la specifica dell'API?
Il connettore lavora con la versione 2026-06-26. La sua specifica OpenAPI è pubblicata su app.b2brouter.net.
Odoo conserva la mia chiave B2Brouter?
La conserva FlexigoTech Cloud, cifrata, e solo dopo il consenso di un amministratore su quella connessione.
Devo programmare qualcosa per usare l'API?
No. Il connettore fa le chiamate, firma e versione comprese. Tu scegli l'ambiente e incolli la chiave.
Continua a leggere
Verificato nel codice del connettore (versione 20.0)
Fonti
- Codice del modulo: b2brouter_connector 20.0 (dc5ea5d4): __manifest__.py
- Codice del modulo: b2brouter_connector 20.0 (dc5ea5d4): static/description/index.html
- Codice del modulo: b2brouter_connector 20.0 (dc5ea5d4): README.md
- Codice del modulo: b2brouter_connector 20.0 (dc5ea5d4): models/fgt_cloud.py
- Codice del modulo: b2brouter_connector 20.0 (dc5ea5d4): models/b2brouter_backend.py
- Codice del modulo: b2brouter_connector 20.0 (dc5ea5d4): wizards/b2brouter_setup_wizard.py
- Codice del modulo: b2brouter_connector 20.0 (dc5ea5d4): views/b2brouter_menus.xml
- Codice del modulo: b2brouter_connector 20.0 (dc5ea5d4): data/ir_cron.xml
