XRechnung-API: per REST prüfen und erstellen
Ein POST mit der Datei liefert Ergebnis und jeden Regelverstoß als JSON. Ein POST mit Rechnungs-JSON liefert eine bereits geprüfte XRechnung 3.0.
curl -H "Authorization: Bearer $FINEKOT_KEY" -F file=@invoice.xml https://api.finekot.com/v1/e-invoice
{
"valid": false,
"verdict": "technically_invalid",
"profile": {"name": "XRechnung 3.0"},
"errors": 3, "warnings": 1,
"issues": [
{"rule": "BR-DE-15", "severity": "error",
"message": "Das Element \"Buyer reference\" (BT-10) muss übermittelt werden.",
"location": "/ubl:Invoice[1]"},
…
],
"cost": 0.02, "balance": 0.98
}Kein Abo, kein Vertrag.
Erstellung aus JSON €0,04 · PDF → XRechnung €0,10
Ein Abo berechnet denselben Monatstarif für 10 oder 1.000 Rechnungen. Hier laden Sie einen beliebigen Betrag auf und zahlen pro Aufruf; Restguthaben bleibt.
10 kostenlose Prüfungen am Tag · €1 gratis mit Schlüssel · danach €0,02 pro Prüfung
XRechnung aus JSON erstellen und das Ergebnis prüfen
op=create berechnet Positionssummen und USt je Satz neu, schreibt UBL oder CII und prüft die Datei vor der Rückgabe. Zwei Einheiten: €0,04.
# invoice.json: {"op": "create", "profile": "xrechnung", "syntax": "ubl", "invoice": {…}}
curl -s https://api.finekot.com/v1/e-invoice \
-H "Authorization: Bearer $FINEKOT_KEY" \
-H "Content-Type: application/json" -d @invoice.json \
| jq '{format, valid: .validation.valid, errors: .validation.errors, result}'
# {"format": "XRechnung 3.0 UBL", "valid": true, "errors": 0,
# "result": "https://api.finekot.com/f/…/RE-2026-0042-xrechnung-ubl.xml?e=…&s=…"}
curl -s -o RE-2026-0042.xml "$RESULT_URL" # the link is signed and lives 24 hoursE-Rechnung prüfen
Offizielle Regeln EN 16931 und XRechnung. Fehler mit Regel-ID, Meldung und Fundstelle.
10 kostenlose Prüfungen am Tag · €1 gratis mit Schlüssel · danach €0,02 pro Prüfung
Verarbeitung auf Servern in Deutschland (Hetzner, Falkenstein). Die hochgeladene Datei wird im Arbeitsspeicher geprüft und nicht gespeichert.
Hier erscheinen Ergebnis, Profil, Summen und jeder Regelverstoß.
Was die API macht
Geprüft wird mit den offiziellen Regelwerken: EN 16931 1.3.17 von CEN / ConnectingEurope und KoSIT-XRechnung-Schematron 2.6.0 (XRechnung 3.0.2), kompiliert mit SaxonC-HE. Auf Ihrer Seite ist nichts zu installieren: kein Java, keine Schematron-Toolchain.
Die Erstellung nimmt Rechnungs-JSON: Verkäufer, Käufer, Positionen mit Menge, Preis und Steuersatz, Zahlung. Ergebnis ist XRechnung 3.0 in UBL oder CII oder mit output=pdf ein Factur-X / ZUGFeRD-PDF.
Beide Operationen laufen über einen Endpunkt, POST /v1/e-invoice, mit Bearer-Schlüssel. Die Antwort trägt die Header X-Cost und X-Balance; ein fehlgeschlagener Aufruf wird nicht berechnet.
Preis in einfachen Zahlen
Vorausbezahltes Guthaben, kein Abo. Berechnet wird nur eine erfolgreiche Antwort; Fehler sind kostenlos.
Ein neuer Schlüssel enthält €1 Startguthaben: 50 Prüfungen.
Guthaben verfällt nicht. Kein Abo.
Apple Pay, Google Pay oder Karte auf der Zahlungsseite der monobank. Ohne Schlüssel wird einer für Sie erstellt.
In diesem Browser ist noch kein Schlüssel.
Für Entwickler
Dieselben Prüfungen per REST und MCP. Ein Header, JSON zurück.
curl https://api.finekot.com/v1/e-invoice \
-H "Authorization: Bearer fk_live_…" \
-F file=@invoice.xml
# → {"valid":false,"errors":2,"issues":[{"rule":"BR-DE-15",…}]}
# X-Cost: 0.02curl https://api.finekot.com/v1/e-invoice \
-H "Authorization: Bearer fk_live_…" \
-H "Content-Type: application/json" \
-d '{"op":"create","output":"pdf","invoice":{…}}'
# → Factur-X PDF url + validation report · X-Cost: 0.04claude mcp add --transport http finekot https://api.finekot.com/mcp --header "Authorization: Bearer fk_live_…"
Vollständige Referenz: /llms.txt · /openapi.json · /.well-known/mcp.json