Invoicing और finance

Account और billing exports के लिए Statement PDF API

Account, billing और activity statement PDFs generate करें, multi-page rows, totals, metadata और optional PDF/A archival settings के साथ.

PRIMARY API JSON Render
ENDPOINT /api/v1/pdf/render
SYSTEMS billing backend / account system / ERP export service / SaaS reporting service
काम जो पूरा करना है

Period data, opening balances, line items, adjustments और totals से customer, account या billing statement PDFs render करें, ताकि users review या retention के लिए consistent record download कर सकें.

यह API कब इस्तेमाल करें

  • आपका system balances, statement periods, transaction rows और totals पहले से own करता है.
  • Account history, billing summaries या finance workflows के लिए PDF export चाहिए.
  • Headers, footers और summary sections के साथ repeatable multi-page output चाहिए.
  • Archival workflows के लिए PDF/A output चाहिए हो सकता है.

यह क्या replace नहीं करता

  • आपको bank connectivity, ledger reconciliation या financial advice चाहिए.
  • आपको same render request में encrypted statements और PDF/A चाहिए. Public Render API security settings और PDF/A profile settings को mutually exclusive मानती है.
  • आपको e-invoice XML packaging चाहिए. उसके लिए E-Invoice Render endpoint use करें.

कौन सा endpoint call करें

PRIMARY

/api/v1/pdf/render

JSON Render इस workflow का default path है।

SECONDARY 1

/api/v1/template-render

जब workflow को related API path, template contract या capabilities lookup चाहिए, तब इसका उपयोग करें।

Minimal request

POST /api/v1/pdf/render - period totals वाला 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 क्या handle करता है

  • Statement pages के लिए DocumentRequest rendering.
  • Text blocks, tables, totals sections, page numbering, metadata और PDF/A profile settings.
  • Stable statement layout और field contract के लिए Template Render.
  • Download या आपके system storage के लिए suitable binary PDF output.

आपका system क्या संभालता है

  • Statement period logic, account balances, transaction data, currency rules और customer identity.
  • Archival policy, access control, file naming और secure delivery.
  • Reconciliation, audit approval या regulated financial representation.

Production checklist

  1. Long transaction descriptions, high row counts, empty periods और negative balances test करें.
  2. हर statement render के लिए request ID generate करें.
  3. तय करें कि statements on demand render होंगे या period close के बाद store होंगे.
  4. PDF/A तभी use करें जब statement की archival policy उसे require करे.
  5. Access control और customer authentication render API से बाहर रखें.

Claim boundaries

  • gPdf account balances compute नहीं करता और ledgers reconcile नहीं करता.
  • API statement PDFs render करती है; financial correctness आपका system own करता है.
  • PDF/A output render setting है, retention policy का substitute नहीं.

Statements period documents हैं

Statement page को closed set of business facts से शुरू करना चाहिए: account, period, opening balance, activity rows, adjustments और closing balance. gPdf इन facts को decide नहीं करता. यह उन्हें PDF layout में render करता है, जिसे आपके users download कर सकते हैं या आपका system store कर सकता है.

Large row sets handle करना

High row counts के लिए statement को repeatable layout की तरह design करें, जिसमें table regions, summary sections और page numbers हों. Layout tune करते समय JSON Render use करें. Field contract stable हो जाने पर Template Render पर move करें.

FAQ

क्या gPdf statement balances calculate कर सकता है?
नहीं. आपका system period, balances, rows और totals भेजता है. gPdf PDF render करता है.
क्या statement PDFs PDF/A use कर सकते हैं?
हाँ, JSON Render PDF/A profile settings support करता है. PDF/A required है या नहीं, यह आपकी archival policy decide करती है.
क्या statements को Template Render use करना चाहिए?
Layout stable होने के बाद आम तौर पर हाँ. Template Render callers को page coordinates repeat किए बिना period data भेजने देता है.
क्या gPdf statements store करता है?
नहीं. Standard render requests PDF response लौटाते हैं. Storage और access control आपका system own करता है.