Öffnen Sie den JSON-Playground, oder nutzen Sie einen der ausführbaren Schnellstarts unten. Der öffentliche Playground braucht keinen API-Schlüssel. Ihr JSON wird nur an Ironfang Finance gesendet, wenn Sie die Erzeugung ausdrücklich starten.
1. Ein synthetisches Beispiel wählen
Speichern Sie Ihr Beispiel als input.json. Die unterstützten Felder finden Sie im versionierten JSON Schema. Beträge und Mengen sind Dezimalzahlen als Zeichenketten, Datumsangaben verwenden YYYY-MM-DD, und unbekannte oder doppelte Felder werden abgelehnt. Rechnungstext wird als Text behandelt. Der Generator meldet widersprüchliche übergebene Summen; er repariert Rechnungen nicht stillschweigend.
2. Einen Schnellstart ausführen
Laden Sie ein Skript in Ihr Projekt herunter und führen Sie es mit einem Eingabe- und einem Ausgabedateinamen aus. Jedes Skript sendet die Eingabe an den Endpunkt für die Erzeugung in der Produktion, verlangt eine erfolgreiche Validierung durch alle fünf Prüfschritte, prüft Hash und Länge des zurückgegebenen XML gegen das Validierungsergebnis und schreibt erst dann die XML-Datei.
| Laufzeit | Download | Befehl |
|---|---|---|
| curl + Python 3 | generate.sh | bash generate.sh input.json invoice.xml |
| Node.js 22.18+ | generate.ts | node generate.ts input.json invoice.xml |
| Python 3 | generate.py | python3 generate.py input.json invoice.xml |
| Go | generate.go | go run generate.go input.json invoice.xml |
Die Standardanfrage wählt ruleset=latest und profile=peppol-bis-billing-3. Das Ergebnis hält das genau aufgelöste Regelwerk und das Validator-Image fest. Für reproduzierbare Integrationen verwenden Sie ein exaktes Regelwerk aus der Live-Registry und den OpenAPI-Vertrag.
3. Ergebnisse speichern und abrufen
Für gespeicherte Ergebnisse setzen Sie IRONFANG_API_KEY in Ihrer Shell-Umgebung auf einen Schlüssel mit finance:einvoices:write und einem aktiven, bezahlten Abonnement von Ironfang Finance. Kostenlose Konten können innerhalb ihres Kontingents validieren; die Erzeugung mit Anmeldung erfordert Build, Pro oder Platform. Siehe die Tarife und Kontingente. Halten Sie Ihren Schlüssel aus Quelldateien und Browsercode heraus. Setzen Sie FINANCEWOLF_IDEMPOTENCY_KEY für eine logische Erzeugung auf einen eindeutigen Wert, und verwenden Sie ihn nur wieder, wenn Sie dieselbe Eingabe mit denselben Optionen wiederholen. Die Skripte wiederholen nicht automatisch. Eine unterbrochene Anfrage kann abgeschlossen worden sein; wiederholen Sie sie mit demselben Wert, um ihr ursprüngliches Ergebnis ohne weiteren Vorgang abzurufen.
Die anonyme Erzeugung ist flüchtig. Ergebnisse mit Anmeldung und erzeugtes XML werden 30 Tage aufbewahrt und können früher gelöscht werden. Das ursprüngliche JSON wird nicht aufbewahrt. Der Playground im Portal (auf Englisch) bietet gespeicherte Ergebnisse und lesbare PDF-Downloads. Das Lesen oder Rendern eines gespeicherten Ergebnisses erfordert finance:einvoices:read. Abgelaufene oder gelöschte Ergebnisse liefern 410; heruntergeladene Kopien bleiben unter Ihrer Kontrolle.
Fehler und Limits verstehen
JSON ist auf 5 MiB begrenzt. Feldfehler benennen nicht unterstützte oder fehlerhafte Eingaben. Eine Störung des Generators oder des Validierungsdienstes begründet kein Ergebnis für die Rechnung und gibt kein erzeugtes XML frei. Beachten Sie Retry-After bei HTTP 429. Verwenden Sie FINANCEWOLF_API_BASE nur, um eine ausdrücklich vertrauenswürdige Entwicklungs- oder Staging-API anzusprechen; die Skripte senden jeden konfigurierten Schlüssel an diese Adresse.
Die Erzeugung gibt genau die Bytes als XML zurück, die durch PHIVE gelaufen sind. Ein lesbares PDF stellt diese Werte dar; es ersetzt das XML nicht. Die Validierung versendet keine Rechnungen, registriert keine Teilnehmer, macht Ironfang nicht zu einem Peppol Access Point, bescheinigt keine rechtliche oder steuerliche Konformität und garantiert nicht die Annahme durch den Empfänger. Siehe die Validierungspipeline und ihre Grenzen.