Wat Billbee vraagt
Volgens zijn helpcentrum, in het Duits, heeft de Billbee API de API-sleutel van de applicatie nodig en daarnaast uw Billbee-gebruikersnaam en een speciaal API-wachtwoord dat u als handelaar identificeert. Dat wachtwoord moet minstens 12 tekens lang zijn en mag geen dubbele punt bevatten. Billbee voegt eraan toe dat er voor API-toegang geen toegangsbeperkingen gelden.
Sinds 1 november 2025 blijven, volgens zijn pagina over de API-prijzen, de eerste 100.000 calls per maand gratis voor elke koppeling of tool. Elke tool krijgt precies één API-sleutel, en de factuur gaat altijd naar de eigenaar van de koppeling.
De sleutel is van FlexigoTech en uw gegevens gaan naar FlexigoTech Cloud
Omdat Billbee één sleutel per tool uitgeeft, is de sleutel van de connector van FlexigoTech. Elke call van uw Odoo naar Billbee loopt via FlexigoTech Cloud, op onze servers in Duitsland. Daar komen uw gebruikersnaam en API-wachtwoord, versleuteld bewaard, samen met die sleutel bij. Een call gaat alleen de deur uit als er een actieve proefperiode of een actief abonnement op FlexigoTech Cloud is.
Het Api-wachtwoord kunt u alleen schrijven en het wordt niet in Odoo bewaard. Als u het op het account opslaat in Billbee › Configuratie › Accounts, gaan uw gebruikersnaam, die wel op het record blijft, en het wachtwoord samen naar FlexigoTech Cloud. Daarvoor vinkt u aan dat u accepteert dat FlexigoTech Cloud uw Billbee-gegevens bewaart en dat de calls erdoorheen lopen. De hulptekst van het veld herinnert eraan dat het om het API-wachtwoord gaat, los van het inlogwachtwoord, minstens 12 tekens lang en zonder dubbele punt.

Billbee › Configuratie › Accounts: het gekoppelde account, met de gegevens opgeslagen in FlexigoTech Cloud en de datum van de laatste test.De verbinding testen
Verbinding testen leest één pagina met één bestelling uit Billbee. Als Billbee antwoordt, gaat het account naar Verbonden, slaat het de testdatum op en herlaadt het record zichzelf. Antwoordt het met 401 of 403, dan gaat het account naar Authenticatiefout en vraagt het u de gebruikersnaam en het API-wachtwoord te controleren.
Alleen een Odoo-beheerder kan Billbee met die gegevens aanroepen. De geplande taken, het bestelbericht en de zending die vertrekt als een levering wordt bevestigd, roepen aan als het systeem. Als u het account archiveert, roept Odoo Billbee er niet meer mee aan: het is de schakelaar die alles stopt.
Het quotum aan calls: alleen vragen wat veranderd is
Om weinig calls te gebruiken, vraagt elke bestelronde alleen de bestellingen op die sinds de vorige veranderd zijn, en stuurt de voorraadtaak alleen de producten waarvan het getal veranderd is, tot 100 per call. De connector telt de calls niet: de verbruikscall van Billbee staat in zijn code, maar geen scherm en geen taak gebruikt hem. De calls worden toch weggeschreven in Billbee › Synchronisatielogboek, met de methode, het pad, de responscode en de milliseconden.
Als er iets misgaat
Antwoordt Billbee met 429, te veel calls, dan probeert Odoo het tot 5 keer opnieuw, en wacht het zo lang als Billbee vraagt of een tijd die bij elke poging verdubbelt, telkens hoogstens 300 seconden. Een 5xx-fout van Billbee wordt tot 3 keer opnieuw geprobeerd. Een pauze van FlexigoTech Cloud wordt niet opnieuw geprobeerd.
Odoo volgt geen omleidingen: als Billbee er een terugstuurde, wordt de call met een fout geweigerd, zodat de gegevens niet ergens anders heen gaan.
Elke fout in het logboek maakt een activiteit aan voor de verantwoordelijke van het account (is die er niet, voor wie aan het werk was). De dagelijkse opschoning verwijdert logregels die ouder zijn dan 90 dagen.

Het bestelbericht
Met Webhook registreren bij Billbee (beste poging), op het account, registreert Odoo in Billbee het bericht over nieuwe bestellingen. Voordat Billbee het accepteert, controleert het het adres, en Odoo antwoordt alleen met dezelfde tekst als het adres het geheim van het account bevat. Daarna laat elk bericht Odoo die bestelling lezen of, als het die niet vindt, meteen de bestelronde starten. Ook als het bericht niet geregistreerd is, komen de bestellingen binnen met de taak, elke 15 minuten.
Wat elke ronde met de bestellingen doet, staat in Billbee-bestellingen in Odoo, en de begrippen van Billbee in wat is Billbee.
We hebben het getest met een Billbee-account
Op 17-11-2026 hebben we met een testaccount voor handelaren van Billbee en de testdienst van FlexigoTech Cloud de verbinding, de voorraad, de bestellingen en de verzending van begin tot eind getest op Odoo 20, zonder fouten. Op 18-11-2026 hebben we met versie 1.2.11 op Odoo 17, 18, 19 en 20 het bestelbericht geregistreerd, en Billbee controleerde eerst het adres. Op Odoo 17, 18 en 20 kwam een daarna in Billbee aangemaakte bestelling binnen in Odoo.
Vragen over de Billbee API en Odoo
Heb ik een eigen Billbee-API-sleutel nodig?
Nee. De sleutel hoort bij de integratie en is van FlexigoTech. U vult uw Billbee-gebruikersnaam in en een API-wachtwoord, dat u in Billbee los van uw inlogwachtwoord aanmaakt.
Waar wordt mijn API-wachtwoord bewaard?
In FlexigoTech Cloud, versleuteld. In uw Odoo kunt u het veld alleen schrijven: u kunt het wijzigen, maar niet lezen.
Wat kost het?
De module kost 9 € per Odoo-versie in Odoo Apps. Hij werkt met FlexigoTech Cloud, vanaf 49 €/maand: plan Connector Standaard voor 49 €/maand of 490 €/jaar, of Pro voor 98 €/maand of 980 €/jaar, exclusief btw. De proefperiode duurt 14 dagen, gratis en zonder kaart. U krijgt 2 maanden ondersteuning bij de ingebruikname en, zolang u geabonneerd blijft, de updates en de ondersteuning, volgens de verkoopvoorwaarden 2.2. Alles staat op de pagina van de Billbee-connector.
Met welke Odoo-versies werkt het?
Met Odoo 17, 18, 19 en 20, op Odoo.sh of op uw eigen server. Op Odoo Online werkt het niet. Uw Billbee-account, met de gebruikersnaam en een API-wachtwoord, en het abonnement daarvan staan daar los van.
Lees verder
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen
Bronnen
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:172
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:103
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:110
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:541
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:230
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:215
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:196
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:153
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:148
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:265
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_sync_log.py:76
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_sync_log.py:117
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:144
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:96
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:582
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:237
- Broncode van de module: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:124
- Broncode van de module: 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
- Echte test van FlexigoTech met een Billbee-testaccount (17 en 18-11-2026)
- flexigotech.com/nl/billbee-koppeling-odoo.html
- www.billbee.io/
- www.billbee.io/en
