Compliance en archivering
Factur-X API voor hybride PDF/A-3b-e-invoices
Genereer Factur-X-PDF/A-3b-facturen met ingebedde EN 16931 CII XML via het publieke E-Invoice Render-endpoint.
PRIMAIRE API E-Invoice Render
ENDPOINT
/api/v1/e-invoice/render SYSTEMEN ERP / facturatiebackend / nalevingsproces / service voor financiële automatisering
Taak om op te lossen
Verpak een gerenderde factuur-PDF als Factur-X PDF/A-3b met ingebedde EN 16931 CII XML nadat uw ERP- of facturatiesysteem de juiste gestructureerde factuurdata heeft geproduceerd.
Wanneer deze API past
- U hebt native Factur-X-output nodig vanuit het publieke E-Invoice Render-endpoint.
- Uw systeem heeft al geldige EN 16931 CII XML voor de factuur.
- U hebt PDF/A-3b-packaging nodig met Factur-X-metadata en koppeling van het bijbehorende bestand.
- U wilt met het capabilities-endpoint het momenteel gepubliceerde E-Invoice-contract bevestigen.
Wat dit niet vervangt
- U hebt gPdf nodig om zakelijke factuursemantiek of belastingbeslissingen voor u te maken.
- U hebt native XRechnung, FatturaPA, KSeF, Peppol, ZATCA, NF-e of andere standaarden nodig die niet in OpenAPI staan.
- U hebt directe indiening bij Chorus Pro of een ander overheidsportaal nodig.
Welk endpoint aanroepen
/api/v1/e-invoice/render
E-Invoice Render is het standaardpad voor deze workflow.
/api/v1/e-invoice/capabilities
Gebruik dit wanneer de workflow een verwant API-pad, templatecontract of capability lookup nodig heeft.
Minimale request
POST /api/v1/e-invoice/render - minimale Factur-X-pakketvorm.
{
"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" }
}
]
}
]
}
Wat gPdf afhandelt
- Factur-X-packaging via E-Invoice Render.
- PDF/A-3b-profielafhandeling voor de hybride factuur-PDF.
- Het inbedden van CII XML als gekoppeld bestand met standaardmetadata.
- Inline PDF-aflevering of object-delivery jobgedrag zoals gedocumenteerd.
Wat uw systeem beheert
- Correcte EN 16931 CII XML, factuurnummers, belastinglogica, koper- en verkoperdata en geschiktheid.
- Externe validatie, ontvangerregels, portaalindiening en juridische interpretatie.
- Opslag, audittrail, retrylogica en aflevering aan de klant of het portaal.
Productiechecklist
- Valideer de CII XML voordat u deze naar gPdf stuurt.
- Zet settings.profile op pdfa-3b of laat dit weg zodat de E-Invoice-standaardinstelling geldt.
- Gebruik settings.e_invoice.standard = factur_x en settings.e_invoice.profile = en16931.
- Haal de geretourneerde PDF door uw Factur-X-validatieproces.
- Houd indiening en routering naar ontvangers buiten de Render API.
Grenzen van de claim
- Native publieke E-Invoice-output is Factur-X of ZUGFeRD met EN 16931 CII XML.
- gPdf dient geen facturen in bij overheid- of koperportalen.
- Uw systeem beheert de zakelijke, fiscale en XML-juistheid.
Factur-X is een E-Invoice-packagingproces
Factur-X combineert een leesbare PDF met machineleesbare EN 16931 CII XML. Het publieke gPdf-endpoint verpakt die combinatie als PDF/A-3b-output. Het bepaalt de factuursemantiek niet en dient het bestand niet in bij een portaal.
FAQ
- Welk endpoint rendert Factur-X?
- Gebruik POST /api/v1/e-invoice/render met settings.e_invoice.standard ingesteld op factur_x.
- Genereert gPdf de EN 16931 XML?
- Uw systeem levert de CII XML aan en beheert de zakelijke juistheid ervan. gPdf verpakt deze in de hybride PDF.
- Ondersteunt gPdf XRechnung op deze pagina?
- Nee. Deze pagina is beperkt tot het publieke Factur-X-contract dat in OpenAPI staat.
- Dient gPdf Factur-X-facturen in bij portalen?
- Nee. Indiening en routering naar ontvangers blijven buiten de Render API.