Kepatuhan dan arsip

ZUGFeRD API untuk invoice hybrid PDF/A-3b

Generate invoice PDF/A-3b ZUGFeRD dengan EN 16931 CII XML tertanam memakai endpoint publik gPdf E-Invoice Render.

API UTAMA E-Invoice Render
ENDPOINT /api/v1/e-invoice/render
SISTEM ERP / backend billing / workflow finance Jerman / layanan compliance automation
Pekerjaan yang diselesaikan

Memaketkan output PDF invoice sebagai PDF/A-3b ZUGFeRD dengan EN 16931 CII XML tertanam setelah ERP atau sistem billing Anda menyiapkan data invoice yang benar.

Kapan memakai API ini

  • Anda membutuhkan output ZUGFeRD native dari endpoint publik E-Invoice Render.
  • Sistem Anda sudah memiliki EN 16931 CII XML yang valid untuk invoice.
  • Anda membutuhkan packaging PDF/A-3b dengan metadata ZUGFeRD dan wiring associated-file.
  • Anda membutuhkan halaman sibling yang jelas untuk halaman e-invoice dan Factur-X yang lebih luas.

Apa yang tidak digantikan

  • Anda membutuhkan native XRechnung generation atau portal submission.
  • Anda membutuhkan gPdf menghitung pajak, menyimpulkan semantik invoice, atau membuat XML dari record akuntansi.
  • Anda membutuhkan standard yang tidak tercantum dalam kontrak OpenAPI publik.

Endpoint yang dipanggil

UTAMA

/api/v1/e-invoice/render

E-Invoice Render adalah jalur default untuk workflow ini.

SEKUNDER 1

/api/v1/e-invoice/capabilities

Gunakan saat workflow butuh jalur API terkait, kontrak template, atau capability lookup.

Request minimal

POST /api/v1/e-invoice/render - bentuk paket ZUGFeRD minimal.

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

Yang ditangani gPdf

  • Packaging ZUGFeRD melalui E-Invoice Render.
  • Penanganan profile PDF/A-3b untuk output invoice hybrid.
  • Embedding CII XML sebagai associated file dengan metadata ZUGFeRD.
  • Perilaku PDF inline atau object delivery sesuai dokumentasi.

Yang dikelola sistem Anda

  • Kebenaran EN 16931 CII XML, data invoice, logika pajak, semantik buyer dan seller.
  • Validasi eksternal, kebutuhan penerima, submission portal, dan interpretasi hukum.
  • Perilaku retry, storage, bukti audit, dan delivery pelanggan.

Checklist produksi

  1. Set settings.e_invoice.standard = zugferd dan settings.e_invoice.profile = en16931.
  2. Gunakan CII XML dengan format = cii dan encoding = utf8.
  3. Set settings.profile ke pdfa-3b atau kosongkan agar default e-invoice berlaku.
  4. Validasi PDF yang dikembalikan dengan workflow validasi ZUGFeRD Anda.
  5. Jaga pekerjaan XRechnung atau portal submission tetap di luar endpoint ini.

Batas klaim

  • Halaman ini mencakup output ZUGFeRD melalui E-Invoice Render.
  • Halaman ini tidak mengklaim native XRechnung generation.
  • Sistem Anda memiliki data bisnis invoice dan validitas XML.

ZUGFeRD memakai jalur render e-invoice

ZUGFeRD bukan endpoint root terpisah. ZUGFeRD dipilih melalui field settings.e_invoice.standard pada POST /api/v1/e-invoice/render. Batas yang sama berlaku: gPdf memaketkan invoice hybrid PDF/A-3b; sistem Anda memiliki fakta invoice dan validitas XML.

FAQ

Endpoint mana yang merender ZUGFeRD?
Gunakan POST /api/v1/e-invoice/render dengan settings.e_invoice.standard diset ke zugferd.
Apakah halaman ini mencakup XRechnung?
Tidak. Halaman ini terbatas pada kontrak ZUGFeRD publik. XRechnung tidak diklaim sebagai output native di sini.
Apakah gPdf membuat CII XML?
Sistem Anda menyediakan EN 16931 CII XML dan memiliki kebenarannya.
Bisakah saya memverifikasi hasilnya?
Gunakan workflow validasi ZUGFeRD Anda dan halaman validator gPdf sebagai konteks validasi.