এটি কি আলাদা endpoint?

স্টেটমেন্ট PDF API workflow-কে public gPdf API path-এ map করে. Page বলে কোন path call করতে হবে এবং request কী own করে.

Templates use করা যাবে?

হ্যাঁ. Layout বদলালে JSON Render use করুন; layout approve হলে এবং callers শুধু business data পাঠালে Template Render use করুন.

Production-এর আগে কী validate করবেন?

Real data এবং workflow-এর printer, scanner, validator, accounting system বা marketplace receiver দিয়ে validate করুন.

Invoicing and finance

প্রোডাকশন সিস্টেমের জন্য স্টেটমেন্ট PDF API

statement PDF structured backend data থেকে browser ছাড়া render করুন. gPdf PDF output সামলায় এবং business rules আপনার system-এ থাকে.

PRIMARY API JSON Render

ENDPOINT /api/v1/pdf/render

SYSTEMS operations backend / finance system / compliance workflow / document service

Playground-এ পরীক্ষা করুন → Docs পড়ুন

যে কাজটি করতে হবে

statement PDF structured data থেকে repeatable PDF হিসেবে generate করা. gPdf document render করে; data semantics এবং workflow state থাকে আপনার system-এ.

কখন এই API ব্যবহার করবেন

Backend-এ statement PDF data আগে থেকেই আছে এবং stable PDF response দরকার.
Operational document-এর জন্য Chromium বা HTML-to-PDF avoid করতে চান.
Reprint, audit বা batch-এর জন্য repeatable output দরকার.

এটি কী replace করে না

gPdf postage কেনা, tax filing, external order তৈরি বা fiscal system হিসেবে কাজ করে না.
Data validation, business rules বা marketplace integrations replace করে না.

কোন 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

/api/v1/pdf/render - statement PDF

{
  "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 করে

Structured request থেকে statement PDF PDF rendering.
Request অনুযায়ী text, tables, lines, barcodes, pages, metadata এবং output options.
Retry, reprint এবং audit-এর জন্য deterministic output.

আপনার system কী own করে

statement PDF-এর সঠিক data, business rules এবং operation state.
Authentication, storage, external workflows এবং receiver validation.

Production checklist

Real data এবং PDF consume করা systems দিয়ে test করুন.
Support, audit এবং reprint-এর জন্য request IDs এবং validation evidence রাখুন.
Approved layout একাধিক system reuse করলে template করুন.

Claim boundaries

gPdf request থেকে PDF render করে; product workflow, database বা business validation replace করে না.
Data semantics, retries, storage এবং final acceptance আপনার system-এ থাকে.

API shape

স্টেটমেন্ট PDF API public gPdf APIs-এর ওপর তৈরি production workflow. Request data, layout, settings এবং render হওয়া PDF parts স্পষ্ট করে. gPdf PDF বানায়; business event-এর meaning আপনার system রাখে.

Endpoint choice

এই workflow-এর default endpoint /api/v1/pdf/render. Layout approve হয়ে systems-এ reuse হলে Template Render ব্যবহার করুন. EN 16931 CII XML embedded Factur-X / ZUGFeRD PDF/A-3b packaging দরকার হলেই E-Invoice Render ব্যবহার করুন.

Production-এর আগে validation

statement PDF real data এবং downstream systems দিয়ে validate করুন. Support, audit এবং reprint-এর জন্য request IDs, rendered output এবং validation evidence রাখুন.

FAQ

এটি কি আলাদা endpoint?: স্টেটমেন্ট PDF API workflow-কে public gPdf API path-এ map করে. Page বলে কোন path call করতে হবে এবং request কী own করে.
Templates use করা যাবে?: হ্যাঁ. Layout বদলালে JSON Render use করুন; layout approve হলে এবং callers শুধু business data পাঠালে Template Render use করুন.
Production-এর আগে কী validate করবেন?: Real data এবং workflow-এর printer, scanner, validator, accounting system বা marketplace receiver দিয়ে validate করুন.