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

XRechnung: erros BR-DE-2 a BR-DE-7, BR-DE-27 e BR-DE-28, o contacto do vendedor

Seis regras fatais e dois avisos da XRechnung pedem o mesmo: que a fatura diga quem a emite e como falar com essa pessoa. Cidade e código postal da sua empresa, um ponto de contacto, um telefone e um e-mail. No Odoo, quase sempre é um dado em falta na ficha da própria empresa, não na do cliente.

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
RegraGravidadeTexto da KoSITO que falta
BR-DE-2fatalDie Gruppe "SELLER CONTACT" (BG-6) muss übermittelt werden.O bloco inteiro de contacto do vendedor.
BR-DE-3fatalDas Element "Seller city" (BT-37) muss übermittelt werden.A cidade da sua empresa.
BR-DE-4fatalDas Element "Seller post code" (BT-38) muss übermittelt werden.O código postal da sua empresa.
BR-DE-5fatalDas Element "Seller contact point" (BT-41) muss übermittelt werden.Uma pessoa ou um departamento de contacto.
BR-DE-6fatalDas Element "Seller contact telephone number" (BT-42) muss übermittelt werden.Um telefone.
BR-DE-7fatalDas Element "Seller contact email address" (BT-43) muss übermittelt werden.Um e-mail.
BR-DE-27warningIn BT-42 sollen mindestens drei Ziffern enthalten sein.Um telefone com pelo menos três algarismos.
BR-DE-28warningIn BT-43 soll genau ein @-Zeichen enthalten sein, welches nicht von einem Leerzeichen, einem Punkt, aber mindestens zwei Zeichen auf beiden Seiten flankiert werden soll. Ein Punkt sollte nicht am Anfang oder am Ende stehen.Um e-mail bem formado: um só @, sem espaços nem pontos colados a ele, e sem ponto no início ou no fim.

Os textos são os do Schematron da XRechnung 3.0.2 (versão v2.6.0 da KoSIT), em alemão, tal como os devolve o validador. Entre as regras da EN 16931 não há nenhuma que peça o contacto do vendedor; entre as da XRechnung, sim. Por isso só aparecem quando a fatura é uma XRechnung.

Cartão das regras BR-DE-2 a BR-DE-7 da XRechnung
Seis regras fatais e dois avisos sobre o contacto do vendedor (BG-6) e a sua morada.

Os dois avisos não derrubam a fatura

BR-DE-27 e BR-DE-28 têm gravidade warning no Schematron, não fatal. O relatório mostra-os, mas uma XRechnung que tenha apenas estes dois avisos continua válida. Vale a pena corrigi-los na mesma: um telefone como «-» ou um e-mail com espaços costumam vir de uma ficha preenchida à pressa.

O que o Odoo verifica antes de gerar

A XRechnung que traz o Odoo verifica duas destas regras na ficha da sua empresa antes de gerar o ficheiro, consoante a versão:

  • Odoo 17: pede um telefone ou um telemóvel, com o aviso «At least one of the following fields %s is required on %s.», e o e-mail, com «The field %s is required on %s.».
  • Odoo 18: por defeito não verifica nem o telefone nem o e-mail. Essa verificação está no exportador antigo, e o Odoo 18 usa o novo, salvo se o parâmetro do sistema account_edi_ubl_cii.use_new_dict_to_xml_helpers estiver com o valor False. O novo escreve como telefone (BT-42) apenas o campo Telefone: se a sua empresa só tiver telemóvel, a XRechnung sai sem telefone e o validador dá BR-DE-6.
  • Odoo 19 e 20: pedem o telefone e o e-mail, e o aviso diz «The field %(field)s is required on %(record)s.», com o nome do campo e o nome da sua empresa.

A cidade, o código postal e o ponto de contacto não têm essa verificação prévia em nenhuma versão. Se a ficha da sua empresa não os tiver, ficará a saber pelo validador do seu cliente ou pelo seu.

Com o nosso módulo XRechnung e ZUGFeRD

O módulo escreve o bloco BG-6 com o nome da sua empresa como ponto de contacto (BT-41), o respetivo telefone (BT-42) e o respetivo e-mail (BT-43). Antes de gerar, verifica o telefone e o e-mail da empresa, e também o e-mail do cliente, com uma mensagem para cada um.

Fatura do Odoo 20 com o separador XRechnung / ZUGFeRD do módulo
Formato XRechnung CII, resultado Valid e a caixa Ready to send marcada. Captura do Odoo 20 com dados de demonstração; o relatório de validação da captura é de teste.

No Odoo 18, 19 e 20, com a subscrição ao FlexigoTech Cloud, cada XRechnung é validada com as regras da KoSIT e o que falha fica na fatura, em Validation Errors, uma linha por regra com o respetivo nível. Só a que passa fica como Ready to send. No Odoo 17, a versão publicada gera a XRechnung, mas não a valida.

O que preencher

  1. Ficha da sua empresa: morada, cidade e código postal completos.
  2. Telefone com indicativo e pelo menos três algarismos, no campo Telefone: o telemóvel só conta na XRechnung do Odoo 17.
  3. Um e-mail de faturação que alguém leia, com um só @ e sem espaços.
  4. Volte a gerar a XRechnung e reveja o resultado antes de a enviar.

Continue a ler

Erro BR-DE-15 na XRechnung: a fatura não tem Buyer reference (BT-10)A BR-DE-15 rejeita uma XRechnung sem Buyer reference (BT-10). O que pede a regra da KoSIT, de onde o tira o Odoo 17, 18, 19 e 20 e quando vai o Leitweg-ID.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.Erro BR-CO-09: o NIF-IVA do vendedor ou do cliente não tem o prefixo do paísBR-CO-09 rejeita um NIF-IVA sem o prefixo do país; BR-CO-26, BR-S-02, BR-AE-02 e BR-IC-02 exigem o do vendedor ou o do cliente. O aviso do Odoo e como o escrever.
Verificado no código do módulo (versão 17.0 e 20.0) e nas fontes indicadas

Fontes