API per PDF di rendiconto per esportazioni account e fatturazione
Genera PDF di rendiconti account, fatturazione e attività con righe multipagina, totali, metadati e impostazioni PDF/A opzionali per l'archiviazione.
/api/v1/pdf/render Renderizzare PDF di rendiconto cliente, account o fatturazione da dati di periodo, saldi iniziali, righe, rettifiche e totali, così gli utenti possono scaricare un record coerente per revisione o conservazione.
Quando usare questa API
- Il vostro sistema possiede già saldi, periodi del rendiconto, righe transazione e totali.
- Vi serve un'esportazione PDF per storico account, riepiloghi di fatturazione o processi finance.
- Vi serve output multipagina ripetibile con intestazioni, piè di pagina e sezioni di riepilogo.
- Potrebbe servirvi output PDF/A per processi di archiviazione.
Cosa non sostituisce
- Vi servono connessioni bancarie, riconciliazione ledger o consulenza finanziaria.
- Vi servono rendiconti cifrati e PDF/A nella stessa richiesta di rendering. La Render API pubblica tratta impostazioni di sicurezza e impostazioni profilo PDF/A come mutuamente esclusive.
- Vi serve packaging XML di fattura elettronica. Usate l'endpoint E-Invoice Render per quello.
Quale endpoint chiamare
/api/v1/pdf/render
JSON Render è il percorso predefinito per questo flusso.
/api/v1/template-render
Usalo quando il flusso richiede l'API collegata, un contratto di template o una verifica delle capacità.
Request minimo
POST /api/v1/pdf/render - copertina rendiconto con totali di periodo.
{
"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" }
}
]
}
]
}
Cosa gestisce gPdf
- Rendering DocumentRequest per pagine di rendiconto.
- Blocchi di testo, tabelle, sezioni totali, numerazione pagine, metadati e impostazioni profilo PDF/A.
- Template Render per un layout rendiconto stabile e un contratto campi.
- Output PDF binario adatto al download o alla conservazione da parte del vostro sistema.
Cosa controlla il tuo sistema
- Logica dei periodi di rendiconto, saldi account, dati transazione, regole valuta e identità cliente.
- Criteri di archiviazione, controllo accessi, naming dei file e consegna sicura.
- Qualsiasi riconciliazione, approvazione di audit o rappresentazione finanziaria regolata.
Checklist di produzione
- Testate descrizioni transazione lunghe, conteggi riga elevati, periodi vuoti e saldi negativi.
- Generate un request ID per ogni rendering di rendiconto.
- Decidete se renderizzare on demand o salvare ogni rendiconto dopo la chiusura del periodo.
- Usate PDF/A solo quando i criteri di archiviazione del rendiconto lo richiedono.
- Tenete controllo accessi e autenticazione cliente fuori dall'API di rendering.
Limiti della promessa
- gPdf non calcola saldi account né riconcilia ledger.
- L'API renderizza PDF di rendiconto; il vostro sistema possiede la correttezza finanziaria.
- L'output PDF/A è un'impostazione di rendering, non un sostituto di una policy di conservazione.
I rendiconti sono documenti di periodo
Una pagina di rendiconto dovrebbe partire da un insieme chiuso di fatti di business: account, periodo, saldo iniziale, righe di attività, rettifiche e saldo finale. gPdf non decide quei fatti. Li renderizza in un layout PDF che gli utenti possono scaricare o che il vostro sistema può conservare.
Gestione di set di righe grandi
Per conteggi riga elevati, progettate il rendiconto come layout ripetibile con aree tabella, sezioni di riepilogo e numeri di pagina. Usate JSON Render mentre regolate il layout. Passate a Template Render quando il contratto dei campi è stabile.
FAQ
- gPdf può calcolare i saldi del rendiconto?
- No. Il vostro sistema invia periodo, saldi, righe e totali. gPdf renderizza il PDF.
- I PDF di rendiconto possono usare PDF/A?
- Sì, JSON Render supporta impostazioni profilo PDF/A. I vostri criteri di archiviazione decidono se PDF/A è richiesto.
- I rendiconti dovrebbero usare Template Render?
- Di solito sì dopo la stabilizzazione del layout. Template Render permette ai sistemi chiamanti di inviare dati di periodo senza ripetere le coordinate di pagina.
- gPdf archivia i rendiconti?
- No. Le richieste di rendering standard restituiscono la risposta PDF. Il vostro sistema possiede archiviazione e controllo accessi.