Kommandozeilen-Anwendung hph JTL ZUGFeRD

Startseite » Kommandozeilen-Anwendung hph JTL ZUGFeRD

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.
  • 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.

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:

ParameterBeschreibungErforderlichBeispiel
/actionGibt die auszuführende Aktion an.Ja/action validate|combine|createwithvalidation
/inputfileGibt den Pfad zur validierenden PDF oder XML an.Bei Aktion /validate/inputfile "C:\hph.ZUGFeRD\facture-x.xml
/inputpdfGibt den Pfad zum Rechnungspdf ohne Zugferd im PDF/A-3b-Datei an.Bei Aktion combine | createwithvalidation/inputpdf „C:\hph.ZUGFeRD\RechnungimPDFA3b_Format.pdf“
/outputfileGibt 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
/jtlinvoicenoRechnungsnummer 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:

  1. Automatisierte Validierung:
    • Erfolgreiche Validierungen führen dazu, dass nur korrekte ZUGFeRD-Rechnungen an den Kunden gesendet werden.
  2. 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.

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!