Zum Inhalt

Rechnungs-PDF erstellen

Der Service Task „Rechnungs-PDF erstellen" kombiniert die automatische Betragsberechnung mit der PDF-Erzeugung in einem einzigen Schritt. Dabei werden zuerst alle Rechnungsbeträge berechnet (Netto, Brutto, Umsatzsteuer) und anschließend ein PDF-Dokument aus einer Handlebars-Vorlage generiert. So wird aus Rechnungsdaten direkt ein fertig formatiertes PDF-Dokument erzeugt.

Funktionsweise

Der Task führt intern zwei Schritte aus:

  1. Betragsberechnung — Positionssummen, Umsatzsteuer und Gesamtbeträge werden automatisch ergänzt (wie bei Rechnungsbeträge berechnen).
  2. PDF-Erzeugung — Die berechneten Daten werden in eine HTML-Vorlage eingesetzt und als PDF gerendert (wie bei PDF aus Handlebars-Template erstellen).

Input-Parameter

Als Eingabe werden die Rechnungsdaten übergeben. Die HTML-Vorlage und der Dateiname werden im Prozess-Designer konfiguriert.

{
  "app_invoice_no": "RE-2026-001",
  "app_invoice_date": "2026-04-08",
  "app_recipient_name": "Muster GmbH",
  "app_invoice_items_custom": [
    {
      "app_item_description": "Beratung",
      "app_amount": 10,
      "app_item_price_net": 150.00,
      "app_vat_percentage": 19,
      "app_unit": "Stunden"
    }
  ]
}

Erläuterung:

  • Die Rechnungsdaten werden über die JSONata-Transformation im Input-Parameter des Service Tasks übergeben.
  • Die HTML-Vorlage wird direkt im Prozess-Designer über den integrierten Template-Editor gepflegt.
  • Der Dateiname wird im Feld „PDF-Dateiname" des Service Tasks definiert (z. B. Rechnung-$(app_invoice_no).pdf).

Output

Der Task gibt eine Datei-Referenz zum erzeugten PDF-Dokument zurück.

{
  "referenceId": "01JXXXXX",
  "filename": "Rechnung-RE-2026-001.pdf",
  "contentType": "application/pdf"
}

JSONata-Beispiel

{
  "app_invoice_no": $.app_invoice_no,
  "app_invoice_date": $.app_invoice_date,
  "app_recipient_name": $.app_recipient_name,
  "app_recipient_street": $.app_recipient_street,
  "app_recipient_zip": $.app_recipient_zip,
  "app_recipient_city": $.app_recipient_city,
  "app_invoice_items_custom": $.app_invoice_items_custom
}

Hinweise

  • Die Betragsberechnung wird automatisch vor der PDF-Erzeugung durchgeführt — berechnete Felder wie app_net_total oder app_vat_total stehen in der Vorlage zur Verfügung.
  • Im Template können alle Handlebars-Helper verwendet werden (z. B. currency_eur, toGermanDate, qrCode).
  • Der Service eignet sich ideal, wenn nur ein PDF benötigt wird — ohne ZUGFeRD-Einbettung.

Tipp

Wird zusätzlich eine E-Rechnung im ZUGFeRD-Standard benötigt, kann stattdessen der Service Komplette E-Rechnung erstellen verwendet werden — dieser erledigt Berechnung, PDF und ZUGFeRD in einem Schritt.