Base de conhecimento Peppol
Entenda a rede por trás de cada integração com a Peppox
Pesquise orientações práticas sobre padrões, identificadores, descoberta, transporte, validação, operações e modelos por país.
BAS
Noções básicas
Visão geral de alto nível sobre Peppol, governança e conceitos essenciais.
O que é o Peppol e quem o opera?
Peppol é uma estrutura e rede interoperável e governada para a troca de documentos empresariais estruturados (por exemplo, faturas eletrônicas, notas de crédito, MLR). É coordenado pela OpenPeppol, uma associação sem fins lucrativos que define especificações e certifica Access Points e SMPs.
Quais benefícios o Peppol oferece em relação a integrações ponto a ponto?
Peppol usa um modelo de “conectar uma vez, alcançar muitos” por meio de Access Points certificados, reduzindo interfaces personalizadas, aplicando regras de validação compartilhadas (EN 16931, BIS/PINT), melhorando a interoperabilidade transfronteiriça e permitindo descoberta padronizada e transporte seguro.
O Peppol é obrigatório em toda a UE?
Não existe um mandato único do Peppol em toda a UE. A UE exige EN 16931 para faturas eletrônicas em compras públicas; muitos países introduzem obrigações nacionais B2B. O Peppol é amplamente adotado como a forma de cumprir e interoperar.
Quais documentos são mais comuns no Peppol?
Invoice e CreditNote (BIS Billing 3.0 / PINT), Message Level Response (MLR) e Invoice Response. Documentos de logística também existem no conjunto Peppol Post-Award.
O que é o “modelo de quatro cantos”?
Remetente → Access Point de envio → Access Point de recebimento → Destinatário. A descoberta (SML→SMP) é usada para encontrar as capacidades e o endpoint seguro do destinatário antes da entrega.
IDE
Identificadores (ISO 6523)
Entendendo identificadores de participantes e armadilhas comuns.
Como os destinatários são identificados?
Peppol usa esquemas ISO 6523 (ICD + valor), formatados como iso6523-actorid-upis::ICD:VALUE (por exemplo, GLN = 0088, CBE belga = 0208).
Qual esquema de identificador devo usar?
Use o esquema que corresponda ao seu identificador oficial (por exemplo, GLN 0088, Bélgica 0208 para BCE/CBE). As orientações do seu Access Point ou da autoridade nacional devem confirmar o esquema correto.
Erros comuns com identificadores
Confundir VAT com IDs de registro da empresa; remover zeros à esquerda; usar um formato de VAT de país sob o ICD incorreto; usar identificadores de teste em produção.
Diretório vs. registro
Estar visível em um diretório ou ferramenta de consulta não é o mesmo que ter um registro SMP válido para um documento/processo específico. Sempre verifique as capacidades SMP do destinatário.
DIS
Descoberta (SMP/SML)
Como SML e SMP funcionam juntos.
Qual é a diferença entre SML e SMP?
SML (Service Metadata Locator) mapeia um ID de participante para seu SMP. O SMP (Service Metadata Publisher) armazena os tipos de documento, IDs de processo e endpoints suportados pelo participante.
O que devo verificar em um registro SMP?
documentTypeID correto, processID, endpoint ativo com peppol-transport-as4-v2_0 e um certificado válido. Confirme o ambiente (teste vs produção).
Por que as consultas às vezes falham com 404 ou 429?
404 = nenhuma capacidade publicada para aquele participante/documento nesse SMP. 429 = limitação de taxa pelos endpoints públicos; reduza a taxa ou use a API do seu provedor.
DOC
Documentos e Perfis
BIS Billing 3.0, PINT e perfis relacionados.
O que é Peppol BIS Billing 3.0?
Uma CIUS de EN 16931 que define como trocar UBL Invoice e Credit Note no Peppol com regras adicionais e listas de códigos para garantir interoperabilidade.
O que é PINT e quando é usado?
O Peppol International Invoice Model (PINT) harmoniza a faturação eletrônica globalmente e fundamenta especializações nacionais (por exemplo, PINT A-NZ, PINT MY, SG BIS).
O que são ProcessIDs e por que são importantes?
Os ProcessIDs (por exemplo, cenbii-procid-ubl::urn:fdc:peppol.eu:2017:poacc:billing:3:1.0) expressam processos de negócio vinculados a um perfil de documento; eles devem corresponder à entrada SMP do destinatário.
MLR vs Invoice Response
MLR fornece feedback técnico/em nível de negócio; Invoice Response fornece confirmações de negócio (por exemplo, aceite/rejeição com motivos). Verifique o suporte no SMP.
VAL
Validação e Listas de Códigos
Fazendo com que EN 16931 + BIS/PINT passem na validação.
Causas típicas de erros de validação
Categorias fiscais incorretas; códigos de unidade inválidos; divergências de moeda/arredondamento; identificadores BT ausentes; extensões específicas de país incorretas; tipos de anexos não permitidos.
Quais listas de códigos falham com mais frequência?
Códigos de unidade UN/ECE, códigos de moeda ISO, categorias de IVA, códigos de meios de pagamento, listas específicas de país (por exemplo, especificidades EHF da Noruega; Singapore, A-NZ PASR/PINT).
Como solucionar erros de EN 16931 vs BIS?
Valide primeiro contra EN 16931 e, em seguida, contra as regras Peppol BIS/PINT. Use validadores oficiais e validadores nacionais quando disponíveis (por exemplo, o validador EHF na Noruega).
TRA
Transporte e Segurança (AS4, PKI)
Transporte AS4 e fundamentos de PKI da OpenPeppol.
Qual transporte é usado?
Peppol utiliza o perfil AS4 (peppol-transport-as4-v2_0) com assinatura e criptografia entre Access Points.
Problemas comuns de entrega AS4
Certificados expirados ou prestes a expirar; URL de endpoint incorreta; incompatibilidade de TLS/cipher; clock skew; payloads grandes sem compressão; configurações de retry muito baixas.
E quanto aos certificados e à PKI?
Os certificados de AP/SMP devem seguir a política PKI da OpenPeppol. Acompanhe notBefore/notAfter, validade da cadeia, status OCSP/CRL e planeje os rollovers com antecedência.
ONB
Integração e Testes
Do sandbox à produção.
Checklist para começar
Escolha um AP certificado, registre o ID ISO 6523, configure as capacidades do SMP, valide UBLs (EN 16931 + BIS/PINT), pilote MLR/Invoice Response e, em seguida, entre em produção.
Ambientes de teste versus produção
Use SML, SMP e endpoints de AP dedicados para teste. Nunca reutilize identificadores de teste em produção.
Boas práticas de cutover
Execute em paralelo com parceiros de teste, monitore MLR/erros, confirme dependências de reporte fiscal e comunique os cronogramas aos parceiros comerciais.
OPS
Operações e Monitoramento
O que medir e como реагir.
O que devemos monitorar no dia a dia?
Resultados de validação, alterações no SMP, saúde dos endpoints, tentativas de nova entrega no AS4, feedback de MLR/Invoice Response, expiração de certificados e latência das mensagens.
Como lidar com limites de taxa e consultas públicas?
Armazene os resultados em cache, respeite os limites de taxa, prefira APIs do lado do provedor e evite coletar dados de endpoints públicos em períodos de pico.
Retenção e trilhas de auditoria
Mantenha os metadados das mensagens (hash, carimbos de data e hora, IDs de remetente/destinatário, IDs de documento), relatórios de validação e respostas de MLR/IR de acordo com a política e a legislação.
PRI
Proteção de Dados e Aspectos Legais
GDPR, leis locais e responsabilidades.
Peppol está em conformidade com o GDPR?
Peppol define transporte seguro e identificadores, mas a conformidade continua sendo sua responsabilidade: base legal, retenção, direitos dos titulares e DPIA quando exigido.
Peppol substitui o reporte fiscal?
Não. Alguns países exigem processos adicionais de e-reporting/CTC. Verifique as exigências nacionais além do transporte e da validação de documentos.
TRO
Solução de problemas
Problemas frequentes e verificações rápidas.
A entrega falha, mas o participante é “encontrado” online
Uma consulta ao diretório não comprova capacidade. Verifique o SMP para o documentTypeID e processID exatos. Certifique-se de que seu AP aponte para o endpoint AS4 listado.
A validação falha em totais ou impostos
Verifique arredondamento (nível de linha vs. nível de fatura), precisão da moeda, consistência da categoria de imposto e a distribuição de allowances/charges conforme as regras da EN 16931.
Anexos rejeitados
Apenas certos tipos MIME e tamanhos são permitidos. Certifique-se de que a codificação base64 e os metadados estejam corretos e que os nomes de arquivo sejam compatíveis com ASCII, se exigido.
429 Too Many Requests nos endpoints públicos
Atenue a cadência, adicione backoff e prefira as APIs do seu provedor. Faça lookups SMP em lote e armazene os resultados em cache.
COU
Perfis por País e Modelos Locais
Como Peppol ou EN 16931 é utilizado localmente.
Bélgica
A faturação eletrónica B2B tornará-se obrigatória a partir de 1 Jan 2026 (de forma faseada). Peppol está confirmado como o padrão para emissão de faturas estruturadas. B2G já está em vigor.
Alemanha
A partir de 1 Jan 2025, as empresas devem ser capazes de receber faturas eletrónicas EN 16931; as obrigações de emissão entram em fase de implementação até 2028. XRechnung/ZUGFeRD estão alinhados com EN 16931.
França
A faturação eletrónica/e-reporting é implementada de forma faseada a partir de Sept 2026; a DGFiP é a Peppol Authority. O modelo envolve PPF/PDP e interoperabilidade Peppol.
Noruega
EHF Billing 3.0 baseado em Peppol BIS 3.0; uso extensivo no setor público e privado.
Singapura (InvoiceNow)
Faturação eletrónica nacional baseada em Peppol; a IMDA é a autoridade. Há guias disponíveis para prestadores de serviços e considerações de GST.
Austrália e Nova Zelândia
PINT A-NZ é o modelo atual; a extensão A-NZ BIS 3.0 foi descontinuada em 2025 para migração para PINT.
Malásia
As especializações PINT Malaysia (Billing/Self-billing) foram publicadas na documentação OpenPeppol Post-Award.
Itália
O B2B nacional utiliza SDI (FatturaPA). Peppol pode ser usado para operações transfronteiriças ou com parceiros/APs que o suportem, mas o SDI continua obrigatório no âmbito doméstico.
DEV
Dicas para Desenvolvedores e Operações
Orientação prática para implementadores.
Padrões seguros de lookup no SMP
Execute lookups em lote e em cache; respeite o TTL do SML/SMP; use as APIs do provedor quando disponíveis; verifique tanto o documentTypeID quanto o processID.
Gestão de certificados
Monitore os períodos de validade, automatize alertas de renovação, verifique as cadeias e teste os endpoints após a rotação. Mantenha os relógios sincronizados (NTP).
Observabilidade
Registre IDs de correlação, IDs de participante, IDs de documento, URL do SMP, URL do endpoint, resultados de validação e payloads de MLR/IR para apoiar auditorias.
Resiliência
Use backoff exponencial para retries AS4, implemente idempotência no lado do remetente e monitore SLAs de throughput/latência.
GLO
Glossário
Access Point (AP)
Gateway certificado que valida e troca mensagens AS4 na rede Peppol.
SMP / SML
SMP armazena capacidades/endpoints; SML aponta para o SMP correto usando DNS.
BIS Billing 3.0
CIUS Peppol da EN 16931 para Invoice e CreditNote.
PINT
Modelo Internacional de Fatura Peppol; base para especializações globais/por país.
AS4
Perfil de transporte de mensagens seguro e confiável usado pelos APs Peppol.