Saltar para o conteúdo

Aviso

UBL-DT-28: Retire o atributo listAgencyID da fatura

Em resumo

Aviso: convém verificar.

UBL-DT-28 significa que o ficheiro UBL contém um atributo listAgencyID, que a norma da fatura eletrónica não utiliza. É apenas um aviso, mas pode corrigir o problema retirando esse atributo da sua exportação.

Nesta página

O que significa

A regra procura em todo o ficheiro um atributo chamado listAgencyID. Em UBL, este atributo pode ser acrescentado a um código, como o código do tipo de fatura ou o código do meio de pagamento, para indicar a organização que mantém a lista de códigos, por exemplo UN/ECE. A EN 16931 e o Peppol já fixam as listas de códigos utilizadas, por isso o atributo não deve aparecer em nenhum ponto da fatura. Basta uma ocorrência em qualquer lugar para o aviso aparecer.

Porque é importante

De acordo com a EN 16931, o atributo listAgencyID não deve constar das faturas nem das notas de crédito UBL.

Como corrigir

Normalmente não é o utilizador que define este atributo. O seu software de faturação acrescenta-o ao escrever o ficheiro, por isso procure uma opção de exportação ou uma versão mais recente, ou peça ao fabricante do software que deixe de o escrever. Se criar o XML manualmente, procure no ficheiro o texto listAgencyID e apague apenas esse atributo, e volte a verificar o ficheiro. Não retire outros atributos, como o listID num código de classificação de artigo, de que a fatura pode precisar. Vale a pena corrigir na próxima vez que alterar a exportação, e mais cedo se um destinatário pedir um ficheiro sem avisos.

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

Atualizado em 7 de novembro de 2026