API per PDF da template nei sistemi di produzione
Genera PDF da template da dati backend strutturati, senza browser, con confini chiari tra il PDF renderizzato da gPdf e le regole del tuo sistema.
/api/v1/template-render Generare PDF da template come PDF riproducibile da dati strutturati. Il tuo sistema mantiene la logica di business; gPdf gestisce il rendering PDF.
Quando usare questa API
- Il tuo backend possiede già i dati per PDF da template e deve ottenere una risposta PDF stabile.
- Vuoi evitare Chromium o HTML-to-PDF per documenti operativi.
- Ti serve output ripetibile per ristampe, audit o batch.
Cosa non sostituisce
- Hai bisogno che gPdf acquisti spedizioni, liquidi imposte, crei ordini esterni o agisca da sistema fiscale.
- Vuoi sostituire validazione dati, logica di business o integrazioni marketplace.
Quale endpoint chiamare
/api/v1/template-render
Template Render è il percorso predefinito per questo workflow.
/api/v1/pdf/render
Usalo quando il workflow richiede l’API collegata, un contratto di template o una verifica delle capacità.
Request minimo
/api/v1/template-render - PDF da template
{
"template_id": "invoice",
"data": [
{
"invoice_number": "INV-2026-001",
"date_of_issue": "2026-05-29",
"date_due": "2026-06-28",
"issuer_name": "Acme Cloud Inc.",
"issuer_address": "88 Harbor Rd, Long Beach, CA",
"bill_to_name": "Receiver Inc.",
"bill_to_address": "123 Main St, Los Angeles, CA",
"subtotal": "$100.00",
"total": "$100.00",
"amount_due": "$100.00",
"items": [
{
"description": "Service A",
"qty": 1,
"unit_price": "$100.00",
"amount": "$100.00"
}
]
}
]
}
Cosa gestisce gPdf
- Rendering PDF di PDF da template da request strutturate.
- Testi, tabelle, linee, codici a barre, pagine, metadati e opzioni di output secondo il request.
- Output deterministico per retry, ristampe e audit.
Cosa controlla il tuo sistema
- Dati corretti per PDF da template, regole di business e stato operativo.
- Autenticazione, persistenza, integrazioni esterne e validazione con i destinatari.
Checklist di produzione
- Testa con dati reali e con i sistemi che riceveranno il PDF.
- Salva request ID ed evidenze per supporto, audit e ristampa.
- Trasforma il layout approvato in template quando più sistemi devono riusarlo.
Limiti della promessa
- gPdf renderizza PDF dal request; non sostituisce workflow, database o validazione prodotto.
- Il tuo sistema mantiene semantica dati, retry, persistenza e accettazione finale.
Forma dell’API
API per PDF da template è un workflow di produzione basato sulle API pubbliche di gPdf. Il request descrive dati, layout, settings e parti PDF da renderizzare. gPdf renderizza il PDF; il tuo sistema mantiene la semantica dell’evento di business.
Scelta dell’endpoint
Per questo workflow, l’endpoint predefinito è /api/v1/template-render. Usa Template Render quando il layout è approvato e riutilizzato tra sistemi. Usa E-Invoice Render solo quando serve packaging Factur-X / ZUGFeRD PDF/A-3b con EN 16931 CII XML incorporato.
Validazione prima della produzione
Valida PDF da template con dati reali e con i sistemi che lo consumeranno. Conserva request ID, output renderizzato ed evidenze di validazione per supporto, audit e ristampa.
FAQ
- È un endpoint separato?
- API per PDF da template collega il workflow a una API pubblica di gPdf. La pagina indica quale percorso chiamare e cosa deve contenere il request.
- Posso usare template?
- Sì. Usa JSON Render mentre il layout cambia; usa Template Render quando il layout è approvato e i caller inviano solo dati di business.
- Cosa validare prima della produzione?
- Valida con dati reali e con stampanti, scanner, validatori, contabilità o marketplace del workflow.