PDF/A-3b API untuk workflow arsip dan e-invoice
Generate output PDF/A-3b dengan gPdf dan pahami kapan PDF/A-3b hanya profile arsip versus wrapper e-invoice.
/api/v1/pdf/render Generate dokumen PDF/A-3b untuk workflow arsip dan pilih endpoint e-invoice ketika PDF/A-3b harus membawa XML EN 16931 Factur-X atau ZUGFeRD yang tertanam.
Kapan memakai API ini
- Anda membutuhkan profile arsip PDF/A-3b untuk dokumen yang dirender.
- Anda perlu menjelaskan batas antara PDF/A biasa dan packaging e-invoice.
- Workflow kepatuhan Anda memvalidasi PDF yang digenerate dengan veraPDF atau reference engine lain.
- Anda membutuhkan halaman publik untuk mengarahkan intent pencarian PDF/A-3b ke endpoint yang benar.
Apa yang tidak digantikan
- Anda membutuhkan workflow attachment file arbitrer yang tidak terdokumentasi di API publik.
- Anda membutuhkan e-invoice Factur-X atau ZUGFeRD melalui JSON Render. Gunakan E-Invoice Render.
- Anda membutuhkan validator API. Permukaan validator publik saat ini adalah halaman /validator/.
Endpoint yang dipanggil
/api/v1/pdf/render
JSON Render adalah jalur default untuk workflow ini.
/api/v1/e-invoice/render
Gunakan saat workflow butuh jalur API terkait, kontrak template, atau capability lookup.
Request minimal
POST /api/v1/pdf/render - minta output PDF/A-3b untuk dokumen yang dirender.
{
"settings": {
"profile": "pdfa-3b"
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Archive copy",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Yang ditangani gPdf
- Pemilihan profile PDF/A melalui pengaturan JSON Render.
- Packaging e-invoice PDF/A-3b ketika memakai POST /api/v1/e-invoice/render.
- Output PDF yang dapat dirender dan cocok untuk validasi reference-engine eksternal.
- Pemisahan jelas antara profile arsip dan workflow e-invoice legal.
Yang dikelola sistem Anda
- Kebijakan retensi dan alasan PDF/A-3b diperlukan.
- Data bisnis, semantik XML, dan kriteria acceptance compliance eksternal.
- Bukti validasi, record audit, dan storage jangka panjang setelah render.
Checklist produksi
- Pilih JSON Render untuk output PDF/A-3b biasa.
- Pilih E-Invoice Render ketika XML EN 16931 tertanam diperlukan.
- Validasi output PDF/A dengan /validator/ atau workflow veraPDF Anda sendiri.
- Catat profile yang diminta dan request ID bersama dokumen yang disimpan.
- Hindari klaim dukungan attachment arbitrer kecuali docs publik mencantumkannya.
Batas klaim
- PDF/A-3b adalah profile arsip; packaging e-invoice adalah workflow yang lebih sempit di atasnya.
- Jangan menyiratkan semua workflow embedded-file arbitrer didukung.
- Route e-invoice diperlukan untuk paket PDF/A-3b Factur-X dan ZUGFeRD.
PDF/A-3b adalah wrapper, bukan seluruh workflow
PDF/A-3b adalah profile arsip PDF. Profile ini penting karena dapat menjadi wrapper untuk e-invoice hybrid, tetapi profile saja tidak membuat dokumen menjadi e-invoice legal. Dokumen arsip biasa dapat memakai PDF/A-3b tanpa XML invoice tertanam.
Untuk Factur-X dan ZUGFeRD, gunakan POST /api/v1/e-invoice/render. Endpoint itu bertanggung jawab atas metadata spesifik e-invoice dan wiring associated-file.
Pilih endpoint berdasarkan intent
Gunakan JSON Render ketika tujuan Anda adalah “render dokumen ini sebagai PDF/A-3b”. Gunakan E-Invoice Render ketika tujuan Anda adalah “paketkan invoice ini sebagai Factur-X atau ZUGFeRD dengan EN 16931 CII XML”. Perbedaan ini menjaga kode tetap jelas dan mencegah job arsip biasa membawa asumsi e-invoice secara tidak sengaja.
Validasi secara eksternal
PDF/A sebaiknya diverifikasi dengan reference engine, bukan klaim marketing. Gunakan validator publik atau pipeline validasi Anda sendiri dan simpan laporannya bersama bukti audit.
FAQ
- Apakah PDF/A-3b selalu e-invoice?
- Tidak. PDF/A-3b adalah profile PDF arsip. E-invoice Factur-X dan ZUGFeRD memakai PDF/A-3b sebagai wrapper untuk XML EN 16931 tertanam.
- Endpoint mana yang membuat PDF/A-3b?
- Gunakan POST /api/v1/pdf/render dengan settings.profile untuk PDF/A-3b biasa. Gunakan POST /api/v1/e-invoice/render ketika output harus berupa e-invoice Factur-X atau ZUGFeRD.
- Bisakah saya melampirkan file arbitrer melalui halaman ini?
- Jangan mengasumsikan dukungan attachment arbitrer kecuali docs API publik mencantumkan workflow tersebut. Halaman ini fokus pada PDF/A-3b dan e-invoice yang terdokumentasi.
- Bagaimana memverifikasi output PDF/A?
- Gunakan /validator/ atau pipeline reference-engine Anda sendiri. Untuk e-invoice, validasi lapisan PDF/A dan lapisan XML tertanam.