Die Sandbox
Probieren Sie alles mit einem Testschlüssel aus (fkn_test_…, im Portal unter API-Schlüssel → Test). Er nutzt
dieselben Endpunkte und dieselbe Prüfung wie Live-Schlüssel, erreicht aber nur die Sandbox.
- Getrennte Daten. Testrechnungen, Dokumente, Zustellungen und Idempotenzschlüssel liegen getrennt von den
Live-Daten. Ein Testschlüssel sieht nie Live-Rechnungen und ein Live-Schlüssel nie Testrechnungen (
404). Verkäufer sind gemeinsam und lesbar. - Als Test gekennzeichnet. Jede Testrechnung trägt den Hinweis „TESTRECHNUNG – keine gültige Rechnung / TEST INVOICE – not a valid invoice“ und ist sonst eine schemagültige XRechnung, ZUGFeRD- oder RO-e-Factura-Rechnung.
- Kostenlos. Nichts wird berechnet oder gezählt; keine Tarifgrenzen, keine Verkäuferverifizierung.
- Nach 30 Tagen gelöscht. Testdaten werden nie archiviert.
- Sichere Zustellung. Peppol ist immer simuliert (
"simulated": true): Empfänger mitrejectlehnen ab,offlinebleiben ausstehend,unknownwerden nicht gefunden, alle anderen erhalten die Rechnung. E-Mails gehen nur an die bestätigten Adressen Ihrer eigenen Portalnutzer, mit[TEST]im Betreff. ANAF wird nie angesprochen (403 sandbox.anaf-unavailable). - Webhooks von Sandbox-Ereignissen tragen
"livemode": "false".
Grenzen
60 Anfragen pro Minute und 2 gleichzeitig (getrennt von Ihren Live-Grenzen), höchstens 500 gespeicherte
Testrechnungen oder 100 MB, 200 Testrechnungen und 200 Zustellungen in 24 Stunden, 20 E-Mails in 24 Stunden
(409 sandbox.limit, 503 sandbox.busy).
Was ein Testschlüssel nicht kann
API-Schlüssel, Webhooks, Verkäuferänderungen und Verbrauch brauchen einen Live-Schlüssel oder das Portal: ein
Testschlüssel erhält 403 sandbox.live-only. Testschlüssel haben nur die Berechtigung invoices.
Der Testhinweis zählt bei nationalen Grenzen für Hinweise mit (CIUS-RO); ein Entwurf, der schon an der Grenze ist, wird nur in der Sandbox abgelehnt.