Blocks inside a column of an inline PDF template — rejected from 2027-01-01
/generate checks the header, body and footer blocks of formatOptions.template, but blocks inside a column of a
columns block went to the renderer unchecked. They are now checked with the same rules, including columns in header
and footer and columns inside columns.
- Until 2026-12-31: the block is rendered as sent, with the warning
TEMPLATE_BLOCK_INVALID.fieldis the path (for exampleformatOptions.template.body.blocks.1.data.columns.0.blocks.0),params.rejectFromis2027-01-01. - From 2027-01-01: such a block is rejected with 400, with the same finding as a top-level block.
enforcePending: truegives you the 400 now.
Templates selected with templateId, and country templates, are not checked here.
Do I need to act? If you see TEMPLATE_BLOCK_INVALID, change the block at field before 2027-01-01.
Currency code checked against ISO 4217
invoice.currency must be an ISO 4217 code — three upper-case letters such as EUR. Before, whether a wrong code was
rejected depended on the format. On /generate, /validate, /embed and /embed/upload, a code that is not in
ISO 4217 now adds the warning CURRENCY_CODE_UNKNOWN with field: "currency". The answer is otherwise unchanged. The
check is case-sensitive (eur is not EUR); we do not change your code. A code that is in ISO 4217 but not allowed by
a format (for example BGN in EN 16931) is still checked by that format’s rules.
Do I need to act? If you see CURRENCY_CODE_UNKNOWN, fix the code.
PDF template: page break, watermark and barcode
formatOptions.template now accepts three more block types in header, body and footer (rejected with 400
before):
pageBreak— starts a new page; optionaldata.label(max. 100 characters).watermark— text across every page, behind the content;data.textrequired (max. 100). OptionalfontSize,color,opacity(0–1),rotation(−90 to 90),bold,font.barcode— 1D barcode or Data Matrix;data.contentrequired (max. 200, placeholders such as{{invoiceNumber}}allowed). Optionalformat(code128default;code39,code93,ean13,ean8,upca,upce,itf14,codabar,datamatrix),width,height(inlengthUnit),alignment,includeText.
Limits count the characters in the template, before placeholders are filled. bordered, chart, formField,
repeater and toc are still rejected with 400.
Dates: preceding invoice date and empty strings
- The
YYYY-MM-DDrule with theDATE_NOT_ISOwarning (rejected from 2026-11-16) now also covers the preceding invoice date (BT-26):referencedInvoiceDate,precedingInvoiceReferences[].issueDateanditems[].creditedFrom.invoiceIssueDate. - An empty string (
"") indueDate,deliveryDate,delivery.date,servicePeriod.start/endoritems[].servicePeriod.start/endis left out of the document with the warningDATE_EMPTY_IGNORED(field). Omit the field or sendYYYY-MM-DD.
