API invoice Factur-X untuk sistem produksi
Buat invoice Factur-X dari data backend terstruktur tanpa browser. gPdf menangani PDF rendering; aturan bisnis tetap berada di sistem Anda.
/api/v1/e-invoice/render Membuat invoice Factur-X sebagai PDF yang dapat direproduksi dari data terstruktur. gPdf merender dokumen; sistem Anda tetap memegang makna data dan status proses.
Kapan memakai API ini
- Backend sudah memiliki data invoice Factur-X dan membutuhkan respons PDF yang stabil.
- Anda ingin menghindari Chromium atau HTML-to-PDF untuk dokumen operasional.
- Anda membutuhkan output berulang untuk reprint, audit, atau batch.
Apa yang tidak digantikan
- gPdf tidak membeli ongkir, melaporkan pajak, membuat pesanan eksternal, atau menjadi sistem fiskal.
- Tidak menggantikan validasi data, aturan bisnis, atau integrasi marketplace.
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
/api/v1/e-invoice/render - invoice Factur-X
{
"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
- Rendering PDF invoice Factur-X dari request terstruktur.
- Teks, tabel, garis, barcode, halaman, metadata, dan opsi output sesuai request.
- Output deterministik untuk retry, reprint, dan audit.
Yang dikelola sistem Anda
- Data invoice Factur-X yang benar, aturan bisnis, dan status operasional.
- Autentikasi, penyimpanan, workflow eksternal, dan validasi dengan sistem penerima.
Checklist produksi
- Uji dengan data nyata dan sistem yang akan menerima PDF.
- Simpan request ID dan bukti validasi untuk support, audit, dan reprint.
- Jadikan layout yang disetujui sebagai template ketika dipakai banyak sistem.
Batas klaim
- gPdf memakai public e-invoice endpoint untuk Factur-X / ZUGFeRD PDF/A-3b.
- Portal pajak, PDP, SDI, KSeF, ZATCA, IRP, Peppol, dan kewajiban hukum di luar scope.
- Buyer data, logika pajak, routing, dan interpretasi hukum lokal tetap milik sistem Anda.
Bentuk API
API invoice Factur-X adalah workflow produksi di atas public APIs gPdf. Request menjelaskan data, layout, settings, dan bagian PDF yang perlu dirender. gPdf membuat PDF; sistem Anda menjaga semantik event bisnis.
Pilihan endpoint
Endpoint default untuk workflow ini adalah /api/v1/e-invoice/render. Gunakan Template Render setelah layout disetujui dan dipakai ulang. Gunakan E-Invoice Render hanya untuk paket Factur-X / ZUGFeRD PDF/A-3b dengan EN 16931 CII XML tertanam.
Validasi sebelum produksi
Validasi invoice Factur-X dengan data nyata dan downstream systems. Simpan request ID, output, dan bukti validasi untuk support, audit, dan reprint.
FAQ
- Apakah ini endpoint terpisah?
- API invoice Factur-X memakai public e-invoice endpoint saat membutuhkan Factur-X / ZUGFeRD PDF/A-3b. Ini bukan surface produk terpisah.
- Apakah mencakup jaringan clearance lokal?
- Tidak. gPdf merender dan mengemas PDF/e-invoice; portal pajak dan routing hukum berada di sistem Anda.
- Bisa tetap memakai JSON Render?
- Bisa untuk PDF biasa. Gunakan E-Invoice Render saat output harus memuat paket e-invoice terstruktur.