Compliance e arquivo
API Factur-X para e-invoices híbridas PDF/A-3b
Gere faturas Factur-X PDF/A-3b com EN 16931 CII XML incorporado pelo endpoint público E-Invoice Render.
API PRINCIPAL E-Invoice Render
ENDPOINT
/api/v1/e-invoice/render SISTEMAS ERP / Backend de cobrança / Fluxo de compliance / Serviço de automação financeira
Tarefa a resolver
Empacotar um PDF de fatura renderizado como Factur-X PDF/A-3b com EN 16931 CII XML incorporado depois que seu ERP ou sistema de cobrança produziu os dados estruturados corretos da fatura.
Quando usar esta API
- Você precisa de saída Factur-X nativa pelo endpoint público E-Invoice Render.
- Seu sistema já tem EN 16931 CII XML válido para a fatura.
- Você precisa de empacotamento PDF/A-3b com metadados Factur-X e ligação de arquivo associado.
- Você quer que o endpoint de capacidades confirme o contrato de e-invoice atualmente publicado.
O que ela não substitui
- Você precisa que o gPdf crie semântica de negócio de fatura ou decisões fiscais por você.
- Você precisa de XRechnung, FatturaPA, KSeF, Peppol, ZATCA, NF-e ou outros padrões nativos não listados no OpenAPI.
- Você precisa de submissão direta ao Chorus Pro ou a outro portal governamental.
Qual endpoint chamar
/api/v1/e-invoice/render
E-Invoice Render é o caminho padrão para este fluxo.
/api/v1/e-invoice/capabilities
Use quando o fluxo precisar da API relacionada, de um contrato de template ou de uma consulta de capacidades.
Request mínimo
POST /api/v1/e-invoice/render - formato mínimo de pacote Factur-X.
{
"settings": {
"profile": "pdfa-3b",
"e_invoice": {
"standard": "factur_x",
"profile": "en16931",
"document_type": "invoice",
"xml": {
"format": "cii",
"encoding": "utf8",
"content": "<rsm:CrossIndustryInvoice>...</rsm:CrossIndustryInvoice>"
}
}
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Factur-X invoice",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
O que a gPdf faz
- Empacotamento Factur-X por E-Invoice Render.
- Tratamento de perfil PDF/A-3b para o PDF de fatura híbrido.
- Incorporação do CII XML como arquivo associado com metadados do padrão.
- Entrega inline do PDF ou comportamento de job com entrega por objeto conforme documentado.
O que seu sistema controla
- EN 16931 CII XML correto, números de fatura, lógica fiscal, dados de comprador e vendedor e elegibilidade.
- Validação externa, regras do destinatário, submissão a portal e interpretação legal.
- Armazenamento, trilha de auditoria, lógica de retentativa e entrega ao cliente ou portal.
Checklist de produção
- Valide o CII XML antes de enviá-lo ao gPdf.
- Defina settings.profile como pdfa-3b ou omita para aplicar o padrão de e-invoice.
- Use settings.e_invoice.standard = factur_x e settings.e_invoice.profile = en16931.
- Passe o PDF retornado pelo seu fluxo de validação Factur-X.
- Mantenha submissão e roteamento ao destinatário fora da API de renderização.
Limites da promessa
- A saída pública nativa de e-invoice é Factur-X ou ZUGFeRD com EN 16931 CII XML.
- O gPdf não submete faturas a portais governamentais ou de compradores.
- Seu sistema controla a correção de negócio, fiscal e XML.
Factur-X é um fluxo de empacotamento de e-invoice
Factur-X combina um PDF legível por humanos com EN 16931 CII XML legível por máquina. O endpoint público do gPdf empacota essa combinação em saída PDF/A-3b. Ele não decide a semântica da fatura nem submete o arquivo a um portal.
FAQ
- Qual endpoint renderiza Factur-X?
- Use POST /api/v1/e-invoice/render com settings.e_invoice.standard definido como factur_x.
- O gPdf gera o EN 16931 XML?
- Seu sistema fornece o CII XML e controla sua correção de negócio. O gPdf o empacota no PDF híbrido.
- O gPdf oferece suporte a XRechnung nesta página?
- Não. Esta página se limita ao contrato público Factur-X listado no OpenAPI.
- O gPdf submete faturas Factur-X a portais?
- Não. Submissão e roteamento ao destinatário permanecem fora da API de renderização.