Statement PDF API untuk export akun dan billing
Buat PDF account, billing, dan activity statement dengan baris multi-halaman, total, metadata, dan pengaturan arsip PDF/A opsional.
/api/v1/pdf/render Merender PDF statement pelanggan, akun, atau billing dari data periode, saldo awal, line item, adjustment, dan total agar pengguna dapat mengunduh record yang konsisten untuk review atau retensi.
Kapan memakai API ini
- Sistem Anda sudah memiliki saldo, periode statement, baris transaksi, dan total.
- Anda membutuhkan export PDF untuk riwayat akun, ringkasan billing, atau workflow finance.
- Anda membutuhkan output multi-halaman yang berulang dengan header, footer, dan bagian ringkasan.
- Anda mungkin membutuhkan output PDF/A untuk workflow arsip.
Apa yang tidak digantikan
- Anda membutuhkan konektivitas bank, rekonsiliasi ledger, atau nasihat finansial.
- Anda membutuhkan statement terenkripsi dan PDF/A dalam request render yang sama. Render API publik memperlakukan pengaturan security dan pengaturan profil PDF/A sebagai mutually exclusive.
- Anda membutuhkan packaging XML e-invoice. Gunakan endpoint E-Invoice Render untuk itu.
Endpoint yang dipanggil
/api/v1/pdf/render
JSON Render adalah jalur default untuk workflow ini.
/api/v1/template-render
Gunakan saat workflow butuh jalur API terkait, kontrak template, atau capability lookup.
Request minimal
POST /api/v1/pdf/render - halaman pembuka statement dengan total periode.
{
"settings": {
"profile": "pdfa-2b"
},
"pages": [
{
"size": "letter",
"elements": [
{
"type": "text",
"x": 18,
"y": 20,
"content": "Account Statement",
"style": { "font_size": 18, "font_family": "NotoSans-Regular" }
},
{
"type": "text",
"x": 18,
"y": 38,
"content": "Period: 2026-05-01 to 2026-05-31\nOpening balance: $1,240.00\nClosing balance: $1,890.25",
"style": { "font_size": 11, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Yang ditangani gPdf
- Render DocumentRequest untuk halaman statement.
- Blok teks, tabel, bagian total, penomoran halaman, metadata, dan pengaturan profil PDF/A.
- Template Render untuk layout statement dan kontrak field yang stabil.
- Output PDF biner yang cocok untuk diunduh atau disimpan oleh sistem Anda.
Yang dikelola sistem Anda
- Logika periode statement, saldo akun, data transaksi, aturan mata uang, dan identitas pelanggan.
- Kebijakan arsip, access control, penamaan file, dan delivery yang aman.
- Rekonsiliasi, approval audit, atau representasi finansial yang diatur.
Checklist produksi
- Uji deskripsi transaksi panjang, jumlah baris tinggi, periode kosong, dan saldo negatif.
- Generate request ID untuk setiap render statement.
- Tentukan apakah statement dirender on demand atau disimpan setelah periode ditutup.
- Gunakan PDF/A hanya ketika kebijakan arsip statement memerlukannya.
- Jaga access control dan autentikasi pelanggan tetap di luar render API.
Batas klaim
- gPdf tidak menghitung saldo akun atau merekonsiliasi ledger.
- API merender PDF statement; sistem Anda memiliki kebenaran finansial.
- Output PDF/A adalah pengaturan render, bukan pengganti kebijakan retensi.
Statement adalah dokumen periode
Halaman statement harus dimulai dari sekumpulan fakta bisnis yang sudah tertutup: akun, periode, saldo awal, baris aktivitas, adjustment, dan saldo akhir. gPdf tidak memutuskan fakta tersebut. gPdf merendernya ke layout PDF yang dapat diunduh pengguna atau disimpan sistem Anda.
Menangani jumlah baris besar
Untuk jumlah baris tinggi, desain statement sebagai layout berulang dengan region tabel, bagian ringkasan, dan nomor halaman. Gunakan JSON Render saat menyetel layout. Pindah ke Template Render saat kontrak field sudah stabil.
FAQ
- Bisakah gPdf menghitung saldo statement?
- Tidak. Sistem Anda mengirim periode, saldo, baris, dan total. gPdf merender PDF.
- Bisakah PDF statement memakai PDF/A?
- Ya, JSON Render mendukung pengaturan profil PDF/A. Kebijakan arsip Anda menentukan apakah PDF/A diperlukan.
- Sebaiknya statement memakai Template Render?
- Biasanya ya setelah layout stabil. Template Render memungkinkan caller mengirim data periode tanpa mengulang koordinat halaman.
- Apakah gPdf menyimpan statement?
- Tidak. Request render standar mengembalikan respons PDF. Sistem Anda memiliki storage dan access control.