Saltar para o conteúdo

Aviso

UBL-CR-589: Referências a documentos de catálogo não são usadas nas linhas

Em resumo

Aviso: convém verificar.

UBL-CR-589 significa que uma linha da fatura ou da nota de crédito remete para um documento de catálogo (cac:CatalogueDocumentReference), que a norma EN 16931 não utiliza. É um aviso. Remova a referência ou, se o adquirente precisar dela, mencione-a na nota da linha (BT-127).

Nesta página

O que significa

A regra analisa o artigo de cada linha da fatura (ou da nota de crédito) num ficheiro UBL. Dá um aviso quando o artigo contém um bloco cac:CatalogueDocumentReference, uma indicação do catálogo de onde vem o artigo. A EN 16931 não tem referência de catálogo numa linha. Tem uma referência do contrato (BT-12) e um número da encomenda (BT-13) para a fatura inteira, e uma referência da linha da encomenda (BT-132) numa linha.

Porque é importante

A EN 16931 não utiliza referências a documentos de catálogo dentro do artigo de uma linha.

Como corrigir

Verifique se o seu software de faturação exporta uma referência de catálogo para cada produto e ajuste o mapeamento da exportação para a omitir. Se o adquirente pediu a referência, coloque-a na nota da linha (BT-127), não no campo do número da encomenda. Se criar o XML manualmente, elimine cac:CatalogueDocumentReference de cac:InvoiceLine/cac:Item (cac:CreditNoteLine numa nota de crédito).

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 InvoiceLine Item CatalogueDocumentReference

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-589 ainda falha e que outras regras falham.

Atualizado em 7 de novembro de 2026