Invoicing ও finance

Account ও billing export-এর জন্য Statement PDF API

Multi-page row, total, metadata এবং optional PDF/A archival setting-সহ account, billing ও activity statement PDF তৈরি করুন।

প্রাথমিক API JSON Render
Endpoint /api/v1/pdf/render
System billing backend / account system / ERP export service / SaaS reporting service
যে কাজটি করতে হবে

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।

সহায়ক 1

/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

  1. Long transaction description, high row count, empty period এবং negative balance test করুন।
  2. প্রতিটি statement render-এর জন্য request ID generate করুন।
  3. On demand render করবেন নাকি period close-এর পরে প্রতিটি statement store করবেন তা ঠিক করুন।
  4. Statement archival policy চাইলে তবেই PDF/A ব্যবহার করুন।
  5. 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 করে।