Saltar para o conteúdo

Aviso

UBL-DT-27: Retire o atributo schemeAgencyID da fatura

Em resumo

Aviso: convém verificar.

UBL-DT-27 significa que o ficheiro UBL contém um atributo schemeAgencyID, que a norma da fatura eletrónica não utiliza. É apenas um aviso, mas pode corrigir o problema retirando esse atributo e mantendo o esquema (schemeID).

Nesta página

O que significa

A regra procura em todo o ficheiro um atributo chamado schemeAgencyID. Em UBL, este atributo pode ser acrescentado a um identificador, como um endereço eletrónico (BT-34, BT-49) ou um número de matrícula (BT-30, BT-47, BT-61), para indicar a organização que mantém o esquema de identificação. A EN 16931 e o Peppol indicam o esquema com o atributo schemeID, por isso o schemeAgencyID 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 schemeAgencyID 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 schemeAgencyID e apague apenas esse atributo, mantendo o schemeID onde o identificador precisar dele, e volte a verificar o ficheiro. 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

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

Atualizado em 7 de novembro de 2026