E-Rechnung erstellen (ZUGFeRD)

Der Service Task „E-Rechnung erstellen (ZUGFeRD-Standard)“ kombiniert eine PDF-Datei mit strukturierten Rechnungsdaten zu einer elektronischen Rechnung im ZUGFeRD-Standard. Die erzeugte E-Rechnung enthält ein eingebettetes XML-Dokument mit allen relevanten Angaben.

Input-Parameter

Die folgenden Felder werden als Eingabe für den Task benötigt:

{
  "invoiceData": {
    "invoiceNumber": "12345",
    "invoiceDate": "2024-12-22",
    "totalAmount": 500.00,
    "customer": {
      "name": "Max Mustermann",
      "address": "Musterstraße 1, 12345 Musterstadt"
    }
  },
  "invoicePDFDocument": "fileReference"
}

Erläuterung:

• invoiceData: JSON-Objekt mit Rechnungsnummer, Datum, Betrag sowie Kundendetails.
• invoicePDFDocument: Referenz zur PDF-Datei, in die die Rechnungsinformationen eingebettet werden.

Output

Der Task gibt eine Referenz zur erstellten E-Rechnung zurück.

{
  "status": 200,
  "response": {
    "fileReference": "s3://bucket-name/invoice12345.pdf"
  }
}

Erläuterung:

• status: Status des Vorgangs (200 für erfolgreich).
• fileReference: Datei-Referenz der erzeugten E-Rechnung im ZUGFeRD-Standard.

JSONata-Beispiele

{
  "invoiceData": {
    "invoiceNumber": $.orderDetails.orderId,
    "invoiceDate": $substring($now(), 0, 10),
    "totalAmount": $.orderDetails.totalAmount,
    "customer": {
      "name": $.customer.name,
      "address": $join([$.customer.street, $.customer.city], ", ")
    }
  },
  "invoicePDFDocument": $.pdfFileReference
}

Hinweise

• Unterstützt den ZUGFeRD-Standard, der strukturierte Daten und ein visuelles PDF kombiniert.
• Stelle sicher, dass die übergebenen invoiceData vollständig und korrekt formatiert sind.
• Bei Fehlern im Erstellungsprozess wird ein entsprechender Statuscode zurückgegeben.

Tipp

Nutze JSONata, um invoiceData dynamisch aus API-Ergebnissen oder bestehenden Datenobjekten abzuleiten.