InvoiceGlass

Extra UBL field “Document hash / Additional document reference › attachment › external reference” · UBL-CR-121

  • Severity · Warning
  • Applies to · UBL
  • Editorial review pending

The CEN check flags the XML element cbc:DocumentHash in UBL invoices and credit notes. It checks for document hash under “additional document reference › attachment › external reference”.

As of

Who can correct it?

The invoicing software provider can correct the export.

How to fix it

  1. Find the entry in the UBL export at cac:AdditionalDocumentReference/cac:Attachment/cac:ExternalReference/cbc:DocumentHash.
  2. Adjust the export to omit cbc:DocumentHash at this location. If you need the information, first check where the selected profile expects it.

Rule text and source

Paraphrase · The test reports a finding as soon as cac:AdditionalDocumentReference/cac:Attachment/cac:ExternalReference/cbc:DocumentHash returns at least one match.

Message to the sender

Hello,

rule UBL-CR-121 was triggered when checking electronic invoice {invoiceNumber}. The validator flagged document hash under “additional document reference › attachment › external reference”. Could you check the export and send us a corrected file?

Kind regards

Example

The rule flags cbc:DocumentHash under “additional document reference › attachment › external reference”. The corrected export omits that element from the affected section.

UBL

cac:AdditionalDocumentReference/cac:Attachment/cac:ExternalReference/cbc:DocumentHash

Fails the rule
<cbc:DocumentHash>d41d8cd98f00b204e9800998ecf8427e</cbc:DocumentHash>

Corrected
<!-- optional element omitted -->

Rule versions

CEN · EN 16931 (KoSIT) 1.3.16

CEN · EN 16931 1.3.17

Validate a file