BR-CL-24Attachment type isn't allowed

ErrorEN 16931BT-125

What it means

An embedded attachment must declare one of six MIME codes: application/pdf, image/png, image/jpeg, text/csv, an Excel (.xlsx) or an OpenDocument (.ods) spreadsheet. Anything else — a Word file, a ZIP, an XML, or a misspelt code like ‘application/PDF’ or ‘pdf’ — fails.

Official message

Rejects the invoice (fatal)
[BR-CL-24]-For Mime code in attribute use MIMEMediaType.

EN 16931 validation artefacts 1.3.17, CEN/TC 434, released 12 October 2026 · Read the rule at the source

Peppol BIS 3.0.22 runs these EN 16931 checks with the CEN artefacts 1.3.16; the message is the same.

Text compared with the published file on 17 November 2026.

Direct fix

Write the MIME type: mimeCode="application/pdf". Peppol accepts only application/pdf, image/png, image/jpeg, text/csv, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (.xlsx) and application/vnd.oasis.opendocument.spreadsheet (.ods); convert anything else to PDF.

Typical causes

  • The file extension is written instead of the MIME type: “pdf”, “.pdf”, “PDF”.
  • A generic upload sets application/octet-stream.
  • A typo such as image/jpg (the type is image/jpeg).

How to fix it

  1. Set mimeCode to exactly application/pdf for a PDF copy of the invoice.
  2. Convert other attachments to PDF, PNG, JPEG, CSV, XLSX or ODS, or send them outside the e-invoice.
  3. If the attachment adds nothing, leave it out: the e-invoice itself is the legal invoice.

Before and after

A real invoice from our sample library, cut down to the lines that matter. The first version fails BR-CL-24; the second passes.

The PDF copy is attached with mimeCode “pdf”, the file extension. In Peppol, PEPPOL-EN16931-CL001 fails along with it.

Before: fails BR-CL-24
<cac:AdditionalDocumentReference>  <cbc:ID>2026/0918</cbc:ID>  <cbc:DocumentDescription>Invoice 2026/0918 (PDF copy)</cbc:DocumentDescription>  <cac:Attachment>    <cbc:EmbeddedDocumentBinaryObject mimeCode="pdf" filename="2026-0918.pdf">JVBERi0xLjQKJSVFT0YK</cbc:EmbeddedDocumentBinaryObject>  </cac:Attachment></cac:AdditionalDocumentReference>
After: passes
<cac:AdditionalDocumentReference>  <cbc:ID>2026/0918</cbc:ID>  <cbc:DocumentDescription>Invoice 2026/0918 (PDF copy)</cbc:DocumentDescription>  <cac:Attachment>    <cbc:EmbeddedDocumentBinaryObject mimeCode="application/pdf" filename="2026-0918.pdf">JVBERi0xLjQKJSVFT0YK</cbc:EmbeddedDocumentBinaryObject>  </cac:Attachment></cac:AdditionalDocumentReference>

It’s one of our sample files, so checking it doesn’t count towards your free validations.

Check your invoice for BR-CL-24

Open the free validator with BR-CL-24 already explained: paste or upload your XML and the finding, if any, is highlighted with its exact line.

Check my invoice

3 free validations a month without an account. Invoice contents are never stored.

Where validators check it

For developers and software suppliers: the test exactly as the official Schematron runs it. The validator applies it to every element that matches the context and reports the rule wherever the test comes out false.

UBL 2.1BR-CL-24
Runs on (context)
cbc:EmbeddedDocumentBinaryObject[@mimeCode]
Test
((@mimeCode = 'application/pdf' or @mimeCode = 'image/png' or @mimeCode = 'image/jpeg' or @mimeCode = 'text/csv' or @mimeCode = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' or @mimeCode = 'application/vnd.oasis.opendocument.spreadsheet'))

Copied from EN16931-UBL-codes.sch, EN 16931 validation artefacts 1.3.17. Text compared with the published file on 17 November 2026.

UN/CEFACT CIIBR-CL-24
Runs on (context)
ram:AttachmentBinaryObject[@mimeCode]
Test
((@mimeCode = 'application/pdf' or @mimeCode = 'image/png' or @mimeCode = 'image/jpeg' or @mimeCode = 'text/csv' or @mimeCode = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' or @mimeCode = 'application/vnd.oasis.opendocument.spreadsheet'))

Copied from EN16931-CII-codes.sch, EN 16931 validation artefacts 1.3.17. Text compared with the published file on 17 November 2026.

What the rule says (technical)

For Mime code in attribute use MIMEMediaType: application/pdf, image/png, image/jpeg, text/csv, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet or application/vnd.oasis.opendocument.spreadsheet.

Set mimeCode to one of the six allowed values (application/pdf for a PDF copy) or remove the attachment.

More errors with a worked fix

Related rules