Welk endpoint rendert ZUGFeRD?

Gebruik POST /api/v1/e-invoice/render met settings.e_invoice.standard ingesteld op zugferd.

Behandelt deze pagina XRechnung?

Nee. Deze pagina is beperkt tot het publieke ZUGFeRD-contract. XRechnung wordt hier niet als native output geclaimd.

Maakt gPdf de CII XML?

Uw systeem levert de EN 16931 CII XML aan en beheert de juistheid ervan.

Kan ik het resultaat controleren?

Gebruik uw ZUGFeRD-validatieproces en de gPdf-validatorpagina's als controlecontext.

Compliance en archivering

ZUGFeRD API voor hybride PDF/A-3b-facturen

Genereer ZUGFeRD-PDF/A-3b-facturen met ingebedde EN 16931 CII XML via het publieke gPdf E-Invoice Render-endpoint.

PRIMAIRE API E-Invoice Render

ENDPOINT /api/v1/e-invoice/render

SYSTEMEN ERP / facturatiebackend / Duits financieel proces / service voor nalevingsautomatisering

Testen in Playground Documentatie lezen

Taak om op te lossen

Verpak factuur-PDF-output als ZUGFeRD PDF/A-3b met ingebedde EN 16931 CII XML nadat uw ERP- of facturatiesysteem de juiste factuurdata heeft voorbereid.

Wanneer deze API past

U hebt native ZUGFeRD-output nodig vanuit het publieke E-Invoice Render-endpoint.
Uw systeem heeft al geldige EN 16931 CII XML voor de factuur.
U hebt PDF/A-3b-packaging nodig met ZUGFeRD-metadata en koppeling van het bijbehorende bestand.
U hebt een duidelijke zusterpagina nodig naast de bredere E-Invoice- en Factur-X-pagina's.

Wat dit niet vervangt

U hebt native XRechnung-generatie of portaalindiening nodig.
U hebt gPdf nodig om belasting te berekenen, factuursemantiek af te leiden of XML uit boekhoudrecords te maken.
U hebt standaarden nodig die niet in het publieke OpenAPI-contract staan.

Welk endpoint aanroepen

PRIMAIR

/api/v1/e-invoice/render

E-Invoice Render is het standaardpad voor deze workflow.

SECUNDAIR 1

/api/v1/e-invoice/capabilities

Gebruik dit wanneer de workflow een verwant API-pad, templatecontract of capability lookup nodig heeft.

Minimale request

POST /api/v1/e-invoice/render - minimale ZUGFeRD-pakketvorm.

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

Wat gPdf afhandelt

ZUGFeRD-packaging via E-Invoice Render.
PDF/A-3b-profielafhandeling voor hybride factuuroutput.
Het inbedden van CII XML als gekoppeld bestand met ZUGFeRD-metadata.
Inline PDF- of objectdelivery-gedrag zoals gedocumenteerd.

Wat uw systeem beheert

Juistheid van EN 16931 CII XML, factuurdata, belastinglogica en koper- en verkopersemantiek.
Externe validatie, ontvangereisen, portaalindiening en juridische interpretatie.
Retrygedrag, opslag, auditbewijs en aflevering aan klanten.

Productiechecklist

Gebruik settings.e_invoice.standard = zugferd en settings.e_invoice.profile = en16931.
Gebruik CII XML met format = cii en encoding = utf8.
Zet settings.profile op pdfa-3b of laat dit weg zodat de E-Invoice-standaardinstelling geldt.
Valideer de geretourneerde PDF met uw ZUGFeRD-validatieproces.
Houd XRechnung- of portaalindieningswerk buiten dit endpoint.

Grenzen van de claim

Deze pagina behandelt ZUGFeRD-output via E-Invoice Render.
Er wordt geen native XRechnung-generatie geclaimd.
Uw systeem beheert factuurbedrijfsdata en XML-geldigheid.

ZUGFeRD gebruikt het E-Invoice-renderpad

ZUGFeRD is geen apart root-endpoint. Het wordt geselecteerd via het veld settings.e_invoice.standard op POST /api/v1/e-invoice/render. Dezelfde grens geldt: gPdf verpakt de PDF/A-3b-hybride factuur; uw systeem beheert de factuurfeiten en XML-geldigheid.

FAQ

Welk endpoint rendert ZUGFeRD?: Gebruik POST /api/v1/e-invoice/render met settings.e_invoice.standard ingesteld op zugferd.
Behandelt deze pagina XRechnung?: Nee. Deze pagina is beperkt tot het publieke ZUGFeRD-contract. XRechnung wordt hier niet als native output geclaimd.
Maakt gPdf de CII XML?: Uw systeem levert de EN 16931 CII XML aan en beheert de juistheid ervan.
Kan ik het resultaat controleren?: Gebruik uw ZUGFeRD-validatieproces en de gPdf-validatorpagina's als controlecontext.