প্রোডাকশন সিস্টেমের জন্য ই-ইনভয়েস রেন্ডারিং API
e-invoice rendering structured backend data থেকে browser ছাড়া render করুন. gPdf PDF output সামলায় এবং business rules আপনার system-এ থাকে.
/api/v1/e-invoice/render e-invoice rendering structured data থেকে repeatable PDF হিসেবে generate করা. gPdf document render করে; data semantics এবং workflow state থাকে আপনার system-এ.
কখন এই API ব্যবহার করবেন
- Backend-এ e-invoice rendering 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/e-invoice/render
E-Invoice Render এই workflow-এর default path.
/api/v1/e-invoice/capabilities
Workflow-তে related API path, template contract অথবা capabilities lookup দরকার হলে ব্যবহার করুন.
Minimal request
/api/v1/e-invoice/render - e-invoice rendering
{
"settings": {
"profile": "pdfa-3b",
"e_invoice": {
"standard": "factur_x",
"profile": "en16931",
"document_type": "invoice",
"xml": {
"format": "cii",
"encoding": "utf8",
"content": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><rsm:CrossIndustryInvoice>...</rsm:CrossIndustryInvoice>"
}
}
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Invoice INV-1007",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf কী handle করে
- Structured request থেকে e-invoice rendering PDF rendering.
- Request অনুযায়ী text, tables, lines, barcodes, pages, metadata এবং output options.
- Retry, reprint এবং audit-এর জন্য deterministic output.
আপনার system কী own করে
- e-invoice rendering-এর সঠিক 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 Factur-X / ZUGFeRD PDF/A-3b-এর জন্য public e-invoice endpoint use করে.
- Tax portals, PDP, SDI, KSeF, ZATCA, IRP, Peppol এবং legal obligations scope-এর বাইরে.
- Buyer data, tax logic, routing এবং local legal interpretation আপনার system-এ থাকে.
API shape
ই-ইনভয়েস রেন্ডারিং 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/e-invoice/render. Layout approve হয়ে systems-এ reuse হলে Template Render ব্যবহার করুন. EN 16931 CII XML embedded Factur-X / ZUGFeRD PDF/A-3b packaging দরকার হলেই E-Invoice Render ব্যবহার করুন.
Production-এর আগে validation
e-invoice rendering real data এবং downstream systems দিয়ে validate করুন. Support, audit এবং reprint-এর জন্য request IDs, rendered output এবং validation evidence রাখুন.
FAQ
- এটি কি আলাদা endpoint?
- ই-ইনভয়েস রেন্ডারিং API Factur-X / ZUGFeRD PDF/A-3b-এর জন্য public e-invoice endpoint use করে. এটি আলাদা product surface নয়.
- এটি কি local clearance networks cover করে?
- না. gPdf PDF/e-invoice file render এবং package করে; tax portals এবং legal routing আপনার system-এ থাকে.
- JSON Render continue করা যাবে?
- Ordinary PDFs-এর জন্য হ্যাঁ. Structured e-invoice package দরকার হলে E-Invoice Render use করুন.