Validação XRechnung: Os 10 Erros Mais Comuns e Como Corrigi-los
Validação XRechnung: Os 10 Erros Mais Comuns e Como Corrigi-los
Quem cria e valida uma XRechnung pela primeira vez irá quase certamente deparar-se com mensagens de erro crípticas. Códigos como BR-DE-15, BR-CO-17 ou BR-S-08 não são exatamente autoexplicativos. No entanto, a maioria destes erros tem causas simples que podem ser corrigidas rapidamente. Neste artigo, explicamos os dez erros de validação mais comuns em linguagem simples e mostramos como resolvê-los.
Porque É a Validação Essencial
XRechnung baseia-se na norma europeia EN 16931. Esta norma define não apenas o formato, mas também regras de negócio vinculativas. Cada regra tem um código único que começa com BR (Business Rule). Regras específicas adicionais alemãs têm o prefixo BR-DE. Uma fatura só é considerada conforme quando todas as regras são satisfeitas. Os sistemas recetores — especialmente os utilizados por agências governamentais — rejeitam automaticamente faturas não conformes.
Os 10 Erros Mais Comuns
1. BR-DE-15: Referência do Comprador em Falta (Leitweg-ID)
Este é o erro encontrado com mais frequência. XRechnung requer uma referência do comprador no campo BuyerReference. Para faturas a entidades adjudicantes do setor público, esta é a Leitweg-ID. Em transações B2B, pode ser utilizado qualquer valor de referência acordado, mas o campo nunca deve estar vazio.
Solução: Introduza a Leitweg-ID do destinatário ou um número de referência acordado.
2. BR-CO-17: Cálculo de IVA Incorreto
BR-CO-17 verifica se o montante do imposto por categoria fiscal (BT-117) foi calculado corretamente: montante do imposto = base tributável (BT-116) x taxa de imposto (BT-119) / 100, arredondado a duas casas decimais. Mesmo diferenças mínimas de arredondamento acionam este erro.
Solução: Calcule o IVA separadamente para cada categoria fiscal a partir da base tributável e da taxa de imposto, e arredonde apenas a duas casas decimais no final. Evite arredondamentos intermédios ao nível dos itens de linha.
3. BR-DE-05: Nome do Contacto do Vendedor em Falta
A extensão alemã XRechnung exige que seja fornecido um nome de contacto na secção "Contacto do Vendedor" (BG-6) — especificamente, um ponto de contacto do vendedor (BT-41). BR-DE-02 torna o grupo de contacto inteiro obrigatório, e BR-DE-05 exige especificamente o nome de contacto.
Solução: Preencha cac:Contact/cbc:Name com o nome de uma pessoa de contacto ou departamento.
4. BR-DE-06: Número de Telefone do Contacto do Vendedor em Falta
A regra BR-DE-06 exige que seja fornecido um número de telefone do vendedor na secção de contacto (BT-42, número de telefone do contacto do vendedor).
Solução: Preencha o elemento cac:Contact/cbc:Telephone.
5. BR-DE-07: Endereço de Email do Contacto do Vendedor em Falta
A regra BR-DE-07 exige que o vendedor forneça um endereço de email na secção de contacto (BT-43, endereço de email do contacto do vendedor).
Solução: Preencha o elemento cac:Contact/cbc:ElectronicMail para o vendedor.
6. BR-S-08: Discrepância na Base Tributável
Este erro indica que o total líquido de uma categoria fiscal não corresponde à soma dos itens de linha associados.
Solução: Assegure-se de que a soma de todos os montantes líquidos dos itens de linha corresponde exatamente ao valor no resumo fiscal (Tax Subtotal).
7. BR-DE-16: Identificação Fiscal do Vendedor em Falta
BR-DE-16 exige que seja fornecido pelo menos um dos seguintes elementos: o número de identificação para efeitos de IVA (BT-31, identificador de IVA do vendedor), o número de registo fiscal (BT-32, identificador de registo fiscal do vendedor), ou um representante fiscal (BG-11, Representante Fiscal do Vendedor).
Solução: Introduza o seu número de identificação para efeitos de IVA no formato DE123456789 em BT-31 ou o seu número de registo fiscal em BT-32. Pelo menos um dos dois é obrigatório.
8. BR-CL-01: Código de Tipo de Fatura Inválido
O tipo de fatura deve corresponder a um código UNTDID 1001 válido. Para uma fatura padrão, o código é 380; para uma nota de crédito, é 381. Outros códigos comuns incluem 389 (fatura autoemitida) e 384 (fatura corrigida).
Solução: Utilize o código correto da lista de códigos UNTDID 1001.
9. BR-CO-10: Totais Inconsistentes
BR-CO-10 verifica se a soma dos montantes líquidos dos itens de linha (BT-106) corresponde ao total dos montantes líquidos individuais dos itens de linha (BT-131). Juntamente com regras relacionadas, garante que o montante total sem IVA (BT-109) = total dos itens de linha (BT-106) - abatimentos (BT-107) + encargos (BT-108).
Solução: Reveja os seus cálculos de totais: a soma de todos os montantes líquidos dos itens de linha deve igualar exatamente BT-106, e BT-106 menos abatimentos mais encargos deve igualar o montante líquido total (BT-109).
10. BR-DE-01: Instruções de Pagamento em Falta
A XRechnung alemã exige que o grupo "Instruções de Pagamento" (BG-16) esteja preenchido. Isto inclui pelo menos a especificação de um código de tipo de meio de pagamento (BT-81), como transferência bancária (código 30 ou 58). Dependendo do método de pagamento, devem ser fornecidos detalhes adicionais como o IBAN (BG-17).
Solução: Adicione as instruções de pagamento em BG-16 com o código de meio de pagamento apropriado e os detalhes associados (por exemplo, IBAN para transferências bancárias). Opcionalmente, pode também incluir condições de pagamento como texto livre em PaymentTerms/Note (BT-20).
Como Evitar Erros Desde o Início
A forma mais fácil de evitar erros de validação é utilizar uma ferramenta que verifica as regras automaticamente. Com o Validador XRechnung gratuito do invapi, pode validar os seus ficheiros XML diretamente no navegador contra todas as regras EN 16931 e XRechnung. As mensagens de erro são apresentadas num formato claro com orientações específicas sobre como corrigi-las.
Alternativamente, pode integrar a API do invapi diretamente no seu fluxo de trabalho de faturação para criar, converter e validar faturas automaticamente antes de serem enviadas.
Conclusão
Os erros de validação XRechnung podem parecer intimidantes à primeira vista, mas quase sempre podem ser rastreados até campos obrigatórios em falta ou problemas de arredondamento. Conhecer os erros mais comuns e utilizar uma boa ferramenta de validação poupa tempo e garante a conformidade. Experimente o Validador invapi gratuito e envie a sua próxima XRechnung sem erros.