Quale endpoint devo usare per output PDF/A generale?

Usate POST /api/v1/pdf/render con il valore settings.profile appropriato per output PDF/A ordinario.

Quando mi serve E-Invoice Render?

Usate E-Invoice Render quando il documento deve essere un pacchetto Factur-X o ZUGFeRD PDF/A-3b con XML CII incorporato.

gPdf valida l'accettazione per l'archiviazione?

No. gPdf renderizza output PDF/A. Il vostro sistema dovrebbe validare l'output rispetto alla policy di accettazione dell'archivio o del cliente.

PDF/A può essere combinato con impostazioni di sicurezza?

Non nell'attuale Render API pubblica. settings.profile e settings.security sono mutuamente esclusivi e combinazioni non valide falliscono la validazione.

Compliance e archiviazione

API PDF/A per generazione PDF da archiviare

Genera output PDF/A da richieste JSON Render per processi di archiviazione, con confini chiari tra profili PDF/A e packaging e-invoice.

API PRINCIPALE JSON Render

ENDPOINT /api/v1/pdf/render

SISTEMI backend di conformità / servizio di archiviazione / servizio export ERP / servizio di automazione documentale

Provare nel Playground Leggere la documentazione

Lavoro da svolgere

Generare output con profilo PDF/A da richieste documentali strutturate quando un processo di business richiede PDF adatti all'archiviazione, scegliendo E-Invoice Render solo quando serve packaging di fattura con XML incorporato.

Quando usare questa API

Il vostro processo richiede un profilo PDF/A selezionato nelle impostazioni di rendering.
Vi serve output archiviabile per fatture, rendiconti, report o documenti.
Volete una pagina PDF/A generale, più ampia del packaging e-invoice PDF/A-3b.
Potete validare il file prodotto con il vostro processo di accettazione per l'archiviazione.

Cosa non sostituisce

Vi serve Factur-X o ZUGFeRD con XML CII EN 16931 incorporato. Usate E-Invoice Render.
Vi serve solo un percorso di verifica. Usate le pagine validator per il contesto di verifica.
Vi serve output cifrato e PDF/A nella stessa richiesta. La Render API pubblica tratta impostazioni di sicurezza e impostazioni profilo PDF/A come mutuamente esclusive.

Quale endpoint chiamare

PRIMARIO

/api/v1/pdf/render

JSON Render è il percorso predefinito per questo flusso.

SECONDARIO 1

/api/v1/e-invoice/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 - impostazione ordinaria di output PDF/A.

{
  "settings": {
    "profile": "pdfa-2b"
  },
  "pages": [
    {
      "size": "a4",
      "elements": [
        {
          "type": "text",
          "x": 20,
          "y": 24,
          "content": "Archive-ready document",
          "style": { "font_size": 16, "font_family": "NotoSans-Regular" }
        }
      ]
    }
  ]
}

Cosa gestisce gPdf

Impostazioni profilo PDF/A nelle richieste JSON Render.
Rendering documentale con testo, tabelle, immagini, codici a barre, metadati e output con profilo.
Packaging e-invoice PDF/A-3b solo tramite il percorso E-Invoice Render.
Risposta PDF binaria con comportamento di errore condiviso.

Cosa controlla il tuo sistema

Policy di archiviazione, selezione del profilo, processo di verifica, conservazione e accettazione legale.
Semantica del documento, dati di business e ogni evidenza esterna richiesta.
Archiviazione, controllo accessi e policy di migrazione futura.

Checklist di produzione

Selezionate il profilo PDF/A richiesto dal vostro archivio o cliente.
Passate l'output nel vostro processo di verifica e accettazione per la conservazione.
Tenete PDF/A e impostazioni di sicurezza in flussi di rendering separati, salvo quando la documentazione pubblica aggiunge un contratto compatibile.
Usate E-Invoice Render quando è richiesto XML CII incorporato.
Conservate i dati sorgente o il PDF restituito secondo la policy di conservazione.

Limiti della promessa

L'output PDF/A non è la stessa cosa del packaging legale e-invoice.
gPdf non sostituisce il vostro processo di accettazione o verifica per l'archiviazione.
Il vostro sistema possiede conservazione e interpretazione di conformità.

PDF/A è una scelta di profilo

Per i documenti ordinari da archiviare, PDF/A viene selezionato nelle impostazioni di rendering. Questo mantiene il processo vicino a JSON Render: il vostro sistema descrive il documento e imposta il profilo di cui ha bisogno.

Il packaging e-invoice è diverso. Quando il documento richiede Factur-X o ZUGFeRD con XML CII incorporato, usate l’endpoint E-Invoice Render.

FAQ

Quale endpoint devo usare per output PDF/A generale?: Usate POST /api/v1/pdf/render con il valore settings.profile appropriato per output PDF/A ordinario.
Quando mi serve E-Invoice Render?: Usate E-Invoice Render quando il documento deve essere un pacchetto Factur-X o ZUGFeRD PDF/A-3b con XML CII incorporato.
gPdf valida l'accettazione per l'archiviazione?: No. gPdf renderizza output PDF/A. Il vostro sistema dovrebbe validare l'output rispetto alla policy di accettazione dell'archivio o del cliente.
PDF/A può essere combinato con impostazioni di sicurezza?: Non nell'attuale Render API pubblica. settings.profile e settings.security sono mutuamente esclusivi e combinazioni non valide falliscono la validazione.