> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.invoice-api.xhub.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.invoice-api.xhub.io/_mcp/server.

# Generate invoice document

POST https://service.invoice-api.xhub.io/api/v1/invoice/{countryCode}/{format}/generate
Content-Type: application/json

Generate an invoice document in the specified format (PDF, XRechnung, ZUGFeRD, etc.). Supports 14 European countries with country-specific e-invoice formats.

### Template selection (PDF-based formats only: `pdf`, `zugferd`, `facturx`)

You have **three ways** to control the PDF template — pick exactly one:

1. **`templateId`** — reference a template previously saved via the web UI or the tRPC `pdf.templateCreate` mutation. The template is loaded from the database using the organization of the API key.
2. **`formatOptions.template`** — inline a complete `BlockTemplate` JSON object in the request body. Use this if you want to ship a template bundled with your integration without storing it server-side.
3. **Omit both** — the server uses the built-in default template (the generic "System Template Standard" template shipped with the API). This is the easiest way to get started.

**Priority if multiple are provided:** `templateId` > `formatOptions.template` > default. For non-PDF formats (e.g. `xrechnung`, `ubl`) the template is ignored — these formats produce pure XML output.

### Body examples
Use the "Examples" dropdown below to toggle between the three variants.

Reference: https://docs.invoice-api.xhub.io/api-reference/invoices/generate

## Authentication

- `Authorization` header (bearer token, required) — API Key authentication. Use `sk_live_*` for production or `sk_test_*` for testing.

## Servers

- `https://service.invoice-api.xhub.io` (Invoice API v1 (production), default)
- `/` (Diese Instanz (lokale Entwicklung))

## Request

### Path parameters

- `countryCode` (enum, required) — ISO 3166-1 alpha-2 country code (lowercase). Determines country-specific validation and available e-invoice formats. Supported countries (37): ae, at, au, be, bg, ch, cy, cz, de, dk, ee, es, fi, fr, gb, gr, hr, hu, ie, is, it, jp, li, lt, lu, lv, mt, nl, no, nz, om, pl, pt, ro, se, si, sk.
  - Allowed values: `ae`, `at`, `au`, `be`, `bg`, `ch`, `cy`, `cz`, `de`, `dk`, `ee`, `es`, `fi`, `fr`, `gb`, `gr`, `hr`, `hu`, `ie`, `is`, `it`, `jp`, `li`, `lt`, `lu`, `lv`, `mt`, `nl`, `no`, `nz`, `om`, `pl`, `pt`, `ro`, `se`, `si`, `sk`
- `format` (enum, required) — Output/input format identifier (lowercase). Valid format values depend on the country — call `GET /api/v1/invoice/{countryCode}/formats` to discover the exact set for a country. Overview: * **pdf** — all 37 countries. * **ubl** — generic Peppol BIS 3.0 UBL on most countries (incl. PINT flavours for AE/AU/NZ); on **PL** it emits the national KSeF FA(3), on **PT** CIUS-PT, on **RO** eFactura (CIUS-RO). * **xrechnung** (DE), **zugferd** (DE — `formatOptions.profile` selects `EN16931`/`BASIC`/`EXTENDED`; CH — Swiss CII flavour for cross-border DE/AT customers). * **ebinterface** (AT). * **facturx** (FR/BE — `formatOptions.profile` selects `EN16931`/`BASIC`). * **fatturapa** (IT — 6-char SDI codes for PA accepted). * **facturae** (ES) — generated only; invoice-api does not report to the AEAT (no VERI\*FACTU record). * **isdoc** (CZ), **nav** (HU), **mydata** (GR), **ksef** (PL). * **cii** (SK — EN 16931 CII, generate and validate with `invoice`; checking a received SK-CII document (`data`) is not offered). * **peppol-ubl** — generic Peppol BIS 3.0 UBL for PL/PT/RO whose `ubl` slot is (or can be) occupied by the national CIUS. * **hr-fisk** (HR — HR-FISK 2.0 CIUS, validate only). * **qr-bill** (CH/LI — structured 32-line QR-Bill payload as text/plain). Exact spelling matters — values must be lowercase. The `peppol-ubl`, `qr-bill` and `hr-fisk` slots are dash-separated.
  - Allowed values: `cii`, `ebinterface`, `facturae`, `facturx`, `fatturapa`, `hr-fisk`, `isdoc`, `ksef`, `mydata`, `nav`, `pdf`, `peppol-ubl`, `qr-bill`, `ubl`, `xrechnung`, `zugferd`

### Body (application/json)

This endpoint expects an object.

- `invoice` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoice, required) — Invoice data to generate document from
- `validate` (boolean, optional) — Run the same XSD + Schematron check as `/validate` on the **generated** document and return the verdict in an additional `validation` block. **This call then counts as 2 units** on the format's `create` entitlement (one for the generation, one for the check) — a call without this flag still counts as 1 and carries no `validation` block. The generator of every country already checks the document it wrote without this flag: a finding answers 422 with `complianceErrors`, a rulebook that could not be applied (or none bound to the written version/profile) adds a `SELF_CHECK_INCOMPLETE` / `SELF_CHECK_NOT_AVAILABLE` warning. With `validate: true` the `validation` block is fed from that same run rather than checking twice, and names the one rulebook of the written version and profile (Factur-X: one report, no longer one per version). Findings the check only reports as `SPEC_RULE_FAILED_KNOWN` warnings are listed there as errors. If the check did not run completely, the block says `status: 'not_run'` with a `reason` and `valid: null` — the document is still returned with 200, and only 1 unit is counted (a check that did not run is not billed).
- `enforcePending` (boolean, optional) — Reject rule findings that are still in their **warning phase**. When a newly enforced rule of a pinned rulebook (EN 16931, Peppol BIS, a national CIUS) would reject a document that was accepted before, we announce it first: for at least 28 days the call still returns 200 and the finding comes as a `SPEC_RULE_PENDING` warning with `rule` (or `pendingKey` when the finding has no rule identifier), `enforceFrom` (the date from which it answers 422) and `specId` (the rulebook). `true` switches that phase off for this call: every finding answers 422 — as it will from `enforceFrom`. Omitted or `false`: warning phase on. The document is not conformant either way; with `validate: true` the `validation` block lists a pending finding as an error with `enforceFrom`.
- `emailRecipients` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaEmailRecipientsItems, optional) — **Paid plans only.** Send the generated document by e-mail to up to 10 recipients after a successful generation. Each entry is an address or an object `{ email, subject?, body? }`; a bare address gets a default subject ("Rechnung \<number> von \<seller>" at `/DE` and `/AT`, otherwise "Invoice \<number> from \<seller>") and a default text. Addresses are compared case-insensitively after trimming; the first entry wins. The attachment is the `data` of the response with its `mimeType` (the hybrid PDF for ZUGFeRD/Factur-X, otherwise the XML). The sender is our invoice mail address with the name of your organization; replies go to the contact e-mail of your seller profile. The response is the same as without this field: the result per recipient is in your generation log (the address is kept for 30 days only when sending failed or the address is blocked). Without an active paid subscription the call is rejected with 403 before anything is generated. Sending does not count as extra usage. A generation that answers 422 sends nothing.
- `templateId` (string, optional) — **Option B** — reference a PDF template previously saved via the web UI (or the `pdf.templateCreate` tRPC mutation) by its UUID. The template is loaded from the database for the organization of the API key. Only used for PDF-based formats (`pdf`, `zugferd`, `facturx`). **Priority:** `templateId` > `formatOptions.template` > the built-in template for the invoice's country > a generic fallback. If all three are omitted, the invoice gets the layout of ITS OWN country — a German invoice gets the German template. Only countries without their own template fall back to the generic "System Template Standard".
- `formatOptions` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptions, optional) — Format-specific options. `template` (inline BlockTemplate, option C — see above), `zugferdProfile` (legacy alias for `profile`), `profile` (EN16931 / BASIC / EXTENDED — ZUGFeRD + Factur-X; the lineless `MINIMUM` and `BASIC WL` profiles are retired and rejected with a 400), `version` (2.3/2.4/2.5 for ZUGFeRD, 1.0/1.07/1.08/1.09 for Factur-X).

## Response

### 200

Invoice document generated successfully

- `success` (boolean, required) — Whether generation was successful
- `format` (string, required) — Output format used
- `filename` (string, required) — Suggested filename
- `mimeType` (string, required) — MIME type of the document
- `hash` (string, required) — Hex-encoded SHA-256 of the returned document bytes (the base64-decoded `data`). Empty string when no document was produced (422). NOT stable across calls for PDF outputs — the PDF carries a creation timestamp and document ID, so two calls with an identical payload yield two different values. Use it to verify the file you received; use `payloadHash` for idempotent filenames and duplicate detection.
- `data` (string, required) — Base64 encoded document
- `payloadHash` (string, optional) — Hex-encoded SHA-256 of the canonical JSON of the `invoice` you sent (object keys sorted recursively, undefined members dropped). Identical invoice data → identical value, on every call. Present on 200 and 422 responses. Use it as the key for idempotent file names and to recognise a document you already generated.
- `embeddedXml` (string, optional) — Embedded XML content (for hybrid PDF formats like ZUGFeRD/Factur-X). The PDF/A-3 in `data` already contains this XML; it is exposed here for convenient display/inspection.
- `validation` (ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaValidation, optional) — Spec-conformance verdict on the generated document — **present only when the request set `validate: true`** (which makes the call count as 2 units). Same shape as the `/:countryCode/:format/validate` response, plus `status`. Fed from the self-check of the same run — no second check.
- `appliedFormatOptions` (AppliedFormatOptions, optional) — The ZUGFeRD / Factur-X version and profile the document was actually written in — the requested ones, or the defaults (`2.4` / `1.08`, `EN16931`) when none was sent. Absent for formats without a version selector (XRechnung, UBL, …).
- `errors` (list of ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaErrorsItems, optional) — Validation errors (if any)
- `warnings` (list of ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaWarningsItems, optional) — Validation warnings (if any). `SELF_CHECK_INCOMPLETE` means a rulebook of our conformance self-check could not be applied (missing, not loadable or failed while running): the document was not fully checked against it. It is a warning, never a 422 — the document was not found to be wrong.`SPEC_RULE_PENDING` means a newly enforced rule found something that is still in its warning phase: the document is returned, and from `enforceFrom` the same finding answers 422 (`specId` names the rulebook; `pendingKey` replaces `rule` when the finding has no rule identifier). Set `enforcePending: true` to be rejected right away. `DATE_NOT_ISO` (`/generate`, `/embed`) means `dueDate`, `deliveryDate`, `delivery.date`, `servicePeriod.start`, `servicePeriod.end`, `taxPointDate` or the preceding invoice date (BT-26: `referencedInvoiceDate`, `precedingInvoiceReferences[].issueDate`, `items[].creditedFrom.invoiceIssueDate`) was not sent as `YYYY-MM-DD` (`field`, e.g. `precedingInvoiceReferences.0.issueDate`): the document carries the date shown in `params.written` (`DD.MM.YYYY` is read day first), and from `params.rejectFrom` this form is rejected with 400 `INVALID_DATE`. Set `enforcePending: true` to be rejected right away. A timestamp (`2027-03-15T23:30:00-05:00`) writes its date part as sent, without a warning. `DATE_EMPTY_IGNORED` (`/generate`, `/embed`, `/embed/upload`) means `dueDate`, `deliveryDate`, `delivery.date`, `servicePeriod.start`/`end` or `items[].servicePeriod.start`/`end` was sent as `""` (`field`, e.g. `items.0.servicePeriod.end`): the field was left out of the document. Omit the field or send `YYYY-MM-DD`. `TEMPLATE_BLOCK_INVALID` (`/generate`, inline `formatOptions.template`) means a block inside a `columns` block fails the check that header, body and footer blocks pass (`field`, e.g. `formatOptions.template.body.blocks.1.data.columns.0.blocks.0`): it was rendered as sent, and from `params.rejectFrom` (2027-01-01) it is rejected with 400. Set `enforcePending: true` to be rejected right away. `CURRENCY_CODE_UNKNOWN` (`/api/v1`; `field: currency`) means `currency` is not an ISO 4217 code; the request was processed as before, `/api/v2` rejects it with 400 `INVALID_CURRENCY`. `FIELD_TOO_LONG` means a seller or buyer address field, a `state`, `projectNumber` or the attachments exceed their limit (`field`, `maximum`); the value was written unchanged, a later release rejects it with 400. `VERIFACTU_NOT_ACTIVE` (`/generate`, seller in ES) means VERI*FACTU is not active on this service: nothing was reported to the AEAT and no VERI*FACTU QR code was added; the document itself was generated. `INVOICE_LINES_ABOVE_MODE_LIMIT` means the invoice has more lines including sub-items (`count`) than this server accepts (`limit`); the document is unchanged, a later release rejects it with 400. `TAX_EXEMPTION_REASON_SUBSTITUTED` (CII formats) means an exempt tax category without `exemptionReason` got the default reason of its category from the VATEX code list (`field`, `params.kategorie`, `params.code`, `params.reason`). `ALLOWANCE_TAX_CATEGORY_REQUIRED` (rule `BR-32`) means an allowance or charge has no tax category and the lines do not determine one (`field`); it comes with `SPEC_RULE_PENDING` and from `enforceFrom` it answers 422. `QUANTITY_ROUNDS_TO_ZERO` (AT, HU, IT, PT) means a quantity other than 0 is written as 0 at the decimal limit of the format (`field`); same warning phase. `DISCOUNT_DECIMALS_ROUNDED` means a line discount was rounded to the decimals of the format (`field`, `params.sent`, `params.written`, `params.max`). `FATTURAPA_AC_REASON_DROPPED` means FatturaPA has no element for the reason of a discount or charge: the reason was not written, the amount is unaffected. `VAT_ID_COUNTRY_PREFIX_ADDED` (rule `BR-CO-09`) means the country prefix was added to a VAT identifier (`field`); the value written is listed in `validation.results[].vatIdErgaenzt`.

## Errors

### 400 Bad Request Error

Bad Request - Invalid invoice data, unsupported country/format, a retired format profile (`MINIMUM` / `BASIC WL`), or a version/profile the format cannot write: `UNSUPPORTED_FORMAT_VERSION` (e.g. `1.08` at a ZUGFeRD route), `UNSUPPORTED_FORMAT_PROFILE` (e.g. `BASIC` for Belgian Factur-X) or `CONFLICTING_FORMAT_OPTIONS` (two keys naming different versions or profiles). Those three carry `code` and `field`, and the message lists the allowed values. A date the generator cannot read (e.g. `29.09.2026` in `issueDate`) gives `code` `INVALID_DATE` with `field`; send dates as `YYYY-MM-DD`. `TOO_MANY_LINE_ITEMS` — the invoice carries more line items than your plan allows per invoice (the body names the sent `count` and the plan `limit`). Free 25, Starter 100, Premium 1000; Enterprise has no limit. Requests above the absolute ceiling of 5000 items (25000 where large-invoice validation is enabled) are rejected by schema validation with `too_big`. Routes that render a PDF layout (`/generate` for `pdf` or a hybrid format, `/convert` into a hybrid format) stay at 5000 and answer with the same `too_big` body (`maximum: 5000`). `TOO_MANY_INVOICE_LINES` — more than 25000 lines in total, counting every sub-item (`items[].subItems`, at any depth). `SUB_ITEMS_TOO_DEEP` — sub-items nested more than 100 levels deep. Both use the validation body (`error` is a list, `success: false`); the entry carries `path` and `params.code`, plus `params.count` or `params.depth` and `params.limit`.

- `PostApiV1InvoiceByCountryCodeByFormatGenerateRequestBadRequestError`
  - ErrorResponse: ErrorResponse
  - PostApiV1InvoiceByCountryCodeByFormatGenerateRequestBadRequestError1
  - PostApiV1InvoiceByCountryCodeByFormatGenerateRequestBadRequestError2

### 401 Unauthorized Error

Unauthorized - Invalid or missing API key

- `error` (string, required) — Error code
- `message` (string, required) — Human-readable error message
- `code` (string, optional) — Machine-readable reason, where one exists — e.g. `UNSUPPORTED_FORMAT_VERSION`, `UNSUPPORTED_FORMAT_PROFILE`, `CONFLICTING_FORMAT_OPTIONS`
- `field` (string, optional) — The request field the error refers to, where one exists

### 403 Forbidden Error

Forbidden - Missing required entitlement

- `error` (string, required) — Error code
- `message` (string, required) — Human-readable error message
- `code` (string, optional) — Machine-readable reason, where one exists — e.g. `UNSUPPORTED_FORMAT_VERSION`, `UNSUPPORTED_FORMAT_PROFILE`, `CONFLICTING_FORMAT_OPTIONS`
- `field` (string, optional) — The request field the error refers to, where one exists

### 404 Not Found Error

Not Found - Referenced templateId does not exist or is not accessible

- `error` (string, required) — Error code
- `message` (string, required) — Human-readable error message
- `code` (string, optional) — Machine-readable reason, where one exists — e.g. `UNSUPPORTED_FORMAT_VERSION`, `UNSUPPORTED_FORMAT_PROFILE`, `CONFLICTING_FORMAT_OPTIONS`
- `field` (string, optional) — The request field the error refers to, where one exists

### 413 Content Too Large Error

The request body exceeds 128 MiB (`PAYLOAD_TOO_LARGE`, `limit` in bytes). Attachments (`invoice.attachments[].content`) travel in the same body.

- `error` (string, required) — Error code
- `message` (string, required) — Human-readable error message
- `code` (string, optional) — Machine-readable reason, where one exists — e.g. `UNSUPPORTED_FORMAT_VERSION`, `UNSUPPORTED_FORMAT_PROFILE`, `CONFLICTING_FORMAT_OPTIONS`
- `field` (string, optional) — The request field the error refers to, where one exists

### 422 Unprocessable Entity Error

Unprocessable Entity - the request was well-formed but the data could not be turned into a conforming document. Either pre-generation validation failed (no output) or the generated document has spec/compliance errors. The response body still carries any generated `data` plus `errors` / `complianceErrors` so the caller can inspect the non-conforming output.

- `success` (boolean, required) — Whether generation was successful
- `format` (string, required) — Output format used
- `filename` (string, required) — Suggested filename
- `mimeType` (string, required) — MIME type of the document
- `hash` (string, required) — Hex-encoded SHA-256 of the returned document bytes (the base64-decoded `data`). Empty string when no document was produced (422). NOT stable across calls for PDF outputs — the PDF carries a creation timestamp and document ID, so two calls with an identical payload yield two different values. Use it to verify the file you received; use `payloadHash` for idempotent filenames and duplicate detection.
- `data` (string, required) — Base64 encoded document
- `payloadHash` (string, optional) — Hex-encoded SHA-256 of the canonical JSON of the `invoice` you sent (object keys sorted recursively, undefined members dropped). Identical invoice data → identical value, on every call. Present on 200 and 422 responses. Use it as the key for idempotent file names and to recognise a document you already generated.
- `embeddedXml` (string, optional) — Embedded XML content (for hybrid PDF formats like ZUGFeRD/Factur-X). The PDF/A-3 in `data` already contains this XML; it is exposed here for convenient display/inspection.
- `validation` (ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaValidation, optional) — Spec-conformance verdict on the generated document — **present only when the request set `validate: true`** (which makes the call count as 2 units). Same shape as the `/:countryCode/:format/validate` response, plus `status`. Fed from the self-check of the same run — no second check.
- `appliedFormatOptions` (AppliedFormatOptions, optional) — The ZUGFeRD / Factur-X version and profile the document was actually written in — the requested ones, or the defaults (`2.4` / `1.08`, `EN16931`) when none was sent. Absent for formats without a version selector (XRechnung, UBL, …).
- `errors` (list of ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaErrorsItems, optional) — Validation errors (if any)
- `warnings` (list of ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaWarningsItems, optional) — Validation warnings (if any). `SELF_CHECK_INCOMPLETE` means a rulebook of our conformance self-check could not be applied (missing, not loadable or failed while running): the document was not fully checked against it. It is a warning, never a 422 — the document was not found to be wrong.`SPEC_RULE_PENDING` means a newly enforced rule found something that is still in its warning phase: the document is returned, and from `enforceFrom` the same finding answers 422 (`specId` names the rulebook; `pendingKey` replaces `rule` when the finding has no rule identifier). Set `enforcePending: true` to be rejected right away. `DATE_NOT_ISO` (`/generate`, `/embed`) means `dueDate`, `deliveryDate`, `delivery.date`, `servicePeriod.start`, `servicePeriod.end`, `taxPointDate` or the preceding invoice date (BT-26: `referencedInvoiceDate`, `precedingInvoiceReferences[].issueDate`, `items[].creditedFrom.invoiceIssueDate`) was not sent as `YYYY-MM-DD` (`field`, e.g. `precedingInvoiceReferences.0.issueDate`): the document carries the date shown in `params.written` (`DD.MM.YYYY` is read day first), and from `params.rejectFrom` this form is rejected with 400 `INVALID_DATE`. Set `enforcePending: true` to be rejected right away. A timestamp (`2027-03-15T23:30:00-05:00`) writes its date part as sent, without a warning. `DATE_EMPTY_IGNORED` (`/generate`, `/embed`, `/embed/upload`) means `dueDate`, `deliveryDate`, `delivery.date`, `servicePeriod.start`/`end` or `items[].servicePeriod.start`/`end` was sent as `""` (`field`, e.g. `items.0.servicePeriod.end`): the field was left out of the document. Omit the field or send `YYYY-MM-DD`. `TEMPLATE_BLOCK_INVALID` (`/generate`, inline `formatOptions.template`) means a block inside a `columns` block fails the check that header, body and footer blocks pass (`field`, e.g. `formatOptions.template.body.blocks.1.data.columns.0.blocks.0`): it was rendered as sent, and from `params.rejectFrom` (2027-01-01) it is rejected with 400. Set `enforcePending: true` to be rejected right away. `CURRENCY_CODE_UNKNOWN` (`/api/v1`; `field: currency`) means `currency` is not an ISO 4217 code; the request was processed as before, `/api/v2` rejects it with 400 `INVALID_CURRENCY`. `FIELD_TOO_LONG` means a seller or buyer address field, a `state`, `projectNumber` or the attachments exceed their limit (`field`, `maximum`); the value was written unchanged, a later release rejects it with 400. `VERIFACTU_NOT_ACTIVE` (`/generate`, seller in ES) means VERI*FACTU is not active on this service: nothing was reported to the AEAT and no VERI*FACTU QR code was added; the document itself was generated. `INVOICE_LINES_ABOVE_MODE_LIMIT` means the invoice has more lines including sub-items (`count`) than this server accepts (`limit`); the document is unchanged, a later release rejects it with 400. `TAX_EXEMPTION_REASON_SUBSTITUTED` (CII formats) means an exempt tax category without `exemptionReason` got the default reason of its category from the VATEX code list (`field`, `params.kategorie`, `params.code`, `params.reason`). `ALLOWANCE_TAX_CATEGORY_REQUIRED` (rule `BR-32`) means an allowance or charge has no tax category and the lines do not determine one (`field`); it comes with `SPEC_RULE_PENDING` and from `enforceFrom` it answers 422. `QUANTITY_ROUNDS_TO_ZERO` (AT, HU, IT, PT) means a quantity other than 0 is written as 0 at the decimal limit of the format (`field`); same warning phase. `DISCOUNT_DECIMALS_ROUNDED` means a line discount was rounded to the decimals of the format (`field`, `params.sent`, `params.written`, `params.max`). `FATTURAPA_AC_REASON_DROPPED` means FatturaPA has no element for the reason of a discount or charge: the reason was not written, the amount is unaffected. `VAT_ID_COUNTRY_PREFIX_ADDED` (rule `BR-CO-09`) means the country prefix was added to a VAT identifier (`field`); the value written is listed in `validation.results[].vatIdErgaenzt`.

### 429 Too Many Requests Error

Quota Exceeded - Usage limit reached

- `error` ("QUOTA_EXCEEDED", required) — Error code
- `message` (string, required) — Error message
- `quota` (ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaQuota, required)

### 500 Internal Server Error

Internal Server Error - unexpected failure while generating the document

- `error` (string, required) — Error code
- `message` (string, required) — Human-readable error message
- `code` (string, optional) — Machine-readable reason, where one exists — e.g. `UNSUPPORTED_FORMAT_VERSION`, `UNSUPPORTED_FORMAT_PROFILE`, `CONFLICTING_FORMAT_OPTIONS`
- `field` (string, optional) — The request field the error refers to, where one exists

### 503 Service Unavailable Error

`EMBED_UNAVAILABLE` — the embedding service is not available and the hybrid PDF is larger than 15 MiB. `Retry-After: 60`; nothing is billed. Try again later. Or: `SERVER_BUSY` — too many calls run at the same time on this server or for your organization (large requests count more). `Retry-After: 5`; nothing is billed. Send the call again after that time.

- `error` (string, required) — Error code
- `message` (string, required) — Human-readable error message
- `code` (string, optional) — Machine-readable reason, where one exists — e.g. `UNSUPPORTED_FORMAT_VERSION`, `UNSUPPORTED_FORMAT_PROFILE`, `CONFLICTING_FORMAT_OPTIONS`
- `field` (string, optional) — The request field the error refers to, where one exists

## Types

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoice

Invoice data to generate document from

- `invoiceNumber` (string, required) — Unique invoice number
- `type` (enum, required) — Invoice type. Maps to BT-3 (UNTDID 1001) where the target format supports it: invoice=380, credit_note=381, correction=384, proforma=325, partial=326, partial_construction=875, partial_final_construction=876, final_construction=877, self_billed=389. Where a format has no code for the type (e.g. Peppol BIS outside DE-to-DE, where PEPPOL-EN16931-P0112 restricts both 326 (partial) and 384 (correction) to a DE seller together with a DE buyer), the document is issued as 380 and the response carries a DOCUMENT_TYPE_FALLBACK warning — never silently, and never a silent 381: `correction` on a non-DE-to-DE Peppol route always falls back to 380, not to the credit-note code. Where the type is not permitted at all (proforma in XRechnung/Peppol BIS), the request is rejected with HTTP 422. Note: `partial` (326) is a partial invoice for a delivered instalment. A prepayment REQUEST is not 386 — 386 is not permitted in XRechnung; use type=invoice, and report prepayments already received via `prepayments` (BT-113).
  - Allowed values: `invoice`, `credit_note`, `proforma`, `correction`, `partial`, `partial_construction`, `partial_final_construction`, `final_construction`, `self_billed`
- `issueDate` (string, required) — Issue date (ISO 8601: YYYY-MM-DD)
- `seller` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceSeller, required) — Seller party information
- `buyer` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceBuyer, required) — Buyer party information
- `items` (list of InvoiceLineItemInput, required) — Invoice line items. Hard ceiling: 5000, or 25000 where large-invoice validation is enabled (`maxItems` shows the value of the server you call). Routes that render a PDF layout stay at 5000 — `/generate` for `pdf` or a hybrid format such as ZUGFeRD or Factur-X, and `/convert` into a hybrid format; above that they answer 400 with the same `too_big` body (`maximum: 5000`). To embed the XML of a larger invoice into your own PDF, use `/embed`. Your plan may allow fewer — a request above the plan limit is rejected with 400 `TOO_MANY_LINE_ITEMS`. Sub-items (`subItems`) count as lines: above 25000 lines in total the request is rejected with 400 `TOO_MANY_INVOICE_LINES`; above 5000 lines in total on a server without large-invoice validation the response carries the warning `INVOICE_LINES_ABOVE_MODE_LIMIT`.
- `currency` (string, required) — Currency code (ISO 4217, three upper-case letters). A code outside ISO 4217 is rejected under `/api/v2` with 400 `INVALID_CURRENCY` (`field: currency`); under `/api/v1` the request is processed as before and `warnings` carries `CURRENCY_CODE_UNKNOWN`.
- `subtotal` (double, required) — Total net amount
- `total` (double, required) — Total gross amount
- `taxSummary` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceTaxSummaryItems, required) — Tax summary per tax rate
- `dueDate` (string, optional, nullable) — Due date (ISO 8601: YYYY-MM-DD). Optional when payment terms (BT-20) are given.
- `deliveryDate` (string, optional, nullable) — Delivery/service date (ISO 8601)
- `servicePeriod` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceServicePeriod, optional, nullable) — Service period (Leistungszeitraum, BG-14). Required in DE if different from issueDate. Send `start`, `end` or both (BR-CO-19); an empty object returns a 400. Formats whose schema requires both dates (ebInterface, Facturae) return a 400 `INVOICE_SERVICE_PERIOD_BOTH_DATES_REQUIRED` when one is missing; ISDOC has no invoicing period and reports `INVOICE_SERVICE_PERIOD_NOT_REPRESENTABLE` as a warning.
- `payee` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePayee, optional, nullable) — Payee (BG-10), if different from the seller. On the CH/LI QR bill (`qr-bill`) the payee is the creditor: postal code, city, country and its own bank account are required.
- `paymentTerms` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePaymentTerms, optional, nullable) — Payment terms
- `cashDiscountPercent` (double, optional, nullable) — Cash discount (Skonto) percentage agreed on the document. > 0, \<= 100, at most two decimals. On German e-invoices this becomes the #SKONTO#TAGE=n#PROZENT=n.nn# line inside the payment terms note (BR-DE-18). Ignored when paymentTerms.earlyPaymentDiscount is present.
- `cashDiscountDays` (integer, optional, nullable) — Days within which the cash discount applies (integer, 0..365).
- `cashDiscountBaseAmount` (double, optional, nullable) — Optional base amount for the cash discount when it is not the payable amount (BASISBETRAG segment, BR-DE-18).
- `paymentMethods` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePaymentMethodsItems, optional, nullable) — Payment methods accepted for this invoice. Used in ZUGFeRD/XRechnung to generate SpecifiedTradeSettlementPaymentMeans. For bank_transfer, seller.bankAccount must also be set.
- `orderNumber` (string, optional, nullable) — Purchase order number (Bestellnummer)
- `customerNumber` (string, optional, nullable) — Customer number at the seller
- `contractNumber` (string, optional, nullable) — Contract number (BT-12)
- `projectNumber` (string, optional, nullable) — Project reference (BT-11). More than 100 characters: warning `FIELD_TOO_LONG` (field `projectNumber`), the value is written unchanged; a later release rejects it with 400.
- `tenderReference` (string, optional, nullable) — Tender or lot reference (BT-17). Several public contracting authorities reject an invoice without it. Rendered as `cac:OriginatorDocumentReference`.
- `objectId` (string, optional, nullable) — Object identifier of the invoice (BT-18) — the thing the invoice is about, e.g. a contract object or a plant. Rendered as `cac:AdditionalDocumentReference` with `cbc:DocumentTypeCode` 130.
- `objectIdScheme` (string, optional, nullable) — Scheme of the object identifier (BT-18-1, UNTDID 1153).
- `businessProcess` (string, optional, nullable) — Business process type (BT-23). Rendered as `cbc:ProfileID`. When omitted the generator emits the profile the target format prescribes.
- `roundingAmount` (double, optional, nullable) — Rounding amount (BT-114)
- `prepaidAmount` (double, optional, nullable) — Amount already paid in advance (BT-113) — a deposit or down payment the buyer has already transferred. Lowers the payable amount only (BR-CO-16: BT-115 = BT-112 − BT-113 + BT-114); the taxable base (BT-109) and the tax amounts stay unchanged, because the buyer paid earlier, not less. Emitted as `cbc:PrepaidAmount` (UBL) resp. `ram:TotalPrepaidAmount` (CII), and as the national equivalent in ISDOC (`PaidDepositsAmount`), ebInterface (`PrepaidAmount`) and Facturae (`TotalPaymentsOnAccount`). Formats without an already-paid element ignore it: FatturaPA, myDATA, NAV, Swiss/Liechtenstein QR-Bill, SAF-T PT, ATCUD/AT-QR and TicketBAI/LROE/VeriFactu. KSeF FA(3) also omits it — it models payment *events* (amount plus payment date), and inventing a date for a clearance system would be worse than the missing amount.
- `allowancesCharges` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceAllowancesChargesItems, optional, nullable) — Invoice-level allowances (discounts) and charges (surcharges) (BG-20 / BG-21). For line-level discounts, use items[].discount instead.
- `delivery` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceDelivery, optional, nullable) — Delivery information (BG-13). Includes delivery date (BT-72), deliver-to name (BT-70), location identifier (BT-71), and delivery address (BG-15).
- `directDebitMandate` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceDirectDebitMandate, optional, nullable) — Direct debit mandate (BG-19). Send it with direct_debit: most formats (XRechnung, Peppol PEPPOL-EN16931-R061) require the mandate reference for payment means code 49 and 59.
- `cardAccount` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceCardAccount, optional, nullable) — Card payment details (BG-18). Set it together with a card payment means code (BT-81 = 48, 54 or 55). Formats that cannot represent the group report a GROUP_NOT_REPRESENTABLE warning instead of dropping it silently.
- `supportingDocuments` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceSupportingDocumentsItems, optional, nullable) — References to supporting documents WITHOUT the file (BT-122/BT-123) — for the file itself use `attachments`. Oman needs the registryId here for the prepayment document and for exports with VATZR-OM-12.
- `retention` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceRetention, optional, nullable) — Security retention. Reduces only the payment, never the totals or the VAT. Written as a sentence into the payment terms (BT-20 or the national equivalent) of every e-invoice format that has payment terms, in the language of the seller (machine-translated for FR, NL, IT, ES, PL; English for other languages). A reason you send is used as given and is not translated. Do not use allowancesCharges for it. Formats or profiles without payment terms (ZUGFeRD and Factur-X MINIMUM, and myDATA without a payment method) reject the request with 422 (RETENTION_NOT_CARRIED); a plain PDF is not affected.
- `prepayments` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePrepaymentsItems, optional, nullable) — The individual prepayments behind `prepaidAmount` (BT-113). Needed where a country requires the prepayment invoice to be referenced — Oman writes each one as `cac:AdditionalDocumentReference` with document type code PDR. Elsewhere `prepaidAmount` alone is enough.
- `notes` (string, optional, nullable) — Additional notes displayed on the invoice
- `profile` (enum, optional) — XRechnung CIUS profile. `xrechnung` produces the standard CustomizationID `urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_3.0`. `xrechnung-extension` produces the EXTENSION CustomizationID `urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_3.0#conformant#urn:xoev-de:kosit:extension:xrechnung_3.0` which unlocks the additional XRechnung-EXTENSION business terms (subItems, third-party payments, ...). Defaults to `xrechnung` when omitted.
  - Allowed values: `xrechnung`, `xrechnung-extension`
- `referencedInvoiceNumber` (string, optional, nullable) — Number of the previously issued invoice this document references (BT-25, BG-3). Used for credit notes, corrections, and partial-invoice chains. Renders as `<cac:BillingReference>` in UBL / `IncludedNote` reference in CII.
- `referencedInvoiceDate` (string, optional, nullable) — Issue date of the referenced invoice (BT-26, ISO 8601 YYYY-MM-DD). Pairs with `referencedInvoiceNumber`.
- `deliveryNote` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceDeliveryNote, optional, nullable) — Despatch advice / delivery note reference (BT-16 / BT-17). Renders as `<cac:DespatchDocumentReference>` in UBL.
- `thirdPartyPayments` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceThirdPartyPaymentsItems, optional, nullable) — Third-party prepaid payments (BG-DEX-09, ZUGFeRD EXTENDED). Each entry is rendered as `<cac:PrepaidPayment>` in UBL.
- `attachments` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceAttachmentsItems, optional, nullable) — Embedded supporting documents (BG-24 / BT-122..125). Rendered as `<cbc:EmbeddedDocumentBinaryObject>` in UBL. More than 20 attachments: warning `FIELD_TOO_LONG` (field `attachments`); a later release rejects it with 400.
- `serviceCategory` (enum, optional) — Service category hint for the reverse-charge note. When a line or the VAT breakdown uses `taxCategoryCode: "AE"`, the generator writes the mandatory note: with seller and buyer in the same country and `construction`, the national note (in Germany §13b UStG); otherwise the EU-wide note (Art. 226 No. 11a VAT Directive), where one exists for the seller country. Without the buyer's country the response carries `REVERSE_CHARGE_BUYER_COUNTRY_MISSING`.
  - Allowed values: `construction`, `general`
- `constructionTax` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceConstructionTax, optional, nullable) — German construction-tax block (§13b UStG / §48 EStG). Setting `exemptionCertificateNumber` triggers the `#FREISTELLUNG#` note in the generated invoice. `withholdingPercent` documents the Bauabzugsteuer rate.
- `countrySpecific` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceCountrySpecific, optional, nullable) — Country-specific invoice data. Must include countryCode matching the invoice country. For DE: buyerReference (BT-10, required), paymentMeansCode (BT-81), leitwegId (B2G), isKleinunternehmer (§19 UStG). Other countries have their own fields — see country-specific documentation.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaEmailRecipientsItems

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaEmailRecipientsItems1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptions

Format-specific options. `template` (inline BlockTemplate, option C — see above), `zugferdProfile` (legacy alias for `profile`), `profile` (EN16931 / BASIC / EXTENDED — ZUGFeRD + Factur-X; the lineless `MINIMUM` and `BASIC WL` profiles are retired and rejected with a 400), `version` (2.3/2.4/2.5 for ZUGFeRD, 1.0/1.07/1.08/1.09 for Factur-X).

- `template` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplate, optional) — **Option C** — inline a complete BlockTemplate JSON object in the request. Only used for PDF-based formats (`pdf`, `zugferd`, `facturx`). **Priority:** `templateId` > `formatOptions.template` > the built-in template for the invoice's country > a generic fallback. If all three are omitted, the invoice gets the layout of ITS OWN country — a German invoice gets the German template. Only countries without their own template fall back to the generic "System Template Standard". A BlockTemplate is a JSON document with the top-level fields `version`, `name`, `page` (size, margins, colorScheme, fontSizes), `header`, `body.blocks`, `footer`, and optional `styles`. The `body.blocks` array contains typed blocks: `text`, `table`, `keyvalue`, `columns`, `summary`, `image`, `spacer`, `line`, `qrcode`, `pageBreak`, `watermark`, `barcode`. Use placeholders like `{{buyer.name}}`, `{{invoiceNumber}}`, `{{items}}`, `{{total}}`, `{{paymentTerms.dueDays}}` — they are resolved from the Invoice data at generation time. A trailing `?` (e.g. `{{buyer.street?}}`) marks a placeholder as optional. See the `withInlineTemplate` example in the Examples dropdown for a full, working template (the generic "System Template Standard").
- `zugferdProfile` (string, optional) — Legacy alias for `profile`. Prefer `profile` — this key is only still read on the `/convert` endpoint. Like `profile`, it rejects the retired `MINIMUM` and `BASIC WL` profiles with a 400.
- `profile` (enum, optional) — Format profile selector. Used by `zugferd` (DE, CH) and `facturx` (FR, BE). - `EN16931` (default for both): full EN-16931 Comfort profile. - `BASIC`: minimal-required EN-16931 subset for simple invoices. Not available for Belgian Factur-X (BE writes `EN16931` and `EXTENDED` only) — requesting it there returns a 400 `UNSUPPORTED_FORMAT_PROFILE` naming the allowed profiles. - `EXTENDED` (ZUGFeRD only): superset with sub-line-items (BG-DEX-01), allowance-charge per category, third-party payments. Sub-line-items (`items[].subItems`) are written only with ZUGFeRD `2.4`/`2.5` **and** `EXTENDED`; in every other version or profile they are left out and the response carries a warning `FIELD_NOT_WRITTEN` with the field path. - `XRECHNUNG` (ZUGFeRD only): the German CIUS on top of EN 16931. The XML claims the XRechnung 3.0 conformance URN (`urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0`) and the file embedded in the PDF is named `xrechnung.xml` instead of `factur-x.xml` — same as at `/embed`. **Retired:** `MINIMUM` and `BASIC WL` / `BASIC_WL` are no longer available. They carry no invoice line items and are therefore not EN-16931 compliant — the specification defines them as a booking aid, not as an invoice. Requesting either returns a 400 naming the alternatives. **Factur-X (FR):** the profile can also come from the legacy key `facturxProfile` or from `invoice.countrySpecific.facturxProfile`. If two of them are set and name different profiles, the request is rejected with a 400 `CONFLICTING_FORMAT_OPTIONS` — send only one of them. The profile actually written is returned in `appliedFormatOptions.profile`.
  - Allowed values: `EN16931`, `BASIC`, `EXTENDED`, `XRECHNUNG`
- `version` (enum, optional) — Format version selector. ZUGFeRD: `2.3` (legacy), `2.4` (default) or `2.5` (latest, EN 16931 code lists v17b). `2.3` has no rulebook of its own bound: a 2.3 document is not checked and carries the warning `SELF_CHECK_NOT_AVAILABLE` — never the verdict of another version. Factur-X: `1.0` / `1.07` / `1.08` (default) / `1.09` (latest). All emit the same `1p0:` URN scheme — the version selects the spec edition the output claims conformance with and the validation rulebook. **Patch releases are included, not separately selectable.** `2.5` emits and validates against **ZUGFeRD 2.5.2**, `1.09` against **Factur-X 1.09.2** — the patches keep the same URN (`urn:cen.eu:en16931:2017`), so they are not a new generation and there is nothing to choose between. What they change is the rulebook: FeRD dropped the VAT-category rules (BR-E/G/IC/O-*, BR-FXEXT-G-08) from profiles that carry no VAT breakdown, so MINIMUM went from 96 to 55 assertions, BASIC WL 270 to 278, BASIC 379 to 385, EN16931 424 to 433, EXTENDED 937 to 943. Asking for `2.5.2` or `1.09.2` is therefore a 400. **The version must belong to the format.** A Factur-X version at a ZUGFeRD route (e.g. `1.08` at `/de/zugferd/generate`) or a ZUGFeRD version at a Factur-X route is rejected with a 400 `UNSUPPORTED_FORMAT_VERSION` whose message lists the allowed versions. Without `version` the default above applies (`2.4` / `1.08`) — the same at `/generate`, `/embed` and `/convert`. XRECHNUNG without `version` is checked against 2.4, which requires seller contact (BT-41) and business process (BT-23). The version and profile actually written are returned in `appliedFormatOptions`. **Factur-X:** the legacy key `facturxVersion` is read as well; if it and `version` differ, the request is rejected with a 400 `CONFLICTING_FORMAT_OPTIONS`.
  - Allowed values: `1.0`, `1.07`, `1.08`, `1.09`, `2.3`, `2.4`, `2.5`

### ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaValidation

Spec-conformance verdict on the generated document — **present only when the request set `validate: true`** (which makes the call count as 2 units). Same shape as the `/:countryCode/:format/validate` response, plus `status`. Fed from the self-check of the same run — no second check.

- `valid` (boolean, required, nullable) — `true` when every checked format passed XSD + Schematron without findings, `false` when a check found something, `null` when a rulebook did not run (`status: not_run`).
- `results` (list of ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaValidationResultsItems, required) — One entry per checked spec format, each with its own verdict and findings
- `status` (enum, required) — `passed` — the rulebook ran and found nothing; `failed` — it found something (`valid: false`, see `errors`); `not_run` — it did not run (completely): `valid` is `null` and `reason` says why. A finding beats `not_run`: a real finding with another rulebook not run is `failed`.
  - Allowed values: `passed`, `failed`, `not_run`
- `errors` (list of ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaValidationErrorsItems, optional) — Flattened findings across all checked formats. Absent when there are none.
- `reason` (enum, optional) — Why the check did not run: rulebook `missing` (we have no pinned rulebook for this format — a retry gives the same answer), `load-failed`, `transform-failed`, `time-budget` (the check took longer than its time limit and was stopped — the document is delivered, it was not fully checked), `sidecar-unavailable` (the check service gave no answer and the document is too large to check here), `not-bound` (no rulebook is bound to the written version/profile), or `not-applied` (the rulebook is deliberately not run on this path). Only with `status: 'not_run'`.
  - Allowed values: `missing`, `load-failed`, `transform-failed`, `time-budget`, `sidecar-unavailable`, `not-bound`, `not-applied`

### AppliedFormatOptions

The ZUGFeRD / Factur-X version and profile the document was actually written in — the requested ones, or the defaults (`2.4` / `1.08`, `EN16931`) when none was sent. Absent for formats without a version selector (XRechnung, UBL, …).

- `version` (enum, required) — Version written (the selectable value — patch releases are included)
  - Allowed values: `1.0`, `1.07`, `1.08`, `1.09`, `2.3`, `2.4`, `2.5`
- `profile` (enum, required) — Profile written
  - Allowed values: `MINIMUM`, `BASIC WL`, `BASIC`, `EN16931`, `EXTENDED`, `XRECHNUNG`

### ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaErrorsItems

- `code` (ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaErrorsItemsCode, required) — Stable house code identifying the check (e.g. `DE_SELLER_CITY_001`, `NL_PAYMENT_MEANS_REQUIRED`, or `SPEC_RULE_FAILED` when a conformance gate objected). Never a standard rule identifier — look those up in `rule`. Safe to match on: it does not change when a rule is re-identified.
- `message` (string, required) — Error message
- `rule` (string, optional) — Identifier of the standard rule this finding violates (e.g. `BR-06`, `BR-DE-5`, `PEPPOL-EN16931-R008`), as published in EN 16931, Peppol BIS or the national CIUS. Present only when a pinned rulebook actually carries that rule and it governs this very check — so you can look it up and read the same statement. Absent means no standard rule covers this finding; the check is then ours alone and `code` names it.
- `field` (string, optional) — Field path (if applicable)
- `maximum` (double, optional) — Only on a `FIELD_TOO_LONG` warning: the limit of `field` — characters for a text field, base64 characters for `attachments[i].content` and `attachments[*].content`, the number of entries for `attachments`.
- `enforceFrom` (string, optional) — Only on a `SPEC_RULE_PENDING` warning: the date (`YYYY-MM-DD`, UTC) from which this finding is rejected with 422. Until then the document is still returned with 200.
- `specId` (string, optional) — Only on a `SPEC_RULE_PENDING` warning: the rulebook the newly enforced rule belongs to (e.g. `en16931-3.0.2-ubl`, `factur-x-1.08-extended`).
- `pendingKey` (string, optional) — Only on a `SPEC_RULE_PENDING` warning whose finding carries no standard rule identifier: a technical key of the finding (not a rule identifier — do not look it up in a rulebook). Stable, so you can recognise the same finding again. Absent when `rule` is present.

### ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaWarningsItems

- `code` (ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaWarningsItemsCode, required) — Stable house code identifying the check (e.g. `DE_SELLER_CITY_001`, `NL_PAYMENT_MEANS_REQUIRED`, or `SPEC_RULE_FAILED` when a conformance gate objected). Never a standard rule identifier — look those up in `rule`. Safe to match on: it does not change when a rule is re-identified.
- `message` (string, required) — Error message
- `rule` (string, optional) — Identifier of the standard rule this finding violates (e.g. `BR-06`, `BR-DE-5`, `PEPPOL-EN16931-R008`), as published in EN 16931, Peppol BIS or the national CIUS. Present only when a pinned rulebook actually carries that rule and it governs this very check — so you can look it up and read the same statement. Absent means no standard rule covers this finding; the check is then ours alone and `code` names it.
- `field` (string, optional) — Field path (if applicable)
- `maximum` (double, optional) — Only on a `FIELD_TOO_LONG` warning: the limit of `field` — characters for a text field, base64 characters for `attachments[i].content` and `attachments[*].content`, the number of entries for `attachments`.
- `enforceFrom` (string, optional) — Only on a `SPEC_RULE_PENDING` warning: the date (`YYYY-MM-DD`, UTC) from which this finding is rejected with 422. Until then the document is still returned with 200.
- `specId` (string, optional) — Only on a `SPEC_RULE_PENDING` warning: the rulebook the newly enforced rule belongs to (e.g. `en16931-3.0.2-ubl`, `factur-x-1.08-extended`).
- `pendingKey` (string, optional) — Only on a `SPEC_RULE_PENDING` warning whose finding carries no standard rule identifier: a technical key of the finding (not a rule identifier — do not look it up in a rulebook). Stable, so you can recognise the same finding again. Absent when `rule` is present.
- `params` (map from string to string, optional) — The values to phrase this warning in your own language (scalars only) — e.g. `{ format }` on `INVOICE_SERVICE_PERIOD_NOT_REPRESENTABLE`. The keys depend on `code`.
- `lossy` (boolean, optional) — `true`: this warning reports a loss — your document carried something the target format has no element for. Amounts survive (they are spread onto the lines), their representation does not. Absent means the warning is not a loss.
- `substituted` (boolean, optional) — `true`: this warning reports a substitution — the target format requires a field your document did not carry, and it was filled from another value (e.g. the delivery date from the issue date, the delivery party name from the buyer name). The document then states something you did not state. Absent means nothing was substituted.
- `severity` (enum, optional) — `info` is a hint, not a defect of the document — e.g. the reporting duty to NAV (`HU_24H_001`) or SDI (`IT_SDI_001`), or a rule the pinned Schematron flags as information. Absent means `warning`.
  - Allowed values: `warning`, `info`
- `count` (integer, optional) — Only on an `INVOICE_LINES_ABOVE_MODE_LIMIT` warning: the number of lines of your invoice, sub-items at any depth included.
- `limit` (integer, optional) — Only on an `INVOICE_LINES_ABOVE_MODE_LIMIT` warning: the number of lines this server accepts without large-invoice validation. A later release rejects an invoice above it with 400.

### ErrorResponse

- `error` (string, required) — Error code
- `message` (string, required) — Human-readable error message
- `code` (string, optional) — Machine-readable reason, where one exists — e.g. `UNSUPPORTED_FORMAT_VERSION`, `UNSUPPORTED_FORMAT_PROFILE`, `CONFLICTING_FORMAT_OPTIONS`
- `field` (string, optional) — The request field the error refers to, where one exists

### PostApiV1InvoiceByCountryCodeByFormatGenerateRequestBadRequestError1

- `error` ("TOO_MANY_LINE_ITEMS", required) — Error code
- `message` (string, required) — Human-readable message naming the sent count and the plan limit
- `lineItems` (ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaOneOf1LineItems, required)

### PostApiV1InvoiceByCountryCodeByFormatGenerateRequestBadRequestError2

The request body failed the input check. `error` lists every finding; each names the field (`path`) and the rule (`code`). Depending on the code, a finding also carries the limit (`maximum`, `minimum`), the expected type (`expected`), the allowed values (`values`) or the unknown keys (`keys`).

- `success` (false, required)
- `error` (list of ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaOneOf2ErrorItems, required)
- `hint` (ValidationHint, optional) — Added to the 400 of the input check when `invoice` is not an invoice object in the Unified format. It only adds information: status, `error` and `success` are the same as without it. Branch on `code`, not on `message`.

### ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaQuota

- `current` (double, required) — Current usage count
- `limit` (double, required) — Usage limit
- `period` (string, optional) — Quota period type of the plan quota that was hit, when the rejection carries one ('monthly', 'yearly', ...). Absent whenever the rejection has no period at all — for example a lapsed subscription, where the limit is 0 and no plan quota was involved. This is a period TYPE, never a calendar label such as "2026-03".

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceSeller

Seller party information

- `name` (string, required) — Legal name of the party
- `countryCode` (string, required) — Country code (ISO 3166-1 alpha-2)
- `tradingName` (string, optional, nullable) — Trading name (if different from legal name)
- `street` (string, optional, nullable) — Street address. More than 200 characters: warning `FIELD_TOO_LONG` (field e.g. `seller.street`), the value is written unchanged; a later release rejects it with 400.
- `additionalStreet` (string, optional, nullable) — Additional address line (BT-36 seller / BT-51 buyer / BT-65 tax representative). More than 200 characters: warning `FIELD_TOO_LONG` (field e.g. `seller.additionalStreet`), the value is written unchanged; a later release rejects it with 400.
- `addressLine3` (string, optional, nullable) — Third address line (BT-162 seller / BT-163 buyer / BT-164 tax representative).
- `city` (string, optional, nullable) — City. More than 100 characters: warning `FIELD_TOO_LONG` (field e.g. `seller.city`), the value is written unchanged; a later release rejects it with 400.
- `postalCode` (string, optional, nullable) — Postal code. More than 20 characters: warning `FIELD_TOO_LONG` (field e.g. `seller.postalCode`), the value is written unchanged; a later release rejects it with 400.
- `state` (string, optional, nullable) — State/region (ISO 3166-2). More than 100 characters: warning `FIELD_TOO_LONG` (field e.g. `seller.state`), the value is written unchanged; a later release rejects it with 400.
- `taxId` (string, optional, nullable) — National tax identification number. For the buyer, not transmitted in ZUGFeRD/Factur-X (only the VAT ID is); a warning is returned.
- `vatId` (string, optional, nullable) — VAT identification number with its country prefix (BT-31 seller / BT-48 buyer / BT-63 tax representative). EN 16931 (BR-CO-09) requires the prefix (ISO 3166-1 alpha-2, Greece `EL`). If the rulebook of the format reports BR-CO-09 and the value starts with a digit, the prefix of the party `countryCode` is added and the response carries the warning `VAT_ID_COUNTRY_PREFIX_ADDED` (field e.g. `buyer.vatId`). Formats without BR-CO-09 keep the value as sent.
- `registrationNumber` (string, optional, nullable) — Public register identifier of the party (BT-30 seller / BT-47 buyer) — Handelsregister, Firmenbuch, Companies House, … Rendered as `cac:PartyLegalEntity/cbc:CompanyID`. GENERIC field: until now every country read this from its own country-specific field (AT `tradeRegisterNumber`, FI `yTunnus`, …), so a business without a matching country block could not send its register number at all. Those fields keep working as a fallback.
- `registrationScheme` (string, optional, nullable) — ISO 6523 ICD code of the register (BT-30-1 / BT-47-1). 🔴 Only set this when the pinned ICD list actually carries a code for the register. The Austrian Firmenbuch has none — an invented code is FATAL per BR-CL-11.
- `identifiers` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceSellerIdentifiersItems, optional, nullable) — Further party identifiers (BT-29 seller / BT-46 buyer / BT-60 payee), repeatable. Written by every EN 16931 format. UBL: `cac:PartyIdentification/cbc:ID` (with `schemeID` if set). CII (ZUGFeRD, Factur-X, XRechnung CII, …): entries with `schemeId` become `ram:GlobalID`, entries without become `ram:ID`. Seller: every entry is BT-29. Buyer: BT-46 occurs at most once. The first entry of `buyer.identifiers` is BT-46 and replaces the invoice `customerNumber`; `customerNumber` is then not written and the response carries the warning `FIELD_NOT_WRITTEN` (field `customerNumber`). Without buyer identifiers `customerNumber` stays BT-46. Further buyer entries are not written either (`FIELD_NOT_WRITTEN`, field `buyer.identifiers.<n>`). `vatId` is only BT-31 (`SpecifiedTaxRegistration`, scheme `VA`). One exception, XRechnung (DE), seller: if the seller has no `identifiers`, no legal registration (BT-30) and no written BT-31, BR-CO-26 still needs one of them. Then `vatId` (or else `taxId`) is written as BT-29, and the response carries the warning `SELLER_IDENTIFIER_DERIVED`. Payee: only the first non-empty entry of `payee.identifiers` becomes BT-60 (with its `schemeId`); further entries are not written (`FIELD_NOT_WRITTEN`, field `payee.identifiers.<n>`). Only without one does the payee `vatId` or `taxId` fill BT-60.
- `email` (string, optional, nullable) — Email address
- `phone` (string, optional, nullable) — Phone number
- `website` (string, optional, nullable) — Website URL
- `contact` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceSellerContact, optional, nullable) — Structured contact person (BG-6 for seller, BG-9 for buyer)
- `bankAccount` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceSellerBankAccount, optional, nullable) — Bank account (required on seller for SEPA bank transfers in ZUGFeRD/XRechnung). For direct debit (SEPA Lastschrift), buyer bankAccount is also required.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceBuyer

Buyer party information

- `name` (string, required) — Legal name of the party
- `countryCode` (string, required) — Country code (ISO 3166-1 alpha-2)
- `tradingName` (string, optional, nullable) — Trading name (if different from legal name)
- `street` (string, optional, nullable) — Street address. More than 200 characters: warning `FIELD_TOO_LONG` (field e.g. `seller.street`), the value is written unchanged; a later release rejects it with 400.
- `additionalStreet` (string, optional, nullable) — Additional address line (BT-36 seller / BT-51 buyer / BT-65 tax representative). More than 200 characters: warning `FIELD_TOO_LONG` (field e.g. `seller.additionalStreet`), the value is written unchanged; a later release rejects it with 400.
- `addressLine3` (string, optional, nullable) — Third address line (BT-162 seller / BT-163 buyer / BT-164 tax representative).
- `city` (string, optional, nullable) — City. More than 100 characters: warning `FIELD_TOO_LONG` (field e.g. `seller.city`), the value is written unchanged; a later release rejects it with 400.
- `postalCode` (string, optional, nullable) — Postal code. More than 20 characters: warning `FIELD_TOO_LONG` (field e.g. `seller.postalCode`), the value is written unchanged; a later release rejects it with 400.
- `state` (string, optional, nullable) — State/region (ISO 3166-2). More than 100 characters: warning `FIELD_TOO_LONG` (field e.g. `seller.state`), the value is written unchanged; a later release rejects it with 400.
- `taxId` (string, optional, nullable) — National tax identification number. For the buyer, not transmitted in ZUGFeRD/Factur-X (only the VAT ID is); a warning is returned.
- `vatId` (string, optional, nullable) — VAT identification number with its country prefix (BT-31 seller / BT-48 buyer / BT-63 tax representative). EN 16931 (BR-CO-09) requires the prefix (ISO 3166-1 alpha-2, Greece `EL`). If the rulebook of the format reports BR-CO-09 and the value starts with a digit, the prefix of the party `countryCode` is added and the response carries the warning `VAT_ID_COUNTRY_PREFIX_ADDED` (field e.g. `buyer.vatId`). Formats without BR-CO-09 keep the value as sent.
- `registrationNumber` (string, optional, nullable) — Public register identifier of the party (BT-30 seller / BT-47 buyer) — Handelsregister, Firmenbuch, Companies House, … Rendered as `cac:PartyLegalEntity/cbc:CompanyID`. GENERIC field: until now every country read this from its own country-specific field (AT `tradeRegisterNumber`, FI `yTunnus`, …), so a business without a matching country block could not send its register number at all. Those fields keep working as a fallback.
- `registrationScheme` (string, optional, nullable) — ISO 6523 ICD code of the register (BT-30-1 / BT-47-1). 🔴 Only set this when the pinned ICD list actually carries a code for the register. The Austrian Firmenbuch has none — an invented code is FATAL per BR-CL-11.
- `identifiers` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceBuyerIdentifiersItems, optional, nullable) — Further party identifiers (BT-29 seller / BT-46 buyer / BT-60 payee), repeatable. Written by every EN 16931 format. UBL: `cac:PartyIdentification/cbc:ID` (with `schemeID` if set). CII (ZUGFeRD, Factur-X, XRechnung CII, …): entries with `schemeId` become `ram:GlobalID`, entries without become `ram:ID`. Seller: every entry is BT-29. Buyer: BT-46 occurs at most once. The first entry of `buyer.identifiers` is BT-46 and replaces the invoice `customerNumber`; `customerNumber` is then not written and the response carries the warning `FIELD_NOT_WRITTEN` (field `customerNumber`). Without buyer identifiers `customerNumber` stays BT-46. Further buyer entries are not written either (`FIELD_NOT_WRITTEN`, field `buyer.identifiers.<n>`). `vatId` is only BT-31 (`SpecifiedTaxRegistration`, scheme `VA`). One exception, XRechnung (DE), seller: if the seller has no `identifiers`, no legal registration (BT-30) and no written BT-31, BR-CO-26 still needs one of them. Then `vatId` (or else `taxId`) is written as BT-29, and the response carries the warning `SELLER_IDENTIFIER_DERIVED`. Payee: only the first non-empty entry of `payee.identifiers` becomes BT-60 (with its `schemeId`); further entries are not written (`FIELD_NOT_WRITTEN`, field `payee.identifiers.<n>`). Only without one does the payee `vatId` or `taxId` fill BT-60.
- `email` (string, optional, nullable) — Email address
- `phone` (string, optional, nullable) — Phone number
- `website` (string, optional, nullable) — Website URL
- `contact` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceBuyerContact, optional, nullable) — Structured contact person (BG-6 for seller, BG-9 for buyer)
- `bankAccount` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceBuyerBankAccount, optional, nullable) — Bank account (required on seller for SEPA bank transfers in ZUGFeRD/XRechnung). For direct debit (SEPA Lastschrift), buyer bankAccount is also required.
- `taxableRecipient` (boolean, optional, nullable) — Whether the buyer is a taxable person. Optional. Evaluated for Portugal only. If you leave it out, the API asks for the full buyer as before.

### InvoiceLineItemInput

- `description` (string, required) — Item description
- `quantity` (double, required) — Quantity (BT-129). Written to the XML with the decimals you send — at least two, at most what the target format allows (FatturaPA and TicketBAI 8, NAV 10, CIUS-PT 3). Negative values allowed for return/credit lines, EN 16931 BG-25. More decimals than the format allows are rounded to its limit, and `warnings` carries `QUANTITY_DECIMALS_ROUNDED` (`lossy: true`) with the field and the written value.
- `unit` (string, required) — Unit code (UN/ECE Rec 20)
- `unitPrice` (double, required) — Unit price, net (BT-146). Written to the XML with the decimals you send — at least two, at most what the target format allows. EN 16931 puts no limit on this field (unlike the document totals, which are capped at two decimals), so a price of 1.639 per litre stays 1.639. Formats with a documented limit are capped: FatturaPA 8 decimals, ebInterface 4. A capped price is rounded, and `warnings` carries `PRICE_DECIMALS_ROUNDED` (`lossy: true`) with the field and the written value. Use `priceBaseQuantity` (BT-149) when the price refers to a number of units other than one.
- `netAmount` (double, required) — Net amount (quantity * unitPrice)
- `taxAmount` (double, required) — Tax amount
- `position` (integer, optional, nullable) — Line item position number (BT-126 — zero-indexed line IDs are valid)
- `articleNumber` (string, optional, nullable) — Article/SKU number — the SELLER's item identifier (BT-155).
- `gtin` (string, optional, nullable) — Global Trade Item Number (BT-157). Rendered as `cac:StandardItemIdentification/cbc:ID` with `schemeID="0160"`.
- `itemDescription` (string, optional, nullable) — Longer item description (BT-154), IN ADDITION to `description` (BT-153, the item name). Not a duplicate: the name identifies the article, this describes it. When omitted, the generators repeat the name.
- `buyerItemId` (string, optional, nullable) — Item identifier assigned by the BUYER (BT-156). Lets the recipient book the line against his own item master without parsing the description text.
- `classification` (list of InvoiceLineItemInputClassificationItems, optional, nullable) — Item classifications (BT-158), repeatable — e.g. UNSPSC, eCl@ss, eTIM.
- `originCountry` (string, optional, nullable) — Country of origin of the item (BT-159, ISO 3166-1 alpha-2).
- `attributes` (list of InvoiceLineItemInputAttributesItems, optional, nullable) — Item attributes (BG-32), repeatable — name and value, both required.
- `note` (string, optional, nullable) — Free-text note for THIS line (BT-127).
- `objectId` (string, optional, nullable) — Object identifier of the line (BT-128) — e.g. a meter number or a ticket id. Rendered as `cac:DocumentReference` with `cbc:DocumentTypeCode` 130.
- `objectIdScheme` (string, optional, nullable) — Scheme of the object identifier (BT-128-1, UNTDID 1153).
- `orderLineReference` (string, optional, nullable) — Referenced purchase order line number (BT-132).
- `buyerAccountingReference` (string, optional, nullable) — Buyer's accounting reference / cost centre for this line (BT-133).
- `servicePeriod` (InvoiceLineItemInputServicePeriod, optional, nullable) — Service period of THIS line (BG-26, BT-134/135). A collective invoice spanning several months needs the period per line — on document level it would be wrong.
- `discount` (InvoiceLineItemInputDiscount, optional, nullable) — Line item discount (BT-136 to BT-138)
- `allowances` (list of InvoiceLineItemInputAllowancesItems, optional, nullable) — Line-level allowances / discounts (BG-27), repeatable. Rendered as `cac:InvoiceLine/cac:AllowanceCharge` with `cbc:ChargeIndicator=false` (UBL) resp. `ram:SpecifiedTradeAllowanceCharge` (CII). Use this instead of `discount` when the line carries more than one reduction or needs a coded reason (BT-140).
- `charges` (list of InvoiceLineItemInputChargesItems, optional, nullable) — Line-level charges / surcharges (BG-28), repeatable — e.g. packaging or an express surcharge. Rendered with `cbc:ChargeIndicator=true`. There is no `discount`-style short form for charges; this is the only way to express them.
- `grossPrice` (double, optional, nullable) — Item gross price (BT-148) — the list price BEFORE the price discount, as printed in the catalogue. Together with `priceDiscount` (BT-147) it documents how `unitPrice` (BT-146) came about: BT-147 = BT-148 − BT-146. Rendered as `cac:Price/cac:AllowanceCharge/cbc:BaseAmount`.
- `priceDiscount` (double, optional, nullable) — Item price discount (BT-147) — the reduction from `grossPrice` (BT-148) to `unitPrice` (BT-146). Affects the PRICE only; it does not change the line net amount, which is already computed from `unitPrice`. For a reduction that lowers the line total, use `allowances` (BG-27).
- `priceBaseQuantity` (double, optional, nullable) — Item price base quantity (BT-149) — the number of units `unitPrice` refers to. `unitPrice: 12, priceBaseQuantity: 100` means "12 per 100 pieces". Omitted means 1.
- `priceBaseUnit` (string, optional, nullable) — Unit of the price base quantity (BT-150, UN/ECE Rec 20). Defaults to the unit of the line (`unit`) when omitted.
- `taxRate` (double, optional, nullable) — Tax rate in percent (BT-152, 0..1). Required for every VAT category except "O" (Not subject to VAT), where EN 16931 BR-O-05 forbids it. Omit the field for category O; for every other category it stays mandatory.
- `taxCategoryCode` (string, optional, nullable) — Tax category code (EN 16931: S, Z, E, AE, K, G, O, ...)
- `taxExemptionReason` (string, optional, nullable) — Tax exemption reason free text (BT-120)
- `taxExemptionReasonCode` (string, optional, nullable) — Tax exemption reason code (BT-121, VATEX code)
- `grossAmount` (double, optional, nullable) — Gross amount (net + tax)
- `lineSubtype` (enum, optional) — Sub-line-item type (BT-X-8, ZUGFeRD 2.4 EXTENDED). DETAIL = included in totals, INFORMATION = info only, GROUP = sum of sub-items.
  - Allowed values: `DETAIL`, `INFORMATION`, `GROUP`
- `parentLineId` (string, optional, nullable) — Parent line item position reference (BT-X-304, for hierarchical line items)
- `perPackageQuantity` (double, optional, nullable) — Quantity per package unit (BT-X-561)
- `subItems` (list of InvoiceLineItemInput, optional, nullable) — Nested sub-line-items (BG-DEX-01, ZUGFeRD 2.4 EXTENDED hierarchy). Each entry has the same shape as a top-level item and may itself have subItems. Use `lineSubtype` (DETAIL/INFORMATION/GROUP) on each sub-item to control how it contributes to totals. At most 100 levels deep (400 `SUB_ITEMS_TOO_DEEP`). Sub-items count as lines: all lines together, top-level and nested, may not exceed 25000 (400 `TOO_MANY_INVOICE_LINES`).

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceTaxSummaryItems

- `netAmount` (double, required) — Net amount for this tax rate
- `taxAmount` (double, required) — Tax amount
- `taxRate` (double, optional, nullable) — Tax rate in percent (BT-119, 0..1). Required for every VAT category except "O" (Not subject to VAT), which carries no rate.
- `taxCategoryCode` (string, optional, nullable) — Tax category code
- `exemptionReason` (string, optional, nullable) — Tax exemption reason free text (BT-120)
- `exemptionReasonCode` (string, optional, nullable) — Tax exemption reason code (BT-121, VATEX code)
- `taxCurrencyTaxAmount` (double, optional, nullable) — Tax amount of this rate in the tax currency (invoice-level `taxCurrencyCode`, BT-6). Austria (ebInterface 6.1): if the invoice currency is not EUR, set `taxCurrencyCode` to "EUR" and give this amount for every rate, otherwise the call is rejected with 422 `AT_EBI_TAX_EUR_AMOUNT_REQUIRED` (rule AT-EBI61-011). No exchange rate is applied.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceServicePeriod

Service period (Leistungszeitraum, BG-14). Required in DE if different from issueDate. Send `start`, `end` or both (BR-CO-19); an empty object returns a 400. Formats whose schema requires both dates (ebInterface, Facturae) return a 400 `INVOICE_SERVICE_PERIOD_BOTH_DATES_REQUIRED` when one is missing; ISDOC has no invoicing period and reports `INVOICE_SERVICE_PERIOD_NOT_REPRESENTABLE` as a warning.

- `start` (string, optional, nullable) — Period start (BT-73, ISO 8601: YYYY-MM-DD)
- `end` (string, optional, nullable) — Period end (BT-74, ISO 8601: YYYY-MM-DD)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePayee

Payee (BG-10), if different from the seller. On the CH/LI QR bill (`qr-bill`) the payee is the creditor: postal code, city, country and its own bank account are required.

- `name` (string, optional, nullable) — Payee name (BT-59). Required by BR-17 when a payee is given.
- `tradingName` (string, optional, nullable) — Trading name (if different from legal name)
- `street` (string, optional, nullable) — Street address of the payee
- `additionalStreet` (string, optional, nullable) — Additional address line of the payee
- `addressLine3` (string, optional, nullable) — Third address line (BT-162 seller / BT-163 buyer / BT-164 tax representative).
- `city` (string, optional, nullable) — City of the payee. Required on the CH/LI QR bill (`qr-bill`): without it 422 `CH_ADDR_005`, field `payee.city`.
- `postalCode` (string, optional, nullable) — Postal code of the payee. Required on the CH/LI QR bill (`qr-bill`): without it 422 `CH_ADDR_004`, field `payee.postalCode`.
- `countryCode` (string, optional, nullable) — Country code of the payee (ISO 3166-1 alpha-2). Required on the CH/LI QR bill (`qr-bill`): without it 422 `CH_ADDR_006`, field `payee.countryCode`.
- `state` (string, optional, nullable) — State/region (ISO 3166-2). More than 100 characters: warning `FIELD_TOO_LONG` (field e.g. `seller.state`), the value is written unchanged; a later release rejects it with 400.
- `taxId` (string, optional, nullable) — National tax identification number. For the buyer, not transmitted in ZUGFeRD/Factur-X (only the VAT ID is); a warning is returned.
- `vatId` (string, optional, nullable) — VAT identification number with its country prefix (BT-31 seller / BT-48 buyer / BT-63 tax representative). EN 16931 (BR-CO-09) requires the prefix (ISO 3166-1 alpha-2, Greece `EL`). If the rulebook of the format reports BR-CO-09 and the value starts with a digit, the prefix of the party `countryCode` is added and the response carries the warning `VAT_ID_COUNTRY_PREFIX_ADDED` (field e.g. `buyer.vatId`). Formats without BR-CO-09 keep the value as sent.
- `registrationNumber` (string, optional, nullable) — Public register identifier of the payee (BT-61), for example a Handelsregister or Companies House number. Rendered as `cac:PartyLegalEntity/cbc:CompanyID` (UBL) and `ram:SpecifiedLegalOrganization/ram:ID` (CII).
- `registrationScheme` (string, optional, nullable) — ISO 6523 ICD code of the register (BT-30-1 / BT-47-1). 🔴 Only set this when the pinned ICD list actually carries a code for the register. The Austrian Firmenbuch has none — an invented code is FATAL per BR-CL-11.
- `identifiers` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePayeeIdentifiersItems, optional, nullable) — Payee identifiers (BT-60). Only the first non-empty entry is written; further entries give `FIELD_NOT_WRITTEN` (field `payee.identifiers.<n>`).
- `email` (string, optional, nullable) — Email address
- `phone` (string, optional, nullable) — Phone number
- `website` (string, optional, nullable) — Website URL
- `contact` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePayeeContact, optional, nullable) — Structured contact person (BG-6 for seller, BG-9 for buyer)
- `bankAccount` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePayeeBankAccount, optional, nullable) — The payee's own account. When set, it is the payment account (BT-84) in every format and the account of the QR bill, instead of `seller.bankAccount`. On the CH/LI QR bill (`qr-bill`) the payee is always the creditor, and creditor and account must match (SIX IG 4.3.1): a payee without its own account gets 422 `CH_IBAN_003`, field `payee.bankAccount.iban`.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePaymentTerms

Payment terms

- `dueDays` (double, optional, nullable) — Payment due in days
- `description` (string, optional, nullable) — Payment terms description
- `earlyPaymentDiscount` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePaymentTermsEarlyPaymentDiscount, optional, nullable) — Early payment discount (Skonto). E.g., 2% discount if paid within 10 days. Takes precedence over the top-level cashDiscount* fields when both are present.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePaymentMethodsItems

Payment method

- `type` (enum, required) — Payment method type. When `countrySpecific.paymentMeansCode` is not set, the first entry sets the payment means code (BT-81, UNTDID 4461) in XRechnung, ZUGFeRD and UBL/Peppol: direct_debit=49 (Direct debit), credit_card=54 (Credit card, only together with `cardAccount`), cash=10, paypal=68 (Online payment service), danish_fik=93 (DK Indbetalingskort FIK), giro=50 (DK postal giro), other=1. bank_transfer / credit_transfer keep the format default: 58 (SEPA credit transfer) in German formats, 30 (Credit transfer) elsewhere. If the target format rejects the derived code (for example 49 without `directDebitMandate`), the document keeps the default and carries the warning PAYMENT_MEANS_CODE_NOT_DERIVED. The same happens when the format would drop your payee account (BG-17) for the derived code (XRechnung and ZUGFeRD write it only for credit transfer). With a card or direct debit the code stays and the warning PAYEE_ACCOUNT_NOT_WRITTEN says the account was left out. credit_card without `cardAccount` carries CARD_ACCOUNT_REQUIRED. An explicit `countrySpecific.paymentMeansCode` always wins. Factur-X, Facturae and FatturaPA map the type with their own tables.
  - Allowed values: `bank_transfer`, `credit_transfer`, `direct_debit`, `credit_card`, `paypal`, `cash`, `danish_fik`, `giro`, `other`
- `details` (string, optional, nullable) — Additional details (e.g., "PayPal: invoice@example.com")

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceAllowancesChargesItems

Invoice-level allowance (discount) or charge (surcharge)

- `isCharge` (boolean, required) — true = surcharge (BG-21), false = discount/allowance (BG-20)
- `amount` (double, required) — Allowance/charge amount (BT-92 / BT-99)
- `percentage` (double, optional, nullable) — Percentage (BT-94 / BT-101) — alternative to fixed amount
- `baseAmount` (double, optional, nullable) — Base amount for percentage calculation (BT-93 / BT-100)
- `reason` (string, optional, nullable) — Reason text (BT-97 / BT-104)
- `reasonCode` (string, optional, nullable) — Reason code per UNTDID 5189 (allowance) / 7161 (charge) (BT-98 / BT-105)
- `taxCategoryCode` (string, optional, nullable) — Tax category code (BT-95 / BT-102)
- `taxRate` (double, optional, nullable) — Tax rate in percent (BT-96 / BT-103)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceDelivery

Delivery information (BG-13). Includes delivery date (BT-72), deliver-to name (BT-70), location identifier (BT-71), and delivery address (BG-15).

- `date` (string, optional, nullable) — Delivery date (BT-72, ISO 8601)
- `name` (string, optional, nullable) — Deliver-to party name (BT-70)
- `locationId` (string, optional, nullable) — Delivery location identifier (BT-71)
- `address` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceDeliveryAddress, optional, nullable) — Delivery address (BG-15)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceDirectDebitMandate

Direct debit mandate (BG-19). Send it with direct_debit: most formats (XRechnung, Peppol PEPPOL-EN16931-R061) require the mandate reference for payment means code 49 and 59.

- `mandateId` (string, required) — SEPA mandate reference (BT-89)
- `creditorId` (string, optional, nullable) — SEPA creditor identifier (BT-90, 0..1). Optional in EN 16931 — required only by national rules (BR-DE-30 for XRechnung, DE-R-030 for German suppliers in Peppol BIS), which are reported against the generated document.
- `debitAccountId` (string, optional, nullable) — Debited account IBAN (BT-91)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceCardAccount

Card payment details (BG-18). Set it together with a card payment means code (BT-81 = 48, 54 or 55). Formats that cannot represent the group report a GROUP_NOT_REPRESENTABLE warning instead of dropping it silently.

- `pan` (string, required) — BT-87 — masked card primary account number. BR-51 forbids the full PAN: PCI allows the first 6 and last 4 digits to be shown, so at most 10 digits — mask characters do not count towards that limit.
- `holderName` (string, optional, nullable) — BT-88 — name of the card holder
- `networkId` (string, optional, nullable) — Card network identifier (cbc:NetworkID; no EN 16931 business term)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceSupportingDocumentsItems

Reference to a supporting document without the file itself (BT-122/BT-123)

- `id` (string, required) — BT-122 — identifier of the supporting document
- `description` (string, optional, nullable) — BT-123 — description of the supporting document
- `registryId` (string, optional, nullable) — Registry/access-point identifier (cbc:UUID). Required in Oman for the prepayment document and for an export invoice with VATZR-OM-12 (IBR-013-OM).

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceRetention

Security retention. Reduces only the payment, never the totals or the VAT. Written as a sentence into the payment terms (BT-20 or the national equivalent) of every e-invoice format that has payment terms, in the language of the seller (machine-translated for FR, NL, IT, ES, PL; English for other languages). A reason you send is used as given and is not translated. Do not use allowancesCharges for it. Formats or profiles without payment terms (ZUGFeRD and Factur-X MINIMUM, and myDATA without a payment method) reject the request with 422 (RETENTION_NOT_CARRIED); a plain PDF is not affected.

- `amount` (double, required) — Retained amount. Reduces only the amount to pay, never the totals or the VAT.
- `percent` (double, optional, nullable) — Retention rate in percent, if you want it named in the sentence
- `baseAmount` (double, optional, nullable) — Amount the retention rate refers to, if it is not the invoice total
- `reason` (string, optional, nullable) — Reason for the retention. Written as sent, never translated.
- `dueDate` (date, optional, nullable) — Date the retained amount becomes due (ISO 8601: YYYY-MM-DD)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePrepaymentsItems

A single prepayment (BT-113 in detail)

- `amount` (double, required) — Amount already paid
- `paidAt` (string, optional, nullable) — Date the prepayment was received (ISO 8601: YYYY-MM-DD)
- `reference` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePrepaymentsItemsReference, optional, nullable) — Reference to the prepayment invoice

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceDeliveryNote

Despatch advice / delivery note reference (BT-16 / BT-17). Renders as `<cac:DespatchDocumentReference>` in UBL.

- `number` (string, required) — Despatch advice / delivery note number (BT-16).
- `date` (string, optional, nullable) — Despatch advice / delivery note date (BT-17, ISO 8601).

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceThirdPartyPaymentsItems

Third-party prepaid payment (BG-DEX-09 / BT-DEX-001..003, ZUGFeRD EXTENDED)

- `type` (string, required) — Third-party payment type identifier (BT-DEX-001). Free-form code chosen by the issuer (e.g., "voucher", "loyalty", "partial").
- `paidAmount` (double, required) — Amount already paid by the third party (BT-DEX-002).
- `description` (string, required) — Human-readable description of the third-party payment (BT-DEX-003).

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceAttachmentsItems

Supporting document (BG-24 / BT-122..125): embedded file, external reference, or both

- `filename` (string, optional, nullable) — Attachment filename (BT-125-2). Together with `mimeType` and `content`, or none of the three.
- `mimeType` (string, optional, nullable) — IANA media type of the attachment (BT-125-1). Together with `filename` and `content`, or none of the three.
- `content` (string, optional, nullable) — Base64-encoded binary content of the attachment (BT-125, 0..1). Send `content`, `mimeType` and `filename` together, or none of them for a reference without an embedded file (BT-122/BT-124). The whole request body is limited to 128 MiB (413 `PAYLOAD_TOO_LARGE` with `limit`); base64 adds a third, so all attachments together stay below about 95 MiB decoded. More than 20,971,520 base64 characters (15 MiB decoded) in one attachment, or more than 41,943,040 (30 MiB decoded) in all attachments together: warning `FIELD_TOO_LONG` (field `attachments[i].content` or `attachments[*].content`, `maximum` in characters); the invoice is processed unchanged, a later release rejects it with 400.
- `description` (string, optional, nullable) — Optional human-readable description of the attachment (BT-123).
- `reference` (string, optional, nullable) — Identifier of the supporting document (BT-122).
- `uri` (string, optional, nullable) — External location of the supporting document (BT-124). Rendered as `cac:Attachment/cac:ExternalReference/cbc:URI` (UBL) or `ram:URIID` (CII). A reference without an embedded file sends `uri` and/or `reference` and leaves out `content`, `mimeType` and `filename`.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceConstructionTax

German construction-tax block (§13b UStG / §48 EStG). Setting `exemptionCertificateNumber` triggers the `#FREISTELLUNG#` note in the generated invoice. `withholdingPercent` documents the Bauabzugsteuer rate.

- `exemptionCertificateNumber` (string, optional, nullable) — Freistellungsbescheinigung number per §48b EStG. When set, the generator emits a "#FREISTELLUNG#" note documenting the construction-withholding exemption.
- `withholdingPercent` (double, optional, nullable) — Construction withholding tax rate in percent (Bauabzugsteuer). Typically 15 in Germany when no Freistellungsbescheinigung is presented.
- `recipientTaxOffice` (string, optional, nullable) — Tax office responsible for the recipient of the construction service.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceCountrySpecific

Country-specific invoice data. Must include countryCode matching the invoice country. For DE: buyerReference (BT-10, required), paymentMeansCode (BT-81), leitwegId (B2G), isKleinunternehmer (§19 UStG). Other countries have their own fields — see country-specific documentation.

- `countryCode` (string, optional, nullable) — ISO 3166-1 alpha-2 country code identifying this country-specific block. Optional — when omitted it is taken from the country in the request path.
- `invoiceTypeCode` (string, optional, nullable) — BT-3 document type code, set explicitly. Takes precedence over `type` and is validated against the code list of the target format (and its conditions — e.g. Peppol permits 326/384 only when both parties are German). A code that contradicts `type` is rejected (HTTP 422) rather than silently resolved. Use this when your ERP already maps to UNTDID 1001 itself.
- `transactionType` (string, optional, nullable) — BTOM-001 Oman invoice transaction type — a 20-character binary mask carried as the `@name` attribute on the document type code. Positions (1-based): 1 full tax, 2 simplified, 3 self-billed, 4 third party, 5 summary, 6 continuous, 7 export, 8 deemed, 9 import RCM, 10 profit margin, 11 profit margin self-billed, 12 e-commerce, 13 import of goods, 14 special zone, 15 prepayment. When omitted the generator writes the standard tax invoice mask.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaEmailRecipientsItems1

- `email` (string, required) — Recipient address.
- `subject` (string, optional) — Subject of this recipient's mail (1–300 characters). Omitted: a default subject.
- `body` (string, optional) — Plain-text body of this recipient's mail (1–10000 characters), sent as text, never as HTML. Omitted: a default text.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplate

**Option C** — inline a complete BlockTemplate JSON object in the request. Only used for PDF-based formats (`pdf`, `zugferd`, `facturx`). **Priority:** `templateId` > `formatOptions.template` > the built-in template for the invoice's country > a generic fallback. If all three are omitted, the invoice gets the layout of ITS OWN country — a German invoice gets the German template. Only countries without their own template fall back to the generic "System Template Standard". A BlockTemplate is a JSON document with the top-level fields `version`, `name`, `page` (size, margins, colorScheme, fontSizes), `header`, `body.blocks`, `footer`, and optional `styles`. The `body.blocks` array contains typed blocks: `text`, `table`, `keyvalue`, `columns`, `summary`, `image`, `spacer`, `line`, `qrcode`, `pageBreak`, `watermark`, `barcode`. Use placeholders like `{{buyer.name}}`, `{{invoiceNumber}}`, `{{items}}`, `{{total}}`, `{{paymentTerms.dueDays}}` — they are resolved from the Invoice data at generation time. A trailing `?` (e.g. `{{buyer.street?}}`) marks a placeholder as optional. See the `withInlineTemplate` example in the Examples dropdown for a full, working template (the generic "System Template Standard").

- `version` (string, required) — Template version (semver, e.g., 1.0.0)
- `name` (string, required) — Template name
- `page` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplatePage, required) — Page configuration
- `body` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBody, required) — Body section (main content)
- `header` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeader, optional) — Header section (on every page unless repeatOnAllPages is false)
- `footer` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooter, optional) — Footer section (last page only unless repeatOnAllPages is true)
- `styles` (map from string to ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateStyles, optional) — Named styles, referenced by blocks via the style property
- `lengthUnit` (enum, optional) — Unit for every spatial value in the template (page margins, block widths/heights, gaps, paddings, spacer heights). ALWAYS SET THIS. When omitted the template is rendered in legacy mode: page margins and spacer heights are read as millimetres, all other lengths as points. Font sizes are always points. Section heights (header/footer) are always millimetres.
  - Allowed values: `pt`, `mm`, `inch`

### ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaValidationResultsItems

- `format` (string, required) — Spec format-id that was validated (e.g. zugferd-2.4-en16931)
- `valid` (boolean, required, nullable) — Whether the generated XML passed XSD + Schematron: `true` passed, `false` failed, `null` when the rulebook did not run (then the check says nothing about the document).
- `errors` (list of ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaValidationResultsItemsErrorsItems, required) — XSD structural + Schematron business-rule findings
- `warnings` (list of ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaValidationResultsItemsWarningsItems, optional) — Findings that do not fail the format, e.g. `TAX_EXEMPTION_REASON_SUBSTITUTED` when a category default was written for a missing exemption reason. `ALLOWANCE_TAX_CATEGORY_REQUIRED` (rule `BR-32`, `field` e.g. `allowancesCharges.0.taxCategoryCode`) is an allowance or charge without a tax category during its warning phase, next to `SPEC_RULE_PENDING` with `enforceFrom`; from that date it is an error. The EN 16931 finding `BR-32` itself stays in `errors` as before — the warning phase covers only our own check. `VAT_ID_COUNTRY_PREFIX_ADDED` (rule `BR-CO-09`, `field` e.g. `buyer.vatId`): the country prefix was added before the check, see `vatIdErgaenzt`. Absent when the check wrote none.
- `vatIdErgaenzt` (list of ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaValidationResultsItemsVatIdErgaenztItems, optional) — VAT identifiers that were sent without their country prefix and checked with it (BR-CO-09), one entry per field. Absent when nothing was added.
- `skipped` (string, optional) — Present only when this format was NOT checked. `not entitled` means the API key holds no `create` entitlement for the format; `valid` is then `false` in the sense of "not proven valid", not "failed a rule".

### ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaValidationErrorsItems

- `code` (string, required) — Rule identifier of the finding (Schematron rule ID, `XSD-ERROR`, …)
- `message` (string, required) — Human-readable finding text
- `enforceFrom` (string, optional) — A finding still in its warning phase (`SPEC_RULE_PENDING` in `warnings`): the date (`YYYY-MM-DD`, UTC) from which it is rejected with 422. It is listed here as an error all the same — the document is not conformant.
- `pendingKey` (string, optional) — With `enforceFrom`, when the finding carries no rule identifier: its technical key (not a rule identifier).

### ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaErrorsItemsCode

Stable house code identifying the check (e.g. `DE_SELLER_CITY_001`, `NL_PAYMENT_MEANS_REQUIRED`, or `SPEC_RULE_FAILED` when a conformance gate objected). Never a standard rule identifier — look those up in `rule`. Safe to match on: it does not change when a rule is re-identified.

- enum
  - Allowed values: `DE_AC_001`, `DE_AC_002`, `DE_BIC_INVALID`, `DE_BR_AE_02`, `DE_BR_AE_03`, `DE_BR_DE_16`, `DE_BR_DEX_04`, `DE_BR_DEX_05`, `DE_BR_DEX_06`, `DE_BR_DEX_07`, `DE_BR_DEX_08`, `DE_BR_K_02`, `DE_BR_K_04`, `DE_BR_K_05`, `DE_BR_O_01`, `DE_BR_O_02`, `DE_BR_O_05`, `DE_BUYER_IBAN_001`, `DE_BUYER_IBAN_REQUIRED`, `DE_CREDITOR_ID_INVALID`, `DE_CREDITOR_ID_REQUIRED`, `DE_DLV_001`, `DE_INV_NUM_NOT_SEQUENTIAL`, `DE_INV_NUM_REQUIRED`, `DE_INV_NUM_SPECIAL_CHARS`, `DE_INV_NUM_TOO_LONG`, `DE_KU_001`, `DE_KU_002`, `DE_LW_002`, `DE_MANDATE_ID_REQUIRED`, `DE_MANDATE_ID_TOO_LONG`, `DE_REF_001`, `DE_REF_002`, `DE_SELLER_CONTACT_001`, `DE_SELLER_IBAN_FORMAT`, `DE_SELLER_IBAN_INVALID`, `DE_SEPA_003`, `DE_VAT_001`, `GR_AFM_001`, `GR_AFM_002`, `GR_CREDIT_NOTE_MISSING_MARK`, `GR_GEN_001`, `GR_INV_001`, `GR_INV_002`, `GR_INV_NUM_REQUIRED`, `GR_PDF_001`, `GR_PDF_002`
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaWarningsItemsCode

Stable house code identifying the check (e.g. `DE_SELLER_CITY_001`, `NL_PAYMENT_MEANS_REQUIRED`, or `SPEC_RULE_FAILED` when a conformance gate objected). Never a standard rule identifier — look those up in `rule`. Safe to match on: it does not change when a rule is re-identified.

- enum
  - Allowed values: `DE_AC_001`, `DE_AC_002`, `DE_BIC_INVALID`, `DE_BR_AE_02`, `DE_BR_AE_03`, `DE_BR_DE_16`, `DE_BR_DEX_04`, `DE_BR_DEX_05`, `DE_BR_DEX_06`, `DE_BR_DEX_07`, `DE_BR_DEX_08`, `DE_BR_K_02`, `DE_BR_K_04`, `DE_BR_K_05`, `DE_BR_O_01`, `DE_BR_O_02`, `DE_BR_O_05`, `DE_BUYER_IBAN_001`, `DE_BUYER_IBAN_REQUIRED`, `DE_CREDITOR_ID_INVALID`, `DE_CREDITOR_ID_REQUIRED`, `DE_DLV_001`, `DE_INV_NUM_NOT_SEQUENTIAL`, `DE_INV_NUM_REQUIRED`, `DE_INV_NUM_SPECIAL_CHARS`, `DE_INV_NUM_TOO_LONG`, `DE_KU_001`, `DE_KU_002`, `DE_LW_002`, `DE_MANDATE_ID_REQUIRED`, `DE_MANDATE_ID_TOO_LONG`, `DE_REF_001`, `DE_REF_002`, `DE_SELLER_CONTACT_001`, `DE_SELLER_IBAN_FORMAT`, `DE_SELLER_IBAN_INVALID`, `DE_SEPA_003`, `DE_VAT_001`, `GR_AFM_001`, `GR_AFM_002`, `GR_CREDIT_NOTE_MISSING_MARK`, `GR_GEN_001`, `GR_INV_001`, `GR_INV_002`, `GR_INV_NUM_REQUIRED`, `GR_PDF_001`, `GR_PDF_002`
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaOneOf1LineItems

- `count` (double, required) — Number of top-level line items in the request (subItems not counted)
- `limit` (double, required) — Line items per invoice allowed by your plan

### ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaOneOf2ErrorItems

- `code` (string, required) — Rule that failed, e.g. `too_big`, `invalid_type`, `invalid_value`.
- `path` (list of ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaOneOf2ErrorItemsPathItems, required) — Path of the field in the request body, e.g. `["invoice", "seller", "name"]`.
- `message` (string, required)
- `maximum` (double, optional)
- `minimum` (double, optional)
- `inclusive` (boolean, optional)
- `origin` (string, optional)
- `expected` (string, optional)
- `values` (list of any, optional)
- `keys` (list of string, optional)
- `format` (string, optional)

### ValidationHint

Added to the 400 of the input check when `invoice` is not an invoice object in the Unified format. It only adds information: status, `error` and `success` are the same as without it. Branch on `code`, not on `message`.

- `code` (enum, required) — `BODY_NOT_JSON`: the body is not JSON. `INVOICE_MISSING`: there is no `invoice` object. `INVOICE_LOOKS_LIKE_XML`: `invoice` (or another field) holds XML. `INVOICE_NOT_UNIFIED`: `invoice` has none of the fields of the Unified format.
  - Allowed values: `BODY_NOT_JSON`, `INVOICE_MISSING`, `INVOICE_LOOKS_LIKE_XML`, `INVOICE_NOT_UNIFIED`
- `message` (string, required) — One sentence in English, at most 200 characters.
- `next` (list of string, optional) — The routes to call instead, in order. Set for `BODY_NOT_JSON` and `INVOICE_LOOKS_LIKE_XML`.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceSellerIdentifiersItems

Party identifier with optional scheme (BT-29 / BT-46)

- `id` (string, required) — Identifier of the party (BT-29 seller / BT-46 buyer).
- `schemeId` (string, optional, nullable) — Identification scheme of the identifier (BT-29-1 / BT-46-1, ISO 6523 ICD).

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceSellerContact

Structured contact person (BG-6 for seller, BG-9 for buyer)

- `name` (string, optional, nullable) — Contact person name
- `phone` (string, optional, nullable) — Contact phone number
- `email` (string, optional, nullable) — Contact email address
- `department` (string, optional, nullable) — Department of the contact person (BT-41-0 seller / BT-56-0 buyer). In ZUGFeRD/Factur-X only one of name or department is transmitted; if both are set, the name is used and a warning is returned.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceSellerBankAccount

Bank account (required on seller for SEPA bank transfers in ZUGFeRD/XRechnung). For direct debit (SEPA Lastschrift), buyer bankAccount is also required.

- `iban` (string, required) — IBAN (International Bank Account Number)
- `bic` (string, optional, nullable) — BIC/SWIFT code (8 or 11 characters)
- `bankName` (string, optional, nullable) — Name of the bank
- `accountHolder` (string, optional, nullable) — Account holder name (if different from party name)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceBuyerIdentifiersItems

Party identifier with optional scheme (BT-29 / BT-46)

- `id` (string, required) — Identifier of the party (BT-29 seller / BT-46 buyer).
- `schemeId` (string, optional, nullable) — Identification scheme of the identifier (BT-29-1 / BT-46-1, ISO 6523 ICD).

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceBuyerContact

Structured contact person (BG-6 for seller, BG-9 for buyer)

- `name` (string, optional, nullable) — Contact person name
- `phone` (string, optional, nullable) — Contact phone number
- `email` (string, optional, nullable) — Contact email address
- `department` (string, optional, nullable) — Department of the contact person (BT-41-0 seller / BT-56-0 buyer). In ZUGFeRD/Factur-X only one of name or department is transmitted; if both are set, the name is used and a warning is returned.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceBuyerBankAccount

Bank account (required on seller for SEPA bank transfers in ZUGFeRD/XRechnung). For direct debit (SEPA Lastschrift), buyer bankAccount is also required.

- `iban` (string, required) — IBAN (International Bank Account Number)
- `bic` (string, optional, nullable) — BIC/SWIFT code (8 or 11 characters)
- `bankName` (string, optional, nullable) — Name of the bank
- `accountHolder` (string, optional, nullable) — Account holder name (if different from party name)

### InvoiceLineItemInputClassificationItems

Item classification (BT-158)

- `id` (string, required) — Classification code of the item (BT-158).
- `schemeId` (string, required) — Identification scheme of the classification code (BT-158-1, UNTDID 7143).
- `schemeVersion` (string, optional, nullable) — Version of the identification scheme (BT-158-2).

### InvoiceLineItemInputAttributesItems

Item attribute (BG-32)

- `name` (string, required) — Name of the item attribute (BT-160).
- `value` (string, required) — Value of the item attribute (BT-161).

### InvoiceLineItemInputServicePeriod

Service period of THIS line (BG-26, BT-134/135). A collective invoice spanning several months needs the period per line — on document level it would be wrong.

- `start` (string, optional, nullable) — Line service period start (BT-134, ISO 8601 YYYY-MM-DD).
- `end` (string, optional, nullable) — Line service period end (BT-135, ISO 8601 YYYY-MM-DD).

### InvoiceLineItemInputDiscount

Line item discount (BT-136 to BT-138)

- `type` (enum, optional) — Discount type: percentage or absolute amount
  - Allowed values: `percentage`, `absolute`
- `value` (double, optional, nullable) — Discount value
- `reason` (string, optional, nullable) — Discount reason (BT-139)

### InvoiceLineItemInputAllowancesItems

Line-level allowance (BG-27) or charge (BG-28)

- `amount` (double, required) — Amount of the allowance/charge (BT-136 / BT-141), in the invoice currency.
- `baseAmount` (double, optional, nullable) — Base amount the percentage applies to (BT-137 / BT-142).
- `percentage` (double, optional, nullable) — Percentage of the allowance/charge (BT-138 / BT-143).
- `reason` (string, optional, nullable) — Reason for the allowance/charge in clear text (BT-139 / BT-144).
- `reasonCode` (string, optional, nullable) — Coded reason for the allowance (BT-140, UNCL 5189) resp. the charge (BT-145, UNCL 7161). Several CIUS require the code when the reason is codeable.

### InvoiceLineItemInputChargesItems

Line-level allowance (BG-27) or charge (BG-28)

- `amount` (double, required) — Amount of the allowance/charge (BT-136 / BT-141), in the invoice currency.
- `baseAmount` (double, optional, nullable) — Base amount the percentage applies to (BT-137 / BT-142).
- `percentage` (double, optional, nullable) — Percentage of the allowance/charge (BT-138 / BT-143).
- `reason` (string, optional, nullable) — Reason for the allowance/charge in clear text (BT-139 / BT-144).
- `reasonCode` (string, optional, nullable) — Coded reason for the allowance (BT-140, UNCL 5189) resp. the charge (BT-145, UNCL 7161). Several CIUS require the code when the reason is codeable.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePayeeIdentifiersItems

- `id` (string, optional, nullable) — Identifier of the payee (BT-60). Empty entries are skipped.
- `schemeId` (string, optional, nullable) — Identification scheme of the identifier (BT-29-1 / BT-46-1, ISO 6523 ICD).

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePayeeContact

Structured contact person (BG-6 for seller, BG-9 for buyer)

- `name` (string, optional, nullable) — Contact person name
- `phone` (string, optional, nullable) — Contact phone number
- `email` (string, optional, nullable) — Contact email address
- `department` (string, optional, nullable) — Department of the contact person (BT-41-0 seller / BT-56-0 buyer). In ZUGFeRD/Factur-X only one of name or department is transmitted; if both are set, the name is used and a warning is returned.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePayeeBankAccount

The payee's own account. When set, it is the payment account (BT-84) in every format and the account of the QR bill, instead of `seller.bankAccount`. On the CH/LI QR bill (`qr-bill`) the payee is always the creditor, and creditor and account must match (SIX IG 4.3.1): a payee without its own account gets 422 `CH_IBAN_003`, field `payee.bankAccount.iban`.

- `iban` (string, required) — IBAN (International Bank Account Number)
- `bic` (string, optional, nullable) — BIC/SWIFT code (8 or 11 characters)
- `bankName` (string, optional, nullable) — Name of the bank
- `accountHolder` (string, optional, nullable) — Account holder name (if different from party name)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePaymentTermsEarlyPaymentDiscount

Early payment discount (Skonto). E.g., 2% discount if paid within 10 days. Takes precedence over the top-level cashDiscount* fields when both are present.

- `days` (integer, required) — Discount valid within this many days (integer, 0..365)
- `discountPercent` (double, required) — Discount percentage (Skonto) — > 0, \<= 100, at most two decimals
- `baseAmount` (double, optional, nullable) — Optional base amount the discount is computed from, when it is not the payable amount (BT-115) — e.g. a partial amount on German construction invoices with retention. Emitted as the BASISBETRAG segment of the XRechnung #SKONTO# line (BR-DE-18). Omit it when the discount applies to the full payable amount.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoiceDeliveryAddress

Delivery address (BG-15)

- `street` (string, optional, nullable) — Delivery street (BT-75)
- `additionalStreet` (string, optional, nullable) — Additional delivery address line (BT-76)
- `city` (string, optional, nullable) — Delivery city (BT-77)
- `postalCode` (string, optional, nullable) — Delivery postal code (BT-78)
- `state` (string, optional, nullable) — Delivery state/region (BT-79). More than 100 characters: warning `FIELD_TOO_LONG` (field `delivery.address.state`), the value is written unchanged; a later release rejects it with 400.
- `addressLine3` (string, optional, nullable) — Third delivery address line (BT-165)
- `countryCode` (string, optional, nullable) — Delivery country code (BT-80)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaInvoicePrepaymentsItemsReference

Reference to the prepayment invoice

- `documentNumber` (string, required) — Invoice number of the prepayment document
- `registryId` (string, optional, nullable) — Registry/access-point identifier of the prepayment document. Required in Oman (IBR-011-OM); the country gate says when.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplatePage

Page configuration

- `size` (enum, required) — Page size (use CUSTOM with customWidth/customHeight)
  - Allowed values: `A4`, `A3`, `A5`, `LETTER`, `LEGAL`, `CUSTOM`
- `margins` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplatePageMargins, required) — Page margins
- `orientation` (enum, optional) — Page orientation
  - Allowed values: `portrait`, `landscape`
- `customWidth` (double, optional) — Custom page width in mm (only for CUSTOM size)
- `customHeight` (double, optional) — Custom page height in mm (only for CUSTOM size)
- `defaultFont` (string, optional) — Default font family for the document
- `colorScheme` (map from string to string, optional) — Named color tokens (e.g., \{ primaryColor: "#47c918", textColor: "#000000" })
- `fontSizes` (map from string to double, optional) — Named font size tokens (e.g., \{ textSize: 10, headingSize: 14 })
- `background` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplatePageBackground, optional) — Background image configuration

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBody

Body section (main content)

- `blocks` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems, required) — Content blocks

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeader

Header section (on every page unless repeatOnAllPages is false)

- `blocks` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems, required) — Blocks in this section; \{\{page.current}} and \{\{page.total}} resolve here
- `height` (double, optional) — Section height in mm (header/footer). Section heights are always mm, regardless of lengthUnit.
- `repeatOnAllPages` (boolean, optional) — Repeat the header on every page (default: true). false = printed once, at the top of the first page.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooter

Footer section (last page only unless repeatOnAllPages is true)

- `blocks` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems, required) — Blocks in this section; \{\{page.current}} and \{\{page.total}} resolve here
- `height` (double, optional) — Section height in mm (header/footer). Section heights are always mm, regardless of lengthUnit.
- `repeatOnAllPages` (boolean, optional) — Repeat the footer on every page (default: false). Without it the footer appears on the last page only.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateStyles

Named style configuration

- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateStylesFontSize, optional) — Font size in points or token
- `bold` (boolean, optional) — Bold text
- `italics` (boolean, optional) — Italic text
- `color` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateStylesColor, optional) — Text color (hex or token)
- `alignment` (enum, optional) — Text alignment
  - Allowed values: `left`, `center`, `right`, `justify`
- `margin` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateStylesMargin, optional) — Margin in points: number | [h, v] | [left, top, right, bottom]
- `lineHeight` (double, optional) — Line height multiplier
- `font` (string, optional) — Font family name

### ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaValidationResultsItemsErrorsItems

- `ruleId` (string, required) — Rule identifier of the finding — a Schematron rule ID (e.g. BR-DE-6, PEPPOL-EN16931-R010), `XSD-ERROR` for a structural schema violation, or `VAL-SYS-005` when the generator/validator threw before any rule fired. A Schematron check without its own ID carries one of our identifiers instead: `SCHEMATRON_ASSERT_WITHOUT_ID` (a failed assert), `SCHEMATRON_REPORT_WITHOUT_ID` (a fired report) or `RULE_ID_MISSING` (only when a rulebook gave an empty ID; the message then carries the rulebook text). A finding of our own pre-check carries its house code here, the same value as `hausCode`. `UNKNOWN` is no longer used.
- `message` (string, required) — Human-readable finding text
- `hausCode` (string, optional) — Present when the finding comes from our own pre-check instead of a rulebook: our code (e.g. `DE_SELLER_CONTACT_001`). `ruleId` then carries the same value.
- `rule` (string, optional) — The standard rule a house finding enforces (e.g. `BR-DE-2`). Absent when no rule of the standard stands behind it.
- `field` (string, optional) — Path of the input field the finding is about, when known (e.g. `seller.contact`).

### ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaValidationResultsItemsWarningsItems

- `ruleId` (string, required) — Rule identifier or house code of the warning
- `message` (string, required) — Human-readable warning text
- `hausCode` (string, optional) — Our code, when the warning comes from our own check
- `rule` (string, optional) — The standard rule behind it, if any
- `field` (string, optional) — Path of the input field the warning is about

### ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaValidationResultsItemsVatIdErgaenztItems

- `field` (string, required) — Path of the VAT identifier in the input, e.g. `buyer.vatId`
- `vatId` (string, required) — The value as checked and written, with its country prefix

### ApiV1InvoiceCountryCodeFormatGeneratePostResponsesContentApplicationJsonSchemaOneOf2ErrorItemsPathItems

- string
- double

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplatePageMargins

Page margins

- `top` (double, required) — Top margin in the template lengthUnit (mm when lengthUnit is omitted)
- `right` (double, required) — Right margin in the template lengthUnit (mm when lengthUnit is omitted)
- `bottom` (double, required) — Bottom margin in the template lengthUnit (mm when lengthUnit is omitted)
- `left` (double, required) — Left margin in the template lengthUnit (mm when lengthUnit is omitted)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplatePageBackground

Background image configuration

- `image` (string, optional) — Base64 encoded image or URL
- `opacity` (double, optional) — Opacity (0-1)
- `position` (enum, optional) — Position mode
  - Allowed values: `stretch`, `center`, `tile`

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems

Template block (text | table | columns | keyvalue | summary | image | spacer | line | qrcode | pageBreak | watermark | barcode). The renderer knows further block types that this API does not accept: bordered, chart, formField, repeater, toc — such a block in header, body or footer is rejected with 400.

- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems0
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems2
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems3
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems4
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems5
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems6
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems7
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems8
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems9
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems10
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems11

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems

Template block (text | table | columns | keyvalue | summary | image | spacer | line | qrcode | pageBreak | watermark | barcode). The renderer knows further block types that this API does not accept: bordered, chart, formField, repeater, toc — such a block in header, body or footer is rejected with 400.

- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems0
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems2
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems3
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems4
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems5
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems6
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems7
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems8
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems9
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems10
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems11

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems

Template block (text | table | columns | keyvalue | summary | image | spacer | line | qrcode | pageBreak | watermark | barcode). The renderer knows further block types that this API does not accept: bordered, chart, formField, repeater, toc — such a block in header, body or footer is rejected with 400.

- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems0
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems2
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems3
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems4
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems5
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems6
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems7
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems8
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems9
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems10
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems11

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateStylesFontSize

Font size in points or token

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateStylesFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateStylesColor

Text color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateStylesColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateStylesMargin

Margin in points: number | [h, v] | [left, top, right, bottom]

- list of any
- list of any
- double

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems0

Text block

- `type` ("text", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf0Data, required)
- `condition` (string, optional) — Conditional rendering: block is only rendered when the placeholder resolves to a non-empty value. Use any scalar placeholder, e.g., \{\{notes}}, \{\{deliveryDate}}, \{\{buyer.taxId}}.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems1

Vertical spacer block

- `type` ("spacer", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf1Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems2

Horizontal line block

- `type` ("line", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf2Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems3

Image block

- `type` ("image", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf3Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems4

Key-value pairs block

- `type` ("keyvalue", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf4Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems5

Data-bound table block

- `type` ("table", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems6

Summary block for totals (subtotal, tax, total)

- `type` ("summary", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems7

QR code block

- `type` ("qrcode", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf7Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems8

Page break block: the following blocks start on a new page

- `type` ("pageBreak", required)
- `condition` (string, optional)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf8Data, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems9

Watermark block

- `type` ("watermark", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf9Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems10

Barcode block (one-dimensional or Data Matrix)

- `type` ("barcode", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf10Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItems11

Multi-column layout block

- `type` ("columns", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf11Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems0

Text block

- `type` ("text", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf0Data, required)
- `condition` (string, optional) — Conditional rendering: block is only rendered when the placeholder resolves to a non-empty value. Use any scalar placeholder, e.g., \{\{notes}}, \{\{deliveryDate}}, \{\{buyer.taxId}}.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems1

Vertical spacer block

- `type` ("spacer", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf1Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems2

Horizontal line block

- `type` ("line", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf2Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems3

Image block

- `type` ("image", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf3Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems4

Key-value pairs block

- `type` ("keyvalue", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf4Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems5

Data-bound table block

- `type` ("table", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems6

Summary block for totals (subtotal, tax, total)

- `type` ("summary", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems7

QR code block

- `type` ("qrcode", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf7Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems8

Page break block: the following blocks start on a new page

- `type` ("pageBreak", required)
- `condition` (string, optional)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf8Data, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems9

Watermark block

- `type` ("watermark", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf9Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems10

Barcode block (one-dimensional or Data Matrix)

- `type` ("barcode", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf10Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItems11

Multi-column layout block

- `type` ("columns", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf11Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems0

Text block

- `type` ("text", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf0Data, required)
- `condition` (string, optional) — Conditional rendering: block is only rendered when the placeholder resolves to a non-empty value. Use any scalar placeholder, e.g., \{\{notes}}, \{\{deliveryDate}}, \{\{buyer.taxId}}.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems1

Vertical spacer block

- `type` ("spacer", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf1Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems2

Horizontal line block

- `type` ("line", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf2Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems3

Image block

- `type` ("image", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf3Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems4

Key-value pairs block

- `type` ("keyvalue", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf4Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems5

Data-bound table block

- `type` ("table", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems6

Summary block for totals (subtotal, tax, total)

- `type` ("summary", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems7

QR code block

- `type` ("qrcode", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf7Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems8

Page break block: the following blocks start on a new page

- `type` ("pageBreak", required)
- `condition` (string, optional)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf8Data, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems9

Watermark block

- `type` ("watermark", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf9Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems10

Barcode block (one-dimensional or Data Matrix)

- `type` ("barcode", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf10Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItems11

Multi-column layout block

- `type` ("columns", required)
- `data` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf11Data, required)
- `condition` (string, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateStylesFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateStylesColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf0Data

- `content` (string, required) — Text content with optional placeholders resolved from Invoice data. Available placeholders: \{\{invoiceNumber}}, \{\{type}}, \{\{issueDate}}, \{\{dueDate}}, \{\{deliveryDate}}, \{\{currency}}, \{\{seller.name}}, \{\{seller.street}}, \{\{seller.postalCode}}, \{\{seller.city}}, \{\{seller.countryCode}}, \{\{seller.taxId}}, \{\{seller.vatId}}, \{\{seller.email}}, \{\{seller.phone}}, \{\{buyer.name}}, \{\{buyer.street}}, \{\{buyer.postalCode}}, \{\{buyer.city}}, \{\{buyer.countryCode}}, \{\{buyer.taxId}}, \{\{buyer.vatId}}, \{\{buyer.email}}, \{\{buyer.phone}}, \{\{subtotal}}, \{\{total}}, \{\{notes}}, \{\{paymentTerms.dueDays}}, \{\{paymentTerms.description}}. For array data (items, taxSummary) use a table block with dataSource instead. Page numbers: \{\{page.current}} and \{\{page.total}} resolve only in header and footer blocks (not in the body). A block whose content resolves to whitespace only renders nothing (it is dropped, no gap) — use a spacer block for vertical space.
- `style` (string, optional) — Reference to a named style
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf0DataFontSize, optional) — Font size in points or token
- `fontFamily` (string, optional) — Font family (overrides document default)
- `bold` (boolean, optional) — Bold text
- `italic` (boolean, optional) — Italic text
- `italics` (boolean, optional) — Italic text (alias)
- `color` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf0DataColor, optional) — Text color (hex or token)
- `hideMode` (enum, optional) — Hide block when placeholders are empty
  - Allowed values: `anyEmpty`, `allEmpty`
- `alignment` (enum, optional) — Text alignment
  - Allowed values: `left`, `center`, `right`, `justify`
- `margin` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf0DataMargin, optional) — Margin in the template lengthUnit (points when lengthUnit is omitted): number | [h, v] | [left, top, right, bottom]

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf1Data

- `height` (double, required) — Height in the template lengthUnit. Legacy: when lengthUnit is omitted, spacer heights are read as mm.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf2Data

- `color` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf2DataColor, optional) — Line color (hex or token)
- `thickness` (double, optional) — Line thickness in the template lengthUnit (points when lengthUnit is omitted)
- `margin` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf2DataMargin, optional) — Margin in the template lengthUnit (points when lengthUnit is omitted): number | [h, v] | [left, top, right, bottom]

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf3Data

- `src` (string, required) — Image source: placeholder (e.g., \{\{logo}} for company logo), base64-encoded data URI (data:image/png;base64,...), or HTTPS URL. When using a placeholder, the image must be provided in the Invoice data under that key.
- `width` (double, optional) — Width in the template lengthUnit (points when lengthUnit is omitted)
- `height` (double, optional) — Height in the template lengthUnit (points when lengthUnit is omitted)
- `fit` (list of any, optional) — Fit into [width, height] box, both in the template lengthUnit (points when lengthUnit is omitted)
- `alignment` (enum, optional) — Alignment
  - Allowed values: `left`, `center`, `right`

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf4Data

- `items` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf4DataItemsItems, required) — Key-value items
- `layout` (enum, optional) — Layout direction (default: vertical)
  - Allowed values: `vertical`, `horizontal`, `inline`
- `labelStyle` (string, optional) — Named style for labels
- `valueStyle` (string, optional) — Named style for values
- `valueAlignment` (enum, optional) — Value alignment (vertical layout)
  - Allowed values: `left`, `center`, `right`
- `labelNoWrap` (boolean, optional)
- `valueNoWrap` (boolean, optional)
- `widths` (list of any, optional) — Column widths: [labelWidth, valueWidth]; numbers in the template lengthUnit (points when lengthUnit is omitted)
- `labelWidth` (double, optional) — Label width in the template lengthUnit (points when lengthUnit is omitted)
- `labelBold` (boolean, optional) — Bold labels
- `labelColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf4DataLabelColor, optional) — Label text color (hex or token)
- `valueColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf4DataValueColor, optional) — Value text color (hex or token)
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf4DataFontSize, optional) — Font size for label and value (or token)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5Data

- `dataSource` (string, required) — Placeholder for array binding: any data path that resolves to an array. Use \{\{items}} for invoice line items or \{\{taxSummary}} for tax breakdown; an array you send yourself in the invoice under your own key works too, e.g. \{\{myRows}} for invoice.myRows. Fields available in \{\{items}}: position, description, articleNumber, quantity, unit, unitPrice, taxRate, taxCategoryCode, netAmount, taxAmount, grossAmount. Fields available in \{\{taxSummary}}: taxRate, taxCategoryCode, netAmount, taxAmount. Reference these fields in column definitions via the "field" property.
- `columns` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataColumnsItems, required) — Column definitions
- `repeatHeader` (boolean, optional) — Repeat header on each page
- `dontBreakRows` (boolean, optional) — Don't break rows across pages
- `headerStyle` (string, optional) — Named style for header row
- `bodyStyle` (string, optional) — Named style for body rows
- `layout` (enum, optional) — Table border layout (default: with borders)
  - Allowed values: `noBorders`, `headerLineOnly`, `lightHorizontalLines`
- `headerFillColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataHeaderFillColor, optional) — Header background color (hex or token)
- `headerTextColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataHeaderTextColor, optional) — Header text color (hex or token)
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataFontSize, optional) — Font size for table content (or token)
- `showHeader` (boolean, optional) — Show table header row
- `cellPadding` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataCellPadding, optional) — Cell padding in the template lengthUnit (points when lengthUnit is omitted)
- `locale` (string, optional) — Locale for number formatting (e.g., de-DE). Can be overridden per column.
- `rowFill` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataRowFill, optional) — Background color of body rows
- `alternateRowFill` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataAlternateRowFill, optional) — Background color of every second body row (zebra stripes)
- `bodyTextColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataBodyTextColor, optional) — Text color of body rows
- `fontFamily` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataFontFamily, optional) — Font family for table content
- `numberFormat` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataNumberFormat, optional) — Number separators for the table; a column with its own locale ignores it
- `dateFormat` (string, optional) — Date pattern with the tokens dd, MM, yyyy (e.g., dd.MM.yyyy)
- `carryOver` (boolean, optional) — Carry-over across page breaks: a subtotal row at the bottom of each page and a carry-over row at the top of the next. Sums the currency columns unless carryOverColumns/carryOverColumn names them.
- `carryOverByTaxRate` (boolean, optional) — Carry-over rows per tax rate instead of one total row
- `carryOverColumn` (string, optional) — Field of the one column to sum (ignored when carryOverColumns is set)
- `carryOverColumns` (list of string, optional) — Fields of the columns to sum for the carry-over
- `carryOverTaxRateField` (string, optional) — Item field holding the tax rate for carryOverByTaxRate (default: taxRate)
- `carryOverLabels` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataCarryOverLabels, optional) — Labels of the carry-over rows
- `prepaidReceiptLabels` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataPrepaidReceiptLabels, optional) — Labels of the prepaid receipts list printed below an items table; only used when the invoice data carries prepaidReceipts

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6Data

- `rows` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataRowsItems, optional) — Simple summary rows
- `headerRows` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataHeaderRowsItems, optional) — Rows above dynamic section
- `dynamicRows` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataDynamicRows, optional) — Dynamic rows from array data
- `footerRows` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataFooterRowsItems, optional) — Rows below dynamic section (e.g., total)
- `width` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataWidth, optional) — Total width of the summary block (e.g., '50%', 250); numbers in the template lengthUnit (points when lengthUnit is omitted)
- `widths` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataWidthsItems, optional) — Column widths: [labelWidth, valueWidth]; numbers in the template lengthUnit (points when lengthUnit is omitted)
- `alignment` (enum, optional) — Horizontal alignment of the block (default: right)
  - Allowed values: `left`, `center`, `right`
- `labelWidth` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataLabelWidth, optional) — Label column width; numbers in the template lengthUnit (points when lengthUnit is omitted)
- `valueWidth` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataValueWidth, optional) — Value column width
- `labelColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataLabelColor, optional) — Label text color
- `valueColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataValueColor, optional) — Value text color
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataFontSize, optional) — Default font size or token
- `separatorBeforeFooter` (boolean, optional) — Show separator line before footer rows
- `locale` (string, optional) — Locale for number formatting (e.g., de-DE)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf7Data

- `content` (string, required) — QR code content with optional placeholders. Example for Swiss QR-Bill: "SPC\n0200\n1\n\{\{seller.iban}}\nK\n\{\{seller.name}}\n\{\{seller.street}}\n\{\{seller.postalCode}} \{\{seller.city}}\n\n\nCH\n\n\n\n\n\n\n\n\{\{total}}\n\{\{currency}}". Any Invoice placeholder can be used (e.g., \{\{invoiceNumber}}, \{\{total}}, \{\{buyer.name}}).
- `size` (double, optional) — Size in the template lengthUnit (points when lengthUnit is omitted)
- `alignment` (enum, optional) — Alignment
  - Allowed values: `left`, `center`, `right`
- `foreground` (string, optional) — Foreground color (hex)
- `background` (string, optional) — Background color (hex)
- `eccLevel` (enum, optional) — Error correction level (L=7%, M=15%, Q=25%, H=30%)
  - Allowed values: `L`, `M`, `Q`, `H`

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf8Data

- `label` (string, optional) — Name of the break (at most 100 characters)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf9Data

- `text` (string, required) — Watermark text, printed across every page behind the content (at most 100 characters)
- `fontSize` (double, optional) — Font size in points
- `color` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf9DataColor, optional) — Color hex string, token reference (\{ "token": "primaryColor" }) or \{ "custom": "#hex" }
- `opacity` (double, optional) — Opacity from 0 (invisible) to 1
- `rotation` (double, optional) — Rotation in degrees, -90 to 90
- `bold` (boolean, optional) — Bold text
- `font` (string, optional) — Font family name (at most 100 characters)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf10Data

- `content` (string, required) — Barcode content with optional placeholders, e.g. \{\{invoiceNumber}} (at most 200 characters before placeholders are filled)
- `format` (enum, optional) — Barcode format (default code128)
  - Allowed values: `code128`, `code39`, `code93`, `ean13`, `ean8`, `upca`, `upce`, `itf14`, `codabar`, `datamatrix`
- `width` (double, optional) — Width in the template lengthUnit (points when lengthUnit is omitted)
- `height` (double, optional) — Height in the template lengthUnit (points when lengthUnit is omitted)
- `alignment` (enum, optional) — Alignment
  - Allowed values: `left`, `center`, `right`
- `includeText` (boolean, optional) — Print the content as text below the barcode

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf11Data

- `columns` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf11DataColumnsItems, required) — Column definitions
- `columnGap` (double, optional) — Gap between columns in the template lengthUnit (points when lengthUnit is omitted)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf0Data

- `content` (string, required) — Text content with optional placeholders resolved from Invoice data. Available placeholders: \{\{invoiceNumber}}, \{\{type}}, \{\{issueDate}}, \{\{dueDate}}, \{\{deliveryDate}}, \{\{currency}}, \{\{seller.name}}, \{\{seller.street}}, \{\{seller.postalCode}}, \{\{seller.city}}, \{\{seller.countryCode}}, \{\{seller.taxId}}, \{\{seller.vatId}}, \{\{seller.email}}, \{\{seller.phone}}, \{\{buyer.name}}, \{\{buyer.street}}, \{\{buyer.postalCode}}, \{\{buyer.city}}, \{\{buyer.countryCode}}, \{\{buyer.taxId}}, \{\{buyer.vatId}}, \{\{buyer.email}}, \{\{buyer.phone}}, \{\{subtotal}}, \{\{total}}, \{\{notes}}, \{\{paymentTerms.dueDays}}, \{\{paymentTerms.description}}. For array data (items, taxSummary) use a table block with dataSource instead. Page numbers: \{\{page.current}} and \{\{page.total}} resolve only in header and footer blocks (not in the body). A block whose content resolves to whitespace only renders nothing (it is dropped, no gap) — use a spacer block for vertical space.
- `style` (string, optional) — Reference to a named style
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf0DataFontSize, optional) — Font size in points or token
- `fontFamily` (string, optional) — Font family (overrides document default)
- `bold` (boolean, optional) — Bold text
- `italic` (boolean, optional) — Italic text
- `italics` (boolean, optional) — Italic text (alias)
- `color` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf0DataColor, optional) — Text color (hex or token)
- `hideMode` (enum, optional) — Hide block when placeholders are empty
  - Allowed values: `anyEmpty`, `allEmpty`
- `alignment` (enum, optional) — Text alignment
  - Allowed values: `left`, `center`, `right`, `justify`
- `margin` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf0DataMargin, optional) — Margin in the template lengthUnit (points when lengthUnit is omitted): number | [h, v] | [left, top, right, bottom]

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf1Data

- `height` (double, required) — Height in the template lengthUnit. Legacy: when lengthUnit is omitted, spacer heights are read as mm.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf2Data

- `color` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf2DataColor, optional) — Line color (hex or token)
- `thickness` (double, optional) — Line thickness in the template lengthUnit (points when lengthUnit is omitted)
- `margin` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf2DataMargin, optional) — Margin in the template lengthUnit (points when lengthUnit is omitted): number | [h, v] | [left, top, right, bottom]

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf3Data

- `src` (string, required) — Image source: placeholder (e.g., \{\{logo}} for company logo), base64-encoded data URI (data:image/png;base64,...), or HTTPS URL. When using a placeholder, the image must be provided in the Invoice data under that key.
- `width` (double, optional) — Width in the template lengthUnit (points when lengthUnit is omitted)
- `height` (double, optional) — Height in the template lengthUnit (points when lengthUnit is omitted)
- `fit` (list of any, optional) — Fit into [width, height] box, both in the template lengthUnit (points when lengthUnit is omitted)
- `alignment` (enum, optional) — Alignment
  - Allowed values: `left`, `center`, `right`

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf4Data

- `items` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf4DataItemsItems, required) — Key-value items
- `layout` (enum, optional) — Layout direction (default: vertical)
  - Allowed values: `vertical`, `horizontal`, `inline`
- `labelStyle` (string, optional) — Named style for labels
- `valueStyle` (string, optional) — Named style for values
- `valueAlignment` (enum, optional) — Value alignment (vertical layout)
  - Allowed values: `left`, `center`, `right`
- `labelNoWrap` (boolean, optional)
- `valueNoWrap` (boolean, optional)
- `widths` (list of any, optional) — Column widths: [labelWidth, valueWidth]; numbers in the template lengthUnit (points when lengthUnit is omitted)
- `labelWidth` (double, optional) — Label width in the template lengthUnit (points when lengthUnit is omitted)
- `labelBold` (boolean, optional) — Bold labels
- `labelColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf4DataLabelColor, optional) — Label text color (hex or token)
- `valueColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf4DataValueColor, optional) — Value text color (hex or token)
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf4DataFontSize, optional) — Font size for label and value (or token)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5Data

- `dataSource` (string, required) — Placeholder for array binding: any data path that resolves to an array. Use \{\{items}} for invoice line items or \{\{taxSummary}} for tax breakdown; an array you send yourself in the invoice under your own key works too, e.g. \{\{myRows}} for invoice.myRows. Fields available in \{\{items}}: position, description, articleNumber, quantity, unit, unitPrice, taxRate, taxCategoryCode, netAmount, taxAmount, grossAmount. Fields available in \{\{taxSummary}}: taxRate, taxCategoryCode, netAmount, taxAmount. Reference these fields in column definitions via the "field" property.
- `columns` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataColumnsItems, required) — Column definitions
- `repeatHeader` (boolean, optional) — Repeat header on each page
- `dontBreakRows` (boolean, optional) — Don't break rows across pages
- `headerStyle` (string, optional) — Named style for header row
- `bodyStyle` (string, optional) — Named style for body rows
- `layout` (enum, optional) — Table border layout (default: with borders)
  - Allowed values: `noBorders`, `headerLineOnly`, `lightHorizontalLines`
- `headerFillColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataHeaderFillColor, optional) — Header background color (hex or token)
- `headerTextColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataHeaderTextColor, optional) — Header text color (hex or token)
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataFontSize, optional) — Font size for table content (or token)
- `showHeader` (boolean, optional) — Show table header row
- `cellPadding` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataCellPadding, optional) — Cell padding in the template lengthUnit (points when lengthUnit is omitted)
- `locale` (string, optional) — Locale for number formatting (e.g., de-DE). Can be overridden per column.
- `rowFill` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataRowFill, optional) — Background color of body rows
- `alternateRowFill` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataAlternateRowFill, optional) — Background color of every second body row (zebra stripes)
- `bodyTextColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataBodyTextColor, optional) — Text color of body rows
- `fontFamily` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataFontFamily, optional) — Font family for table content
- `numberFormat` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataNumberFormat, optional) — Number separators for the table; a column with its own locale ignores it
- `dateFormat` (string, optional) — Date pattern with the tokens dd, MM, yyyy (e.g., dd.MM.yyyy)
- `carryOver` (boolean, optional) — Carry-over across page breaks: a subtotal row at the bottom of each page and a carry-over row at the top of the next. Sums the currency columns unless carryOverColumns/carryOverColumn names them.
- `carryOverByTaxRate` (boolean, optional) — Carry-over rows per tax rate instead of one total row
- `carryOverColumn` (string, optional) — Field of the one column to sum (ignored when carryOverColumns is set)
- `carryOverColumns` (list of string, optional) — Fields of the columns to sum for the carry-over
- `carryOverTaxRateField` (string, optional) — Item field holding the tax rate for carryOverByTaxRate (default: taxRate)
- `carryOverLabels` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataCarryOverLabels, optional) — Labels of the carry-over rows
- `prepaidReceiptLabels` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataPrepaidReceiptLabels, optional) — Labels of the prepaid receipts list printed below an items table; only used when the invoice data carries prepaidReceipts

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6Data

- `rows` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataRowsItems, optional) — Simple summary rows
- `headerRows` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataHeaderRowsItems, optional) — Rows above dynamic section
- `dynamicRows` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataDynamicRows, optional) — Dynamic rows from array data
- `footerRows` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataFooterRowsItems, optional) — Rows below dynamic section (e.g., total)
- `width` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataWidth, optional) — Total width of the summary block (e.g., '50%', 250); numbers in the template lengthUnit (points when lengthUnit is omitted)
- `widths` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataWidthsItems, optional) — Column widths: [labelWidth, valueWidth]; numbers in the template lengthUnit (points when lengthUnit is omitted)
- `alignment` (enum, optional) — Horizontal alignment of the block (default: right)
  - Allowed values: `left`, `center`, `right`
- `labelWidth` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataLabelWidth, optional) — Label column width; numbers in the template lengthUnit (points when lengthUnit is omitted)
- `valueWidth` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataValueWidth, optional) — Value column width
- `labelColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataLabelColor, optional) — Label text color
- `valueColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataValueColor, optional) — Value text color
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataFontSize, optional) — Default font size or token
- `separatorBeforeFooter` (boolean, optional) — Show separator line before footer rows
- `locale` (string, optional) — Locale for number formatting (e.g., de-DE)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf7Data

- `content` (string, required) — QR code content with optional placeholders. Example for Swiss QR-Bill: "SPC\n0200\n1\n\{\{seller.iban}}\nK\n\{\{seller.name}}\n\{\{seller.street}}\n\{\{seller.postalCode}} \{\{seller.city}}\n\n\nCH\n\n\n\n\n\n\n\n\{\{total}}\n\{\{currency}}". Any Invoice placeholder can be used (e.g., \{\{invoiceNumber}}, \{\{total}}, \{\{buyer.name}}).
- `size` (double, optional) — Size in the template lengthUnit (points when lengthUnit is omitted)
- `alignment` (enum, optional) — Alignment
  - Allowed values: `left`, `center`, `right`
- `foreground` (string, optional) — Foreground color (hex)
- `background` (string, optional) — Background color (hex)
- `eccLevel` (enum, optional) — Error correction level (L=7%, M=15%, Q=25%, H=30%)
  - Allowed values: `L`, `M`, `Q`, `H`

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf8Data

- `label` (string, optional) — Name of the break (at most 100 characters)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf9Data

- `text` (string, required) — Watermark text, printed across every page behind the content (at most 100 characters)
- `fontSize` (double, optional) — Font size in points
- `color` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf9DataColor, optional) — Color hex string, token reference (\{ "token": "primaryColor" }) or \{ "custom": "#hex" }
- `opacity` (double, optional) — Opacity from 0 (invisible) to 1
- `rotation` (double, optional) — Rotation in degrees, -90 to 90
- `bold` (boolean, optional) — Bold text
- `font` (string, optional) — Font family name (at most 100 characters)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf10Data

- `content` (string, required) — Barcode content with optional placeholders, e.g. \{\{invoiceNumber}} (at most 200 characters before placeholders are filled)
- `format` (enum, optional) — Barcode format (default code128)
  - Allowed values: `code128`, `code39`, `code93`, `ean13`, `ean8`, `upca`, `upce`, `itf14`, `codabar`, `datamatrix`
- `width` (double, optional) — Width in the template lengthUnit (points when lengthUnit is omitted)
- `height` (double, optional) — Height in the template lengthUnit (points when lengthUnit is omitted)
- `alignment` (enum, optional) — Alignment
  - Allowed values: `left`, `center`, `right`
- `includeText` (boolean, optional) — Print the content as text below the barcode

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf11Data

- `columns` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf11DataColumnsItems, required) — Column definitions
- `columnGap` (double, optional) — Gap between columns in the template lengthUnit (points when lengthUnit is omitted)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf0Data

- `content` (string, required) — Text content with optional placeholders resolved from Invoice data. Available placeholders: \{\{invoiceNumber}}, \{\{type}}, \{\{issueDate}}, \{\{dueDate}}, \{\{deliveryDate}}, \{\{currency}}, \{\{seller.name}}, \{\{seller.street}}, \{\{seller.postalCode}}, \{\{seller.city}}, \{\{seller.countryCode}}, \{\{seller.taxId}}, \{\{seller.vatId}}, \{\{seller.email}}, \{\{seller.phone}}, \{\{buyer.name}}, \{\{buyer.street}}, \{\{buyer.postalCode}}, \{\{buyer.city}}, \{\{buyer.countryCode}}, \{\{buyer.taxId}}, \{\{buyer.vatId}}, \{\{buyer.email}}, \{\{buyer.phone}}, \{\{subtotal}}, \{\{total}}, \{\{notes}}, \{\{paymentTerms.dueDays}}, \{\{paymentTerms.description}}. For array data (items, taxSummary) use a table block with dataSource instead. Page numbers: \{\{page.current}} and \{\{page.total}} resolve only in header and footer blocks (not in the body). A block whose content resolves to whitespace only renders nothing (it is dropped, no gap) — use a spacer block for vertical space.
- `style` (string, optional) — Reference to a named style
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf0DataFontSize, optional) — Font size in points or token
- `fontFamily` (string, optional) — Font family (overrides document default)
- `bold` (boolean, optional) — Bold text
- `italic` (boolean, optional) — Italic text
- `italics` (boolean, optional) — Italic text (alias)
- `color` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf0DataColor, optional) — Text color (hex or token)
- `hideMode` (enum, optional) — Hide block when placeholders are empty
  - Allowed values: `anyEmpty`, `allEmpty`
- `alignment` (enum, optional) — Text alignment
  - Allowed values: `left`, `center`, `right`, `justify`
- `margin` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf0DataMargin, optional) — Margin in the template lengthUnit (points when lengthUnit is omitted): number | [h, v] | [left, top, right, bottom]

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf1Data

- `height` (double, required) — Height in the template lengthUnit. Legacy: when lengthUnit is omitted, spacer heights are read as mm.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf2Data

- `color` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf2DataColor, optional) — Line color (hex or token)
- `thickness` (double, optional) — Line thickness in the template lengthUnit (points when lengthUnit is omitted)
- `margin` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf2DataMargin, optional) — Margin in the template lengthUnit (points when lengthUnit is omitted): number | [h, v] | [left, top, right, bottom]

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf3Data

- `src` (string, required) — Image source: placeholder (e.g., \{\{logo}} for company logo), base64-encoded data URI (data:image/png;base64,...), or HTTPS URL. When using a placeholder, the image must be provided in the Invoice data under that key.
- `width` (double, optional) — Width in the template lengthUnit (points when lengthUnit is omitted)
- `height` (double, optional) — Height in the template lengthUnit (points when lengthUnit is omitted)
- `fit` (list of any, optional) — Fit into [width, height] box, both in the template lengthUnit (points when lengthUnit is omitted)
- `alignment` (enum, optional) — Alignment
  - Allowed values: `left`, `center`, `right`

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf4Data

- `items` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf4DataItemsItems, required) — Key-value items
- `layout` (enum, optional) — Layout direction (default: vertical)
  - Allowed values: `vertical`, `horizontal`, `inline`
- `labelStyle` (string, optional) — Named style for labels
- `valueStyle` (string, optional) — Named style for values
- `valueAlignment` (enum, optional) — Value alignment (vertical layout)
  - Allowed values: `left`, `center`, `right`
- `labelNoWrap` (boolean, optional)
- `valueNoWrap` (boolean, optional)
- `widths` (list of any, optional) — Column widths: [labelWidth, valueWidth]; numbers in the template lengthUnit (points when lengthUnit is omitted)
- `labelWidth` (double, optional) — Label width in the template lengthUnit (points when lengthUnit is omitted)
- `labelBold` (boolean, optional) — Bold labels
- `labelColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf4DataLabelColor, optional) — Label text color (hex or token)
- `valueColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf4DataValueColor, optional) — Value text color (hex or token)
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf4DataFontSize, optional) — Font size for label and value (or token)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5Data

- `dataSource` (string, required) — Placeholder for array binding: any data path that resolves to an array. Use \{\{items}} for invoice line items or \{\{taxSummary}} for tax breakdown; an array you send yourself in the invoice under your own key works too, e.g. \{\{myRows}} for invoice.myRows. Fields available in \{\{items}}: position, description, articleNumber, quantity, unit, unitPrice, taxRate, taxCategoryCode, netAmount, taxAmount, grossAmount. Fields available in \{\{taxSummary}}: taxRate, taxCategoryCode, netAmount, taxAmount. Reference these fields in column definitions via the "field" property.
- `columns` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataColumnsItems, required) — Column definitions
- `repeatHeader` (boolean, optional) — Repeat header on each page
- `dontBreakRows` (boolean, optional) — Don't break rows across pages
- `headerStyle` (string, optional) — Named style for header row
- `bodyStyle` (string, optional) — Named style for body rows
- `layout` (enum, optional) — Table border layout (default: with borders)
  - Allowed values: `noBorders`, `headerLineOnly`, `lightHorizontalLines`
- `headerFillColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataHeaderFillColor, optional) — Header background color (hex or token)
- `headerTextColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataHeaderTextColor, optional) — Header text color (hex or token)
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataFontSize, optional) — Font size for table content (or token)
- `showHeader` (boolean, optional) — Show table header row
- `cellPadding` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataCellPadding, optional) — Cell padding in the template lengthUnit (points when lengthUnit is omitted)
- `locale` (string, optional) — Locale for number formatting (e.g., de-DE). Can be overridden per column.
- `rowFill` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataRowFill, optional) — Background color of body rows
- `alternateRowFill` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataAlternateRowFill, optional) — Background color of every second body row (zebra stripes)
- `bodyTextColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataBodyTextColor, optional) — Text color of body rows
- `fontFamily` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataFontFamily, optional) — Font family for table content
- `numberFormat` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataNumberFormat, optional) — Number separators for the table; a column with its own locale ignores it
- `dateFormat` (string, optional) — Date pattern with the tokens dd, MM, yyyy (e.g., dd.MM.yyyy)
- `carryOver` (boolean, optional) — Carry-over across page breaks: a subtotal row at the bottom of each page and a carry-over row at the top of the next. Sums the currency columns unless carryOverColumns/carryOverColumn names them.
- `carryOverByTaxRate` (boolean, optional) — Carry-over rows per tax rate instead of one total row
- `carryOverColumn` (string, optional) — Field of the one column to sum (ignored when carryOverColumns is set)
- `carryOverColumns` (list of string, optional) — Fields of the columns to sum for the carry-over
- `carryOverTaxRateField` (string, optional) — Item field holding the tax rate for carryOverByTaxRate (default: taxRate)
- `carryOverLabels` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataCarryOverLabels, optional) — Labels of the carry-over rows
- `prepaidReceiptLabels` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataPrepaidReceiptLabels, optional) — Labels of the prepaid receipts list printed below an items table; only used when the invoice data carries prepaidReceipts

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6Data

- `rows` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataRowsItems, optional) — Simple summary rows
- `headerRows` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataHeaderRowsItems, optional) — Rows above dynamic section
- `dynamicRows` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataDynamicRows, optional) — Dynamic rows from array data
- `footerRows` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataFooterRowsItems, optional) — Rows below dynamic section (e.g., total)
- `width` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataWidth, optional) — Total width of the summary block (e.g., '50%', 250); numbers in the template lengthUnit (points when lengthUnit is omitted)
- `widths` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataWidthsItems, optional) — Column widths: [labelWidth, valueWidth]; numbers in the template lengthUnit (points when lengthUnit is omitted)
- `alignment` (enum, optional) — Horizontal alignment of the block (default: right)
  - Allowed values: `left`, `center`, `right`
- `labelWidth` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataLabelWidth, optional) — Label column width; numbers in the template lengthUnit (points when lengthUnit is omitted)
- `valueWidth` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataValueWidth, optional) — Value column width
- `labelColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataLabelColor, optional) — Label text color
- `valueColor` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataValueColor, optional) — Value text color
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataFontSize, optional) — Default font size or token
- `separatorBeforeFooter` (boolean, optional) — Show separator line before footer rows
- `locale` (string, optional) — Locale for number formatting (e.g., de-DE)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf7Data

- `content` (string, required) — QR code content with optional placeholders. Example for Swiss QR-Bill: "SPC\n0200\n1\n\{\{seller.iban}}\nK\n\{\{seller.name}}\n\{\{seller.street}}\n\{\{seller.postalCode}} \{\{seller.city}}\n\n\nCH\n\n\n\n\n\n\n\n\{\{total}}\n\{\{currency}}". Any Invoice placeholder can be used (e.g., \{\{invoiceNumber}}, \{\{total}}, \{\{buyer.name}}).
- `size` (double, optional) — Size in the template lengthUnit (points when lengthUnit is omitted)
- `alignment` (enum, optional) — Alignment
  - Allowed values: `left`, `center`, `right`
- `foreground` (string, optional) — Foreground color (hex)
- `background` (string, optional) — Background color (hex)
- `eccLevel` (enum, optional) — Error correction level (L=7%, M=15%, Q=25%, H=30%)
  - Allowed values: `L`, `M`, `Q`, `H`

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf8Data

- `label` (string, optional) — Name of the break (at most 100 characters)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf9Data

- `text` (string, required) — Watermark text, printed across every page behind the content (at most 100 characters)
- `fontSize` (double, optional) — Font size in points
- `color` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf9DataColor, optional) — Color hex string, token reference (\{ "token": "primaryColor" }) or \{ "custom": "#hex" }
- `opacity` (double, optional) — Opacity from 0 (invisible) to 1
- `rotation` (double, optional) — Rotation in degrees, -90 to 90
- `bold` (boolean, optional) — Bold text
- `font` (string, optional) — Font family name (at most 100 characters)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf10Data

- `content` (string, required) — Barcode content with optional placeholders, e.g. \{\{invoiceNumber}} (at most 200 characters before placeholders are filled)
- `format` (enum, optional) — Barcode format (default code128)
  - Allowed values: `code128`, `code39`, `code93`, `ean13`, `ean8`, `upca`, `upce`, `itf14`, `codabar`, `datamatrix`
- `width` (double, optional) — Width in the template lengthUnit (points when lengthUnit is omitted)
- `height` (double, optional) — Height in the template lengthUnit (points when lengthUnit is omitted)
- `alignment` (enum, optional) — Alignment
  - Allowed values: `left`, `center`, `right`
- `includeText` (boolean, optional) — Print the content as text below the barcode

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf11Data

- `columns` (list of ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf11DataColumnsItems, required) — Column definitions
- `columnGap` (double, optional) — Gap between columns in the template lengthUnit (points when lengthUnit is omitted)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf0DataFontSize

Font size in points or token

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf0DataFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf0DataColor

Text color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf0DataColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf0DataMargin

Margin in the template lengthUnit (points when lengthUnit is omitted): number | [h, v] | [left, top, right, bottom]

- list of any
- list of any
- double

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf2DataColor

Line color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf2DataColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf2DataMargin

Margin in the template lengthUnit (points when lengthUnit is omitted): number | [h, v] | [left, top, right, bottom]

- list of any
- list of any
- double

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf4DataItemsItems

Key-value pair

- `label` (string, required) — Label text
- `value` (string, required) — Value text with optional placeholders resolved from Invoice data. Examples: \{\{invoiceNumber}}, \{\{issueDate}}, \{\{dueDate}}, \{\{seller.name}}, \{\{buyer.city}}, \{\{subtotal}}, \{\{total}}.
- `labelAlign` (enum, optional)
  - Allowed values: `left`, `center`, `right`
- `valueAlign` (enum, optional)
  - Allowed values: `left`, `center`, `right`
- `optionalMode` (enum, optional) — Behavior when value placeholder resolves to empty
  - Allowed values: `required`, `optional-visible`, `optional-hidden`

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf4DataLabelColor

Label text color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf4DataLabelColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf4DataValueColor

Value text color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf4DataValueColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf4DataFontSize

Font size for label and value (or token)

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf4DataFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataColumnsItems

Table column definition

- `field` (string, required) — Field name in data source items. For \{\{items}}: position, description, articleNumber, quantity, unit, unitPrice, taxRate, netAmount, taxAmount, grossAmount. For \{\{taxSummary}}: taxRate, taxCategoryCode, netAmount, taxAmount.
- `width` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataColumnsItemsWidth, required) — Column width: number in the template lengthUnit (points when lengthUnit is omitted), '*' (fill), 'auto', or percentage ('50%')
- `header` (string, optional) — Column header text (optional; ignored when the table has showHeader: false)
- `align` (enum, optional) — Text alignment
  - Allowed values: `left`, `center`, `right`
- `format` (enum, optional) — Value format (currency=2 decimals, percent=adds %)
  - Allowed values: `currency`, `percent`, `number`
- `decimalPlaces` (double, optional) — Decimal places for formatted values
- `template` (string, optional) — Template string with placeholders (e.g., \{\{field:currency:2}})
- `currencySymbol` (boolean, optional) — Show currency symbol
- `locale` (string, optional) — Locale for number formatting (e.g., de-DE). Overrides table-level locale.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataHeaderFillColor

Header background color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataHeaderFillColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataHeaderTextColor

Header text color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataHeaderTextColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataFontSize

Font size for table content (or token)

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataCellPadding

Cell padding in the template lengthUnit (points when lengthUnit is omitted)

- `left` (double, optional)
- `right` (double, optional)
- `top` (double, optional)
- `bottom` (double, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataRowFill

Background color of body rows

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataRowFill1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataRowFill2

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataAlternateRowFill

Background color of every second body row (zebra stripes)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataAlternateRowFill1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataAlternateRowFill2

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataBodyTextColor

Text color of body rows

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataBodyTextColor1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataBodyTextColor2

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataFontFamily

Font family for table content

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataFontFamily1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataFontFamily2

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataNumberFormat

Number separators for the table; a column with its own locale ignores it

- `decimal` (string, required) — Decimal separator, one character
- `group` (string, required) — Thousands separator, one character or empty

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataCarryOverLabels

Labels of the carry-over rows

- `subtotal` (string, optional) — Label of the subtotal row (default: Zwischensumme)
- `carry` (string, optional) — Label of the carry-over row (default: Übertrag)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataPrepaidReceiptLabels

Labels of the prepaid receipts list printed below an items table; only used when the invoice data carries prepaidReceipts

- `heading` (string, optional) — Heading of the prepaid receipts list
- `receipt` (string, optional) — Receipt line, \{number} is the receipt number
- `methods` (map from string to string, optional) — Label per payment method

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataRowsItems

Summary row

- `label` (string, required) — Row label
- `value` (string, required) — Value with optional placeholder (e.g., \{\{subtotal}}, \{\{total}})
- `bold` (boolean, optional) — Bold text
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataRowsItemsFontSize, optional) — Font size in points or token
- `separator` (boolean, optional) — Show separator line above this row
- `valueAlign` (enum, optional)
  - Allowed values: `left`, `center`, `right`
- `valueFormat` (enum, optional)
  - Allowed values: `currency`, `percent`, `number`
- `currencySymbol` (boolean, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataHeaderRowsItems

Summary row

- `label` (string, required) — Row label
- `value` (string, required) — Value with optional placeholder (e.g., \{\{subtotal}}, \{\{total}})
- `bold` (boolean, optional) — Bold text
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataHeaderRowsItemsFontSize, optional) — Font size in points or token
- `separator` (boolean, optional) — Show separator line above this row
- `valueAlign` (enum, optional)
  - Allowed values: `left`, `center`, `right`
- `valueFormat` (enum, optional)
  - Allowed values: `currency`, `percent`, `number`
- `currencySymbol` (boolean, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataDynamicRows

Dynamic rows from array data

- `dataSource` (string, required) — Placeholder for array (e.g., \{\{taxSummary}})
- `valueField` (string, required) — Field name for value (e.g., taxAmount)
- `valueFormat` (enum, optional)
  - Allowed values: `currency`, `percent`, `number`
- `labelTemplate` (string, optional) — Label template (e.g., "MwSt: \{\{taxRate:percent}}")
- `currencySymbol` (boolean, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataFooterRowsItems

Summary row

- `label` (string, required) — Row label
- `value` (string, required) — Value with optional placeholder (e.g., \{\{subtotal}}, \{\{total}})
- `bold` (boolean, optional) — Bold text
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataFooterRowsItemsFontSize, optional) — Font size in points or token
- `separator` (boolean, optional) — Show separator line above this row
- `valueAlign` (enum, optional)
  - Allowed values: `left`, `center`, `right`
- `valueFormat` (enum, optional)
  - Allowed values: `currency`, `percent`, `number`
- `currencySymbol` (boolean, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataWidth

Total width of the summary block (e.g., '50%', 250); numbers in the template lengthUnit (points when lengthUnit is omitted)

- double
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataWidthsItems

- double
- "*"
- "auto"

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataLabelWidth

Label column width; numbers in the template lengthUnit (points when lengthUnit is omitted)

- double
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataValueWidth

Value column width

- double
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataLabelColor

Label text color

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataLabelColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataValueColor

Value text color

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataValueColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataFontSize

Default font size or token

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf9DataColor

Color hex string, token reference (\{ "token": "primaryColor" }) or \{ "custom": "#hex" }

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf9DataColor1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf9DataColor2

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf11DataColumnsItems

- `width` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf11DataColumnsItemsWidth, required) — Column width: number in the template lengthUnit (points when lengthUnit is omitted), percentage ('50%'), '*', or 'auto'
- `blocks` (list of any, required) — From 2027-01-01 a block in a column that fails the check of header, body and footer blocks is rejected with 400 (right away with `enforcePending: true`); until then it is rendered as sent with the warning `TEMPLATE_BLOCK_INVALID`. Same block types as top-level, recursive.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf0DataFontSize

Font size in points or token

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf0DataFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf0DataColor

Text color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf0DataColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf0DataMargin

Margin in the template lengthUnit (points when lengthUnit is omitted): number | [h, v] | [left, top, right, bottom]

- list of any
- list of any
- double

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf2DataColor

Line color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf2DataColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf2DataMargin

Margin in the template lengthUnit (points when lengthUnit is omitted): number | [h, v] | [left, top, right, bottom]

- list of any
- list of any
- double

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf4DataItemsItems

Key-value pair

- `label` (string, required) — Label text
- `value` (string, required) — Value text with optional placeholders resolved from Invoice data. Examples: \{\{invoiceNumber}}, \{\{issueDate}}, \{\{dueDate}}, \{\{seller.name}}, \{\{buyer.city}}, \{\{subtotal}}, \{\{total}}.
- `labelAlign` (enum, optional)
  - Allowed values: `left`, `center`, `right`
- `valueAlign` (enum, optional)
  - Allowed values: `left`, `center`, `right`
- `optionalMode` (enum, optional) — Behavior when value placeholder resolves to empty
  - Allowed values: `required`, `optional-visible`, `optional-hidden`

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf4DataLabelColor

Label text color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf4DataLabelColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf4DataValueColor

Value text color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf4DataValueColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf4DataFontSize

Font size for label and value (or token)

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf4DataFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataColumnsItems

Table column definition

- `field` (string, required) — Field name in data source items. For \{\{items}}: position, description, articleNumber, quantity, unit, unitPrice, taxRate, netAmount, taxAmount, grossAmount. For \{\{taxSummary}}: taxRate, taxCategoryCode, netAmount, taxAmount.
- `width` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataColumnsItemsWidth, required) — Column width: number in the template lengthUnit (points when lengthUnit is omitted), '*' (fill), 'auto', or percentage ('50%')
- `header` (string, optional) — Column header text (optional; ignored when the table has showHeader: false)
- `align` (enum, optional) — Text alignment
  - Allowed values: `left`, `center`, `right`
- `format` (enum, optional) — Value format (currency=2 decimals, percent=adds %)
  - Allowed values: `currency`, `percent`, `number`
- `decimalPlaces` (double, optional) — Decimal places for formatted values
- `template` (string, optional) — Template string with placeholders (e.g., \{\{field:currency:2}})
- `currencySymbol` (boolean, optional) — Show currency symbol
- `locale` (string, optional) — Locale for number formatting (e.g., de-DE). Overrides table-level locale.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataHeaderFillColor

Header background color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataHeaderFillColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataHeaderTextColor

Header text color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataHeaderTextColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataFontSize

Font size for table content (or token)

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataCellPadding

Cell padding in the template lengthUnit (points when lengthUnit is omitted)

- `left` (double, optional)
- `right` (double, optional)
- `top` (double, optional)
- `bottom` (double, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataRowFill

Background color of body rows

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataRowFill1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataRowFill2

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataAlternateRowFill

Background color of every second body row (zebra stripes)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataAlternateRowFill1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataAlternateRowFill2

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataBodyTextColor

Text color of body rows

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataBodyTextColor1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataBodyTextColor2

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataFontFamily

Font family for table content

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataFontFamily1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataFontFamily2

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataNumberFormat

Number separators for the table; a column with its own locale ignores it

- `decimal` (string, required) — Decimal separator, one character
- `group` (string, required) — Thousands separator, one character or empty

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataCarryOverLabels

Labels of the carry-over rows

- `subtotal` (string, optional) — Label of the subtotal row (default: Zwischensumme)
- `carry` (string, optional) — Label of the carry-over row (default: Übertrag)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataPrepaidReceiptLabels

Labels of the prepaid receipts list printed below an items table; only used when the invoice data carries prepaidReceipts

- `heading` (string, optional) — Heading of the prepaid receipts list
- `receipt` (string, optional) — Receipt line, \{number} is the receipt number
- `methods` (map from string to string, optional) — Label per payment method

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataRowsItems

Summary row

- `label` (string, required) — Row label
- `value` (string, required) — Value with optional placeholder (e.g., \{\{subtotal}}, \{\{total}})
- `bold` (boolean, optional) — Bold text
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataRowsItemsFontSize, optional) — Font size in points or token
- `separator` (boolean, optional) — Show separator line above this row
- `valueAlign` (enum, optional)
  - Allowed values: `left`, `center`, `right`
- `valueFormat` (enum, optional)
  - Allowed values: `currency`, `percent`, `number`
- `currencySymbol` (boolean, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataHeaderRowsItems

Summary row

- `label` (string, required) — Row label
- `value` (string, required) — Value with optional placeholder (e.g., \{\{subtotal}}, \{\{total}})
- `bold` (boolean, optional) — Bold text
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataHeaderRowsItemsFontSize, optional) — Font size in points or token
- `separator` (boolean, optional) — Show separator line above this row
- `valueAlign` (enum, optional)
  - Allowed values: `left`, `center`, `right`
- `valueFormat` (enum, optional)
  - Allowed values: `currency`, `percent`, `number`
- `currencySymbol` (boolean, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataDynamicRows

Dynamic rows from array data

- `dataSource` (string, required) — Placeholder for array (e.g., \{\{taxSummary}})
- `valueField` (string, required) — Field name for value (e.g., taxAmount)
- `valueFormat` (enum, optional)
  - Allowed values: `currency`, `percent`, `number`
- `labelTemplate` (string, optional) — Label template (e.g., "MwSt: \{\{taxRate:percent}}")
- `currencySymbol` (boolean, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataFooterRowsItems

Summary row

- `label` (string, required) — Row label
- `value` (string, required) — Value with optional placeholder (e.g., \{\{subtotal}}, \{\{total}})
- `bold` (boolean, optional) — Bold text
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataFooterRowsItemsFontSize, optional) — Font size in points or token
- `separator` (boolean, optional) — Show separator line above this row
- `valueAlign` (enum, optional)
  - Allowed values: `left`, `center`, `right`
- `valueFormat` (enum, optional)
  - Allowed values: `currency`, `percent`, `number`
- `currencySymbol` (boolean, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataWidth

Total width of the summary block (e.g., '50%', 250); numbers in the template lengthUnit (points when lengthUnit is omitted)

- double
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataWidthsItems

- double
- "*"
- "auto"

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataLabelWidth

Label column width; numbers in the template lengthUnit (points when lengthUnit is omitted)

- double
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataValueWidth

Value column width

- double
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataLabelColor

Label text color

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataLabelColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataValueColor

Value text color

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataValueColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataFontSize

Default font size or token

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf9DataColor

Color hex string, token reference (\{ "token": "primaryColor" }) or \{ "custom": "#hex" }

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf9DataColor1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf9DataColor2

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf11DataColumnsItems

- `width` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf11DataColumnsItemsWidth, required) — Column width: number in the template lengthUnit (points when lengthUnit is omitted), percentage ('50%'), '*', or 'auto'
- `blocks` (list of any, required) — From 2027-01-01 a block in a column that fails the check of header, body and footer blocks is rejected with 400 (right away with `enforcePending: true`); until then it is rendered as sent with the warning `TEMPLATE_BLOCK_INVALID`. Same block types as top-level, recursive.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf0DataFontSize

Font size in points or token

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf0DataFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf0DataColor

Text color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf0DataColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf0DataMargin

Margin in the template lengthUnit (points when lengthUnit is omitted): number | [h, v] | [left, top, right, bottom]

- list of any
- list of any
- double

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf2DataColor

Line color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf2DataColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf2DataMargin

Margin in the template lengthUnit (points when lengthUnit is omitted): number | [h, v] | [left, top, right, bottom]

- list of any
- list of any
- double

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf4DataItemsItems

Key-value pair

- `label` (string, required) — Label text
- `value` (string, required) — Value text with optional placeholders resolved from Invoice data. Examples: \{\{invoiceNumber}}, \{\{issueDate}}, \{\{dueDate}}, \{\{seller.name}}, \{\{buyer.city}}, \{\{subtotal}}, \{\{total}}.
- `labelAlign` (enum, optional)
  - Allowed values: `left`, `center`, `right`
- `valueAlign` (enum, optional)
  - Allowed values: `left`, `center`, `right`
- `optionalMode` (enum, optional) — Behavior when value placeholder resolves to empty
  - Allowed values: `required`, `optional-visible`, `optional-hidden`

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf4DataLabelColor

Label text color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf4DataLabelColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf4DataValueColor

Value text color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf4DataValueColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf4DataFontSize

Font size for label and value (or token)

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf4DataFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataColumnsItems

Table column definition

- `field` (string, required) — Field name in data source items. For \{\{items}}: position, description, articleNumber, quantity, unit, unitPrice, taxRate, netAmount, taxAmount, grossAmount. For \{\{taxSummary}}: taxRate, taxCategoryCode, netAmount, taxAmount.
- `width` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataColumnsItemsWidth, required) — Column width: number in the template lengthUnit (points when lengthUnit is omitted), '*' (fill), 'auto', or percentage ('50%')
- `header` (string, optional) — Column header text (optional; ignored when the table has showHeader: false)
- `align` (enum, optional) — Text alignment
  - Allowed values: `left`, `center`, `right`
- `format` (enum, optional) — Value format (currency=2 decimals, percent=adds %)
  - Allowed values: `currency`, `percent`, `number`
- `decimalPlaces` (double, optional) — Decimal places for formatted values
- `template` (string, optional) — Template string with placeholders (e.g., \{\{field:currency:2}})
- `currencySymbol` (boolean, optional) — Show currency symbol
- `locale` (string, optional) — Locale for number formatting (e.g., de-DE). Overrides table-level locale.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataHeaderFillColor

Header background color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataHeaderFillColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataHeaderTextColor

Header text color (hex or token)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataHeaderTextColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataFontSize

Font size for table content (or token)

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataCellPadding

Cell padding in the template lengthUnit (points when lengthUnit is omitted)

- `left` (double, optional)
- `right` (double, optional)
- `top` (double, optional)
- `bottom` (double, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataRowFill

Background color of body rows

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataRowFill1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataRowFill2

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataAlternateRowFill

Background color of every second body row (zebra stripes)

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataAlternateRowFill1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataAlternateRowFill2

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataBodyTextColor

Text color of body rows

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataBodyTextColor1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataBodyTextColor2

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataFontFamily

Font family for table content

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataFontFamily1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataFontFamily2

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataNumberFormat

Number separators for the table; a column with its own locale ignores it

- `decimal` (string, required) — Decimal separator, one character
- `group` (string, required) — Thousands separator, one character or empty

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataCarryOverLabels

Labels of the carry-over rows

- `subtotal` (string, optional) — Label of the subtotal row (default: Zwischensumme)
- `carry` (string, optional) — Label of the carry-over row (default: Übertrag)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataPrepaidReceiptLabels

Labels of the prepaid receipts list printed below an items table; only used when the invoice data carries prepaidReceipts

- `heading` (string, optional) — Heading of the prepaid receipts list
- `receipt` (string, optional) — Receipt line, \{number} is the receipt number
- `methods` (map from string to string, optional) — Label per payment method

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataRowsItems

Summary row

- `label` (string, required) — Row label
- `value` (string, required) — Value with optional placeholder (e.g., \{\{subtotal}}, \{\{total}})
- `bold` (boolean, optional) — Bold text
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataRowsItemsFontSize, optional) — Font size in points or token
- `separator` (boolean, optional) — Show separator line above this row
- `valueAlign` (enum, optional)
  - Allowed values: `left`, `center`, `right`
- `valueFormat` (enum, optional)
  - Allowed values: `currency`, `percent`, `number`
- `currencySymbol` (boolean, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataHeaderRowsItems

Summary row

- `label` (string, required) — Row label
- `value` (string, required) — Value with optional placeholder (e.g., \{\{subtotal}}, \{\{total}})
- `bold` (boolean, optional) — Bold text
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataHeaderRowsItemsFontSize, optional) — Font size in points or token
- `separator` (boolean, optional) — Show separator line above this row
- `valueAlign` (enum, optional)
  - Allowed values: `left`, `center`, `right`
- `valueFormat` (enum, optional)
  - Allowed values: `currency`, `percent`, `number`
- `currencySymbol` (boolean, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataDynamicRows

Dynamic rows from array data

- `dataSource` (string, required) — Placeholder for array (e.g., \{\{taxSummary}})
- `valueField` (string, required) — Field name for value (e.g., taxAmount)
- `valueFormat` (enum, optional)
  - Allowed values: `currency`, `percent`, `number`
- `labelTemplate` (string, optional) — Label template (e.g., "MwSt: \{\{taxRate:percent}}")
- `currencySymbol` (boolean, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataFooterRowsItems

Summary row

- `label` (string, required) — Row label
- `value` (string, required) — Value with optional placeholder (e.g., \{\{subtotal}}, \{\{total}})
- `bold` (boolean, optional) — Bold text
- `fontSize` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataFooterRowsItemsFontSize, optional) — Font size in points or token
- `separator` (boolean, optional) — Show separator line above this row
- `valueAlign` (enum, optional)
  - Allowed values: `left`, `center`, `right`
- `valueFormat` (enum, optional)
  - Allowed values: `currency`, `percent`, `number`
- `currencySymbol` (boolean, optional)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataWidth

Total width of the summary block (e.g., '50%', 250); numbers in the template lengthUnit (points when lengthUnit is omitted)

- double
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataWidthsItems

- double
- "*"
- "auto"

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataLabelWidth

Label column width; numbers in the template lengthUnit (points when lengthUnit is omitted)

- double
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataValueWidth

Value column width

- double
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataLabelColor

Label text color

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataLabelColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataValueColor

Value text color

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataValueColor1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataFontSize

Default font size or token

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf9DataColor

Color hex string, token reference (\{ "token": "primaryColor" }) or \{ "custom": "#hex" }

- string
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf9DataColor1
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf9DataColor2

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf11DataColumnsItems

- `width` (ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf11DataColumnsItemsWidth, required) — Column width: number in the template lengthUnit (points when lengthUnit is omitted), percentage ('50%'), '*', or 'auto'
- `blocks` (list of any, required) — From 2027-01-01 a block in a column that fails the check of header, body and footer blocks is rejected with 400 (right away with `enforcePending: true`); until then it is rendered as sent with the warning `TEMPLATE_BLOCK_INVALID`. Same block types as top-level, recursive.

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf0DataFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf0DataColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf2DataColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf4DataLabelColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf4DataValueColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf4DataFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataColumnsItemsWidth

Column width: number in the template lengthUnit (points when lengthUnit is omitted), '*' (fill), 'auto', or percentage ('50%')

- double
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataHeaderFillColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataHeaderTextColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataRowFill1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataRowFill2

- `custom` (string, required)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataAlternateRowFill1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataAlternateRowFill2

- `custom` (string, required)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataBodyTextColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataBodyTextColor2

- `custom` (string, required)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataFontFamily1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf5DataFontFamily2

- `custom` (string, required)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataRowsItemsFontSize

Font size in points or token

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataRowsItemsFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataHeaderRowsItemsFontSize

Font size in points or token

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataHeaderRowsItemsFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataFooterRowsItemsFontSize

Font size in points or token

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataFooterRowsItemsFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataLabelColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataValueColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf9DataColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf9DataColor2

- `custom` (string, required)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf11DataColumnsItemsWidth

Column width: number in the template lengthUnit (points when lengthUnit is omitted), percentage ('50%'), '*', or 'auto'

- double
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf0DataFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf0DataColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf2DataColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf4DataLabelColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf4DataValueColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf4DataFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataColumnsItemsWidth

Column width: number in the template lengthUnit (points when lengthUnit is omitted), '*' (fill), 'auto', or percentage ('50%')

- double
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataHeaderFillColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataHeaderTextColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataRowFill1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataRowFill2

- `custom` (string, required)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataAlternateRowFill1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataAlternateRowFill2

- `custom` (string, required)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataBodyTextColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataBodyTextColor2

- `custom` (string, required)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataFontFamily1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf5DataFontFamily2

- `custom` (string, required)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataRowsItemsFontSize

Font size in points or token

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataRowsItemsFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataHeaderRowsItemsFontSize

Font size in points or token

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataHeaderRowsItemsFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataFooterRowsItemsFontSize

Font size in points or token

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataFooterRowsItemsFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataLabelColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataValueColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf9DataColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf9DataColor2

- `custom` (string, required)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf11DataColumnsItemsWidth

Column width: number in the template lengthUnit (points when lengthUnit is omitted), percentage ('50%'), '*', or 'auto'

- double
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf0DataFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf0DataColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf2DataColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf4DataLabelColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf4DataValueColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf4DataFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataColumnsItemsWidth

Column width: number in the template lengthUnit (points when lengthUnit is omitted), '*' (fill), 'auto', or percentage ('50%')

- double
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataHeaderFillColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataHeaderTextColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataRowFill1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataRowFill2

- `custom` (string, required)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataAlternateRowFill1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataAlternateRowFill2

- `custom` (string, required)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataBodyTextColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataBodyTextColor2

- `custom` (string, required)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataFontFamily1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf5DataFontFamily2

- `custom` (string, required)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataRowsItemsFontSize

Font size in points or token

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataRowsItemsFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataHeaderRowsItemsFontSize

Font size in points or token

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataHeaderRowsItemsFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataFooterRowsItemsFontSize

Font size in points or token

- double
- ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataFooterRowsItemsFontSize1

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataLabelColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataValueColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf9DataColor1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf9DataColor2

- `custom` (string, required)

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf11DataColumnsItemsWidth

Column width: number in the template lengthUnit (points when lengthUnit is omitted), percentage ('50%'), '*', or 'auto'

- double
- string

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataRowsItemsFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataHeaderRowsItemsFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateBodyBlocksItemsOneOf6DataFooterRowsItemsFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataRowsItemsFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataHeaderRowsItemsFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateHeaderBlocksItemsOneOf6DataFooterRowsItemsFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataRowsItemsFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataHeaderRowsItemsFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

### ApiV1InvoiceCountryCodeFormatGeneratePostRequestBodyContentApplicationJsonSchemaFormatOptionsTemplateFooterBlocksItemsOneOf6DataFooterRowsItemsFontSize1

Reference to a design token

- `token` (string, required) — Token name from colorScheme or fontSizes

## Examples

### PDF generated successfully

**Request**

```json
{
  "invoice": {
    "invoiceNumber": "INV-2026-0042",
    "type": "invoice",
    "issueDate": "2026-03-20",
    "seller": {
      "name": "TechCorp GmbH",
      "countryCode": "DE",
      "street": "Kantstraße 12",
      "city": "Berlin",
      "postalCode": "10623",
      "taxId": "27/123/45678",
      "vatId": "DE136695976",
      "email": "billing@techcorp.de",
      "phone": "+49 30 1234567",
      "bankAccount": {
        "iban": "DE89370400440532013000",
        "bic": "COBADEFFXXX",
        "bankName": "Commerzbank"
      }
    },
    "buyer": {
      "name": "Muster GmbH",
      "countryCode": "DE",
      "street": "Hauptstraße 42",
      "city": "München",
      "postalCode": "80331",
      "vatId": "DE811569869",
      "email": "invoice@muster.de"
    },
    "items": [
      {
        "description": "Software Development Services — March 2026",
        "quantity": 40,
        "unit": "HUR",
        "unitPrice": 120,
        "netAmount": 4800,
        "taxAmount": 912,
        "position": 1,
        "articleNumber": "SVC-DEV-001",
        "taxRate": 19,
        "taxCategoryCode": "S",
        "grossAmount": 5712
      }
    ],
    "currency": "EUR",
    "subtotal": 4800,
    "total": 5712,
    "taxSummary": [
      {
        "netAmount": 4800,
        "taxAmount": 912,
        "taxRate": 19,
        "taxCategoryCode": "S"
      }
    ],
    "dueDate": "2026-04-19",
    "deliveryDate": "2026-03-20",
    "paymentTerms": {
      "dueDays": 30,
      "description": "Zahlbar innerhalb von 30 Tagen ohne Abzug",
      "earlyPaymentDiscount": {
        "days": 10,
        "discountPercent": 2
      }
    },
    "paymentMethods": [
      {
        "type": "bank_transfer",
        "details": "SEPA-Überweisung"
      }
    ],
    "notes": "Vielen Dank für Ihren Auftrag!",
    "countrySpecific": {
      "countryCode": "DE",
      "buyerReference": "04011000-12345-34",
      "paymentMeansCode": "58"
    }
  },
  "templateId": "550e8400-e29b-41d4-a716-446655440000"
}
```

**Response**

```json
{
  "success": true,
  "format": "pdf",
  "filename": "INV-2026-0042.pdf",
  "mimeType": "application/pdf",
  "hash": "a1b2c3d4e5f6...",
  "data": "JVBERi0xLjcKJeLjz9MK...",
  "payloadHash": "3d80b2995c1f..."
}
```

**SDK Code**

```python PDF generated successfully
import requests

url = "https://service.invoice-api.xhub.io/api/v1/invoice/de/pdf/generate"

payload = {
    "invoice": {
        "invoiceNumber": "INV-2026-0042",
        "type": "invoice",
        "issueDate": "2026-03-20",
        "seller": {
            "name": "TechCorp GmbH",
            "countryCode": "DE",
            "street": "Kantstraße 12",
            "city": "Berlin",
            "postalCode": "10623",
            "taxId": "27/123/45678",
            "vatId": "DE136695976",
            "email": "billing@techcorp.de",
            "phone": "+49 30 1234567",
            "bankAccount": {
                "iban": "DE89370400440532013000",
                "bic": "COBADEFFXXX",
                "bankName": "Commerzbank"
            }
        },
        "buyer": {
            "name": "Muster GmbH",
            "countryCode": "DE",
            "street": "Hauptstraße 42",
            "city": "München",
            "postalCode": "80331",
            "vatId": "DE811569869",
            "email": "invoice@muster.de"
        },
        "items": [
            {
                "description": "Software Development Services — March 2026",
                "quantity": 40,
                "unit": "HUR",
                "unitPrice": 120,
                "netAmount": 4800,
                "taxAmount": 912,
                "position": 1,
                "articleNumber": "SVC-DEV-001",
                "taxRate": 19,
                "taxCategoryCode": "S",
                "grossAmount": 5712
            }
        ],
        "currency": "EUR",
        "subtotal": 4800,
        "total": 5712,
        "taxSummary": [
            {
                "netAmount": 4800,
                "taxAmount": 912,
                "taxRate": 19,
                "taxCategoryCode": "S"
            }
        ],
        "dueDate": "2026-04-19",
        "deliveryDate": "2026-03-20",
        "paymentTerms": {
            "dueDays": 30,
            "description": "Zahlbar innerhalb von 30 Tagen ohne Abzug",
            "earlyPaymentDiscount": {
                "days": 10,
                "discountPercent": 2
            }
        },
        "paymentMethods": [
            {
                "type": "bank_transfer",
                "details": "SEPA-Überweisung"
            }
        ],
        "notes": "Vielen Dank für Ihren Auftrag!",
        "countrySpecific": {
            "countryCode": "DE",
            "buyerReference": "04011000-12345-34",
            "paymentMeansCode": "58"
        }
    },
    "templateId": "550e8400-e29b-41d4-a716-446655440000"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript PDF generated successfully
const url = 'https://service.invoice-api.xhub.io/api/v1/invoice/de/pdf/generate';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"invoice":{"invoiceNumber":"INV-2026-0042","type":"invoice","issueDate":"2026-03-20","seller":{"name":"TechCorp GmbH","countryCode":"DE","street":"Kantstraße 12","city":"Berlin","postalCode":"10623","taxId":"27/123/45678","vatId":"DE136695976","email":"billing@techcorp.de","phone":"+49 30 1234567","bankAccount":{"iban":"DE89370400440532013000","bic":"COBADEFFXXX","bankName":"Commerzbank"}},"buyer":{"name":"Muster GmbH","countryCode":"DE","street":"Hauptstraße 42","city":"München","postalCode":"80331","vatId":"DE811569869","email":"invoice@muster.de"},"items":[{"description":"Software Development Services — March 2026","quantity":40,"unit":"HUR","unitPrice":120,"netAmount":4800,"taxAmount":912,"position":1,"articleNumber":"SVC-DEV-001","taxRate":19,"taxCategoryCode":"S","grossAmount":5712}],"currency":"EUR","subtotal":4800,"total":5712,"taxSummary":[{"netAmount":4800,"taxAmount":912,"taxRate":19,"taxCategoryCode":"S"}],"dueDate":"2026-04-19","deliveryDate":"2026-03-20","paymentTerms":{"dueDays":30,"description":"Zahlbar innerhalb von 30 Tagen ohne Abzug","earlyPaymentDiscount":{"days":10,"discountPercent":2}},"paymentMethods":[{"type":"bank_transfer","details":"SEPA-Überweisung"}],"notes":"Vielen Dank für Ihren Auftrag!","countrySpecific":{"countryCode":"DE","buyerReference":"04011000-12345-34","paymentMeansCode":"58"}},"templateId":"550e8400-e29b-41d4-a716-446655440000"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go PDF generated successfully
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://service.invoice-api.xhub.io/api/v1/invoice/de/pdf/generate"

	payload := strings.NewReader("{\n  \"invoice\": {\n    \"invoiceNumber\": \"INV-2026-0042\",\n    \"type\": \"invoice\",\n    \"issueDate\": \"2026-03-20\",\n    \"seller\": {\n      \"name\": \"TechCorp GmbH\",\n      \"countryCode\": \"DE\",\n      \"street\": \"Kantstraße 12\",\n      \"city\": \"Berlin\",\n      \"postalCode\": \"10623\",\n      \"taxId\": \"27/123/45678\",\n      \"vatId\": \"DE136695976\",\n      \"email\": \"billing@techcorp.de\",\n      \"phone\": \"+49 30 1234567\",\n      \"bankAccount\": {\n        \"iban\": \"DE89370400440532013000\",\n        \"bic\": \"COBADEFFXXX\",\n        \"bankName\": \"Commerzbank\"\n      }\n    },\n    \"buyer\": {\n      \"name\": \"Muster GmbH\",\n      \"countryCode\": \"DE\",\n      \"street\": \"Hauptstraße 42\",\n      \"city\": \"München\",\n      \"postalCode\": \"80331\",\n      \"vatId\": \"DE811569869\",\n      \"email\": \"invoice@muster.de\"\n    },\n    \"items\": [\n      {\n        \"description\": \"Software Development Services — March 2026\",\n        \"quantity\": 40,\n        \"unit\": \"HUR\",\n        \"unitPrice\": 120,\n        \"netAmount\": 4800,\n        \"taxAmount\": 912,\n        \"position\": 1,\n        \"articleNumber\": \"SVC-DEV-001\",\n        \"taxRate\": 19,\n        \"taxCategoryCode\": \"S\",\n        \"grossAmount\": 5712\n      }\n    ],\n    \"currency\": \"EUR\",\n    \"subtotal\": 4800,\n    \"total\": 5712,\n    \"taxSummary\": [\n      {\n        \"netAmount\": 4800,\n        \"taxAmount\": 912,\n        \"taxRate\": 19,\n        \"taxCategoryCode\": \"S\"\n      }\n    ],\n    \"dueDate\": \"2026-04-19\",\n    \"deliveryDate\": \"2026-03-20\",\n    \"paymentTerms\": {\n      \"dueDays\": 30,\n      \"description\": \"Zahlbar innerhalb von 30 Tagen ohne Abzug\",\n      \"earlyPaymentDiscount\": {\n        \"days\": 10,\n        \"discountPercent\": 2\n      }\n    },\n    \"paymentMethods\": [\n      {\n        \"type\": \"bank_transfer\",\n        \"details\": \"SEPA-Überweisung\"\n      }\n    ],\n    \"notes\": \"Vielen Dank für Ihren Auftrag!\",\n    \"countrySpecific\": {\n      \"countryCode\": \"DE\",\n      \"buyerReference\": \"04011000-12345-34\",\n      \"paymentMeansCode\": \"58\"\n    }\n  },\n  \"templateId\": \"550e8400-e29b-41d4-a716-446655440000\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby PDF generated successfully
require 'uri'
require 'net/http'

url = URI("https://service.invoice-api.xhub.io/api/v1/invoice/de/pdf/generate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"invoice\": {\n    \"invoiceNumber\": \"INV-2026-0042\",\n    \"type\": \"invoice\",\n    \"issueDate\": \"2026-03-20\",\n    \"seller\": {\n      \"name\": \"TechCorp GmbH\",\n      \"countryCode\": \"DE\",\n      \"street\": \"Kantstraße 12\",\n      \"city\": \"Berlin\",\n      \"postalCode\": \"10623\",\n      \"taxId\": \"27/123/45678\",\n      \"vatId\": \"DE136695976\",\n      \"email\": \"billing@techcorp.de\",\n      \"phone\": \"+49 30 1234567\",\n      \"bankAccount\": {\n        \"iban\": \"DE89370400440532013000\",\n        \"bic\": \"COBADEFFXXX\",\n        \"bankName\": \"Commerzbank\"\n      }\n    },\n    \"buyer\": {\n      \"name\": \"Muster GmbH\",\n      \"countryCode\": \"DE\",\n      \"street\": \"Hauptstraße 42\",\n      \"city\": \"München\",\n      \"postalCode\": \"80331\",\n      \"vatId\": \"DE811569869\",\n      \"email\": \"invoice@muster.de\"\n    },\n    \"items\": [\n      {\n        \"description\": \"Software Development Services — March 2026\",\n        \"quantity\": 40,\n        \"unit\": \"HUR\",\n        \"unitPrice\": 120,\n        \"netAmount\": 4800,\n        \"taxAmount\": 912,\n        \"position\": 1,\n        \"articleNumber\": \"SVC-DEV-001\",\n        \"taxRate\": 19,\n        \"taxCategoryCode\": \"S\",\n        \"grossAmount\": 5712\n      }\n    ],\n    \"currency\": \"EUR\",\n    \"subtotal\": 4800,\n    \"total\": 5712,\n    \"taxSummary\": [\n      {\n        \"netAmount\": 4800,\n        \"taxAmount\": 912,\n        \"taxRate\": 19,\n        \"taxCategoryCode\": \"S\"\n      }\n    ],\n    \"dueDate\": \"2026-04-19\",\n    \"deliveryDate\": \"2026-03-20\",\n    \"paymentTerms\": {\n      \"dueDays\": 30,\n      \"description\": \"Zahlbar innerhalb von 30 Tagen ohne Abzug\",\n      \"earlyPaymentDiscount\": {\n        \"days\": 10,\n        \"discountPercent\": 2\n      }\n    },\n    \"paymentMethods\": [\n      {\n        \"type\": \"bank_transfer\",\n        \"details\": \"SEPA-Überweisung\"\n      }\n    ],\n    \"notes\": \"Vielen Dank für Ihren Auftrag!\",\n    \"countrySpecific\": {\n      \"countryCode\": \"DE\",\n      \"buyerReference\": \"04011000-12345-34\",\n      \"paymentMeansCode\": \"58\"\n    }\n  },\n  \"templateId\": \"550e8400-e29b-41d4-a716-446655440000\"\n}"

response = http.request(request)
puts response.read_body
```

```java PDF generated successfully
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://service.invoice-api.xhub.io/api/v1/invoice/de/pdf/generate")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"invoice\": {\n    \"invoiceNumber\": \"INV-2026-0042\",\n    \"type\": \"invoice\",\n    \"issueDate\": \"2026-03-20\",\n    \"seller\": {\n      \"name\": \"TechCorp GmbH\",\n      \"countryCode\": \"DE\",\n      \"street\": \"Kantstraße 12\",\n      \"city\": \"Berlin\",\n      \"postalCode\": \"10623\",\n      \"taxId\": \"27/123/45678\",\n      \"vatId\": \"DE136695976\",\n      \"email\": \"billing@techcorp.de\",\n      \"phone\": \"+49 30 1234567\",\n      \"bankAccount\": {\n        \"iban\": \"DE89370400440532013000\",\n        \"bic\": \"COBADEFFXXX\",\n        \"bankName\": \"Commerzbank\"\n      }\n    },\n    \"buyer\": {\n      \"name\": \"Muster GmbH\",\n      \"countryCode\": \"DE\",\n      \"street\": \"Hauptstraße 42\",\n      \"city\": \"München\",\n      \"postalCode\": \"80331\",\n      \"vatId\": \"DE811569869\",\n      \"email\": \"invoice@muster.de\"\n    },\n    \"items\": [\n      {\n        \"description\": \"Software Development Services — March 2026\",\n        \"quantity\": 40,\n        \"unit\": \"HUR\",\n        \"unitPrice\": 120,\n        \"netAmount\": 4800,\n        \"taxAmount\": 912,\n        \"position\": 1,\n        \"articleNumber\": \"SVC-DEV-001\",\n        \"taxRate\": 19,\n        \"taxCategoryCode\": \"S\",\n        \"grossAmount\": 5712\n      }\n    ],\n    \"currency\": \"EUR\",\n    \"subtotal\": 4800,\n    \"total\": 5712,\n    \"taxSummary\": [\n      {\n        \"netAmount\": 4800,\n        \"taxAmount\": 912,\n        \"taxRate\": 19,\n        \"taxCategoryCode\": \"S\"\n      }\n    ],\n    \"dueDate\": \"2026-04-19\",\n    \"deliveryDate\": \"2026-03-20\",\n    \"paymentTerms\": {\n      \"dueDays\": 30,\n      \"description\": \"Zahlbar innerhalb von 30 Tagen ohne Abzug\",\n      \"earlyPaymentDiscount\": {\n        \"days\": 10,\n        \"discountPercent\": 2\n      }\n    },\n    \"paymentMethods\": [\n      {\n        \"type\": \"bank_transfer\",\n        \"details\": \"SEPA-Überweisung\"\n      }\n    ],\n    \"notes\": \"Vielen Dank für Ihren Auftrag!\",\n    \"countrySpecific\": {\n      \"countryCode\": \"DE\",\n      \"buyerReference\": \"04011000-12345-34\",\n      \"paymentMeansCode\": \"58\"\n    }\n  },\n  \"templateId\": \"550e8400-e29b-41d4-a716-446655440000\"\n}")
  .asString();
```

```php PDF generated successfully
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://service.invoice-api.xhub.io/api/v1/invoice/de/pdf/generate', [
  'body' => '{
  "invoice": {
    "invoiceNumber": "INV-2026-0042",
    "type": "invoice",
    "issueDate": "2026-03-20",
    "seller": {
      "name": "TechCorp GmbH",
      "countryCode": "DE",
      "street": "Kantstraße 12",
      "city": "Berlin",
      "postalCode": "10623",
      "taxId": "27/123/45678",
      "vatId": "DE136695976",
      "email": "billing@techcorp.de",
      "phone": "+49 30 1234567",
      "bankAccount": {
        "iban": "DE89370400440532013000",
        "bic": "COBADEFFXXX",
        "bankName": "Commerzbank"
      }
    },
    "buyer": {
      "name": "Muster GmbH",
      "countryCode": "DE",
      "street": "Hauptstraße 42",
      "city": "München",
      "postalCode": "80331",
      "vatId": "DE811569869",
      "email": "invoice@muster.de"
    },
    "items": [
      {
        "description": "Software Development Services — March 2026",
        "quantity": 40,
        "unit": "HUR",
        "unitPrice": 120,
        "netAmount": 4800,
        "taxAmount": 912,
        "position": 1,
        "articleNumber": "SVC-DEV-001",
        "taxRate": 19,
        "taxCategoryCode": "S",
        "grossAmount": 5712
      }
    ],
    "currency": "EUR",
    "subtotal": 4800,
    "total": 5712,
    "taxSummary": [
      {
        "netAmount": 4800,
        "taxAmount": 912,
        "taxRate": 19,
        "taxCategoryCode": "S"
      }
    ],
    "dueDate": "2026-04-19",
    "deliveryDate": "2026-03-20",
    "paymentTerms": {
      "dueDays": 30,
      "description": "Zahlbar innerhalb von 30 Tagen ohne Abzug",
      "earlyPaymentDiscount": {
        "days": 10,
        "discountPercent": 2
      }
    },
    "paymentMethods": [
      {
        "type": "bank_transfer",
        "details": "SEPA-Überweisung"
      }
    ],
    "notes": "Vielen Dank für Ihren Auftrag!",
    "countrySpecific": {
      "countryCode": "DE",
      "buyerReference": "04011000-12345-34",
      "paymentMeansCode": "58"
    }
  },
  "templateId": "550e8400-e29b-41d4-a716-446655440000"
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp PDF generated successfully
using RestSharp;

var client = new RestClient("https://service.invoice-api.xhub.io/api/v1/invoice/de/pdf/generate");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"invoice\": {\n    \"invoiceNumber\": \"INV-2026-0042\",\n    \"type\": \"invoice\",\n    \"issueDate\": \"2026-03-20\",\n    \"seller\": {\n      \"name\": \"TechCorp GmbH\",\n      \"countryCode\": \"DE\",\n      \"street\": \"Kantstraße 12\",\n      \"city\": \"Berlin\",\n      \"postalCode\": \"10623\",\n      \"taxId\": \"27/123/45678\",\n      \"vatId\": \"DE136695976\",\n      \"email\": \"billing@techcorp.de\",\n      \"phone\": \"+49 30 1234567\",\n      \"bankAccount\": {\n        \"iban\": \"DE89370400440532013000\",\n        \"bic\": \"COBADEFFXXX\",\n        \"bankName\": \"Commerzbank\"\n      }\n    },\n    \"buyer\": {\n      \"name\": \"Muster GmbH\",\n      \"countryCode\": \"DE\",\n      \"street\": \"Hauptstraße 42\",\n      \"city\": \"München\",\n      \"postalCode\": \"80331\",\n      \"vatId\": \"DE811569869\",\n      \"email\": \"invoice@muster.de\"\n    },\n    \"items\": [\n      {\n        \"description\": \"Software Development Services — March 2026\",\n        \"quantity\": 40,\n        \"unit\": \"HUR\",\n        \"unitPrice\": 120,\n        \"netAmount\": 4800,\n        \"taxAmount\": 912,\n        \"position\": 1,\n        \"articleNumber\": \"SVC-DEV-001\",\n        \"taxRate\": 19,\n        \"taxCategoryCode\": \"S\",\n        \"grossAmount\": 5712\n      }\n    ],\n    \"currency\": \"EUR\",\n    \"subtotal\": 4800,\n    \"total\": 5712,\n    \"taxSummary\": [\n      {\n        \"netAmount\": 4800,\n        \"taxAmount\": 912,\n        \"taxRate\": 19,\n        \"taxCategoryCode\": \"S\"\n      }\n    ],\n    \"dueDate\": \"2026-04-19\",\n    \"deliveryDate\": \"2026-03-20\",\n    \"paymentTerms\": {\n      \"dueDays\": 30,\n      \"description\": \"Zahlbar innerhalb von 30 Tagen ohne Abzug\",\n      \"earlyPaymentDiscount\": {\n        \"days\": 10,\n        \"discountPercent\": 2\n      }\n    },\n    \"paymentMethods\": [\n      {\n        \"type\": \"bank_transfer\",\n        \"details\": \"SEPA-Überweisung\"\n      }\n    ],\n    \"notes\": \"Vielen Dank für Ihren Auftrag!\",\n    \"countrySpecific\": {\n      \"countryCode\": \"DE\",\n      \"buyerReference\": \"04011000-12345-34\",\n      \"paymentMeansCode\": \"58\"\n    }\n  },\n  \"templateId\": \"550e8400-e29b-41d4-a716-446655440000\"\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift PDF generated successfully
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [
  "invoice": [
    "invoiceNumber": "INV-2026-0042",
    "type": "invoice",
    "issueDate": "2026-03-20",
    "seller": [
      "name": "TechCorp GmbH",
      "countryCode": "DE",
      "street": "Kantstraße 12",
      "city": "Berlin",
      "postalCode": "10623",
      "taxId": "27/123/45678",
      "vatId": "DE136695976",
      "email": "billing@techcorp.de",
      "phone": "+49 30 1234567",
      "bankAccount": [
        "iban": "DE89370400440532013000",
        "bic": "COBADEFFXXX",
        "bankName": "Commerzbank"
      ]
    ],
    "buyer": [
      "name": "Muster GmbH",
      "countryCode": "DE",
      "street": "Hauptstraße 42",
      "city": "München",
      "postalCode": "80331",
      "vatId": "DE811569869",
      "email": "invoice@muster.de"
    ],
    "items": [
      [
        "description": "Software Development Services — March 2026",
        "quantity": 40,
        "unit": "HUR",
        "unitPrice": 120,
        "netAmount": 4800,
        "taxAmount": 912,
        "position": 1,
        "articleNumber": "SVC-DEV-001",
        "taxRate": 19,
        "taxCategoryCode": "S",
        "grossAmount": 5712
      ]
    ],
    "currency": "EUR",
    "subtotal": 4800,
    "total": 5712,
    "taxSummary": [
      [
        "netAmount": 4800,
        "taxAmount": 912,
        "taxRate": 19,
        "taxCategoryCode": "S"
      ]
    ],
    "dueDate": "2026-04-19",
    "deliveryDate": "2026-03-20",
    "paymentTerms": [
      "dueDays": 30,
      "description": "Zahlbar innerhalb von 30 Tagen ohne Abzug",
      "earlyPaymentDiscount": [
        "days": 10,
        "discountPercent": 2
      ]
    ],
    "paymentMethods": [
      [
        "type": "bank_transfer",
        "details": "SEPA-Überweisung"
      ]
    ],
    "notes": "Vielen Dank für Ihren Auftrag!",
    "countrySpecific": [
      "countryCode": "DE",
      "buyerReference": "04011000-12345-34",
      "paymentMeansCode": "58"
    ]
  ],
  "templateId": "550e8400-e29b-41d4-a716-446655440000"
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://service.invoice-api.xhub.io/api/v1/invoice/de/pdf/generate")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

### ZUGFeRD generated successfully

**Request**

```json
{
  "invoice": {
    "invoiceNumber": "INV-2026-0042",
    "type": "invoice",
    "issueDate": "2026-03-20",
    "seller": {
      "name": "TechCorp GmbH",
      "countryCode": "DE",
      "street": "Kantstraße 12",
      "city": "Berlin",
      "postalCode": "10623",
      "taxId": "27/123/45678",
      "vatId": "DE136695976",
      "email": "billing@techcorp.de",
      "phone": "+49 30 1234567",
      "bankAccount": {
        "iban": "DE89370400440532013000",
        "bic": "COBADEFFXXX",
        "bankName": "Commerzbank"
      }
    },
    "buyer": {
      "name": "Muster GmbH",
      "countryCode": "DE",
      "street": "Hauptstraße 42",
      "city": "München",
      "postalCode": "80331",
      "vatId": "DE811569869",
      "email": "invoice@muster.de"
    },
    "items": [
      {
        "description": "Software Development Services — March 2026",
        "quantity": 40,
        "unit": "HUR",
        "unitPrice": 120,
        "netAmount": 4800,
        "taxAmount": 912,
        "position": 1,
        "articleNumber": "SVC-DEV-001",
        "taxRate": 19,
        "taxCategoryCode": "S",
        "grossAmount": 5712
      }
    ],
    "currency": "EUR",
    "subtotal": 4800,
    "total": 5712,
    "taxSummary": [
      {
        "netAmount": 4800,
        "taxAmount": 912,
        "taxRate": 19,
        "taxCategoryCode": "S"
      }
    ],
    "dueDate": "2026-04-19",
    "deliveryDate": "2026-03-20",
    "paymentTerms": {
      "dueDays": 30,
      "description": "Zahlbar innerhalb von 30 Tagen ohne Abzug",
      "earlyPaymentDiscount": {
        "days": 10,
        "discountPercent": 2
      }
    },
    "paymentMethods": [
      {
        "type": "bank_transfer",
        "details": "SEPA-Überweisung"
      }
    ],
    "notes": "Vielen Dank für Ihren Auftrag!",
    "countrySpecific": {
      "countryCode": "DE",
      "buyerReference": "04011000-12345-34",
      "paymentMeansCode": "58"
    }
  },
  "templateId": "550e8400-e29b-41d4-a716-446655440000"
}
```

**Response**

```json
{
  "success": true,
  "format": "zugferd",
  "filename": "INV-2026-0042-zugferd.pdf",
  "mimeType": "application/pdf",
  "hash": "f6e5d4c3b2a1...",
  "data": "JVBERi0xLjcKJeLjz9MK...",
  "payloadHash": "3d80b2995c1f..."
}
```

**SDK Code**

```python ZUGFeRD generated successfully
import requests

url = "https://service.invoice-api.xhub.io/api/v1/invoice/de/pdf/generate"

payload = {
    "invoice": {
        "invoiceNumber": "INV-2026-0042",
        "type": "invoice",
        "issueDate": "2026-03-20",
        "seller": {
            "name": "TechCorp GmbH",
            "countryCode": "DE",
            "street": "Kantstraße 12",
            "city": "Berlin",
            "postalCode": "10623",
            "taxId": "27/123/45678",
            "vatId": "DE136695976",
            "email": "billing@techcorp.de",
            "phone": "+49 30 1234567",
            "bankAccount": {
                "iban": "DE89370400440532013000",
                "bic": "COBADEFFXXX",
                "bankName": "Commerzbank"
            }
        },
        "buyer": {
            "name": "Muster GmbH",
            "countryCode": "DE",
            "street": "Hauptstraße 42",
            "city": "München",
            "postalCode": "80331",
            "vatId": "DE811569869",
            "email": "invoice@muster.de"
        },
        "items": [
            {
                "description": "Software Development Services — March 2026",
                "quantity": 40,
                "unit": "HUR",
                "unitPrice": 120,
                "netAmount": 4800,
                "taxAmount": 912,
                "position": 1,
                "articleNumber": "SVC-DEV-001",
                "taxRate": 19,
                "taxCategoryCode": "S",
                "grossAmount": 5712
            }
        ],
        "currency": "EUR",
        "subtotal": 4800,
        "total": 5712,
        "taxSummary": [
            {
                "netAmount": 4800,
                "taxAmount": 912,
                "taxRate": 19,
                "taxCategoryCode": "S"
            }
        ],
        "dueDate": "2026-04-19",
        "deliveryDate": "2026-03-20",
        "paymentTerms": {
            "dueDays": 30,
            "description": "Zahlbar innerhalb von 30 Tagen ohne Abzug",
            "earlyPaymentDiscount": {
                "days": 10,
                "discountPercent": 2
            }
        },
        "paymentMethods": [
            {
                "type": "bank_transfer",
                "details": "SEPA-Überweisung"
            }
        ],
        "notes": "Vielen Dank für Ihren Auftrag!",
        "countrySpecific": {
            "countryCode": "DE",
            "buyerReference": "04011000-12345-34",
            "paymentMeansCode": "58"
        }
    },
    "templateId": "550e8400-e29b-41d4-a716-446655440000"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript ZUGFeRD generated successfully
const url = 'https://service.invoice-api.xhub.io/api/v1/invoice/de/pdf/generate';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"invoice":{"invoiceNumber":"INV-2026-0042","type":"invoice","issueDate":"2026-03-20","seller":{"name":"TechCorp GmbH","countryCode":"DE","street":"Kantstraße 12","city":"Berlin","postalCode":"10623","taxId":"27/123/45678","vatId":"DE136695976","email":"billing@techcorp.de","phone":"+49 30 1234567","bankAccount":{"iban":"DE89370400440532013000","bic":"COBADEFFXXX","bankName":"Commerzbank"}},"buyer":{"name":"Muster GmbH","countryCode":"DE","street":"Hauptstraße 42","city":"München","postalCode":"80331","vatId":"DE811569869","email":"invoice@muster.de"},"items":[{"description":"Software Development Services — March 2026","quantity":40,"unit":"HUR","unitPrice":120,"netAmount":4800,"taxAmount":912,"position":1,"articleNumber":"SVC-DEV-001","taxRate":19,"taxCategoryCode":"S","grossAmount":5712}],"currency":"EUR","subtotal":4800,"total":5712,"taxSummary":[{"netAmount":4800,"taxAmount":912,"taxRate":19,"taxCategoryCode":"S"}],"dueDate":"2026-04-19","deliveryDate":"2026-03-20","paymentTerms":{"dueDays":30,"description":"Zahlbar innerhalb von 30 Tagen ohne Abzug","earlyPaymentDiscount":{"days":10,"discountPercent":2}},"paymentMethods":[{"type":"bank_transfer","details":"SEPA-Überweisung"}],"notes":"Vielen Dank für Ihren Auftrag!","countrySpecific":{"countryCode":"DE","buyerReference":"04011000-12345-34","paymentMeansCode":"58"}},"templateId":"550e8400-e29b-41d4-a716-446655440000"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go ZUGFeRD generated successfully
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://service.invoice-api.xhub.io/api/v1/invoice/de/pdf/generate"

	payload := strings.NewReader("{\n  \"invoice\": {\n    \"invoiceNumber\": \"INV-2026-0042\",\n    \"type\": \"invoice\",\n    \"issueDate\": \"2026-03-20\",\n    \"seller\": {\n      \"name\": \"TechCorp GmbH\",\n      \"countryCode\": \"DE\",\n      \"street\": \"Kantstraße 12\",\n      \"city\": \"Berlin\",\n      \"postalCode\": \"10623\",\n      \"taxId\": \"27/123/45678\",\n      \"vatId\": \"DE136695976\",\n      \"email\": \"billing@techcorp.de\",\n      \"phone\": \"+49 30 1234567\",\n      \"bankAccount\": {\n        \"iban\": \"DE89370400440532013000\",\n        \"bic\": \"COBADEFFXXX\",\n        \"bankName\": \"Commerzbank\"\n      }\n    },\n    \"buyer\": {\n      \"name\": \"Muster GmbH\",\n      \"countryCode\": \"DE\",\n      \"street\": \"Hauptstraße 42\",\n      \"city\": \"München\",\n      \"postalCode\": \"80331\",\n      \"vatId\": \"DE811569869\",\n      \"email\": \"invoice@muster.de\"\n    },\n    \"items\": [\n      {\n        \"description\": \"Software Development Services — March 2026\",\n        \"quantity\": 40,\n        \"unit\": \"HUR\",\n        \"unitPrice\": 120,\n        \"netAmount\": 4800,\n        \"taxAmount\": 912,\n        \"position\": 1,\n        \"articleNumber\": \"SVC-DEV-001\",\n        \"taxRate\": 19,\n        \"taxCategoryCode\": \"S\",\n        \"grossAmount\": 5712\n      }\n    ],\n    \"currency\": \"EUR\",\n    \"subtotal\": 4800,\n    \"total\": 5712,\n    \"taxSummary\": [\n      {\n        \"netAmount\": 4800,\n        \"taxAmount\": 912,\n        \"taxRate\": 19,\n        \"taxCategoryCode\": \"S\"\n      }\n    ],\n    \"dueDate\": \"2026-04-19\",\n    \"deliveryDate\": \"2026-03-20\",\n    \"paymentTerms\": {\n      \"dueDays\": 30,\n      \"description\": \"Zahlbar innerhalb von 30 Tagen ohne Abzug\",\n      \"earlyPaymentDiscount\": {\n        \"days\": 10,\n        \"discountPercent\": 2\n      }\n    },\n    \"paymentMethods\": [\n      {\n        \"type\": \"bank_transfer\",\n        \"details\": \"SEPA-Überweisung\"\n      }\n    ],\n    \"notes\": \"Vielen Dank für Ihren Auftrag!\",\n    \"countrySpecific\": {\n      \"countryCode\": \"DE\",\n      \"buyerReference\": \"04011000-12345-34\",\n      \"paymentMeansCode\": \"58\"\n    }\n  },\n  \"templateId\": \"550e8400-e29b-41d4-a716-446655440000\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby ZUGFeRD generated successfully
require 'uri'
require 'net/http'

url = URI("https://service.invoice-api.xhub.io/api/v1/invoice/de/pdf/generate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"invoice\": {\n    \"invoiceNumber\": \"INV-2026-0042\",\n    \"type\": \"invoice\",\n    \"issueDate\": \"2026-03-20\",\n    \"seller\": {\n      \"name\": \"TechCorp GmbH\",\n      \"countryCode\": \"DE\",\n      \"street\": \"Kantstraße 12\",\n      \"city\": \"Berlin\",\n      \"postalCode\": \"10623\",\n      \"taxId\": \"27/123/45678\",\n      \"vatId\": \"DE136695976\",\n      \"email\": \"billing@techcorp.de\",\n      \"phone\": \"+49 30 1234567\",\n      \"bankAccount\": {\n        \"iban\": \"DE89370400440532013000\",\n        \"bic\": \"COBADEFFXXX\",\n        \"bankName\": \"Commerzbank\"\n      }\n    },\n    \"buyer\": {\n      \"name\": \"Muster GmbH\",\n      \"countryCode\": \"DE\",\n      \"street\": \"Hauptstraße 42\",\n      \"city\": \"München\",\n      \"postalCode\": \"80331\",\n      \"vatId\": \"DE811569869\",\n      \"email\": \"invoice@muster.de\"\n    },\n    \"items\": [\n      {\n        \"description\": \"Software Development Services — March 2026\",\n        \"quantity\": 40,\n        \"unit\": \"HUR\",\n        \"unitPrice\": 120,\n        \"netAmount\": 4800,\n        \"taxAmount\": 912,\n        \"position\": 1,\n        \"articleNumber\": \"SVC-DEV-001\",\n        \"taxRate\": 19,\n        \"taxCategoryCode\": \"S\",\n        \"grossAmount\": 5712\n      }\n    ],\n    \"currency\": \"EUR\",\n    \"subtotal\": 4800,\n    \"total\": 5712,\n    \"taxSummary\": [\n      {\n        \"netAmount\": 4800,\n        \"taxAmount\": 912,\n        \"taxRate\": 19,\n        \"taxCategoryCode\": \"S\"\n      }\n    ],\n    \"dueDate\": \"2026-04-19\",\n    \"deliveryDate\": \"2026-03-20\",\n    \"paymentTerms\": {\n      \"dueDays\": 30,\n      \"description\": \"Zahlbar innerhalb von 30 Tagen ohne Abzug\",\n      \"earlyPaymentDiscount\": {\n        \"days\": 10,\n        \"discountPercent\": 2\n      }\n    },\n    \"paymentMethods\": [\n      {\n        \"type\": \"bank_transfer\",\n        \"details\": \"SEPA-Überweisung\"\n      }\n    ],\n    \"notes\": \"Vielen Dank für Ihren Auftrag!\",\n    \"countrySpecific\": {\n      \"countryCode\": \"DE\",\n      \"buyerReference\": \"04011000-12345-34\",\n      \"paymentMeansCode\": \"58\"\n    }\n  },\n  \"templateId\": \"550e8400-e29b-41d4-a716-446655440000\"\n}"

response = http.request(request)
puts response.read_body
```

```java ZUGFeRD generated successfully
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://service.invoice-api.xhub.io/api/v1/invoice/de/pdf/generate")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"invoice\": {\n    \"invoiceNumber\": \"INV-2026-0042\",\n    \"type\": \"invoice\",\n    \"issueDate\": \"2026-03-20\",\n    \"seller\": {\n      \"name\": \"TechCorp GmbH\",\n      \"countryCode\": \"DE\",\n      \"street\": \"Kantstraße 12\",\n      \"city\": \"Berlin\",\n      \"postalCode\": \"10623\",\n      \"taxId\": \"27/123/45678\",\n      \"vatId\": \"DE136695976\",\n      \"email\": \"billing@techcorp.de\",\n      \"phone\": \"+49 30 1234567\",\n      \"bankAccount\": {\n        \"iban\": \"DE89370400440532013000\",\n        \"bic\": \"COBADEFFXXX\",\n        \"bankName\": \"Commerzbank\"\n      }\n    },\n    \"buyer\": {\n      \"name\": \"Muster GmbH\",\n      \"countryCode\": \"DE\",\n      \"street\": \"Hauptstraße 42\",\n      \"city\": \"München\",\n      \"postalCode\": \"80331\",\n      \"vatId\": \"DE811569869\",\n      \"email\": \"invoice@muster.de\"\n    },\n    \"items\": [\n      {\n        \"description\": \"Software Development Services — March 2026\",\n        \"quantity\": 40,\n        \"unit\": \"HUR\",\n        \"unitPrice\": 120,\n        \"netAmount\": 4800,\n        \"taxAmount\": 912,\n        \"position\": 1,\n        \"articleNumber\": \"SVC-DEV-001\",\n        \"taxRate\": 19,\n        \"taxCategoryCode\": \"S\",\n        \"grossAmount\": 5712\n      }\n    ],\n    \"currency\": \"EUR\",\n    \"subtotal\": 4800,\n    \"total\": 5712,\n    \"taxSummary\": [\n      {\n        \"netAmount\": 4800,\n        \"taxAmount\": 912,\n        \"taxRate\": 19,\n        \"taxCategoryCode\": \"S\"\n      }\n    ],\n    \"dueDate\": \"2026-04-19\",\n    \"deliveryDate\": \"2026-03-20\",\n    \"paymentTerms\": {\n      \"dueDays\": 30,\n      \"description\": \"Zahlbar innerhalb von 30 Tagen ohne Abzug\",\n      \"earlyPaymentDiscount\": {\n        \"days\": 10,\n        \"discountPercent\": 2\n      }\n    },\n    \"paymentMethods\": [\n      {\n        \"type\": \"bank_transfer\",\n        \"details\": \"SEPA-Überweisung\"\n      }\n    ],\n    \"notes\": \"Vielen Dank für Ihren Auftrag!\",\n    \"countrySpecific\": {\n      \"countryCode\": \"DE\",\n      \"buyerReference\": \"04011000-12345-34\",\n      \"paymentMeansCode\": \"58\"\n    }\n  },\n  \"templateId\": \"550e8400-e29b-41d4-a716-446655440000\"\n}")
  .asString();
```

```php ZUGFeRD generated successfully
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://service.invoice-api.xhub.io/api/v1/invoice/de/pdf/generate', [
  'body' => '{
  "invoice": {
    "invoiceNumber": "INV-2026-0042",
    "type": "invoice",
    "issueDate": "2026-03-20",
    "seller": {
      "name": "TechCorp GmbH",
      "countryCode": "DE",
      "street": "Kantstraße 12",
      "city": "Berlin",
      "postalCode": "10623",
      "taxId": "27/123/45678",
      "vatId": "DE136695976",
      "email": "billing@techcorp.de",
      "phone": "+49 30 1234567",
      "bankAccount": {
        "iban": "DE89370400440532013000",
        "bic": "COBADEFFXXX",
        "bankName": "Commerzbank"
      }
    },
    "buyer": {
      "name": "Muster GmbH",
      "countryCode": "DE",
      "street": "Hauptstraße 42",
      "city": "München",
      "postalCode": "80331",
      "vatId": "DE811569869",
      "email": "invoice@muster.de"
    },
    "items": [
      {
        "description": "Software Development Services — March 2026",
        "quantity": 40,
        "unit": "HUR",
        "unitPrice": 120,
        "netAmount": 4800,
        "taxAmount": 912,
        "position": 1,
        "articleNumber": "SVC-DEV-001",
        "taxRate": 19,
        "taxCategoryCode": "S",
        "grossAmount": 5712
      }
    ],
    "currency": "EUR",
    "subtotal": 4800,
    "total": 5712,
    "taxSummary": [
      {
        "netAmount": 4800,
        "taxAmount": 912,
        "taxRate": 19,
        "taxCategoryCode": "S"
      }
    ],
    "dueDate": "2026-04-19",
    "deliveryDate": "2026-03-20",
    "paymentTerms": {
      "dueDays": 30,
      "description": "Zahlbar innerhalb von 30 Tagen ohne Abzug",
      "earlyPaymentDiscount": {
        "days": 10,
        "discountPercent": 2
      }
    },
    "paymentMethods": [
      {
        "type": "bank_transfer",
        "details": "SEPA-Überweisung"
      }
    ],
    "notes": "Vielen Dank für Ihren Auftrag!",
    "countrySpecific": {
      "countryCode": "DE",
      "buyerReference": "04011000-12345-34",
      "paymentMeansCode": "58"
    }
  },
  "templateId": "550e8400-e29b-41d4-a716-446655440000"
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp ZUGFeRD generated successfully
using RestSharp;

var client = new RestClient("https://service.invoice-api.xhub.io/api/v1/invoice/de/pdf/generate");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"invoice\": {\n    \"invoiceNumber\": \"INV-2026-0042\",\n    \"type\": \"invoice\",\n    \"issueDate\": \"2026-03-20\",\n    \"seller\": {\n      \"name\": \"TechCorp GmbH\",\n      \"countryCode\": \"DE\",\n      \"street\": \"Kantstraße 12\",\n      \"city\": \"Berlin\",\n      \"postalCode\": \"10623\",\n      \"taxId\": \"27/123/45678\",\n      \"vatId\": \"DE136695976\",\n      \"email\": \"billing@techcorp.de\",\n      \"phone\": \"+49 30 1234567\",\n      \"bankAccount\": {\n        \"iban\": \"DE89370400440532013000\",\n        \"bic\": \"COBADEFFXXX\",\n        \"bankName\": \"Commerzbank\"\n      }\n    },\n    \"buyer\": {\n      \"name\": \"Muster GmbH\",\n      \"countryCode\": \"DE\",\n      \"street\": \"Hauptstraße 42\",\n      \"city\": \"München\",\n      \"postalCode\": \"80331\",\n      \"vatId\": \"DE811569869\",\n      \"email\": \"invoice@muster.de\"\n    },\n    \"items\": [\n      {\n        \"description\": \"Software Development Services — March 2026\",\n        \"quantity\": 40,\n        \"unit\": \"HUR\",\n        \"unitPrice\": 120,\n        \"netAmount\": 4800,\n        \"taxAmount\": 912,\n        \"position\": 1,\n        \"articleNumber\": \"SVC-DEV-001\",\n        \"taxRate\": 19,\n        \"taxCategoryCode\": \"S\",\n        \"grossAmount\": 5712\n      }\n    ],\n    \"currency\": \"EUR\",\n    \"subtotal\": 4800,\n    \"total\": 5712,\n    \"taxSummary\": [\n      {\n        \"netAmount\": 4800,\n        \"taxAmount\": 912,\n        \"taxRate\": 19,\n        \"taxCategoryCode\": \"S\"\n      }\n    ],\n    \"dueDate\": \"2026-04-19\",\n    \"deliveryDate\": \"2026-03-20\",\n    \"paymentTerms\": {\n      \"dueDays\": 30,\n      \"description\": \"Zahlbar innerhalb von 30 Tagen ohne Abzug\",\n      \"earlyPaymentDiscount\": {\n        \"days\": 10,\n        \"discountPercent\": 2\n      }\n    },\n    \"paymentMethods\": [\n      {\n        \"type\": \"bank_transfer\",\n        \"details\": \"SEPA-Überweisung\"\n      }\n    ],\n    \"notes\": \"Vielen Dank für Ihren Auftrag!\",\n    \"countrySpecific\": {\n      \"countryCode\": \"DE\",\n      \"buyerReference\": \"04011000-12345-34\",\n      \"paymentMeansCode\": \"58\"\n    }\n  },\n  \"templateId\": \"550e8400-e29b-41d4-a716-446655440000\"\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift ZUGFeRD generated successfully
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [
  "invoice": [
    "invoiceNumber": "INV-2026-0042",
    "type": "invoice",
    "issueDate": "2026-03-20",
    "seller": [
      "name": "TechCorp GmbH",
      "countryCode": "DE",
      "street": "Kantstraße 12",
      "city": "Berlin",
      "postalCode": "10623",
      "taxId": "27/123/45678",
      "vatId": "DE136695976",
      "email": "billing@techcorp.de",
      "phone": "+49 30 1234567",
      "bankAccount": [
        "iban": "DE89370400440532013000",
        "bic": "COBADEFFXXX",
        "bankName": "Commerzbank"
      ]
    ],
    "buyer": [
      "name": "Muster GmbH",
      "countryCode": "DE",
      "street": "Hauptstraße 42",
      "city": "München",
      "postalCode": "80331",
      "vatId": "DE811569869",
      "email": "invoice@muster.de"
    ],
    "items": [
      [
        "description": "Software Development Services — March 2026",
        "quantity": 40,
        "unit": "HUR",
        "unitPrice": 120,
        "netAmount": 4800,
        "taxAmount": 912,
        "position": 1,
        "articleNumber": "SVC-DEV-001",
        "taxRate": 19,
        "taxCategoryCode": "S",
        "grossAmount": 5712
      ]
    ],
    "currency": "EUR",
    "subtotal": 4800,
    "total": 5712,
    "taxSummary": [
      [
        "netAmount": 4800,
        "taxAmount": 912,
        "taxRate": 19,
        "taxCategoryCode": "S"
      ]
    ],
    "dueDate": "2026-04-19",
    "deliveryDate": "2026-03-20",
    "paymentTerms": [
      "dueDays": 30,
      "description": "Zahlbar innerhalb von 30 Tagen ohne Abzug",
      "earlyPaymentDiscount": [
        "days": 10,
        "discountPercent": 2
      ]
    ],
    "paymentMethods": [
      [
        "type": "bank_transfer",
        "details": "SEPA-Überweisung"
      ]
    ],
    "notes": "Vielen Dank für Ihren Auftrag!",
    "countrySpecific": [
      "countryCode": "DE",
      "buyerReference": "04011000-12345-34",
      "paymentMeansCode": "58"
    ]
  ],
  "templateId": "550e8400-e29b-41d4-a716-446655440000"
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://service.invoice-api.xhub.io/api/v1/invoice/de/pdf/generate")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```