প্রোডাকশন সিস্টেমের জন্য রসিদ PDF API
receipt PDF structured backend data থেকে browser ছাড়া render করুন. gPdf PDF output সামলায় এবং business rules আপনার system-এ থাকে.
/api/v1/pdf/render receipt PDF structured data থেকে repeatable PDF হিসেবে generate করা. gPdf document render করে; data semantics এবং workflow state থাকে আপনার system-এ.
কখন এই API ব্যবহার করবেন
- Backend-এ receipt 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 করবেন
/api/v1/pdf/render
JSON Render এই workflow-এর default path.
/api/v1/template-render
Workflow-তে related API path, template contract অথবা capabilities lookup দরকার হলে ব্যবহার করুন.
Minimal request
/api/v1/pdf/render - receipt PDF
{
"pages": [
{
"size": "a6",
"elements": [
{
"type": "text",
"x": 10,
"y": 12,
"content": "Receipt R-2026-1001",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
},
{
"type": "text",
"x": 10,
"y": 28,
"content": "Order total: $82.40\nPaid by card ending 4242\nTax: $6.10",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "qrcode",
"content": "https://example.com/receipts/R-2026-1001",
"x": 10,
"y": 58,
"width": 28,
"height": 28
}
]
}
]
}
gPdf কী handle করে
- Structured request থেকে receipt PDF PDF rendering.
- Request অনুযায়ী text, tables, lines, barcodes, pages, metadata এবং output options.
- Retry, reprint এবং audit-এর জন্য deterministic output.
আপনার system কী own করে
- receipt 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
receipt 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 করুন.