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

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:

ParameterBeschreibungErforderlichBeispiel
/actionGibt die auszuführende Aktion an.Ja/action validate|combine|create|createwithvalidation
/formatGibt das Format XRECHNUNG|ZUGFERD|skip anNein: Defaultwert: ZUGFERD/format „XRECHNUNG“
/inputfileGibt den Pfad zur validierenden PDF oder XML an.Bei Aktion /validate/inputfile "C:\hph.ZUGFeRD\factur-x.xml
/inputpdfGibt 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“
/inputxmlGibt den Pfad zur XML-Datei das eingebettet werden sollBei Aktion combine/inputxml „C:\hph.ZUGFeRD\factur-x.xml
/outputfileGibt 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
/jtlinvoicenoRechnungsnummer 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:

  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.
  3. 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!