PDF/A API voor archiefgeschikte PDF-generatie
Genereer PDF/A-output vanuit JSON Render-requests voor archiveringsprocessen, met duidelijke grenzen tussen PDF/A-profielen en E-Invoice-packaging.
/api/v1/pdf/render Genereer PDF/A-profieloutput vanuit gestructureerde documentrequests wanneer een bedrijfsproces archiefgeschikte PDF's nodig heeft, en kies E-Invoice Render alleen wanneer packaging met ingebedde XML-factuurdata vereist is.
Wanneer deze API past
- Uw proces heeft een PDF/A-profiel nodig dat in renderinstellingen wordt gekozen.
- U hebt archiefgeschikte factuur-, overzichts-, rapport- of documentoutput nodig.
- U wilt een algemene PDF/A-pagina die breder is dan PDF/A-3b-E-Invoice-packaging.
- U kunt het geproduceerde bestand controleren met uw eigen acceptatieproces voor archivering.
Wat dit niet vervangt
- U hebt Factur-X of ZUGFeRD met ingebedde EN 16931 CII XML nodig. Gebruik E-Invoice Render.
- U hebt alleen een controleproces nodig. Gebruik de validatorpagina's voor validatiecontext.
- U hebt versleutelde output en PDF/A in dezelfde request nodig. De publieke Render API behandelt beveiligingsinstellingen en PDF/A-profielinstellingen als wederzijds uitsluitend.
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 - gewone PDF/A-outputinstelling.
{
"settings": {
"profile": "pdfa-2b"
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Archive-ready document",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Wat gPdf afhandelt
- PDF/A-profielinstellingen op JSON Render-requests.
- Documentrendering met tekst, tabellen, afbeeldingen, barcodes, metadata en profieloutput.
- PDF/A-3b-E-Invoice-packaging alleen via het E-Invoice Render-pad.
- Binaire PDF-respons met gedeeld foutgedrag.
Wat uw systeem beheert
- Archiveringsbeleid, profielkeuze, controleproces, bewaartermijn en juridische acceptatie.
- Documentsemantiek, bedrijfsdata en eventueel vereist extern bewijs.
- Opslag, toegangscontrole en toekomstig migratiebeleid.
Productiechecklist
- Kies het PDF/A-profiel dat uw archief of klant vereist.
- Haal output door uw validator en acceptatieproces voor bewaring.
- Houd PDF/A- en beveiligingsinstellingen in gescheiden renderpaden, tenzij de publieke documentatie een compatibel contract toevoegt.
- Gebruik E-Invoice Render wanneer ingebedde CII XML vereist is.
- Bewaar de brondata of geretourneerde PDF volgens het bewaarbeleid.
Grenzen van de claim
- PDF/A-output is niet hetzelfde als juridische E-Invoice-packaging.
- gPdf vervangt uw archiefacceptatie of validatorproces niet.
- Uw systeem beheert bewaring en interpretatie van naleving.
PDF/A is een profielkeuze
Voor gewone archiefdocumenten wordt PDF/A gekozen via renderinstellingen. Zo blijft het proces dicht bij JSON Render: uw systeem beschrijft het document en stelt het benodigde profiel in.
E-Invoice-packaging is anders. Wanneer het document Factur-X of ZUGFeRD met ingebedde CII XML nodig heeft, gebruikt u het E-Invoice Render-endpoint.
FAQ
- Welk endpoint moet ik gebruiken voor algemene PDF/A-output?
- Gebruik POST /api/v1/pdf/render met de juiste settings.profile-waarde voor gewone PDF/A-output.
- Wanneer heb ik E-Invoice Render nodig?
- Gebruik E-Invoice Render wanneer het document een Factur-X- of ZUGFeRD-PDF/A-3b-pakket met ingebedde CII XML moet zijn.
- Controleert gPdf archiefacceptatie?
- Nee. gPdf rendert PDF/A-output. Uw systeem moet output controleren tegen het acceptatiebeleid van het archief of de klant.
- Kan PDF/A worden gecombineerd met beveiligingsinstellingen?
- Niet in de huidige publieke Render API. settings.profile en settings.security sluiten elkaar uit en ongeldige combinaties falen bij validatie.