Saltar para o conteúdo

Aviso

UBL-DT-17: Não use o atributo listName

Em resumo

Aviso: convém verificar.

UBL-DT-17 significa que a fatura contém um atributo listName, que a norma pede para não usar. Retire o atributo da exportação para eliminar o aviso.

Nesta página

O que significa

O teste procura em todo o ficheiro um atributo listName. Em UBL, pode estar num valor codificado, como o código do meio de pagamento (BT-81), e indicar o nome da lista de códigos de onde o valor é retirado. Basta uma ocorrência em qualquer ponto do ficheiro para o aviso aparecer.

Porque é importante

A EN 16931 recomenda omitir o atributo listName nas faturas e notas de crédito UBL.

Como corrigir

Vale a pena corrigir se o aviso se repete em todas as faturas. Peça ao fabricante do seu software de faturação que deixe de escrever listName. Se criar o XML manualmente, retire o atributo de todos os elementos que o têm e mantenha os códigos. Exporte de novo e volte a verificar o ficheiro.

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

List name attribute should not be present

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

Atualizado em 7 de novembro de 2026