Compliance और archival

PDF/A-3b hybrid invoices के लिए ZUGFeRD API

Public gPdf E-Invoice Render endpoint से embedded EN 16931 CII XML वाले ZUGFeRD PDF/A-3b invoices generate करें.

PRIMARY API E-Invoice Render
ENDPOINT /api/v1/e-invoice/render
SYSTEMS ERP / billing backend / German finance workflow / compliance automation service
काम जो पूरा करना है

ERP या billing system correct invoice data prepare कर चुका हो, उसके बाद invoice PDF output को embedded EN 16931 CII XML वाले ZUGFeRD PDF/A-3b के रूप में package करें.

यह API कब इस्तेमाल करें

  • आपको public E-Invoice Render endpoint से native ZUGFeRD output चाहिए.
  • आपके system के पास invoice के लिए valid EN 16931 CII XML पहले से है.
  • ZUGFeRD metadata और associated-file wiring के साथ PDF/A-3b packaging चाहिए.
  • Broader e-invoice और Factur-X pages की clear sibling page चाहिए.

यह क्या replace नहीं करता

  • आपको native XRechnung generation या portal submission चाहिए.
  • आपको gPdf से tax calculate, invoice semantics infer या accounting records से XML create कराना है.
  • आपको public OpenAPI contract में listed नहीं standards चाहिए.

कौन सा endpoint call करें

PRIMARY

/api/v1/e-invoice/render

E-Invoice Render इस workflow का default path है।

SECONDARY 1

/api/v1/e-invoice/capabilities

जब workflow को related API path, template contract या capabilities lookup चाहिए, तब इसका उपयोग करें।

Minimal request

POST /api/v1/e-invoice/render - minimal ZUGFeRD package shape.

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

gPdf क्या handle करता है

  • E-Invoice Render से ZUGFeRD packaging.
  • Hybrid invoice output के लिए PDF/A-3b profile handling.
  • ZUGFeRD metadata के साथ CII XML को associated file की तरह embed करना.
  • Docs में described inline PDF या object delivery behavior.

आपका system क्या संभालता है

  • EN 16931 CII XML correctness, invoice data, tax logic, buyer और seller semantics.
  • External validation, recipient requirements, portal submission और legal interpretation.
  • Retry behavior, storage, audit evidence और customer delivery.

Production checklist

  1. settings.e_invoice.standard = zugferd और settings.e_invoice.profile = en16931 set करें.
  2. format = cii और encoding = utf8 वाला CII XML use करें.
  3. settings.profile को pdfa-3b set करें या omit करें ताकि e-invoice default apply हो.
  4. Returned PDF को अपने ZUGFeRD validation workflow से validate करें.
  5. XRechnung या portal submission work को इस endpoint से बाहर रखें.

Claim boundaries

  • यह page E-Invoice Render से ZUGFeRD output cover करता है.
  • यह native XRechnung generation claim नहीं करता.
  • Invoice business data और XML validity आपका system own करता है.

ZUGFeRD e-invoice render path use करता है

ZUGFeRD अलग root endpoint नहीं है. इसे POST /api/v1/e-invoice/render पर settings.e_invoice.standard field से select किया जाता है. वही boundary लागू रहती है: gPdf PDF/A-3b hybrid invoice package करता है; invoice facts और XML validity आपका system own करता है.

FAQ

कौन सा endpoint ZUGFeRD render करता है?
settings.e_invoice.standard को zugferd set करके POST /api/v1/e-invoice/render use करें.
क्या यह page XRechnung cover करता है?
नहीं. यह page public ZUGFeRD contract तक limited है. XRechnung को यहाँ native output claim नहीं किया गया है.
क्या gPdf CII XML create करता है?
आपका system EN 16931 CII XML supply करता है और उसकी correctness own करता है.
क्या result verify कर सकता हूँ?
Validation context के लिए अपना ZUGFeRD validation workflow और gPdf validator pages use करें.