Actions6
Invoice → Generate
AI-generatedSummary
Generate a Factur‑X / ZUGFeRD invoice PDF/A-3.
Inputs
- invoiceNumber (required) — Invoice identifier as it appears on the document (e.g., 2026-001)
- invoiceDate (required) — ISO-8601 date YYYY-MM-DD for the invoice.
- dueDate — Optional ISO-8601 due date YYYY-MM-DD.
- currency (required) — ISO-4217 currency code (default EUR).
- vatRate (required) — Decimal VAT rate (0.21 = 21%). Use 0 for reverse-charge.
- vatLabel — Human-readable VAT label shown on the invoice (default '21% BTW').
- seller (required) — Fixed collection of seller details; at least Name, City, Country, VAT Number required.
- buyer (required) — Fixed collection of buyer details; at least Name, City, Country required.
- lines (required) — Array of line items; each with Description, Quantity, UnitPriceExclVat, and Unit.
- invoiceNotes — Optional memo text; supports markdown if Notes Format set to markdown.
- invoiceNotesFormat — Format of the notes: plain text, markdown, or sanitized HTML.
- invoiceProfile — Invoice profile: Basic for standard Factur-X or XRechnung DE for German mandatory fields.
- invoiceBuyerReference — BT-10 reference required for XRechnung DE invoices to German authorities.
- invoiceSellerContact — Optional seller contact details (Name, Phone, Email).
- invoicePaymentInstructions — Optional payment instructions (IBAN, BIC, Account Holder, Mode).
- invoiceTimestamp — Whether to apply an RFC 3161 timestamp to the PDF.
- invoiceEvidencePack — Whether to bundle an evidence pack ZIP alongside the PDF (requires plan feature).
- invoiceAccessibilityLevel — PDF/UA-1 accessibility level for screen-reader compatibility (requires pdf_ua feature).
- invoiceIdempotencyKey — Key for safe retries; must be set explicitly for idempotent calls.
Output shape
a single invoice result containing the generated PDF/A-3 binary and metadata
Response includes the PDF/A-3 file and optional fields such as jobId; errors are returned as error objects.
Examples
Example 1: Create standard invoice for a Dutch supplier
Set Invoice Number 2025-001, Invoice Date {{ $now }}, Currency EUR, VAT Rate 0.21, fill Seller and Buyer mandatory fields, add line items, Profile Basic
Example 2: Generate XRechnung DE invoice for a German authority
Select Profile XRechnung DE, fill Invoice Number, Invoice Buyer Reference, add required seller/buyer fields, add line items, set dueDate if needed
Example 3: Issue reverse-charge invoice with 0% VAT
Set VAT Rate 0, leave VAT Label empty, fill required seller and buyer fields, add line items, Profile Basic, optionally set Idempotency Key