Peppol BIS Billing 3.0: Regras de negócio e erros de validação
Guia técnico completo sobre as regras de negócio Peppol BIS Billing 3.0 (BR-, PEPPOL-): o que validam, como interpretá-las e como corrigir os erros.
O que são as regras de negócio Peppol?
O Peppol BIS Billing 3.0 define dois conjuntos de regras de validação além da estrutura XSD: as regras EN 16931 (prefixo BR-) que implementam a norma europeia, e as regras específicas Peppol (prefixo PEPPOL-) que adicionam restrições suplementares.
Existem mais de 200 regras de negócio. Cada regra tem um identificador único (ex: BR-01, PEPPOL-EN16931-R001), uma descrição do que valida, e um nível de severidade: fatal (rejeição) ou warning (aviso).
As regras fatais devem ser cumpridas para que a fatura seja aceite na rede Peppol. As regras warning indicam boas práticas ou situações que podem causar problemas de processamento downstream.
Erros de validação Peppol mais frequentes
Os erros BR- e PEPPOL- mais encontrados na validação:
BR-01: Fatura sem número
O elemento ID da fatura é obrigatório e deve ser único. Uma fatura sem número é inválida em Peppol.
BR-CO-15: Total de IVA incorreto
O total de IVA declarado deve ser igual à soma dos montantes de IVA por taxa. Erro de cálculo frequente em sistemas legados.
PEPPOL-EN16931-R001: Moeda inconsistente
A moeda da fatura e a moeda dos montantes de IVA devem ser a mesma. Erro em faturas multi-moeda mal configuradas.
BR-S-08: Base de tributação em falta
Para cada linha com IVA, o montante base tributável (TaxableAmount) é obrigatório.
PEPPOL-EN16931-R004: Identificador de perfil inválido
O CustomizationID deve ser 'urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0'. Valor incorreto ou ausente.
Como interpretar e corrigir as regras
Cada mensagem de erro inclui o identificador da regra (ex: BR-01), o contexto XPath onde o erro foi encontrado, e uma descrição em inglês. O identificador permite consultar a documentação oficial Peppol.
Para regras BR- (EN 16931): consulte a especificação EN 16931-1 e o documento de aplicação EN 16931-3-2 (UBL). Para regras PEPPOL-: consulte o BIS Billing 3.0 disponível no site docs.peppol.eu.
O nosso validador UBL/Peppol executa todas as regras Schematron e apresenta os erros com o contexto XPath e a descrição completa, facilitando o diagnóstico e a correção.
Boas práticas para conformidade Peppol
Use sempre o perfil correto: o CustomizationID deve corresponder exatamente ao perfil Peppol BIS Billing 3.0. Uma diferença de maiúsculas/minúsculas ou um espaço extra causa rejeição.
Teste com amostras reais: use o nosso validador com faturas reais antes de ir a produção. Os erros de cálculo (totais de IVA, valor total da fatura) são frequentes e dependem dos dados específicos.
Mantenha as regras atualizadas: a OpenPeppol publica atualizações periódicas das regras Schematron. Verifique regularmente se o seu sistema usa as versões mais recentes.
Valide as suas faturas Peppol
O nosso validador executa todas as regras BR- e PEPPOL- em tempo real no seu browser. Nenhum dado é enviado para os nossos servidores.
Validar agoraPerguntas frequentes
Qual a diferença entre regras BR- e PEPPOL-?
As regras BR- implementam a norma europeia EN 16931. As regras PEPPOL- são específicas da rede Peppol e adicionam restrições suplementares ao EN 16931.
Uma fatura com warnings Peppol pode ser enviada?
Tecnicamente sim, os warnings não bloqueiam a transmissão. Mas devem ser analisados: podem causar problemas de processamento no sistema do destinatário.
Como obter a lista completa das regras Peppol?
A lista completa está disponível em docs.peppol.eu. As regras Schematron são publicadas em formato XML e podem ser executadas com processadores XSLT padrão.
Por que a minha fatura falha na regra BR-CO-15?
BR-CO-15 verifica que o total de IVA da fatura (TaxTotal/TaxAmount) é igual à soma dos TaxSubtotal/TaxAmount. Verifique os cálculos e arredondamentos em cada linha.
O que é o CustomizationID e por que é crítico?
O CustomizationID identifica o perfil de conformidade. Para Peppol BIS Billing 3.0, deve ser exatamente 'urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0'.
As regras Peppol são as mesmas em todos os países?
As regras core BR- e PEPPOL- são as mesmas. Alguns países adicionam extensões nacionais (ex: NLCIUS para os Países Baixos, AUNZ para Austrália/Nova Zelândia).
Como testar as regras Peppol sem enviar para a rede?
Use o nosso validador local (processamento no browser). Também pode usar o Peppol Testbed oficial ou o validador da OpenPeppol para testes mais completos.
A versão das regras Schematron importa?
Sim, a OpenPeppol publica novas versões periodicamente. Certifique-se de que o seu sistema usa a versão mais recente para evitar falhas com Access Points atualizados.
Como validar faturas de crédito (notas de crédito) Peppol?
As notas de crédito Peppol usam o documento CreditNote UBL (não Invoice). As regras são similares mas algumas são específicas. O nosso validador suporta ambos os tipos.
Existem ferramentas open-source para validação Peppol?
Sim: phive (Java, da OpenPeppol), Mustang (Java, para Factur-X/ZUGFeRD com suporte Peppol), e Saxon (processador XSLT para executar as regras Schematron diretamente).