Kepatuhan dan arsip
Factur-X API untuk e-invoice hybrid PDF/A-3b
Generate invoice PDF/A-3b Factur-X dengan EN 16931 CII XML tertanam melalui endpoint publik E-Invoice Render.
API UTAMA E-Invoice Render
ENDPOINT
/api/v1/e-invoice/render SISTEM ERP / backend billing / workflow kepatuhan / layanan finance automation
Pekerjaan yang diselesaikan
Memaketkan PDF invoice yang sudah dirender sebagai PDF/A-3b Factur-X dengan EN 16931 CII XML tertanam setelah ERP atau sistem billing Anda menghasilkan data invoice terstruktur yang benar.
Kapan memakai API ini
- Anda membutuhkan output Factur-X 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 Factur-X dan wiring associated-file.
- Anda ingin endpoint capabilities mengonfirmasi kontrak e-invoice yang saat ini dipublikasikan.
Apa yang tidak digantikan
- Anda membutuhkan gPdf membuat semantik bisnis invoice atau keputusan pajak untuk Anda.
- Anda membutuhkan native XRechnung, FatturaPA, KSeF, Peppol, ZATCA, NF-e, atau standar lain yang tidak tercantum di OpenAPI.
- Anda membutuhkan submission langsung ke Chorus Pro atau portal pemerintah lain.
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 Factur-X minimal.
{
"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" }
}
]
}
]
}
Yang ditangani gPdf
- Packaging Factur-X melalui E-Invoice Render.
- Penanganan profil PDF/A-3b untuk PDF invoice hybrid.
- Embedding CII XML sebagai associated file dengan metadata standar.
- Delivery PDF inline atau perilaku object-delivery job sesuai dokumentasi.
Yang dikelola sistem Anda
- EN 16931 CII XML yang benar, nomor invoice, logika pajak, data buyer dan seller, serta eligibility.
- Validasi eksternal, aturan penerima, submission portal, dan interpretasi hukum.
- Storage, audit trail, logika retry, dan delivery ke pelanggan atau portal.
Checklist produksi
- Validasi CII XML sebelum mengirimnya ke gPdf.
- Set settings.profile ke pdfa-3b atau kosongkan agar default e-invoice berlaku.
- Gunakan settings.e_invoice.standard = factur_x dan settings.e_invoice.profile = en16931.
- Jalankan PDF yang dikembalikan melalui workflow validator Factur-X Anda.
- Jaga submission dan routing penerima tetap di luar render API.
Batas klaim
- Output e-invoice native publik adalah Factur-X atau ZUGFeRD dengan EN 16931 CII XML.
- gPdf tidak mengirim invoice ke portal pemerintah atau buyer.
- Sistem Anda memiliki kebenaran bisnis, pajak, dan XML.
Factur-X adalah workflow packaging e-invoice
Factur-X menggabungkan PDF yang dapat dibaca manusia dengan EN 16931 CII XML yang dapat dibaca mesin. Endpoint publik gPdf memaketkan kombinasi tersebut menjadi output PDF/A-3b. Endpoint ini tidak memutuskan semantik invoice atau mengirim file ke portal.
FAQ
- Endpoint mana yang merender Factur-X?
- Gunakan POST /api/v1/e-invoice/render dengan settings.e_invoice.standard diset ke factur_x.
- Apakah gPdf membuat EN 16931 XML?
- Sistem Anda menyediakan CII XML dan memiliki kebenaran bisnisnya. gPdf memaketkannya ke PDF hybrid.
- Apakah gPdf mendukung XRechnung di halaman ini?
- Tidak. Halaman ini terbatas pada kontrak Factur-X publik yang tercantum di OpenAPI.
- Apakah gPdf mengirim invoice Factur-X ke portal?
- Tidak. Submission dan routing penerima tetap di luar render API.