Naar hoofdinhoud
Billbee

De Billbee API vanuit Odoo: de sleutel, uw API-wachtwoord, het quotum en wat er bij fouten gebeurt

Om met de Billbee API te praten, hebt u drie dingen nodig: de sleutel van de integratie, uw Billbee-gebruikersnaam en een API-wachtwoord. Met de Odoo-connector levert FlexigoTech de sleutel, en uw gebruikersnaam en wachtwoord gaan één keer, versleuteld, naar FlexigoTech Cloud.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 20 november 2026

In het kort

Module
Billbee
Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de connector, versie 20.0 · in de bronnen onderaan
Leestijd
5 min

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.

Het Billbee-account in Odoo
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.

Odoo gekoppeld aan FlexigoTech Cloud
Het onderdeel FlexigoTech Cloud in de instellingen van Odoo: de gekoppelde database en de Billbee-connector in zijn proefperiode.

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

Bestellingen van Billbee in Odoo: naar Verkoop, met klant, regels per SKU en de juiste btwHoe de connector Billbee-bestellingen in Odoo Verkoop zet: elke 15 minuten, met klant en levering, regels per SKU, btw inbegrepen en automatisering.De voorraad van Odoo in Billbee: het getal dat aankomt, hoe vaak, en wat er gebeurt als ze niet kloppenWelke voorraad de Odoo-connector naar Billbee stuurt, waarom hij onbevestigde Billbee-bestellingen aftrekt en wat de vergelijking om de zes uur doet.Billbee-verzending vanuit Odoo: een bestelling in twee leveringen en wat Billbee bij elke zietWat Odoo naar Billbee stuurt als u elke levering bevestigt: het trackingnummer, de vervoerder, de status verzonden pas aan het eind en het label.Wat is Billbee, en wat elk van zijn begrippen in Odoo isWat Billbee is, wie het gebruikt en wat de begrippen betekenen (status, reclamatie, Freier Provider, API-wachtwoord) als u het aan Odoo koppelt.
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