Welchen Endpunkt sollte ich für allgemeine PDF/A-Ausgabe nutzen?

Nutzen Sie POST /api/v1/pdf/render mit dem passenden settings.profile-Wert für normale PDF/A-Ausgabe.

Wann brauche ich E-Invoice Render?

Nutzen Sie E-Invoice Render, wenn das Dokument ein Factur-X- oder ZUGFeRD-PDF/A-3b-Paket mit eingebettetem CII XML sein muss.

Validiert gPdf die Archiv-Akzeptanz?

Nein. gPdf rendert PDF/A-Ausgabe. Ihr System sollte die Ausgabe gegen die Archiv- oder Kunden-Abnahmerichtlinie validieren.

Kann PDF/A mit Sicherheitseinstellungen kombiniert werden?

Nicht in der aktuellen öffentlichen Render API. settings.profile und settings.security schließen sich gegenseitig aus; ungültige Kombinationen scheitern in der Validierung.

Compliance und Archivierung

PDF/A API für archivfähige PDF-Generierung

Erzeugen Sie PDF/A-Ausgabe aus JSON-Render-Requests für Archivierungs-Workflows, mit klarer Grenze zwischen PDF/A-Profilen und E-Invoice-Paketierung.

PRIMÄRE API JSON Render

ENDPOINT /api/v1/pdf/render

SYSTEME Compliance-Backend / Archivdienst / ERP-Exportdienst / Dokumentenautomatisierungsdienst

Im Playground testen Dokumentation lesen

Aufgabe im Workflow

Erzeugen Sie Ausgabe mit PDF/A-Profil aus strukturierten Dokument-Requests, wenn ein Geschäftsprozess archivfreundliche PDFs benötigt, und wählen Sie E-Invoice Render nur dann, wenn eingebettete XML-Rechnungspaketierung erforderlich ist.

Wann diese API passt

Ihr Workflow benötigt ein PDF/A-Profil, das in den Render-Einstellungen ausgewählt wird.
Sie benötigen archivfähige Ausgabe für Rechnungen, Kontoauszüge, Berichte oder Dokumente.
Sie möchten eine allgemeine PDF/A-Seite, die breiter ist als PDF/A-3b-E-Invoice-Paketierung.
Sie können die erzeugte Datei mit Ihrem eigenen Archiv-Abnahmeworkflow validieren.

Was sie nicht ersetzt

Sie benötigen Factur-X oder ZUGFeRD mit eingebettetem EN 16931 CII XML. Nutzen Sie E-Invoice Render.
Sie benötigen nur einen Validator-Workflow. Nutzen Sie die Validator-Seiten als Validierungskontext.
Sie benötigen verschlüsselte Ausgabe und PDF/A im selben Request. Die öffentliche Render API behandelt Sicherheitseinstellungen und PDF/A-Profileinstellungen als gegenseitig ausschließend.

Welchen Endpoint aufrufen

PRIMÄR

/api/v1/pdf/render

JSON Render ist der Standardpfad für diesen Workflow.

SEKUNDÄR 1

/api/v1/e-invoice/render

Nutzen Sie dies, wenn der Workflow den zugehörigen API-Pfad, einen Template-Vertrag oder eine Capability-Abfrage braucht.

Minimaler Request

POST /api/v1/pdf/render - normale PDF/A-Ausgabeeinstellung.

{
  "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" }
        }
      ]
    }
  ]
}

Was gPdf übernimmt

PDF/A-Profileinstellungen auf JSON-Render-Requests.
Dokument-Rendering mit Text, Tabellen, Bildern, Barcodes, Metadaten und Profilausgabe.
PDF/A-3b-E-Invoice-Paketierung nur über den E-Invoice Render-Pfad.
Binäre PDF-Antwort mit gemeinsamem Fehlerverhalten.

Was Ihr System verantwortet

Archivierungsrichtlinie, Profilwahl, Validierungsworkflow, Aufbewahrung und rechtliche Akzeptanz.
Dokumentsemantik, Geschäftsdaten und alle erforderlichen externen Nachweise.
Speicherung, Zugriffskontrolle und zukünftige Migrationsstrategie.

Produktions-Checkliste

Wählen Sie das PDF/A-Profil, das Ihr Archiv oder Ihr Kunde verlangt.
Führen Sie die Ausgabe durch Ihren Validator- und Aufbewahrungs-Abnahmeworkflow.
Halten Sie PDF/A- und Sicherheitseinstellungen in getrennten Render-Flows, solange die öffentlichen Docs keinen kompatiblen Vertrag ergänzen.
Nutzen Sie E-Invoice Render, wenn eingebettetes CII XML erforderlich ist.
Speichern Sie Quelldaten oder zurückgegebenes PDF gemäß Ihrer Aufbewahrungsrichtlinie.

Aussagegrenzen

PDF/A-Ausgabe ist nicht dasselbe wie rechtliche E-Invoice-Paketierung.
gPdf ersetzt nicht Ihren Archiv-Abnahme- oder Validator-Workflow.
Ihr System verantwortet Aufbewahrung und Compliance-Interpretation.

PDF/A ist eine Profilwahl

Für normale Archivdokumente wird PDF/A über Render-Einstellungen ausgewählt. Damit bleibt der Workflow nah an JSON Render: Ihr System beschreibt das Dokument und setzt das benötigte Profil.

E-Invoice-Paketierung ist etwas anderes. Wenn das Dokument Factur-X oder ZUGFeRD mit eingebettetem CII XML benötigt, nutzen Sie den E-Invoice Render-Endpunkt.

FAQ

Welchen Endpunkt sollte ich für allgemeine PDF/A-Ausgabe nutzen?: Nutzen Sie POST /api/v1/pdf/render mit dem passenden settings.profile-Wert für normale PDF/A-Ausgabe.
Wann brauche ich E-Invoice Render?: Nutzen Sie E-Invoice Render, wenn das Dokument ein Factur-X- oder ZUGFeRD-PDF/A-3b-Paket mit eingebettetem CII XML sein muss.
Validiert gPdf die Archiv-Akzeptanz?: Nein. gPdf rendert PDF/A-Ausgabe. Ihr System sollte die Ausgabe gegen die Archiv- oder Kunden-Abnahmerichtlinie validieren.
Kann PDF/A mit Sicherheitseinstellungen kombiniert werden?: Nicht in der aktuellen öffentlichen Render API. settings.profile und settings.security schließen sich gegenseitig aus; ungültige Kombinationen scheitern in der Validierung.