API BCE Testmodus: fiktive Daten, Testschlüssel, Sandbox
Testmodus der API BCE: pk_test-Schlüssel, eine Test-API wie v2 und fiktive Unternehmensnummern für jeden Fall, ohne Kontingent und ohne echte Daten.
Entwickeln und testen Sie Ihre Integration, ohne echte Daten oder Ihr Kontingent zu berühren. Die Test-API antwortet genau wie die Live-API (gleiche Routen, gleiche JSON-Hülle, gleiche Fehlercodes) mit fiktiven Unternehmen.
So funktioniert es#
- Erstellen Sie ein Testschlüsselpaar (
pk_test_…/sk_test_…) in Ihrem Konto. - Rufen Sie
https://api-bce.be/test/v2statthttps://companybelgium.be/api/v2auf, mit denselben Headern. - Für den Livebetrieb ändern Sie die Basis-URL und nutzen einen Live-Schlüssel: Ihr Code bleibt gleich.
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"Testschlüssel erreichen nie echte Daten, und die Test-API lehnt Live-Schlüssel ab: eine Verwechslung ist ausgeschlossen.
Test-Unternehmensnummern#
Wie die Testkarten von Stripe löst jede Nummer einen bestimmten Fall aus. Alle bestehen die Modulo-97-Prüfung.
| Nummer | Verhalten |
|---|---|
0999.999.130 | Aktives Unternehmen, vollständige Daten (Tätigkeiten, Niederlassungen, Jahresabschlüsse, Geschäftsführer). |
0999.999.229 | Konkurs eröffnet (juridicalSituationCode 050, inDistress true). |
0999.999.328 | Eingestelltes Unternehmen (Status Stopped). |
0999.999.427 | Natürliche Person (Selbständige), ohne Jahresabschlüsse. |
0999.999.724 | 403 auf /financial und /roles: höherer Tarif erforderlich. |
0999.999.526 | 429: Monatskontingent überschritten. |
0999.999.625 | 500: Serverfehler (und 503 bei VIES). |
0999.999.823 | 404: gültige Nummer, unbekanntes Unternehmen. |
0999.999.999 | 400: ungültige Nummer (Modulo-97-Prüfung fehlgeschlagen). |
USt-Nummern (VIES)#
| Nummer | Verhalten |
|---|---|
BE0999999130 | Gültig, mit Name und Adresse. |
BE0999999328 | Ungültig (eingestelltes Unternehmen). |
BE0999999625 | 503: VIES nicht verfügbar. |
Niederlassungen#
| Nummer | Verhalten |
|---|---|
2.999.999.172 | Sitz des aktiven Unternehmens. |
2.999.999.271 | Filiale in Gent. |
2.999.999.370 | Niederlassung des insolventen Unternehmens. |
Grenzen#
Der Testmodus erlaubt 1.000 Anfragen pro Stunde und Testschlüssel, ohne Monatskontingent. Webhooks sind im Testmodus noch nicht verfügbar.
Szenarien mit der API BCE gezielt testen#
Der Testmodus ist mehr als eine Spielwiese. Er erlaubt Ihnen, jeden Zweig Ihres Codes gezielt auszulösen. Jede Testnummer steht für einen bestimmten Fall. Deshalb können Sie automatisierte Tests schreiben, die immer dasselbe Ergebnis liefern. Echte Unternehmen ändern sich dagegen jeden Werktag.
- Lieferantenprüfung:
0999.999.130für den Normalfall,0999.999.229für einen eröffneten Konkurs. - Stammdatenpflege:
0999.999.328für ein eingestelltes Unternehmen,0999.999.427für eine natürliche Person. - Tarifgrenzen:
0999.999.724liefert 403 auf/financialund/roles. - Robustheit:
0999.999.526löst 429 aus,0999.999.625einen Serverfehler 500. - Eingabeprüfung:
0999.999.823ergibt 404,0999.999.999dagegen 400.
Testmodus in Ihre Pipeline einbinden#
Hinterlegen Sie zuerst die Basis-URL als Konfigurationswert. In der Testumgebung zeigt sie auf https://api-bce.be/test/v2, in der Produktion auf https://companybelgium.be/api/v2. Danach wechseln Sie nur noch Schlüssel und URL. Ihr Code bleibt also identisch. Außerdem lehnt die Test-API Live-Schlüssel ab. Eine Verwechslung fällt deshalb sofort auf.
Für die USt-Prüfung gibt es ebenfalls feste Fälle. BE0999999130 ist gültig, BE0999999328 ungültig, und BE0999999625 simuliert einen Ausfall von VIES mit 503. Testen Sie damit zum Beispiel Ihre Rechnungsstellung. Prüfen Sie schließlich die Niederlassungen 2.999.999.172, 2.999.999.271 und 2.999.999.370.
Grenzen des Testmodus#
Der Testmodus erlaubt 1.000 Anfragen pro Stunde je Testschlüssel und kennt kein Monatskontingent. Webhooks sind dort jedoch noch nicht verfügbar. Testen Sie Ihren Webhook-Empfänger daher mit der Testzustellung der Live-API. Beachten Sie außerdem, dass alle Testdaten fiktiv sind. Sie eignen sich also nicht für Datenanalysen.
Testfälle sinnvoll organisieren#
Ordnen Sie jeder Testnummer einen benannten Testfall zu. Ein Test namens Konkurs nutzt zum Beispiel immer 0999.999.229. Ein anderer prüft mit 0999.999.427, dass Ihr Code eine natürliche Person ohne Jahresabschlüsse akzeptiert. Dadurch bleibt Ihre Testsuite lesbar. Außerdem erkennt jeder im Team sofort, welcher Fall fehlschlägt.
Lassen Sie diese Tests in Ihrer CI laufen. Das Stundenlimit von 1.000 Anfragen reicht dafür in der Regel aus. Bündeln Sie jedoch die Aufrufe, wenn mehrere Pipelines denselben Testschlüssel nutzen.
Nutzen Sie den Testmodus außerdem für Demos und Schulungen. Die fiktiven Unternehmen zeigen alle wichtigen Fälle, ohne echte Firmen preiszugeben. So erklären Sie Kollegen zum Beispiel, wie Ihr System einen Konkurs oder ein eingestelltes Unternehmen anzeigt. Auch Präsentationen für Kunden bleiben damit frei von personenbezogenen Daten.
Häufige Fragen zum Testmodus der API BCE#
Kostet der Testmodus der API BCE etwas?
Nein. Testaufrufe belasten Ihr Monatskontingent nicht. Es gilt nur das Limit von 1.000 Anfragen pro Stunde je Testschlüssel.
Sind die Testnummern echte Unternehmen?
Nein. Die Nummern 0999.999.xxx bestehen die Modulo-97-Prüfung, gehören aber keinem Unternehmen. Ihre Validierung funktioniert also wie mit echten Nummern.
Antwortet die Test-API anders als die Live-API?
Nein. Routen, JSON-Hülle und Fehlercodes sind gleich. Nur die Daten sind fiktiv, und Webhooks fehlen im Testmodus noch.