API per fatture Factur-X nei sistemi di produzione
Genera fatture Factur-X da dati backend strutturati, senza browser, con confini chiari tra il PDF renderizzato da gPdf e le regole del tuo sistema.
/api/v1/e-invoice/render Generare fatture Factur-X 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 fatture Factur-X 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/e-invoice/render
E-Invoice Render è il percorso predefinito per questo workflow.
/api/v1/e-invoice/capabilities
Usalo quando il workflow richiede l’API collegata, un contratto di template o una verifica delle capacità.
Request minimo
/api/v1/e-invoice/render - fatture Factur-X
{
"settings": {
"profile": "pdfa-3b",
"e_invoice": {
"standard": "factur_x",
"profile": "en16931",
"document_type": "invoice",
"xml": {
"format": "cii",
"encoding": "utf8",
"content": "<rsm:CrossIndustryInvoice>...</rsm:CrossIndustryInvoice>"
}
}
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Factur-X invoice",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Cosa gestisce gPdf
- Rendering PDF di fatture Factur-X 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 fatture Factur-X, 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 usa l’endpoint pubblico e-invoice per Factur-X / ZUGFeRD PDF/A-3b.
- Portali fiscali, PDP, SDI, KSeF, ZATCA, IRP, Peppol e obblighi legali restano fuori scope.
- Il tuo sistema mantiene dati acquirente, logica fiscale, routing e interpretazione legale locale.
Forma dell’API
API per fatture Factur-X è 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/e-invoice/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 fatture Factur-X 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 fatture Factur-X usa l’endpoint pubblico e-invoice quando il workflow richiede Factur-X / ZUGFeRD PDF/A-3b. Non è una superficie separata.
- Copre reti locali di clearance?
- No. gPdf renderizza e impacchetta il PDF/e-invoice; portali fiscali e routing legale restano nel tuo sistema.
- Posso continuare a usare JSON Render?
- Sì per PDF ordinari. Usa E-Invoice Render quando l’output deve includere il pacchetto strutturato dell’API pubblica.