Saltar para o conteúdo principal
XRechnung · regras da KoSIT

Erro BR-DE-15 na XRechnung: a fatura não tem Buyer reference (BT-10)

A BR-DE-15 é uma regra da XRechnung, o formato alemão de fatura eletrónica: toda a fatura tem de levar a referência do comprador, o campo BT-10. Numa entidade pública alemã, nesse campo vai o seu Leitweg-ID; numa empresa, a referência que lhe tenham indicado. Se faltar, o validador da KoSIT considera a fatura não válida.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 4 de novembro de 2026

O essencial

Versões
Odoo 17, 18, 19 e 20
Verificado
no código do módulo, versão 17.0 e 20.0 · nas fontes indicadas no fim
Leitura
4 min

O texto da regra, tal como aparece no relatório do validador (a KoSIT escreve-o em alemão), é este: «Das Element "Buyer reference" (BT-10) muss übermittelt werden.» Quer dizer que o elemento Buyer reference tem de constar na fatura. No Schematron da XRechnung 3.0.2 (versão v2.6.0 da KoSIT) a sua gravidade é fatal: não é um aviso, a fatura não passa.

O que verifica e o que não verifica

A regra só olha para se o campo existe e não está vazio. Não verifica se o valor faz sentido: qualquer texto a cumpre. Em UBL é o elemento cbc:BuyerReference, no cabeçalho do documento.

O Peppol BIS, o formato usado na Bélgica ou nos Países Baixos, é mais flexível: basta a referência do comprador ou a referência da encomenda, como diz a sua regra PEPPOL-EN16931-R003: «A buyer reference or purchase order reference MUST be provided.» Por isso, uma fatura que circula sem problemas pelo Peppol pode cair na BR-DE-15 quando a converte em XRechnung para um cliente alemão.

Ficha da regra BR-DE-15 da XRechnung
A BR-DE-15 é fatal no Schematron da KoSIT: sem BT-10, a XRechnung não é válida.

De onde tira o Odoo o BT-10

A exportação XRechnung que traz o Odoo (sem módulos de terceiros) preenche o campo assim:

VersãoValor do BT-10Se não houver nenhum
Odoo 17O campo Referência da empresa cliente. Se o seu endereço eletrónico Peppol (EAS) for 0204, o seu Peppol Endpoint.Escreve «N/A».
Odoo 18 e 19O campo Referência do contacto ou, se estiver vazio, o da sua empresa. Com EAS 0204, o Peppol Endpoint.Escreve «N/A».
Odoo 20Igual, mas o esquema e o identificador chamam-se Routing ID e Routing Endpoint. Com Routing ID 0204, o Routing Endpoint.Escreve «N/A».

Com a XRechnung do Odoo, a BR-DE-15 não chega a disparar, porque o campo nunca fica vazio. Mas «N/A» só cumpre a letra da regra. Não é a referência que espera o seu cliente e, se fatura a uma entidade pública, não é o seu Leitweg-ID. Antes de enviar, abra o XML ou a pré-visualização e veja o que leva o BT-10.

Quando o cliente é uma entidade pública

O 0204 é o esquema do Leitweg-ID na lista de endereços eletrónicos. Se na ficha da entidade puser esse esquema e o seu Leitweg-ID como identificador, o Odoo copia-o para o BT-10 sem que tenha de o escrever em cada fatura. Para uma empresa privada, o normal é a referência que lhe pedirem, muitas vezes o número da encomenda ou de fornecedor: vai no campo Referência da sua ficha.

Com o nosso módulo XRechnung e ZUGFeRD

O módulo tem um separador próprio E-Invoicing na ficha do cliente, com dois campos para este dado: Leitweg-ID (BT-10), que usa se marcar o cliente como entidade pública (B2G Partner), e Buyer Reference (BT-10) para os restantes. Se marcar o cliente como entidade pública e lhe faltar o Leitweg-ID, o módulo não gera a fatura: para com «B2G partner requires a Leitweg-ID (BT-10).». Se não for entidade pública e a Buyer Reference estiver vazia, o XML sai sem BuyerReference, sem preenchimentos como «N/A», e aí aparece a BR-DE-15.

Ficha de um cliente público no Odoo 20 com o separador E-Invoicing do módulo XRechnung
Cliente marcado como B2G Partner, com o seu Leitweg-ID (BT-10) e a Buyer Reference vazia. Captura do Odoo 20 com dados de demonstração.

No Odoo 18, 19 e 20 vê-o antes de enviar seja o que for: com a subscrição ao FlexigoTech Cloud, cada XRechnung que gera é validada com as regras da KoSIT e as falhas ficam na fatura, em Validation Errors, uma linha por regra. Uma fatura com BR-DE-15 não fica marcada como Ready to send. A versão publicada para o Odoo 17 gera a XRechnung mas não a valida.

Como resolver

  1. Se o cliente for uma entidade pública alemã, peça o seu Leitweg-ID e ponha-o na ficha do contacto: no campo Leitweg-ID do separador E-Invoicing com o nosso módulo, ou como endereço eletrónico com esquema 0204 no Odoo.
  2. Se for uma empresa, pergunte que referência quer ver e guarde-a na ficha do contacto (Buyer Reference com o módulo, Referência no Odoo).
  3. Gere de novo a XRechnung: a que já enviou não muda e, se foi rejeitada, tem de enviar a corrigida.
  4. Verifique o BT-10 no resultado antes de a enviar.

Continue a ler

XRechnung: erros BR-DE-2 a BR-DE-7, BR-DE-27 e BR-DE-28, o contacto do vendedorBR-DE-2 a BR-DE-7 exigem na XRechnung a cidade, o código postal, um contacto, um telefone e um e-mail do vendedor. O que diz cada regra e como cumpri-la no Odoo.Erros BR-DE-1, BR-61 e BR-DE-23 na XRechnung: as instruções de pagamentoBR-DE-1 exige na XRechnung as instruções de pagamento (BG-16) e BR-61 a conta quando se paga por transferência. O que escreve o Odoo 17, 18, 19 e 20 e como o corrigir.Erros PEPPOL-EN16931-R010 e R020: o endereço eletrónico do comprador ou do vendedorPEPPOL-EN16931-R010 e R020 exigem o endereço eletrónico do comprador e do vendedor; BR-62, BR-63 e BR-CL-25, o seu esquema. Onde está no Odoo 17, 18, 19 e 20.
Verificado no código do módulo (versão 17.0 e 20.0) e nas fontes indicadas

Fontes