Account ও billing export-এর জন্য Statement PDF API
Multi-page row, total, metadata এবং optional PDF/A archival setting-সহ account, billing ও activity statement PDF তৈরি করুন।
/api/v1/pdf/render Period data, opening balance, line item, adjustment এবং total থেকে customer, account বা billing statement PDF render করুন, যাতে user review বা retention-এর জন্য consistent record download করতে পারে।
কখন এই API ব্যবহার করবেন
- আপনার system balance, statement period, transaction row এবং total আগে থেকেই own করে।
- Account history, billing summary বা finance workflow-এর জন্য PDF export দরকার।
- Header, footer এবং summary section-সহ repeatable multi-page output দরকার।
- Archival workflow-এর জন্য PDF/A output দরকার হতে পারে।
এটি কী replace করে না
- Bank connectivity, ledger reconciliation বা financial advice দরকার।
- একই render request-এ encrypted statement এবং PDF/A দরকার। Public Render API security setting ও PDF/A profile setting-কে mutually exclusive হিসেবে treat করে।
- E-invoice XML packaging দরকার। এর জন্য E-Invoice Render endpoint ব্যবহার করুন।
কোন endpoint call করবেন
/api/v1/pdf/render
JSON Render এই workflow-এর default path।
/api/v1/template-render
Workflow-তে related API path, template contract অথবা capabilities lookup দরকার হলে ব্যবহার করুন।
নূন্যতম request
POST /api/v1/pdf/render - period total-সহ statement cover page।
{
"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" }
}
]
}
]
}
gPdf কী করে
- Statement page-এর জন্য DocumentRequest rendering।
- Text block, table, total section, page numbering, metadata এবং PDF/A profile setting।
- Stable statement layout ও field contract-এর জন্য Template Render।
- আপনার system download বা storage করতে পারে এমন binary PDF output।
আপনার system-এর দায়িত্ব
- Statement period logic, account balance, transaction data, currency rule এবং customer identity।
- Archival policy, access control, file naming এবং secure delivery।
- Reconciliation, audit approval বা regulated financial representation।
Production checklist
- Long transaction description, high row count, empty period এবং negative balance test করুন।
- প্রতিটি statement render-এর জন্য request ID generate করুন।
- On demand render করবেন নাকি period close-এর পরে প্রতিটি statement store করবেন তা ঠিক করুন।
- Statement archival policy চাইলে তবেই PDF/A ব্যবহার করুন।
- Access control এবং customer authentication render API-এর বাইরে রাখুন।
দাবির সীমা
- gPdf account balance compute করে না বা ledger reconcile করে না।
- API statement PDF render করে; financial correctness আপনার system own করে।
- PDF/A output একটি render setting, retention policy-এর substitute নয়।
Statement period document
Statement page একটি closed set of business facts থেকে শুরু হওয়া উচিত: account, period, opening balance, activity row, adjustment এবং closing balance। gPdf সেই fact decide করে না। এটি সেগুলোকে PDF layout-এ render করে, যা user download করতে পারে বা আপনার system store করতে পারে।
Large row set handle করা
High row count-এর জন্য statement-কে table region, summary section এবং page number-সহ repeatable layout হিসেবে design করুন। Layout tune করার সময় JSON Render ব্যবহার করুন। Field contract stable হলে Template Render-এ move করুন।
FAQ
- gPdf কি statement balance calculate করতে পারে?
- না। আপনার system period, balance, row এবং total পাঠায়। gPdf PDF render করে।
- Statement PDF কি PDF/A ব্যবহার করতে পারে?
- হ্যাঁ, JSON Render PDF/A profile setting support করে। PDF/A দরকার কি না আপনার archival policy ঠিক করে।
- Statement কি Template Render ব্যবহার করা উচিত?
- Layout stable হলে সাধারণত হ্যাঁ। Template Render caller-দের page coordinate repeat না করে period data পাঠাতে দেয়।
- gPdf কি statement store করে?
- না। Standard render request PDF response return করে। Storage এবং access control আপনার system own করে।