# API-Schnittstelle für XRechnung zu PDF

Quelle: https://xrechnung.pro/api-schnittstelle-fuer-xrechnung-zu-pdf-konvertierung/
Aktualisiert: 30. Juli 2026
Anbieter: XRechnung PRO (Datenschutzfabrik UG, Wuppertal)

**Kurz gesagt:** Die XRechnung-Konverter-API von XRechnung PRO wandelt XRechnungen per HTTPS-Aufruf in PDF um. Die XML-Datei wird per POST mit einem API-Schlüssel im Header übergeben, die Antwort enthält das PDF. So lässt sich die Umwandlung in bestehende ERP-, CRM- und Warenwirtschaftssysteme einbinden, die von sich aus keine XRechnungen darstellen können.

Preis: ab 49 € im Monat
Passend für: Softwarehäuser und IT-Abteilungen, die die Umwandlung in eine eigene Anwendung einbauen wollen.
Nicht passend für: Anwender ohne Entwicklungsressourcen. Dafür ist der E-Mail-Konverter der einfachere Weg.

## Auf einen Blick

- **Endpunkt:** POST https://app.xrechnung2pdf.de/api/xrechnung/convert
- **Authentifizierung:** API-Schlüssel im Header x-api-key
- **Übergabe:** multipart/form-data, Feld xrechnung_file
- **Antwort:** JSON mit Statusfeld und dem PDF als Binärdaten
- **Übertragung:** ausschließlich über HTTPS
- **Preise:** 49 € (50 Aufrufe/Tag) · 99 € (100/Tag) · 199 € (250/Tag), je im Monat zzgl. USt

## Für Entwickler: der Aufruf

Ein einziger Endpunkt, ein Schlüssel im Header, die Datei als Formularfeld.

```bash
curl --location 'https://app.xrechnung2pdf.de/api/xrechnung/convert' \
  --header 'x-api-key: IHR_SCHLUESSEL' \
  --form 'xrechnung_file=@rechnung.xml'
```

**Erfolgreiche Antwort (200)**

```json
{
  "status": "success",
  "message": "XRechnung erfolgreich in PDF konvertiert.",
  "pdf_file": "<pdf_binary_data>"
}
```

**Ungültige Datei (400)**

```json
{
  "status": "error",
  "message": "Ungültiges Format der XRechnung. Bitte überprüfen Sie das XML-Dokument."
}
```

**Ungültiger Schlüssel (403)**

```json
{
  "status": "error",
  "message": "Ungültiges API-Token. Zugriff verweigert."
}
```

## Parameter

| Ort | Name | Typ | Bedeutung |
| --- | --- | --- | --- |
| Header | `x-api-key` | String | Ihr API-Schlüssel |
| Formularfeld | `xrechnung_file` | Datei | die XRechnung im XML-Format |

## Was Sie beim Einbau beachten sollten

**Behandeln Sie 400 als Datenfehler, nicht als Ausfall.** Ein Status 400 bedeutet, dass die übergebene Datei nicht der erwarteten Struktur entspricht — ein erneuter Versuch mit derselben Datei führt zum gleichen Ergebnis. Legen Sie solche Fälle in eine Fehlerliste zur manuellen Prüfung, statt sie in einer Warteschlange zu wiederholen.

**Bewahren Sie das XML auf, nicht nur das PDF.** Aufbewahrungspflichtig ist nach § 14b UStG die strukturierte Datei. Wenn Ihre Anwendung nur das erzeugte PDF ablegt, entsteht eine Aufbewahrungslücke — das ist der häufigste Fehler beim Einbau in ein Dokumentenmanagement.

**Rechnen Sie mit dem Tageslimit.** Der Zähler läuft pro Tag. Wenn Ihr Rechnungseingang gebündelt am Monatsanfang kommt, wählen Sie die Stufe nach dem Spitzentag, nicht nach dem Durchschnitt — oder sprechen Sie mit uns über eine passende Regelung.

## Wenn Ihr System keine API kann

Das ist häufiger als man denkt, gerade bei älteren Warenwirtschaften. Zwei Wege ohne Programmierung:

- **[E-Mail-Konverter](/e-mail-konverter-fuer-xrechnung-zu-pdf/)** — Ihre Software oder Ihr Mailprogramm leitet die Rechnung an eine Adresse weiter, das PDF kommt zurück.
- **[HotFolder](/xrechnung-konverter-tool/)** — ein überwachter Ordner auf einem Windows-Rechner, alles darin wird automatisch umgewandelt.

## Wenn Sie XRechnungen erzeugen müssen

Diese API wandelt XRechnungen in PDF. Der umgekehrte Weg — aus Ihren Rechnungsdaten eine normgerechte XRechnung erzeugen — ist eine [individuelle Anbindung](/individuelle-softwareentwicklung/) an Ihr System. Nennen Sie uns Ihr System und ob es eine Datenbank oder eine Exportfunktion hat, dann sagen wir Ihnen, wie aufwendig das ist.

## Häufige Fragen

### Wie bekomme ich einen API-Schlüssel?

Über das Kontaktformular. Nennen Sie die erwartete Zahl der Aufrufe pro Tag und das System, aus dem Sie aufrufen wollen. Sie erhalten einen Schlüssel für einen Test und danach das passende Angebot.

### Was passiert, wenn ich das Tageslimit überschreite?

Weitere Aufrufe werden abgelehnt, bis der Zähler am Folgetag zurückgesetzt wird. Wenn Ihr Volumen schwankt oder saisonal Spitzen hat, sagen Sie uns das — dafür lässt sich eine Regelung treffen, die Ihnen nicht mitten im Monatsabschluss den Betrieb blockiert.

### Werden die übergebenen Rechnungen gespeichert?

Nein. Die Datei wird für die Umwandlung verarbeitet und nicht dauerhaft gespeichert. Übertragen wird ausschließlich verschlüsselt über HTTPS.

### Kann die API auch XRechnungen erzeugen?

Die hier beschriebene Schnittstelle wandelt nur in eine Richtung: XRechnung zu PDF. Wenn Sie aus Ihrem System heraus XRechnungen erzeugen wollen, ist das eine individuelle Anbindung — sprechen Sie uns an, das ist eine häufige Anforderung.

### Was, wenn mein System keine API-Aufrufe kann?

Dann nutzen Sie den E-Mail-Konverter — die Datei wird an eine Adresse gesendet und das PDF kommt zurück. Fast jedes System kann E-Mails versenden. Alternativ überwacht die HotFolder-Fassung des Windows-Programms einen Ordner.

### Gibt es eine Testumgebung?

Sie erhalten für den Test einen Schlüssel mit begrenztem Volumen auf demselben Endpunkt. Eine getrennte Sandbox gibt es nicht — die Umwandlung verändert nichts, deshalb ist ein Test gegen die echte Schnittstelle unkritisch.

---

Bei Zitaten bitte Quelle nennen: XRechnung PRO, https://xrechnung.pro/api-schnittstelle-fuer-xrechnung-zu-pdf-konvertierung/
Angaben zur Rechtslage sind keine steuerliche oder rechtliche Beratung.