Überblick
PdfToEInvoice ist ein leistungsstarkes Kommandozeilenwerkzeug zur Erstellung von ZUGFeRD/Factur-X-konformen E-Rechnungen im PDF/A-3b-Format. Das Programm kombiniert Ihre bestehenden PDF-Rechnungen mit maschinenlesbaren XML-Daten – vollständig konform mit den europäischen E-Invoicing-Standards.
Warum PdfToEInvoice?
| Vorteil | Beschreibung |
|---|---|
| ✅ Schriftunabhängig | Durch Rasterung als Bild-PDF werden Schriften nicht eingebettet – keine Lizenzprobleme, keine fehlenden Fonts |
| ✅ Pixelgenaue Darstellung | Ihr Dokument sieht auf jedem Gerät und in jedem PDF-Reader exakt gleich aus |
| ✅ PDF/A-3b konform | Erfüllt alle Anforderungen für die Langzeitarchivierung |
| ✅ ZUGFeRD/Factur-X kompatibel | Vollständige Unterstützung der europäischen E-Rechnungsstandards |
| ✅ Flexible Bildqualität | Wählen Sie zwischen Farbe, Graustufen oder Schwarzweiß |
| ✅ Einstellbare Auflösung | Von 72 DPI (klein) bis 1200 DPI (druckfähig) |
| ✅ Komprimierung anpassbar | JPEG-Qualität von 10% bis 100% einstellbar |
| ✅ Keine Installation nötig | Einfach entpacken und starten |
| ✅ Keine .NET-Installation erforderlich | Alle Abhängigkeiten sind enthalten |
Systemvoraussetzungen
- Betriebssystem: Windows 10/11 (64-Bit)
- Speicher: Mindestens 100 MB freier Festplattenspeicher
- RAM: Mindestens 512 MB (empfohlen: 2 GB für große PDFs)
💡 Keine separate .NET-Installation erforderlich! Die komplette Laufzeitumgebung ist bereits im Programm enthalten.
Installation
So einfach geht's:
- ZIP-Archiv herunterladen
- In einen Ordner Ihrer Wahl entpacken, z.B.:
C:\Programme\PdfToEInvoice\C:\Tools\PdfToEInvoice\
- Fertig! Keine weitere Installation notwendig.
Inhalt des ZIP-Archivs
📁 PdfToEInvoice
├── PdfToEInvoice.exe (Hauptprogramm)
├── pdfium.dll (PDF-Rendering-Engine)
└── appsettings.json (Konfigurationsdatei)
Konfiguration
Die Datei appsettings.json enthält alle Einstellungen. Passen Sie diese einmalig an Ihre Anforderungen an:
{
"CustomerInfo": {
"Author": "Musterfirma GmbH",
"Title": "Rechnung",
"Mandant": "Musterfirma GmbH"
},
"License": {
"Key": "LIC-XXXXX-XXXXX-XXXXX",
"Holder": "Musterfirma GmbH",
"Restriction": "Lizenziert für den internen Gebrauch."
},
"Copyright": {
"Owner": "isential gmbh",
"Notice": "Alle Rechte vorbehalten."
},
"Watermark": {
"Enabled": true,
"FontSize": 7,
"Opacity": 0.4
},
"RenderingDefaults": {
"ColorMode": "Color",
"DPI": 300,
"JPEGQuality": 90
}
}
Konfigurationsoptionen im Detail
CustomerInfo (Dokumenteigenschaften) ⁽¹⁾
| Einstellung | Beschreibung | Beispiel |
|---|---|---|
Author |
Autor des PDF-Dokuments | "Musterfirma GmbH" |
Title |
Dokumenttitel | "Rechnungswesen" |
Mandant |
Mandantenname für Lizenzzuordnung | "Musterfirma GmbH" |
License (Lizenzinformationen) ⁽¹⁾
| Einstellung | Beschreibung | Beispiel |
|---|---|---|
Key |
Ihr Lizenzschlüssel | "LIC-12345-ABCDE" |
Holder |
Name des Lizenznehmers | "Musterfirma GmbH" |
Restriction |
Nutzungshinweis | "Nur für internen Gebrauch" |
Watermark (Wasserzeichen) ⁽¹⁾
| Einstellung | Beschreibung | Wertebereich |
|---|---|---|
Enabled |
Wasserzeichen aktivieren | true / false |
FontSize |
Schriftgröße in Punkten | 5 - 20 (empfohlen: 7) |
Opacity |
Transparenz | 0.0 (unsichtbar) - 1.0 (opak) |
RenderingDefaults (Bildqualität)
| Einstellung | Beschreibung | Wertebereich |
|---|---|---|
ColorMode |
Farbmodus | Color, Grayscale, Monochrome |
DPI |
Auflösung | 72 - 1200 |
JPEGQuality |
Komprimierung | 10 - 100 |
⁽¹⁾ Diese Daten dürfen unter keinen Umständen geändert werden. Jede Abweichung führt zum sofortigen Programmabbruch.
Verwendung
Grundsyntax
PdfToEInvoice.exe <Eingangs-PDF> <XML-Rechnung> <Ausgangs-PDF> [Optionen]
Parameter
| Parameter | Beschreibung | Pflicht |
|---|---|---|
<Eingangs-PDF> |
Pfad zur Original-PDF-Rechnung | ✅ Ja |
<XML-Rechnung> |
Pfad zur ZUGFeRD/Factur-X XML-Datei | ✅ Ja |
<Ausgangs-PDF> |
Pfad für die erzeugte PDF/A-3b-Datei | ✅ Ja |
[Optionen] |
Rendering-Optionen (optional) | ❌ Nein |
Optionen-Format
ColorMode:DPI:JPEGQuality
Praxisbeispiele
Beispiel 1: Standardqualität (empfohlen für E-Mail-Versand)
PdfToEInvoice.exe "Rechnung_2025_001.pdf" "Rechnung_2025_001.xml" "E-Rechnung_2025_001.pdf"
Ergebnis: Farbiges PDF mit 300 DPI und 90% JPEG-Qualität
Beispiel 2: Optimiert für Archivierung (hohe Qualität)
PdfToEInvoice.exe "Rechnung.pdf" "Rechnung.xml" "Archiv_Rechnung.pdf" Color:600:95
Einstellungen:
- 🎨 Farbmodus: Farbe
- 📐 Auflösung: 600 DPI
- 🗜️ Qualität: 95%
Ideal für: Langzeitarchivierung, Druckvorlagen
Beispiel 3: Kompakt für schnellen Versand
PdfToEInvoice.exe "Rechnung.pdf" "Rechnung.xml" "Email_Rechnung.pdf" Color:150:75
Einstellungen:
- 🎨 Farbmodus: Farbe
- 📐 Auflösung: 150 DPI
- 🗜️ Qualität: 75%
Ideal für: E-Mail-Versand, kleine Dateigrößen
Beispiel 4: Graustufen für Textdokumente
PdfToEInvoice.exe "Rechnung.pdf" "Rechnung.xml" "Grau_Rechnung.pdf" Grayscale:300:85
Einstellungen:
- 🎨 Farbmodus: Graustufen
- 📐 Auflösung: 300 DPI
- 🗜️ Qualität: 85%
Ideal für: Rechnungen ohne Farbgrafiken, Platzersparnis
Beispiel 5: Schwarzweiß für maximale Kompression
PdfToEInvoice.exe "Rechnung.pdf" "Rechnung.xml" "SW_Rechnung.pdf" Monochrome:200:80
Einstellungen:
- 🎨 Farbmodus: Schwarzweiß
- 📐 Auflösung: 200 DPI
- 🗜️ Qualität: 80%
Ideal für: Reine Textdokumente, Fax-Ersatz
Qualitätseinstellungen im Vergleich
| Verwendung | ColorMode | DPI | Quality | Dateigröße | Qualität |
|---|---|---|---|---|---|
| E-Mail (schnell) | Color | 150 | 70 | ~200 KB/Seite | ⭐⭐⭐ |
| E-Mail (Standard) | Color | 200 | 80 | ~400 KB/Seite | ⭐⭐⭐⭐ |
| Archivierung | Color | 300 | 90 | ~800 KB/Seite | ⭐⭐⭐⭐⭐ |
| Druck | Color | 600 | 95 | ~2 MB/Seite | ⭐⭐⭐⭐⭐ |
| Graustufen | Grayscale | 300 | 85 | ~300 KB/Seite | ⭐⭐⭐⭐ |
| Schwarzweiß | Monochrome | 200 | 80 | ~100 KB/Seite | ⭐⭐⭐ |
Lizenzierung
Lizenzmodell
PdfToEInvoice wird pro Mandant lizenziert. Jeder Mandant (Firma/Organisation) benötigt eine eigene Lizenz.
Lizenzschutz
Das Programm integriert umfassende Lizenzinformationen in jedes erzeugte PDF:
1. Sichtbares Wasserzeichen
Auf jeder Seite wird dezent unten rechts angezeigt:
Lizenziert für: Musterfirma GmbH | © 2025 isential gmbh. Alle Rechte vorbehalten.
2. PDF-Metadaten
Die Dokumenteigenschaften enthalten:
- Autor: Ihr Firmenname
- Betreff: Lizenzinformationen und Mandant
- Stichwörter: Maschinenlesbare Lizenzdaten
3. Maschinenlesbare Daten
Im PDF eingebettet (für automatische Prüfungen):
LicenseHolder:Musterfirma GmbH;LicenseKey:LIC-XXXXX;Mandant:Musterfirma GmbH;Copyright:isential gmbh
Vorteile der integrierten Lizenzierung
- ✅ Rückverfolgbarkeit: Jedes Dokument ist eindeutig zuordenbar
- ✅ Compliance: Nachweis der rechtmäßigen Softwarenutzung
- ✅ Audit-Sicherheit: Lizenzinformationen sind dokumentiert
- ✅ Dezent: Wasserzeichen stört nicht beim Lesen
Integration in Ihre Software
PdfToEInvoice ist als Kommandozeilenwerkzeug konzipiert und lässt sich einfach in bestehende Systeme integrieren:
C# / .NET
var startInfo = new ProcessStartInfo
{
FileName = @"C:\Programme\PdfToEInvoice\PdfToEInvoice.exe",
Arguments = $"\"{inputPdf}\" \"{xmlFile}\" \"{outputPdf}\" Color:300:90",
UseShellExecute = false,
RedirectStandardOutput = true,
RedirectStandardError = true,
CreateNoWindow = true
};
using var process = Process.Start(startInfo);
process.WaitForExit();
if (process.ExitCode == 0)
{
Console.WriteLine("E-Rechnung erfolgreich erstellt!");
}
else
{
var error = process.StandardError.ReadToEnd();
Console.WriteLine($"Fehler: {error}");
}
PowerShell
$result = & "C:\Programme\PdfToEInvoice\PdfToEInvoice.exe" `
"C:\Rechnungen\Rechnung.pdf" `
"C:\Rechnungen\Rechnung.xml" `
"C:\Rechnungen\E-Rechnung.pdf" `
"Color:300:90"
if ($LASTEXITCODE -eq 0) {
Write-Host "E-Rechnung erfolgreich erstellt!" -ForegroundColor Green
} else {
Write-Host "Fehler bei der Erstellung" -ForegroundColor Red
}
Batch-Datei
@echo off
set TOOL=C:\Programme\PdfToEInvoice\PdfToEInvoice.exe
"%TOOL%" "%1" "%2" "%3" Color:300:90
if %ERRORLEVEL% EQU 0 (
echo E-Rechnung erfolgreich erstellt!
) else (
echo Fehler bei der Erstellung!
)
Exit-Codes
| Code | Bedeutung |
|---|---|
0 |
✅ Erfolgreich ausgeführt |
1 |
❌ Fehler (Details auf stderr) |
Fehlerbehebung
Häufige Fehler und Lösungen
| Fehlermeldung | Ursache | Lösung |
|---|---|---|
Eingangs-PDF nicht gefunden |
Dateipfad falsch | Pfad prüfen, ggf. in Anführungszeichen setzen |
XML-Rechnung nicht gefunden |
XML-Datei fehlt | XML-Datei erstellen oder Pfad korrigieren |
Konfiguration konnte nicht geladen werden |
appsettings.json fehlt oder fehlerhaft | JSON-Syntax prüfen |
PDF konnte nicht geladen werden |
PDF beschädigt oder geschützt | PDF ohne Passwortschutz verwenden |
Tipps
- 🔍 Verwenden Sie absolute Pfade für zuverlässige Ergebnisse
- 📁 Stellen Sie sicher, dass das Ausgabeverzeichnis existiert
- 🔐 Bei passwortgeschützten PDFs: Schutz vorher entfernen
- 💾 Prüfen Sie, ob genügend Speicherplatz vorhanden ist
Technische Details
Unterstützte Standards
- PDF/A-3b: ISO 19005-3 für Langzeitarchivierung
- ZUGFeRD 2.x: Deutscher E-Rechnungsstandard
- Factur-X: Französisch-deutscher E-Rechnungsstandard
- EN 16931: Europäische Norm für elektronische Rechnungen
- Farbprofil: sRGB IEC61966-2.1 (eingebettet)
Support & Kontakt
isential gmbh
Bei Fragen zur Lizenzierung oder technischem Support wenden Sie sich bitte an Ihren Ansprechpartner bei isential.
© 2025-2026 isential gmbh. Alle Rechte vorbehalten.
PdfToEInvoice ist ein Produkt der isential gmbh. ZUGFeRD ist ein eingetragenes Warenzeichen des Forums elektronische Rechnung Deutschland (FeRD). Factur-X ist ein gemeinsamer Standard von Deutschland und Frankreich.
