API ZUGFeRD per fatture ibride PDF/A-3b
Genera fatture ZUGFeRD PDF/A-3b con XML CII EN 16931 incorporato usando l'endpoint pubblico gPdf E-Invoice Render.
/api/v1/e-invoice/render Confezionare l'output PDF della fattura come ZUGFeRD PDF/A-3b con XML CII EN 16931 incorporato dopo che il vostro ERP o sistema di fatturazione ha preparato i dati fattura corretti.
Quando usare questa API
- Vi serve output ZUGFeRD nativo dall'endpoint pubblico E-Invoice Render.
- Il vostro sistema possiede già XML CII EN 16931 valido per la fattura.
- Vi serve packaging PDF/A-3b con metadati ZUGFeRD e cablaggio del file associato.
- Vi serve una pagina affine e chiara rispetto alle pagine e-invoice più ampia e Factur-X.
Cosa non sostituisce
- Vi serve generazione XRechnung nativa o invio a portale.
- Vi serve che gPdf calcoli imposte, inferisca semantica di fattura o crei XML da record contabili.
- Vi servono standard non elencati nel contratto OpenAPI pubblico.
Quale endpoint chiamare
/api/v1/e-invoice/render
E-Invoice Render è il percorso predefinito per questo flusso.
/api/v1/e-invoice/capabilities
Usalo quando il flusso richiede l'API collegata, un contratto di template o una verifica delle capacità.
Request minimo
POST /api/v1/e-invoice/render - forma minima del pacchetto ZUGFeRD.
{
"settings": {
"profile": "pdfa-3b",
"e_invoice": {
"standard": "zugferd",
"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": "ZUGFeRD invoice",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Cosa gestisce gPdf
- Packaging ZUGFeRD tramite E-Invoice Render.
- Gestione del profilo PDF/A-3b per output di fattura ibrida.
- Incorporamento dell'XML CII come file associato con metadati ZUGFeRD.
- Comportamento di consegna PDF inline o object delivery come documentato.
Cosa controlla il tuo sistema
- Correttezza dell'XML CII EN 16931, dati fattura, logica fiscale e semantica acquirente/venditore.
- Validazione esterna, requisiti del destinatario, invio a portale e interpretazione legale.
- Comportamento di retry, conservazione, evidenze di audit e consegna al cliente.
Checklist di produzione
- Impostate settings.e_invoice.standard = zugferd e settings.e_invoice.profile = en16931.
- Usate XML CII con format = cii ed encoding = utf8.
- Impostate settings.profile su pdfa-3b oppure omettetelo per usare il default e-invoice.
- Validate il PDF restituito nel vostro processo di validazione ZUGFeRD.
- Tenete lavoro XRechnung o invio a portale fuori da questo endpoint.
Limiti della promessa
- Questa pagina copre output ZUGFeRD tramite E-Invoice Render.
- Non dichiara generazione XRechnung nativa.
- Il vostro sistema possiede dati business della fattura e validità XML.
ZUGFeRD usa il percorso di rendering e-invoice
ZUGFeRD non è un endpoint root separato. Si seleziona tramite il campo
settings.e_invoice.standard su POST /api/v1/e-invoice/render. Vale lo stesso
confine: gPdf confeziona la fattura ibrida PDF/A-3b; il vostro sistema possiede
i fatti della fattura e la validità XML.
FAQ
- Quale endpoint renderizza ZUGFeRD?
- Usate POST /api/v1/e-invoice/render con settings.e_invoice.standard impostato su zugferd.
- Questa pagina copre XRechnung?
- No. Questa pagina è limitata al contratto pubblico ZUGFeRD. XRechnung non è dichiarato qui come output nativo.
- gPdf crea l'XML CII?
- Il vostro sistema fornisce l'XML CII EN 16931 e ne possiede la correttezza.
- Posso verificare il risultato?
- Usate il vostro processo di validazione ZUGFeRD e le pagine validator di gPdf per il contesto di validazione.