Factuur-PDF-API voor facturatie- en financiële systemen
Genereer gewone factuur-PDF's uit facturatiegegevens met JSON Render of Template Render, terwijl belasting- en boekhoudlogica in uw eigen systeem blijven.
/api/v1/pdf/render Zet factuurgegevens uit een facturatie-, ERP- of SaaS-systeem om naar een leesbare factuur-PDF, terwijl nummering, belasting, betalingsstatus en boekhoudkundige betekenis in het systeem blijven dat de API aanroept.
Wanneer deze API past
- U hebt gewone factuur-PDF's nodig voor klanten, bonnen, rekeningoverzichten of boekhoudexports.
- Uw systeem beheert al factuurnummers, belastingberekening, regelitems en betalingsstatus.
- U wilt tabellen, totalen, metadata en optionele PDF/A-instellingen zonder een browser te draaien.
- U wilt een `template_id`-contract voor terugkerende factuurlay-outs.
Wat dit niet vervangt
- U hebt een juridisch E-Invoice-pakket nodig, zoals Factur-X of ZUGFeRD. Gebruik dan E-Invoice Render.
- U verwacht dat gPdf belasting berekent, boekhoudregels valideert of betalingen reconcilieert.
- U wilt willekeurige HTML-facturen converteren in plaats van gestructureerde JSON of sjablonen te gebruiken.
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.
/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 - minimale factuurkop en totaal.
{
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Invoice INV-1007",
"style": { "font_size": 18, "font_family": "NotoSans-Regular" }
},
{
"type": "text",
"x": 20,
"y": 42,
"content": "Bill to: Example Customer\nAmount due: USD 245.00",
"style": { "font_size": 11, "font_family": "NotoSans-Regular" }
},
{
"type": "line",
"x1": 20,
"y1": 62,
"x2": 190,
"y2": 62
}
]
}
]
}
Wat gPdf afhandelt
- Rendering van factuur-PDF's vanuit JSON-pagina's of sjabloondata.
- Tekst, tabellen, totalenblokken, paginering, metadata en optionele PDF/A-output.
- Template Render voor stabiele factuurlay-outs die door meerdere systemen worden gebruikt.
- Binaire PDF-respons en een consistente API-foutstructuur.
Wat uw systeem beheert
- Factuurnummers, betalingsstatus, belastingberekening, kortingen, creditnota's en grootboekbetekenis.
- Klant- en afzendergegevens, mapping van regelitems, valuta en afrondingsregels.
- Bewaartermijnen, aflevering, e-mail, betaallinks en reconciliatie met het boekhoudsysteem.
Productiechecklist
- Controleer dat elk zichtbaar factuurveld naar brondata uit het facturatiesysteem verwijst.
- Test overlopende regelitems, lange klantnamen, facturen met meerdere pagina's en totalen.
- Bepaal of de lay-out in JSON Render of in een gepubliceerd sjabloon thuishoort.
- Houd gewone factuur-PDF-generatie gescheiden van juridische E-Invoice-packaging.
- Bewaar request-ID's en outputbestandsnamen bij uw factuurrecords.
Grenzen van de claim
- Gewone factuur-PDF's zijn niet hetzelfde als juridische E-Invoice-verplichtingen.
- gPdf rendert het factuurdocument; het berekent geen belasting of boekhoudstatus.
- Factur-X / ZUGFeRD-output hoort thuis op POST /api/v1/e-invoice/render.
Gewone facturen versus E-Invoices
Een gewone factuur-PDF is het document dat uw klant leest. Deze kan worden gegenereerd met JSON Render of Template Render. Uw systeem bepaalt het factuurnummer, de belasting, regelitems, valuta en betalingsstatus; gPdf rendert daarna de zichtbare PDF.
Een juridische E-Invoice is iets anders. Factur-X en ZUGFeRD combineren een
leesbare PDF/A-3b-factuur met ingebedde EN 16931 CII XML. Gebruik
POST /api/v1/e-invoice/render voor dat pakket.
Template Render is meestal het productie-endpoint
Financiële teams willen zelden dat elke service opnieuw factuurcoördinaten
opbouwt. De gebruikelijke route is om de factuur eenmaal te ontwerpen, deze als
sjabloon te publiceren en aanroepende systemen een stabiel template_id plus
een dataschema te geven. JSON Render blijft nuttig voor maatwerklay-outs,
interne tools en prototyping van sjablonen.
Houd boekhoudlogica upstream
gPdf moet definitieve weergavewaarden ontvangen, geen openstaande boekhoudbeslissingen. Bereken belasting, kortingen, afronding, betalingsstatus en factuurgeschiktheid voordat u de Render API aanroept. Zo blijft de PDF-output deterministisch en blijft het financiële systeem de leidende bron.
FAQ
- Is een factuur-PDF hetzelfde als een E-Invoice?
- Nee. Een gewone factuur-PDF is leesbare output voor mensen. Een Factur-X- of ZUGFeRD-E-Invoice bevat daarnaast EN 16931 CII XML in een PDF/A-3b-wrapper.
- Welk endpoint moet ik gebruiken voor terugkerende facturen?
- Gebruik Template Render wanneer de factuurlay-out stabiel is en aanroepende systemen alleen `template_id` plus `data` hoeven te sturen. Gebruik JSON Render wanneer code de lay-out beheert.
- Berekent gPdf belasting?
- Nee. Uw facturatie- of boekhoudsysteem berekent belasting, totalen, kortingen en betalingsstatus voordat het renderdata verstuurt.
- Kunnen factuur-PDF's PDF/A gebruiken?
- Ja, JSON Render ondersteunt PDF/A-instellingen. Gebruik E-Invoice Render specifiek wanneer de factuur als Factur-X of ZUGFeRD moet worden verpakt.