Validador KoSIT: como validar ficheiros ZUGFeRD e XRechnung
O Validador KoSIT (Koordinierungsstelle für IT-Standards — Coordenação de Normas de TI) é a ferramenta oficial da administração alemã para validar faturas eletrónicas. Quem envia ficheiros ZUGFeRD ou XRechnung deve validá-los previamente — uma fatura rejeitada atrasa o pagamento e causa trabalho desnecessário.
> Resposta rápida: O Validador KoSIT verifica faturas eletrónicas contra esquemas XSD, regras de negócio e regras CIUS alemãs. Pode utilizá-lo como ferramenta Java local ou, em alternativa, usar o Validador gratuito de ZUGFeRD e XRechnung diretamente no seu navegador.
O que verifica exatamente o Validador KoSIT?
O Validador realiza cinco verificações sequenciais:
- Verificação de sintaxe: O XML é bem formado?
- Verificação de esquema: A estrutura está em conformidade com o esquema UBL 2.1 ou CII?
- Regras de negócio (BR): Todos os campos obrigatórios estão presentes? (BR-01 a BR-65)
- Regras de cálculo (BR-CO): Os totais estão corretos? (Líquido + Imposto = Bruto)
- Regras CIUS: Regras específicas alemãs para XRechnung (BR-DE-01 a BR-DE-25)
Apenas quando todos os cinco níveis são aprovados é que a fatura eletrónica é considerada válida. Um único erro em qualquer nível resulta em rejeição.
Como posso utilizar o Validador KoSIT?
Opção 1: Validador online
Vários fornecedores disponibilizam o Validador KoSIT como ferramenta online. Carrega o seu ficheiro XML e recebe imediatamente o resultado da validação. A desvantagem: os dados da sua fatura são transmitidos para um servidor externo.
Opção 2: Linha de comandos (Java)
O Validador oficial é um programa Java:
- Instale o Java Runtime (JRE 11+)
- Descarregue o Validador ZIP
- Carregue a configuração (Scenarios) para XRechnung ou ZUGFeRD
- Execute o comando:
java -jar validationtool.jar -s scenarios.xml ficheiro.xml
Opção 3: Validador gratuito no navegador
O Validador de ZUGFeRD e XRechnung no nosso site verifica o seu ficheiro XML diretamente no navegador contra todos os campos obrigatórios da EN 16931. Sem instalação, sem envio — o ficheiro nunca sai do seu computador.
Quais são os erros de validação mais comuns?
| Erro | Causa | Solução |
|---|---|---|
| BR-02 | Data da fatura em falta | Adicione BT-2 (IssueDate) |
| BR-06 | Nome do vendedor em falta | Adicione BT-27 (SellerName) |
| BR-16 | Sem linhas de fatura | Adicione pelo menos uma InvoiceLine |
| BR-CO-10 | Total incorreto | Verifique os totais das linhas |
| BR-DE-01 | [Leitweg-ID](/blog/leitweg-id-explicado) em falta | Adicione BT-10 para XRechnung |
Uma visão completa dos campos obrigatórios encontra-se em EN 16931: Todos os campos obrigatórios.
Por que devo validar antes de enviar?
Uma fatura eletrónica inválida é imediatamente rejeitada por entidades públicas através da ZRE. Empresas com sistemas automatizados de receção de faturas também rejeitam ficheiros defeituosos. O resultado: pagamentos atrasados e esforço de correção desnecessário.
Valide cada fatura eletrónica antes de enviar com o Validador gratuito de ZUGFeRD e XRechnung — diretamente no seu navegador, sem envio para um servidor. Em alternativa, pode criar uma XRechnung através do Gerador de XRechnung baseado em formulário — a validação está integrada.
Como é que o TaxLayer valida automaticamente?
O TaxLayer valida automaticamente cada fatura eletrónica gerada contra todos os campos obrigatórios da EN 16931 antes de o ficheiro estar disponível para descarregamento. Desta forma, evita rejeições pelo destinatário — sem necessidade de um passo de validação manual. As duas primeiras conversões por mês são gratuitas.
Perguntas frequentes
O que é o Validador KoSIT?
O Validador KoSIT é a ferramenta oficial da Coordenação de Normas de TI (Koordinierungsstelle für IT-Standards) para validar faturas eletrónicas. Valida ficheiros XML contra esquemas XSD, regras Schematron e regras CIUS alemãs para XRechnung.
Que verificações realiza o Validador KoSIT?
Realiza cinco níveis de verificação: verificação de sintaxe (XML bem formado), verificação de esquema (estrutura UBL/CII), regras de negócio (BR-01 a BR-65), regras de cálculo (líquido + imposto = bruto) e regras CIUS (BR-DE-01 a BR-DE-25).
Existe uma alternativa online gratuita ao Validador KoSIT?
Sim. O Validador de ZUGFeRD e XRechnung do TaxLayer verifica o seu ficheiro diretamente no navegador contra todos os campos obrigatórios da EN 16931 — sem instalação, sem envio para um servidor.
O que significa o erro BR-DE-01?
BR-DE-01 significa que o Leitweg-ID (BT-10) está em falta. Este erro ocorre com XRechnung, uma vez que o Leitweg-ID é um campo obrigatório. Mais detalhes em Leitweg-ID explicado.
Posso validar PDFs ZUGFeRD com o Validador?
O Validador KoSIT oficial apenas verifica ficheiros XML. O Validador TaxLayer pode também verificar PDFs ZUGFeRD diretamente no navegador — extrai o XML incorporado automaticamente.
Devo validar cada fatura eletrónica antes de enviar?
Não é legalmente obrigatório mas é fortemente recomendado. Uma fatura eletrónica inválida será rejeitada pelo destinatário, atrasando o pagamento. O TaxLayer valida automaticamente contra a EN 16931 antes de gerar o ficheiro.
Ferramentas grátis
Artigos relacionados
Converta as suas faturas PDF agora
Experimente o TaxLayer gratuitamente — 2 conversões por mês, sem cartão de crédito.
Começar