API BCE testmodus: testsleutels en fictieve bedrijfsgegevens
Testmodus van API BCE: pk_test-sleutels, een test-API gelijk aan v2 en fictieve ondernemingsnummers voor elk geval, zonder quotum of echte gegevens.
Bouw en test je integratie zonder echte gegevens of je quotum aan te spreken. De test-API antwoordt precies zoals de live-API (zelfde routes, zelfde JSON-envelope, zelfde foutcodes) met fictieve ondernemingen.
Hoe het werkt#
- Maak een testsleutelpaar (
pk_test_…/sk_test_…) aan in je account. - Roep
https://api-bce.be/test/v2aan in plaats vanhttps://companybelgium.be/api/v2, met dezelfde headers. - Ga je live, vervang dan de basis-URL en gebruik een live-sleutel: je code verandert niet.
curl https://api-bce.be/test/v2/enterprise/0999.999.130 \
-H "X-API-Key: $API_BCE_KEY_TEST" \
-H "X-API-Secret: $API_BCE_SECRET_TEST"Testsleutels bereiken nooit echte gegevens en de test-API weigert live-sleutels: je kunt ze niet per vergissing verwisselen.
Test-ondernemingsnummers#
Zoals de testkaarten van Stripe triggert elk nummer een precies geval. Ze doorstaan allemaal de modulo 97-controle.
| Nummer | Gedrag |
|---|---|
0999.999.130 | Actieve onderneming, volledige gegevens (activiteiten, vestigingen, jaarrekeningen, bestuurders). |
0999.999.229 | Faillissement geopend (juridicalSituationCode 050, inDistress true). |
0999.999.328 | Stopgezette onderneming (status Stopped). |
0999.999.427 | Natuurlijk persoon (zelfstandige), zonder jaarrekeningen. |
0999.999.724 | 403 op /financial en /roles: hogere formule vereist. |
0999.999.526 | 429: maandquotum overschreden. |
0999.999.625 | 500: serverfout (en 503 bij VIES). |
0999.999.823 | 404: geldig nummer, onbekende onderneming. |
0999.999.999 | 400: ongeldig nummer (modulo 97-controle mislukt). |
Btw-nummers (VIES)#
| Nummer | Gedrag |
|---|---|
BE0999999130 | Geldig, met naam en adres. |
BE0999999328 | Niet geldig (stopgezette onderneming). |
BE0999999625 | 503: VIES niet beschikbaar. |
Vestigingen#
| Nummer | Gedrag |
|---|---|
2.999.999.172 | Zetel van de actieve onderneming. |
2.999.999.271 | Filiaal in Gent. |
2.999.999.370 | Vestiging van de failliete onderneming. |
Limieten#
De testmodus laat 1.000 verzoeken per uur en per testsleutel toe, zonder maandquotum. Webhooks zijn nog niet beschikbaar in testmodus.
Een volledige testsuite bouwen met API BCE#
De testnummers zijn het meest waardevol in geautomatiseerde tests. Elk nummer geeft immers altijd hetzelfde, voorspelbare antwoord. Je kunt er dus vaste verwachtingen op bouwen in je integratietests of je CI-pijplijn. Daarbij verbruik je geen maandquotum, want de testmodus heeft er geen.
Een goede testsuite dekt niet alleen het geslaagde pad. Ze controleert ook hoe je software reageert op slecht nieuws. Denk daarom aan scenario's zoals deze:
- Leverancierscontrole: 0999.999.229 moet in je workflow een waarschuwing geven, want het faillissement is geopend.
- Klantenbestand: 0999.999.328 is stopgezet. Je software moet die klant dus markeren of blokkeren.
- Zelfstandigen: 0999.999.427 is een natuurlijk persoon zonder jaarrekeningen. Je scherm mag dan niet breken op ontbrekende financiële gegevens.
- Formulebeperking: 0999.999.724 geeft een 403 op
/financialen/roles. Toon dan een duidelijke melding in plaats van een fout. - Veerkracht: 0999.999.526 geeft een 429 en 0999.999.625 een 500. Zo test je je logica om opnieuw te proberen.
Van test naar live zonder verrassingen#
Het overschakelen is bewust eenvoudig. Je wijzigt de basis-URL van https://api-bce.be/test/v2 naar https://companybelgium.be/api/v2 en gebruikt een live-sleutel. Zet beide waarden daarom in configuratie, niet in code. Zo wissel je per omgeving zonder een nieuwe release.
Houd echter rekening met twee verschillen. Ten eerste laat de testmodus 1.000 verzoeken per uur per testsleutel toe, wat los staat van de limiet van je live-formule. Ten tweede zijn webhooks nog niet beschikbaar in testmodus. Test je webhook-ontvanger dus apart, bijvoorbeeld met een testlevering vanaf de live-API.
Ten slotte: gebruik nooit echte ondernemingsnummers in je testdata. De test-API kent ze niet en geeft dan een 404. Bovendien blijven je tests zo onafhankelijk van wijzigingen in het echte register.
Een vaste set testgevallen
Leg de testnummers bij voorkeur vast in één bestand met constanten. Zo gebruiken al je tests dezelfde waarden en zie je meteen welk geval een test dekt. Voeg bovendien de testvestigingen toe, zoals 2.999.999.271 voor het filiaal in Gent. Draai deze suite ten slotte bij elke wijziging aan je integratie met API BCE. Een gebroken scenario valt dan op voordat het in productie komt.
Veelgestelde vragen over API BCE en de testmodus#
Kan ik een live-sleutel gebruiken op de test-API?
Nee. De test-API weigert live-sleutels en testsleutels bereiken nooit echte gegevens. Je kunt ze dus niet per vergissing verwisselen.
Hoe test ik een ongeldig ondernemingsnummer?
Gebruik 0999.999.999: dat nummer doorstaat de modulo 97-controle niet en geeft een 400. Het nummer 0999.999.823 is wel geldig, maar onbekend, en geeft dus een 404.
Bestaan er ook testgegevens voor btw en vestigingen?
Ja. Er zijn btw-nummers voor een geldig, een ongeldig en een onbeschikbaar VIES-antwoord. Daarnaast zijn er drie testvestigingen, waaronder een filiaal in Gent.