Welcher Endpunkt rendert Factur-X?

Nutzen Sie POST /api/v1/e-invoice/render mit settings.e_invoice.standard = factur_x.

Erzeugt gPdf das EN 16931 XML?

Ihr System liefert das CII XML und verantwortet dessen geschäftliche Korrektheit. gPdf paketiert es in das hybride PDF.

Unterstützt gPdf auf dieser Seite XRechnung?

Nein. Diese Seite ist auf den öffentlichen Factur-X-Vertrag beschränkt, der in OpenAPI aufgeführt ist.

Reicht gPdf Factur-X-Rechnungen bei Portalen ein?

Nein. Einreichung und Empfänger-Routing bleiben außerhalb der Render API.

Compliance und Archivierung

Factur-X API für hybride PDF/A-3b-E-Rechnungen

Erzeugen Sie Factur-X-Rechnungen als PDF/A-3b mit eingebettetem EN 16931 CII XML über den öffentlichen E-Invoice Render-Endpunkt.

PRIMÄRE API E-Invoice Render

ENDPOINT /api/v1/e-invoice/render

SYSTEME ERP / Billing-Backend / Compliance-Workflow / Finanzautomatisierungsdienst

Im Playground testen Dokumentation lesen

Aufgabe im Workflow

Verpacken Sie ein gerendertes Rechnungs-PDF als Factur-X PDF/A-3b mit eingebettetem EN 16931 CII XML, nachdem Ihr ERP- oder Billing-System die korrekten strukturierten Rechnungsdaten erzeugt hat.

Wann diese API passt

Sie benötigen native Factur-X-Ausgabe aus dem öffentlichen E-Invoice Render-Endpunkt.
Ihr System hat bereits gültiges EN 16931 CII XML für die Rechnung.
Sie benötigen PDF/A-3b-Paketierung mit Factur-X-Metadaten und Verknüpfung der zugehörigen Datei.
Sie möchten über den Capabilities-Endpunkt den aktuell veröffentlichten E-Invoice-Vertrag bestätigen.

Was sie nicht ersetzt

Sie benötigen, dass gPdf Rechnungslogik oder Steuerentscheidungen für Sie erzeugt.
Sie benötigen native Ausgabe für XRechnung, FatturaPA, KSeF, Peppol, ZATCA, NF-e oder andere Standards, die nicht in OpenAPI aufgeführt sind.
Sie benötigen direkte Einreichung bei Chorus Pro oder einem anderen Regierungsportal.

Welchen Endpoint aufrufen

PRIMÄR

/api/v1/e-invoice/render

E-Invoice Render ist der Standardpfad für diesen Workflow.

SEKUNDÄR 1

/api/v1/e-invoice/capabilities

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

Minimaler Request

POST /api/v1/e-invoice/render - minimale Factur-X-Paketform.

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

Was gPdf übernimmt

Factur-X-Paketierung über E-Invoice Render.
PDF/A-3b-Profilbehandlung für das hybride Rechnungs-PDF.
Einbettung von CII XML als zugehörige Datei mit Standard-Metadaten.
Inline-PDF-Auslieferung oder Object-Delivery-Job-Verhalten wie dokumentiert.

Was Ihr System verantwortet

Korrektes EN 16931 CII XML, Rechnungsnummern, Steuerlogik, Käufer- und Verkäuferdaten sowie Eignung.
Externe Validierung, Empfängerregeln, Portalübermittlung und rechtliche Interpretation.
Speicherung, Audit Trail, Retry-Logik und Zustellung an Kunden oder Portal.

Produktions-Checkliste

Validieren Sie das CII XML, bevor Sie es an gPdf senden.
Setzen Sie settings.profile auf pdfa-3b oder lassen Sie es weg, damit der E-Invoice-Default greift.
Nutzen Sie settings.e_invoice.standard = factur_x und settings.e_invoice.profile = en16931.
Prüfen Sie das zurückgegebene PDF mit Ihrem Factur-X-Validierungsworkflow.
Halten Sie Einreichung und Empfänger-Routing außerhalb der Render API.

Aussagegrenzen

Native öffentliche E-Invoice-Ausgabe ist Factur-X oder ZUGFeRD mit EN 16931 CII XML.
gPdf reicht keine Rechnungen bei Regierungs- oder Käuferportalen ein.
Ihr System verantwortet geschäftliche, steuerliche und XML-Korrektheit.

Factur-X ist ein E-Invoice-Paketierungsworkflow

Factur-X verbindet ein menschenlesbares PDF mit maschinenlesbarem EN 16931 CII XML. Der öffentliche gPdf-Endpunkt paketiert diese Kombination als PDF/A-3b-Ausgabe. Er entscheidet nicht über die Rechnungssemantik und reicht die Datei nicht bei einem Portal ein.

FAQ

Welcher Endpunkt rendert Factur-X?: Nutzen Sie POST /api/v1/e-invoice/render mit settings.e_invoice.standard = factur_x.
Erzeugt gPdf das EN 16931 XML?: Ihr System liefert das CII XML und verantwortet dessen geschäftliche Korrektheit. gPdf paketiert es in das hybride PDF.
Unterstützt gPdf auf dieser Seite XRechnung?: Nein. Diese Seite ist auf den öffentlichen Factur-X-Vertrag beschränkt, der in OpenAPI aufgeführt ist.
Reicht gPdf Factur-X-Rechnungen bei Portalen ein?: Nein. Einreichung und Empfänger-Routing bleiben außerhalb der Render API.