Saltar para o conteúdo

Aviso

UBL-CR-121: Retire a soma de verificação das referências externas a anexos

Em resumo

Aviso: convém verificar.

UBL-CR-121 significa que o seu ficheiro UBL contém uma soma de verificação (cbc:DocumentHash) em cac:AdditionalDocumentReference/cac:Attachment/cac:ExternalReference. Elimine cbc:DocumentHash dessa referência externa e volte a verificar o ficheiro.

Nesta página

O que significa

Numa fatura ou nota de crédito UBL, esta regra verifica que nenhum cac:AdditionalDocumentReference/cac:Attachment/cac:ExternalReference contém cbc:DocumentHash, uma soma de verificação do ficheiro referenciado. Num documento anexo (BG-24), a ligação externa (BT-124) fica em cbc:URI, na mesma referência externa. A verificação aplica-se mesmo que cbc:URI não esteja presente.

Porque é importante

A EN 16931 recomenda omitir a soma de verificação das referências externas a anexos. Esta regra verifica a estrutura XML, não se o ficheiro referenciado foi alterado.

Como corrigir

Elimine cbc:DocumentHash de cac:AdditionalDocumentReference/cac:Attachment/cac:ExternalReference e mantenha qualquer cbc:URI existente nesse local. Se usar software de faturação, peça ao respetivo suporte que deixe de exportar cbc:DocumentHash nesse local. Volte a verificar o ficheiro corrigido.

Depois de corrigir o ficheiro, volte a verificá-lo gratuitamente: Verificar uma fatura eletrónica

Ou corrija a fatura num formulário e transfira o ficheiro corrigido, por 1 crédito: Corrigir uma fatura eletrónica rejeitada

A regra tal como foi publicada

A UBL invoice should not include the AdditionalDocumentReference Attachment External DocumentHash

Onde esta regra se aplica

Conjunto de regras Versão
EN 16931 (UBL) 1.3.17
EN 16931 (UBL credit note) 1.3.17
XRechnung 3.0 (UBL) 3.0.2
XRechnung 3.0 (UBL credit note) 3.0.2
Peppol BIS Billing 3.0 (invoice) 2026.5
Peppol BIS Billing 3.0 (credit note) 2026.5
SI-UBL 2.0 / NLCIUS (invoice) 2.0.3.13
SI-UBL 2.0 / NLCIUS (credit note) 2.0.3.13
France CTC (UBL invoice) 1.4.0-04
France CTC (UBL credit note) 1.4.0-04
CIUS-RO UBL Invoice 1.0.9 1.0.9
CIUS-RO UBL Credit Note 1.0.9 1.0.9
Texto da regra retirado de phive-rules 4.6.4.

Verifique o seu ficheiro

Arraste para aqui a sua fatura eletrónica para ver se a regra UBL-CR-121 ainda falha e que outras regras falham.

Atualizado em 7 de novembro de 2026