Für Entwickler

REST-API

Erzeugen und validieren Sie E-Rechnungen direkt aus Ihrem System. API-Zugang ist im Business-Plan (29 €/Monat) enthalten — Schlüssel erstellen Sie unter Mein Konto.

Authentifizierung

Authorization: Bearer er_<ihr-schlüssel>

POST /api/v1/generate

JSON-Rechnungsdaten rein, fertige XRechnung 3.0 (UBL-XML) raus.

curl -X POST https://klarrechnung.com/api/v1/generate \
  -H "Authorization: Bearer er_..." \
  -H "Content-Type: application/json" \
  -d '{...{"}"}' > rechnung.xml

Beispiel-Body:

{
  "number": "2026-001",
  "issueDate": "2026-07-15",
  "dueDate": "2026-07-29",
  "buyerReference": "BESTELL-4711",
  "kleinunternehmer": false,
  "seller": {
    "name": "Muster GmbH", "street": "Beispielweg 1", "zip": "10115", "city": "Berlin",
    "countryCode": "DE", "vatId": "DE123456789",
    "email": "rechnung@muster.de", "phone": "+49 30 1234567", "contactName": "A. Muster"
  },
  "buyer": {
    "name": "Kunde AG", "street": "Kundenstr. 2", "zip": "80331", "city": "München", "countryCode": "DE"
  },
  "payment": { "iban": "DE89370400440532013000", "bic": "COBADEFFXXX", "terms": "Zahlbar in 14 Tagen." },
  "lines": [
    { "name": "Beratung Juli", "quantity": 8, "unitCode": "HUR", "unitPrice": 120, "vatRate": 19 }
  ]
}

POST /api/v1/validate

XRechnung-XML oder ZUGFeRD-PDF als Body (oder multipart-Feld file) — zurück kommt ein JSON-Report mit Fehlern, Hinweisen und den geparsten Rechnungsdaten.

curl -X POST https://klarrechnung.com/api/v1/validate \
  -H "Authorization: Bearer er_..." \
  -H "Content-Type: application/xml" \
  --data-binary @rechnung.xml
{
  "valid": true,
  "findings": [],
  "official": false,
  "invoice": { "number": "2026-001", "payable": 1142.4, ... }
}

MCP-Server (Claude, Cursor & Co.)

Derselbe Funktionsumfang als Model-Context-Protocol-Server: Ihr KI-Assistent erstellt und prüft E-Rechnungen direkt im Chat. Transport: Streamable HTTP, Auth per Bearer-API-Schlüssel.

# Claude Code
claude mcp add klarrechnung --transport http https://klarrechnung.com/api/mcp \
  --header "Authorization: Bearer er_..."

# Werkzeuge: generate_xrechnung, validate_invoice

Limits