E-Rechnung API: XRechnung, ZUGFeRD und Peppol BIS per REST erzeugen, prüfen, lesen

Was muss eine E-Rechnung-API können?

Vier Dinge, die eine PDF-Vorlage nicht kann. Erstens die Formate: XRechnung für deutsche Behörden und viele Unternehmen, ZUGFeRD / Factur-X für den Rechnungsempfänger, der weiter ein PDF sehen will, Peppol BIS für das Peppol-Netz (in Belgien seit 2026 Pflicht zwischen Unternehmen). Zweitens die Prüfung vor dem Versand: Eine Datei, die BR-DE-15 oder PEPPOL-EN16931-R010 verletzt, wird vom Portal oder vom Zugangspunkt abgewiesen. Drittens den Empfang: eine erhaltene E-Rechnung lesen, prüfen und in die eigene Buchhaltung übernehmen. Viertens die Ehrlichkeit über Grenzen: welche Felder geschrieben werden, welche nicht, und was die API nicht tut (versenden, archivieren).

Die drei Aufrufe

Ein Beispiel: XRechnung erzeugen

Die Rechnungsdaten folgen den Geschäftsbegriffen der EN 16931; Summen und Steueraufschlüsselung rechnet die API aus den Positionen. Mit Idempotency-Key liefert eine Wiederholung dieselbe Datei, ohne zweite Berechnung.

{
  "format": "xrechnung-ubl",
  "number": "2026-017",
  "issueDate": "2026-10-20",
  "paymentTermsDays": 14,
  "buyerReference": "EK-2026-0345",
  "deliveryDate": "2026-10-15",
  "seller": {
    "name": "Lena Hartmann — Webdesign",
    "address": {
      "street": "Lindenstraße 14",
      "postalCode": "10969",
      "city": "Berlin",
      "countryCode": "DE"
    },
    "vatId": "DE136695976",
    "contact": {
      "name": "Lena Hartmann",
      "phone": "+49 30 1234567",
      "email": "rechnung@hartmann-webdesign.example"
    }
  },
  "buyer": {
    "name": "Mustermann Maschinenbau GmbH",
    "address": {
      "street": "Industrieweg 7",
      "postalCode": "70565",
      "city": "Stuttgart",
      "countryCode": "DE"
    },
    "contact": {
      "email": "buchhaltung@mustermann.example"
    }
  },
  "payment": {
    "iban": "DE02120300000000202051"
  },
  "lines": [
    {
      "name": "Relaunch Website, Konzeption und Umsetzung",
      "quantity": 24,
      "unitCode": "HUR",
      "unitPrice": 95,
      "vat": {
        "category": "S",
        "rate": 19
      }
    },
    {
      "name": "Lizenz Bildmaterial",
      "quantity": 1,
      "unitCode": "C62",
      "unitPrice": 128.4,
      "vat": {
        "category": "S",
        "rate": 19
      }
    }
  ]
}

curl -X POST "https://veriport.io/api/v1/einvoice/create" \
  -H "Authorization: Bearer vp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 2026-017" \
  -D headers.txt -o xrechnung.xml \
  -d @invoice.json

Was die API nicht tut

• Kein Versand: die API erzeugt und prüft Dateien, sie übermittelt nichts (kein Peppol-Zugangspunkt, keine E-Mail an den Empfänger).
• Keine Speicherung: Eingabe und Datei existieren nur während der Anfrage; die GoBD-konforme Archivierung bleibt beim Rechnungssteller.
• Keine Steuerberatung: die Datei enthält die Angaben, die Sie senden; welche Steuerkategorie gilt, entscheidet der Rechnungssteller.
• Version 1 schreibt: Euro, Verkäufer in Deutschland, Käufer in einem EU-Mitgliedstaat, Kategorien S, Z, E, AE und K, Rechnung 380, Gutschrift 381, Rechnungskorrektur 384, Überweisung, bis 500 Positionen, Nachlässe und Zuschläge auf Belegebene. Anhänge, Anzahlungen, Positionszeiträume, Artikelnummern und Lastschrift werden mit einvoice_unsupported abgelehnt, nie stillschweigend weggelassen.

Was kostet eine E-Rechnung per API?

20 Aufrufe je erzeugter Rechnung: mit dem 10.000er-Paket ($29) sind das 500 Rechnungen, also knapp 6 Cent je Rechnung; mit dem 2.000er-Paket ($9) 100 Rechnungen zu 9 Cent. Anbieter, die auch versenden (Peppol-Zugangspunkte), nehmen 18 bis 30 Cent je Dokument inklusive Übermittlung; der Vergleich steht datiert auf der Produktseite. 100 kostenlose Aufrufe im Monat sind fünf Rechnungen oder zwanzig Prüfungen.