Saltar para o conteúdo

Códigos de erro de faturas explicados

Cada código abaixo leva a uma explicação simples da regra e de como corrigir a fatura.

Nesta página

Os validadores de faturas eletrónicas indicam cada regra falhada pelo seu código, como BR-CO-10 ou PEPPOL-EN16931-R001. O prefixo diz de que conjunto de regras vem: da norma europeia EN 16931, de uma especificação nacional como a XRechnung, ou da Peppol. A verificação do Klarbon apresenta os códigos e, quando disponíveis, explicações e orientações de correção.

Corrigir os erros permite passar as regras selecionadas; isso não garante a aceitação pelo destinatário. Os avisos não bloqueiam o resultado.

De onde vêm os códigos?

Prefixo Conjunto de regras Fonte
BR-, BR-CO-, BR-S- e semelhantes regras de negócio da EN 16931 artefactos da EN 16931, em inglês
BR-DE- XRechnung, Alemanha KoSIT, em alemão
PEPPOL-EN16931- Peppol BIS Billing 3.0 OpenPeppol, em inglês
outros prefixos nacionais especificações nacionais, como BR-FR- em França ou BR-NL- na NLCIUS neerlandesa o responsável nacional

Um erro de esquema, indicado antes de qualquer regra, significa que o próprio XML está mal formado ou usa um elemento que a sintaxe não permite.

Conjuntos de regras

O catálogo do Klarbon agrupa as regras por conjunto: EN 16931, XRechnung, Peppol BIS Billing, Factur-X e ZUGFeRD, a NLCIUS neerlandesa, as regras francesas BR-FR e a CIUS-RO romena. A verificação de CIUS-RO ainda não está disponível. Os ficheiros que declaram NLCIUS usam as regras correspondentes. As regras nacionais francesas exigem selecionar França; uma morada francesa não as ativa por si só. As regras UBL.BE belgas não fazem parte do catálogo. Quando uma verificação encontra um problema, o resultado aponta para a regra em causa.

A CIUS-PT tem regras próprias publicadas pela eSPap, mas o Klarbon ainda não as verifica.

O que faço com um erro?

  1. Verifique o ficheiro em Verificar uma fatura eletrónica para ver cada regra falhada, explicada.
  2. Se gerou a fatura, corrija-a no seu programa e exporte de novo, ou use Corrigir uma fatura eletrónica. Em Portugal, se a correção mudar os dados da fatura, faz-se no programa de faturação certificado, por exemplo com uma nota de crédito.
  3. Se a recebeu, peça ao emitente uma fatura corrigida; alterar uma fatura emitida por outra pessoa torna-a um documento diferente.

Veja porque são rejeitadas as faturas eletrónicas para as causas mais frequentes.

Ver também

Perguntas frequentes

O que significa um código de erro como BR-CO-10?

Identifica uma regra de negócio. As regras BR vêm da norma europeia EN 16931; as BR-CO são verificações de cálculo e coerência. A BR-CO-10 diz que a soma dos valores das linhas tem de ser igual ao total das linhas da fatura.

Como sei de que conjunto de regras vem um erro?

Pelo prefixo. As regras BR- são da EN 16931, as BR-DE- da XRechnung, as PEPPOL-EN16931- da Peppol BIS, e os outros conjuntos nacionais têm prefixos próprios.

Qual é a diferença entre um erro e um aviso?

Um erro, ou resultado fatal, torna a fatura inválida e leva normalmente à rejeição. Um aviso assinala algo invulgar que não torna o ficheiro inválido.

O Klarbon verifica as regras da CIUS-PT?

Ainda não. O Klarbon abre faturas CIUS-PT, em beta, mas ainda não as verifica com as regras publicadas pela eSPap.

Fontes

Atualizado em 6 de novembro de 2026