Finekot API
EN 16931 · XRechnung 3.0 · ZUGFeRD / Factur-X

E-Rechnung aus Ihren Daten erstellen

€0,04 Erstellung aus JSON · Kein Abo, kein Vertrag.

ERP- oder Shopfelder auf ein JSON-Objekt abbilden. Die API liefert eine XRechnung 3.0, neu berechnet und mit den KoSIT-Regeln geprüft.

Anfrage
curl -H "Authorization: Bearer $FINEKOT_KEY" -H "Content-Type: application/json" -d @invoice.json https://api.finekot.com/v1/e-invoice
Antwort (gekürzt)
{
  "format": "XRechnung 3.0 UBL",
  "result": "https://api.finekot.com/f/…/RE-2026-0042-xrechnung-ubl.xml",
  "totals": {"line_total": "1022.90", "tax_total": "191.36", "payable": "1214.26"},
  "validation": {"valid": true, "errors": 0, "warnings": 0},
  "units": 2, "cost": 0.04
}
Preis pro Aufruf€0,04Erstellung aus JSON

Kein Abo, kein Vertrag.

Pro prüfung €0,02 · 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 CII aus Python erstellen

XRechnung verlangt Käuferreferenz, Verkäuferkontakt mit Telefon und E-Mail sowie eine elektronische Adresse des Käufers. Fehlen sie, kommen sie als BR-DE-Fehler in der Prüfung zurück, nicht als stilles Bestehen.

Python · requests
import os, requests

invoice = {
    "number": "RE-2026-0042", "issue_date": "2026-11-03", "currency": "EUR",
    "buyer_reference": "04011000-12345-34",          # Leitweg-ID or agreed reference
    "delivery_date": "2026-11-01",
    "seller": {"name": "Muster Software GmbH", "vat_id": "DE123456789",
               "address": {"street": "Hauptstr. 1", "city": "Berlin", "postcode": "10115", "country": "DE"},
               "contact": {"name": "Billing", "phone": "+49 30 1234567", "email": "billing@muster.example"}},
    "buyer": {"name": "Beispiel AG",
              "address": {"street": "Rathausplatz 2", "city": "Köln", "postcode": "50667", "country": "DE"},
              "electronic_address": {"scheme": "EM", "id": "invoices@beispiel.example"}},
    "payment": {"means_code": "58", "iban": "DE02120300000000202051"},
    "lines": [{"name": "Support, November", "quantity": 10, "unit": "HUR", "price": 95, "vat_rate": 19}],
}
r = requests.post("https://api.finekot.com/v1/e-invoice",
                  headers={"Authorization": f"Bearer {os.environ['FINEKOT_KEY']}"},
                  json={"op": "create", "profile": "xrechnung", "syntax": "cii", "invoice": invoice},
                  timeout=60)
out = r.json()
print(out["format"], out["totals"]["payable"], out["validation"]["valid"])
open("RE-2026-0042.xml", "wb").write(requests.get(out["result"], timeout=60).content)

E-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.

Ergebnis

Hier erscheinen Ergebnis, Profil, Summen und jeder Regelverstoß.

Von ERP-Feldern zur XRechnung

Das JSON folgt dem Datenmodell der EN 16931 mit einfachen Namen: number, issue_date, seller, buyer, payment, lines. Einheiten nach UN/ECE (C62, HUR, DAY); USt-Kategorie standardmäßig S.

Der Server berechnet Positionsnetto, USt je Satz und Zahlbetrag, schreibt UBL oder CII mit der Spezifikationskennung XRechnung 3.0 und prüft das Ergebnis mit EN 16931 1.3.17 und KoSIT-Schematron 2.6.0.

Preis: €0,04 pro Rechnung aus vorausbezahltem Guthaben. Guthaben verfällt nicht; es gibt keinen Monatsmindestbetrag.

Preis in einfachen Zahlen

Vorausbezahltes Guthaben, kein Abo. Berechnet wird nur eine erfolgreiche Antwort; Fehler sind kostenlos.

Eine Prüfungpro Dokument€0,02
Eine E-Rechnung aus JSONXML oder Factur-X-PDF€0,04
PDF-Rechnung → XRechnung / ZUGFeRDlesen €0,06 + erzeugen €0,04€0,10

Ein neuer Schlüssel enthält €1 Startguthaben: 50 Prüfungen.

Paket€5 250 Prüfungen oder 50 PDF-Umwandlungen
Paket€20 1 000 Prüfungen oder 200 PDF-Umwandlungen

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.

Ihr Schlüssel und Guthaben—

In diesem Browser ist noch kein Schlüssel.

Für Entwickler

Dieselben Prüfungen per REST und MCP. Ein Header, JSON zurück.

validate
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.02
create
curl 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.04
MCP
claude mcp add --transport http finekot https://api.finekot.com/mcp --header "Authorization: Bearer fk_live_…"

API-Anleitungen