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
/api/v1/e-invoice/render
E-Invoice Render adalah jalur default untuk workflow ini.
/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
- Set settings.e_invoice.standard = zugferd dan settings.e_invoice.profile = en16931.
- Gunakan CII XML dengan format = cii dan encoding = utf8.
- Set settings.profile ke pdfa-3b atau kosongkan agar default e-invoice berlaku.
- Validasi PDF yang dikembalikan dengan workflow validasi ZUGFeRD Anda.
- 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.