Mit dem Kommandozeilentool hph.JTL.ZUGFeRD.Console können Sie einfach und effizient ZUGFeRD-konforme Rechnungen erstellen. Das Tool bietet flexible Einsatzmöglichkeiten.
Tipp: Erstellen Sie zuerst ZUGFeRD / X-Rechnungen einfach mit der Gui-Anwendung bevor Sie sich dem Thema der Automatisierung mit der Befehlszeilenanwendung und JTL-Workflows widmen.
Funktionen im Überblick
- ZUGFeRD PDF/XML validieren
- Nutzen Sie die Kommandozeile unabhängig von JTL-Wawi, um:
- ZUGFeRD-PDF-Dateien oder XML-Daten zu validieren.
- PDF und XML-Dokumente zu kombinieren und in einem standardisierten Format bereitzustellen.
- Nutzen Sie die Kommandozeile unabhängig von JTL-Wawi, um:
- XRECHNUNG
- Erstellung von X-Rechnungen für B2G / B2B – Kunden
- Einbettung des Rechnungspdfs als Sichtbeleg/Anlage
- Integration in JTL-Wawi Workflows
- hph JTL ZugFerd Console ermöglicht Ihnen über die JTL-Workflows:
- Die Generierung der
factur-x.xml
/ X-Rechnungs.xml - Die Validierung der XML-Daten gegen das entsprechende Schema.
- Das Einbetten der validierten XML-Daten in das bestehende Rechnungspdf im PDF/A-3b-Format.
- Versand an die Kunden-Rechnungsemailadresse aus JTL.
- Schreiben einer Info in die Kundenhistorie um die Transparenz in JTL zu gewähren.
- Die Generierung der
- hph JTL ZugFerd Console ermöglicht Ihnen über die JTL-Workflows:
Jetzt einfach ZUGFeRD / X-Rechnungen automatisiert versenden, ohne XML-Vorlagen und einem Update der JTL-Warenwirtschaft.

Beschreibung der Aufrufparameter für die Konsolenanwendung
Die Anwendung erwartet mehrere Aufrufparameter, die jeweils mit einem Schalter beginnen (z. B. /action
) und durch einen Wert ergänzt werden. Nachfolgend sind die verfügbaren Parameter und ihre Bedeutungen beschrieben:
Parameter | Beschreibung | Erforderlich | Beispiel |
---|---|---|---|
/action | Gibt die auszuführende Aktion an. | Ja | /action validate|combine|create|createwithvalidation |
/format | Gibt das Format XRECHNUNG|ZUGFERD|skip an | Nein: Defaultwert: ZUGFERD | /format „XRECHNUNG“ |
/inputfile | Gibt den Pfad zur validierenden PDF oder XML an. | Bei Aktion /validate | /inputfile "C:\hph.ZUGFeRD\factur-x.xml „ |
/inputpdf | Gibt den Pfad zum Rechnungspdf ohne Zugferd im PDF/A-3b-Datei an. Bei Format XRECHNUNG wird das PDF als Anhang eingebettet. | Bei Aktion combine | createwithvalidation | create | /inputpdf „C:\hph.ZUGFeRD\RechnungimPDFA3b_Format.pdf“ |
/inputxml | Gibt den Pfad zur XML-Datei das eingebettet werden soll | Bei Aktion combine | /inputxml „C:\hph.ZUGFeRD\factur-x.xml |
/outputfile | Gibt den Pfad für die ZUGFeRD-PDF/XRechnungs.xml an. | Optional, wenn nicht angegeben wir die Datei mit .ZUGFeRD abgespeichert | /outputfile "C:\hph.ZUGFeRD\JTL-Wawi-ZUGFerd.pdf „ |
/jtlinvoiceno | Rechnungsnummer in der JTL-Wawi. SQL-ConnectionString muss in den Einstellungen gesetzt sein. Bei Rechnungskorrekturen wird ebenfalls der Parameter verwendet. | Bei Aktion createwithvalidation|create | /jtlinvoiceno „121165“ |
Allgemeine Hinweise:
- Die Reihenfolge der Parameter spielt keine Rolle.
- Wenn ein Parameter angegeben wird, aber der zugehörige Wert fehlt, wird eine Fehlermeldung ausgegeben.
- Ab Version 1.5 könnt Ihr die Anwendung auch ohne Parameter aufrufen und erhält Eingabeaufforderungen für die einzelnen Funktionen zur E-Rechnungserzeugung.
Beispielaufruf zum Erzeugen einer ZUGFeRD-Rechnung mit hph JTL ZUGFeRD Console
Aufruf Erzeugung mit Validierung, in dem Fall wird die Einstellung „ActionValidationFailed“ berücksichtigt“. Das „Inputpdf“ wird hierbei mit der ZUGFeRD-Rechnung ersetzt.
hph.JTL.ZUGFeRD.Console.exe /action "createwithvalidation" /jtlinvoiceno "121165" /inputpdf "C:\ExportWawi\Invoice 121165.pdf"
Erzeugung einer ZUGFeRD-Rechnung ohne Validierung
hph.JTL.ZUGFeRD.Console.exe /action "create" /jtlinvoiceno "121165" /inputpdf "C:\ExportWawi\Invoice 121165.pdf"
Erzeugung einer X-Rechnung mit den Rechnungsdaten aus JTL
/action create /format "XRECHNUNG" /jtlinvoiceno "122674" /outputfile "C:\ExportWawi\XRechnung-122674.xml"
JTL-Workflowintegration
Durch die Integration in den JTL-Workflow können Sie den Versand von ZUGFeRD-Rechnungen an Ihre B2B-Kunden vollständig automatisieren. Dies umfasst:
- Automatisierte Validierung:
- Erfolgreiche Validierungen führen dazu, dass nur korrekte ZUGFeRD-Rechnungen an den Kunden gesendet werden.
- Fehlerbehandlung:
- Bei negativen Validierungsergebnissen kann entschieden werden, ob:
- Der Versand/JTL-Workflow gestoppt wird.
- Alternativ die Rechnung ohne ZUGFeRD-Daten wie bisher gesendet wird.
- Hierzu können Sie die Einstellung ActionValidationFailed unter den Einstellungen setzen.
- Bei negativen Validierungsergebnissen kann entschieden werden, ob:
- E-Rechnungsformat ZUGFeRD/XRechnung/Standardpdf
- einfache Steuerung des E-Rechnungszielformat über Dotliquid und dem /format Parameter
Lesen Sie hier die Anleitung zur Integration des Kommandozeilentools in JTL-Wawi Workflows und versenden Sie die ZUGFeRD-Rechnungen automatisiert.
Jetzt downloaden: Entdecken Sie die Möglichkeiten, die Ihnen die Software bietet, und gestalten Sie Ihren Rechnungsversand effizient und standardkonform!