PDF/A-3b API voor archivering en E-Invoice-processen
Genereer PDF/A-3b-output met gPdf en bepaal wanneer PDF/A-3b alleen een archiefprofiel is en wanneer het een E-Invoice-wrapper is.
/api/v1/pdf/render Genereer PDF/A-3b-documenten voor archiveringsprocessen en kies het E-Invoice-endpoint wanneer PDF/A-3b ingebedde Factur-X- of ZUGFeRD-EN 16931 XML moet dragen.
Wanneer deze API past
- U hebt een PDF/A-3b-archiefprofiel nodig voor een gerenderd document.
- U moet de grens tussen gewone PDF/A en E-Invoice-packaging uitleggen.
- Uw nalevingsproces controleert gegenereerde PDF's met veraPDF of een andere referentie-engine.
- U hebt een publieke pagina nodig die PDF/A-3b-zoekintentie naar het juiste endpoint leidt.
Wat dit niet vervangt
- U hebt willekeurige processen voor bestandsbijlagen nodig die niet in de publieke API zijn gedocumenteerd.
- U hebt Factur-X- of ZUGFeRD-e-invoices via JSON Render nodig. Gebruik E-Invoice Render.
- U hebt een validator-API nodig. Het huidige publieke validatoroppervlak is de /validator/-pagina.
Welk endpoint aanroepen
/api/v1/pdf/render
JSON Render is het standaardpad voor deze workflow.
/api/v1/e-invoice/render
Gebruik dit wanneer de workflow een verwant API-pad, templatecontract of capability lookup nodig heeft.
Minimale request
POST /api/v1/pdf/render - vraag PDF/A-3b-output aan voor een gerenderd document.
{
"settings": {
"profile": "pdfa-3b"
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Archive copy",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Wat gPdf afhandelt
- PDF/A-profielkeuze via JSON Render-instellingen.
- PDF/A-3b-E-Invoice-packaging bij gebruik van POST /api/v1/e-invoice/render.
- Renderbare PDF-output die geschikt is voor controle door externe referentie-engines.
- Duidelijke scheiding tussen archiefprofiel en juridisch E-Invoice-proces.
Wat uw systeem beheert
- Het bewaarbeleid en de reden waarom PDF/A-3b vereist is.
- Bedrijfsdata, XML-semantiek en externe acceptatiecriteria voor naleving.
- Controlebewijs, auditrecords en langetermijnopslag na rendering.
Productiechecklist
- Kies JSON Render voor gewone PDF/A-3b-output.
- Kies E-Invoice Render wanneer ingebedde EN 16931 XML vereist is.
- Controleer PDF/A-output met /validator/ of uw eigen veraPDF-proces.
- Registreer het gevraagde profiel en request-ID bij het opgeslagen document.
- Claim geen ondersteuning voor willekeurige bijlagen tenzij de publieke documentatie die noemt.
Grenzen van de claim
- PDF/A-3b is een archiefprofiel; E-Invoice-packaging is een smaller proces bovenop dat profiel.
- Implicieer niet dat elk willekeurig proces met ingebedde bestanden wordt ondersteund.
- De E-Invoice-route is vereist voor Factur-X- en ZUGFeRD-PDF/A-3b-pakketten.
PDF/A-3b is de wrapper, niet het hele proces
PDF/A-3b is een PDF-archiefprofiel. Het is belangrijk omdat het als wrapper voor hybride e-invoices kan dienen, maar het profiel alleen maakt een document nog geen juridische E-Invoice. Een gewoon gearchiveerd document kan PDF/A-3b gebruiken zonder ingebedde factuur-XML.
Gebruik voor Factur-X en ZUGFeRD POST /api/v1/e-invoice/render. Dat endpoint
is verantwoordelijk voor E-Invoice-specifieke metadata en koppeling van het
bijbehorende bestand.
Kies het endpoint op basis van intentie
Gebruik JSON Render wanneer uw doel is: “render dit document als PDF/A-3b”. Gebruik E-Invoice Render wanneer uw doel is: “verpak deze factuur als Factur-X of ZUGFeRD met EN 16931 CII XML”. Dat onderscheid houdt code duidelijk en voorkomt dat gewone archiveringstaken onbedoeld E-Invoice-aannames meenemen.
Controleer extern
PDF/A moet worden gecontroleerd met een referentie-engine, niet met een marketingclaim. Gebruik de publieke validator of uw eigen controlepipeline en bewaar het rapport bij uw auditbewijs.
FAQ
- Is PDF/A-3b altijd een E-Invoice?
- Nee. PDF/A-3b is een PDF-archiefprofiel. Factur-X- en ZUGFeRD-e-invoices gebruiken PDF/A-3b als wrapper voor ingebedde EN 16931 XML.
- Welk endpoint maakt PDF/A-3b?
- Gebruik POST /api/v1/pdf/render met settings.profile voor gewone PDF/A-3b. Gebruik POST /api/v1/e-invoice/render wanneer de output een Factur-X- of ZUGFeRD-e-invoice moet zijn.
- Kan ik via deze pagina willekeurige bestanden koppelen?
- Ga niet uit van ondersteuning voor willekeurige bijlagen tenzij de publieke API-documentatie dat proces vermeldt. Deze pagina richt zich op gedocumenteerd PDF/A-3b- en E-Invoice-gebruik.
- Hoe controleer ik PDF/A-output?
- Gebruik /validator/ of uw eigen pipeline met referentie-engines. Controleer voor e-invoices zowel de PDF/A-laag als de ingebedde XML-laag.