Saltar para o conteúdo
Tema
Português
Tema

Validar uma fatura UBL

Beta Esta ferramenta está em beta. Foi testada com ficheiros de exemplo e alguns pormenores ainda podem mudar. Reveja o resultado antes de confiar nele.

Valide uma fatura UBL 2.1 com as regras suportadas e consulte os erros e orientações disponíveis. Gratuito dentro do limite diário; em beta.

Em resumo

Verifique uma fatura com base nas regras da EN 16931 e nas regras nacionais aplicáveis. Leia cada resultado e as indicações sobre o que corrigir. Gratuito, 5 por dia sem conta.

O validador UBL do Klarbon verifica uma fatura ou nota de crédito UBL 2.1 com as regras de negócio da EN 16931 para UBL. Quando o ficheiro declara Peppol BIS Billing 3.0, XRechnung ou a NLCIUS neerlandesa, aplica esse conjunto de regras. Os resultados incluem códigos de regra e, quando disponíveis, orientações de correção.

Cinco verificações por dia são gratuitas, vinte com uma conta gratuita. As faturas CIUS-PT ainda não são validadas.

O que verifica o validador?

Uma fatura UBL é um ficheiro XML na Universal Business Language da OASIS (OASIS UBL 2.1, em inglês). O campo cbc:CustomizationID diz que regras segue, e o Klarbon escolhe o conjunto de regras a partir dele:

O ficheiro declara Regras aplicadas
Só a EN 16931 EN 16931 1.3.17 para UBL (artefactos CEN/TC 434, em inglês)
Peppol BIS Billing 3.0 regras Peppol BIS Billing 3.0 (OpenPeppol, em inglês), incluindo a EN 16931
XRechnung 3.0 XRechnung 3.0.2 para faturas, incluindo a EN 16931; notas de crédito UBL ainda não suportadas
NLCIUS SI-UBL 2.0 para faturas, incluindo a EN 16931; notas de crédito UBL ainda não suportadas
CIUS-PT não verificado; as regras da eSPap ainda não estão disponíveis no Klarbon
UBL.BE não verificado; as regras UBL.BE não estão disponíveis no Klarbon

O relatório indica o conjunto de regras e a versão. A verificação de UBL está em beta. Veja o que é o UBL.

Como validar um ficheiro UBL?

  1. Carregue o ficheiro XML. No telemóvel, escolha-o em Ficheiros, no Mail ou nas transferências.
  2. Leia o relatório. Os resultados mostram o código da regra e a gravidade, com termo de negócio, localização no ficheiro e orientações de correção quando disponíveis.
  3. Corrija e verifique de novo no seu programa de faturação, ou com Corrigir uma fatura eletrónica.

Que erros são frequentes?

Campos obrigatórios em falta, como a referência do adquirente ou o endereço eletrónico, totais ou resumos do IVA que não batem certo, e códigos fora das listas permitidas, como a unidade ou a categoria de IVA. Um ficheiro UBL que abre num visualizador pode falhar estas regras; abrir e verificar são passos distintos. Veja erros de faturas explicados.

O Klarbon envia a fatura?

Não. O Klarbon verifica o ficheiro. Não é um ponto de acesso Peppol e não envia, regista nem submete faturas.

O que acontece ao meu ficheiro?

É enviado para os servidores do Klarbon, verificado em memória e apagado no fim do pedido. Veja o que acontece aos meus ficheiros.

Quanto custa?

Cinco verificações por dia sem conta, vinte com uma conta gratuita, até 2000 por dia com os planos Pro e Contabilista. Veja os preços.

Ver também

Perguntas frequentes

Como valido uma fatura UBL?

Carregue o ficheiro XML no validador UBL do Klarbon. Ele verifica a fatura com as regras de negócio da EN 16931 para UBL, ou com as regras Peppol BIS Billing, XRechnung ou NLCIUS quando o ficheiro declara uma delas, e apresenta os resultados, com orientações de correção quando disponíveis.

O validador verifica as regras da CIUS-PT?

Ainda não. Um ficheiro CIUS-PT abre no Klarbon, em beta, mas ainda não pode ser validado com as regras portuguesas publicadas pela eSPap.

Que versão de UBL suporta?

UBL 2.1. São verificados Invoice e CreditNote em EN 16931 e Peppol BIS. A verificação de notas de crédito UBL em XRechnung e NLCIUS ainda não é suportada. Uma versão UBL mais recente não é automaticamente um perfil aceite.

Um ficheiro UBL que abre também é válido?

Não necessariamente. Abrir mostra o conteúdo do ficheiro, mesmo com regras falhadas. Só a verificação diz se as regras de negócio são cumpridas.

Um resultado válido garante que a fatura é aceite?

Não. Um resultado válido significa que as regras técnicas escolhidas são cumpridas. Não confirma o tratamento do IVA, os valores nem as exigências próprias do destinatário.

Fontes

Atualizado em 6 de novembro de 2026