Rekeningoverzicht-PDF-API voor account- en facturatie-exports
Genereer rekening-, facturatie- en activiteitenoverzichten als PDF met rijen over meerdere pagina's, totalen, metadata en optionele PDF/A-archiveringsinstellingen.
/api/v1/pdf/render Render klant-, account- of facturatieoverzichten als PDF vanuit periodedata, beginsaldi, regelitems, correcties en totalen, zodat gebruikers een consistent document kunnen downloaden voor controle of bewaring.
Wanneer deze API past
- Uw systeem beheert al saldi, overzichtsperioden, transactierijen en totalen.
- U hebt een PDF-export nodig voor accounthistorie, facturatiesamenvattingen of financiële processen.
- U hebt herhaalbare output over meerdere pagina's nodig met kopteksten, voetteksten en samenvattingssecties.
- U hebt mogelijk PDF/A-output nodig voor archiveringsprocessen.
Wat dit niet vervangt
- U hebt bankconnectiviteit, grootboekreconciliatie of financieel advies nodig.
- U hebt versleutelde overzichten en PDF/A in dezelfde renderrequest nodig. De publieke Render API behandelt beveiligingsinstellingen en PDF/A-profielinstellingen als wederzijds uitsluitend.
- U hebt E-Invoice-XML-packaging nodig. Gebruik daarvoor het E-Invoice Render-endpoint.
Welk endpoint aanroepen
/api/v1/pdf/render
JSON Render is het standaardpad voor deze workflow.
/api/v1/template-render
Gebruik dit wanneer de workflow een verwant API-pad, templatecontract of capability lookup nodig heeft.
Minimale request
POST /api/v1/pdf/render - voorblad voor een overzicht met periodetotalen.
{
"settings": {
"profile": "pdfa-2b"
},
"pages": [
{
"size": "letter",
"elements": [
{
"type": "text",
"x": 18,
"y": 20,
"content": "Account Statement",
"style": { "font_size": 18, "font_family": "NotoSans-Regular" }
},
{
"type": "text",
"x": 18,
"y": 38,
"content": "Period: 2026-05-01 to 2026-05-31\nOpening balance: $1,240.00\nClosing balance: $1,890.25",
"style": { "font_size": 11, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Wat gPdf afhandelt
- DocumentRequest-rendering voor overzichtspagina's.
- Tekstblokken, tabellen, totalensecties, paginanummering, metadata en PDF/A-profielinstellingen.
- Template Render voor een stabiele lay-out voor overzichten en een veldcontract.
- Binaire PDF-output die geschikt is om door uw systeem te downloaden of op te slaan.
Wat uw systeem beheert
- Periodenlogica, accountsaldi, transactiedata, valutaregels en klantidentiteit.
- Archiveringsbeleid, toegangscontrole, bestandsnaamgeving en veilige aflevering.
- Elke reconciliatie, auditgoedkeuring of gereguleerde financiële weergave.
Productiechecklist
- Test lange transactiebeschrijvingen, hoge aantallen rijen, lege perioden en negatieve saldi.
- Genereer een request-ID voor elke render van een overzicht.
- Bepaal of u on demand rendert of elk overzicht na periodeafsluiting opslaat.
- Gebruik PDF/A alleen wanneer het archiveringsbeleid voor het overzicht dit vereist.
- Houd toegangscontrole en klantauthenticatie buiten de Render API.
Grenzen van de claim
- gPdf berekent geen accountsaldi en reconcilieert geen grootboeken.
- De API rendert overzichts-PDF's; uw systeem beheert de financiële juistheid.
- PDF/A-output is een renderinstelling, geen vervanging voor een bewaarbeleid.
Overzichten zijn periodedocumenten
Een overzichtspagina moet starten vanuit een afgesloten set bedrijfsfeiten: account, periode, beginsaldo, activiteitenregels, correcties en eindsaldo. gPdf bepaalt die feiten niet. Het rendert ze naar een PDF-lay-out die uw gebruikers kunnen downloaden of die uw systeem kan opslaan.
Grote aantallen rijen verwerken
Ontwerp het overzicht bij hoge rij-aantallen als een herhaalbare lay-out met tabelgebieden, samenvattingssecties en paginanummers. Gebruik JSON Render bij het afstemmen van de lay-out. Stap over op Template Render wanneer het veldcontract stabiel is.
FAQ
- Kan gPdf saldi voor overzichten berekenen?
- Nee. Uw systeem stuurt de periode, saldi, rijen en totalen. gPdf rendert de PDF.
- Kunnen overzichts-PDF's PDF/A gebruiken?
- Ja, JSON Render ondersteunt PDF/A-profielinstellingen. Uw archiveringsbeleid bepaalt of PDF/A vereist is.
- Moeten overzichten Template Render gebruiken?
- Meestal wel nadat de lay-out stabiel is. Met Template Render kunnen aanroepende systemen periodedata sturen zonder paginacoördinaten te herhalen.
- Slaat gPdf overzichten op?
- Nee. Standaard renderrequests retourneren de PDF-respons. Uw systeem beheert opslag en toegangscontrole.