ZUGFeRD und XRechnung über eine API

Ein Aufruf. Geprüfte Dokumente zurück.

curl -X POST https://invoiceapi.io/v1/templates/$TEMPLATE_ID/invoices \
  -H "Authorization: Bearer $INVOICEAPI_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d @rechnung.json

{
  "seller": {
    "name": "Muster Software GmbH",
    "vatId": "DE123456789",
    "electronicAddress": "[email protected]",
    "address": {
      "line1": "Beispielstraße 12",
      "city": "Berlin",
      "postCode": "10115",
      "countryCode": "DE"
    },
    "contact": {
      "name": "Max Muster",
      "phone": "+49 30 1234567",
      "email": "[email protected]"
    }
  },
  "buyer": {
    "name": "Kunde AG",
    "vatId": "DE987654321",
    "electronicAddress": "[email protected]",
    "address": {
      "line1": "Kundenweg 1",
      "city": "München",
      "postCode": "80331",
      "countryCode": "DE"
    }
  },
  "invoice": {
    "number": "R-2026-1001",
    "issueDate": "2026-07-01",
    "dueDate": "2026-07-31",
    "currency": "EUR",
    "buyerReference": "KND-2026-77"
  },
  "items": [
    {
      "name": "Beratung",
      "quantity": "8",
      "unit": "HUR",
      "unitPrice": "120.00",
      "vatRate": "19"
    }
  ],
  "payment": {
    "iban": "DE75512108001245126199",
    "bic": "SOGEDEFF",
    "accountName": "Muster Software GmbH",
    "reference": "R-2026-1001"
  }
}

Rechnungsprofil und Vorlage legen Sie einmalig im Dashboard an. Danach ist jede Rechnung ein Aufruf. Der Testmodus ist derselbe Weg mit einem sk_test_-Schlüssel.

Schlägt die Prüfung fehl, kommt die Regel-ID zurück — für die 81 katalogisierten Regeln auf Deutsch und Englisch, mit BT-Code und Pfad soweit hinterlegt; für alle anderen der unübersetzte KoSIT-Text. Es wird nichts ausgeliefert und nichts abgelegt.

Ein Datensatz, zwei Formate

Woran Sie das nachprüfen können

Formate

ZUGFeRD als PDF/A-3U (Mustang), XRechnung 3.0.2 als XML. Rechnungswährung ist EUR.

Prüfung

KoSIT-Validator 1.6.2, Szenario v2026-01-31, dazu veraPDF für die PDF/A-3U-Konformität. Die Prüfung ist ein hartes Tor: fällt sie durch, entsteht keine Datei.

Standort

Hetzner, Falkenstein (fsn1). Region und Endpunkt des Objektspeichers werden beim Start geprüft; außerhalb der EU startet die Anwendung nicht.

Aufbewahrung

§ 147 Abs. 4 AO: gerechnet ab Ende des Kalenderjahres, wahlweise 8 oder 10 Jahre. Ein Legal Hold setzt die Löschung aus.

Hash-Kette

Je Organisation eine fortlaufende SHA-256-Kette über Eingabedaten und Ausgabedateien. Eine nachträgliche Änderung fällt beim Nachrechnen auf. GoBD-orientiert.

Fehlermeldungen

Die 81 katalogisierten KoSIT-Regeln kommen als Klartext auf Deutsch und Englisch zurück, mit EN-16931-BT-Code und Pfad in Ihrem Datensatz, soweit hinterlegt. Nicht katalogisierte Regeln liefern stattdessen den unübersetzten KoSIT-Rohtext.

Export

Ein ZIP mit Originaldateien, CSV und einem Ketten-Nachweis, den eine Prüferin ohne uns nachrechnen kann.

Preise

Der Testmodus zählt nicht gegen das Dokumentkontingent. Testrechnungen tragen ein TESTRECHNUNG-Wasserzeichen.

Alle Beträge netto, zuzüglich Umsatzsteuer.