Zum Hauptinhalt springen
csv2zugferd

beispiele

Datasrc mit globaler Steuer

Beispiel für columns-Suffix mit globaler INVOICE_TAX-Spalte und echter PDF-Vorlage.

Die Datei test\datasrc.csv enthält eine komplette Rechnung in genau einer CSV-Zeile.

Typische Merkmale:

  • Positionen stehen in Suffix-Spalten wie PRODUCT_NAME_0, PRODUCT_PRICE_0
  • Steuer und Summen stehen global pro Rechnung in Spalten wie INVOICE_TAX, INVOICE_TOTAL
  • als PDF-Vorlage wird eine echte Datei verwendet, hier test\2483.pdf

Passender Aufruf:

.\csv2zugferd-win-x64.exe --csv .\test\datasrc.csv --pdf .\test\2483.pdf --config .\test\config.yml --output .\test\output

Wichtiger Ausschnitt aus der YAML-Konfiguration:

lineItems:
  mode: "columns"
  columnPattern:
    style: "suffix"
    separator: "_"
    startIndex: 0
    zeroPadding: 0
  fields:
    name:
      column: "PRODUCT_NAME"
    netUnitPrice:
      column: "PRODUCT_PRICE"
    billedQuantity:
      column: "PRODUCT_QUANTITY"
    taxPercent:
      column: "INVOICE_TAX"

Dabei wird INVOICE_TAX nicht als Positionsspalte gesucht, sondern als globale Rechnungs-Spalte gelesen und auf jede erzeugte Position angewendet.

Für einen XML-Testlauf kann derselbe Aufruf mit --xml-only ergänzt werden. Das Testskript test\test.cmd verwendet bewusst die echte 2483.pdf statt einer leeren Dummy-Datei.