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 eine ZUGFeRD Rechnung einfach mit der Gui-Anwendung bevor Sie sich dem Thema der Automatisierung 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:
- Integration in JTL-Wawi Workflows
- hph JTL ZugFerd Console ermöglicht Ihnen über die JTL-Workflows:
- Die Generierung der
facture-x.xml
– ZUGFeRD Version 2.3 Extended. - 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-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|createwithvalidation |
/inputfile | Gibt den Pfad zur validierenden PDF oder XML an. | Bei Aktion /validate | /inputfile "C:\hph.ZUGFeRD\facture-x.xml „ |
/inputpdf | Gibt den Pfad zum Rechnungspdf ohne Zugferd im PDF/A-3b-Datei an. | Bei Aktion combine | createwithvalidation | /inputpdf „C:\hph.ZUGFeRD\RechnungimPDFA3b_Format.pdf“ |
/outputfile | Gibt den Pfad für die ZUGFeRD-PDF 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 Aktion createwithvalidation | /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.
Beispielaufruf zum Erzeugen einer ZUGFeRD-Rechnung mit hph JTL ZUGFeRD Console
hph.JTL.ZUGFeRD.Console.exe /action createwithvalidation /jtlinvoiceno 121165 /inputpdf "C:\ExportWawi\Invoice 121165.pdf"
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:
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 das Tool bietet, und gestalten Sie Ihren Rechnungsversand effizient und standardkonform!