Compliance ও archival
Hybrid PDF/A-3b e-invoice-এর জন্য Factur-X API
Public E-Invoice Render endpoint দিয়ে embedded EN 16931 CII XML-সহ Factur-X PDF/A-3b invoice তৈরি করুন।
প্রাথমিক API E-Invoice Render
Endpoint
/api/v1/e-invoice/render System ERP / billing backend / compliance workflow / finance automation service
যে কাজটি করতে হবে
ERP বা billing system সঠিক structured invoice data তৈরি করার পরে rendered invoice PDF-কে embedded EN 16931 CII XML-সহ Factur-X PDF/A-3b হিসেবে package করুন।
কখন এই API ব্যবহার করবেন
- Public E-Invoice Render endpoint থেকে native Factur-X output দরকার।
- আপনার system-এ invoice-এর valid EN 16931 CII XML আগে থেকেই আছে।
- Factur-X metadata ও associated-file wiring-সহ PDF/A-3b packaging দরকার।
- Currently published e-invoice contract confirm করতে capabilities endpoint ব্যবহার করতে চান।
এটি কী replace করে না
- gPdf আপনার জন্য invoice business semantics বা tax decision তৈরি করবে চান।
- OpenAPI-তে list নয় এমন native XRechnung, FatturaPA, KSeF, Peppol, ZATCA, NF-e বা অন্য standard দরকার।
- Chorus Pro বা অন্য government portal-এ সরাসরি submission দরকার।
কোন 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 দরকার হলে ব্যবহার করুন।
নূন্যতম request
POST /api/v1/e-invoice/render - minimal Factur-X package shape।
{
"settings": {
"profile": "pdfa-3b",
"e_invoice": {
"standard": "factur_x",
"profile": "en16931",
"document_type": "invoice",
"xml": {
"format": "cii",
"encoding": "utf8",
"content": "<rsm:CrossIndustryInvoice>...</rsm:CrossIndustryInvoice>"
}
}
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Factur-X invoice",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf কী করে
- E-Invoice Render দিয়ে Factur-X packaging।
- Hybrid invoice PDF-এর জন্য PDF/A-3b profile handling।
- Standard metadata-সহ CII XML associated file হিসেবে embed করা।
- Documented inline PDF delivery বা object-delivery job behavior।
আপনার system-এর দায়িত্ব
- সঠিক EN 16931 CII XML, invoice number, tax logic, buyer ও seller data এবং eligibility।
- External validation, recipient rule, portal submission এবং legal interpretation।
- Storage, audit trail, retry logic এবং customer বা portal-এ delivery।
Production checklist
- CII XML gPdf-এ পাঠানোর আগে validate করুন।
- settings.profile pdfa-3b করুন, বা e-invoice default apply করতে omit করুন।
- settings.e_invoice.standard = factur_x এবং settings.e_invoice.profile = en16931 ব্যবহার করুন।
- Returned PDF আপনার Factur-X validator workflow দিয়ে চালান।
- Submission এবং recipient routing render API-এর বাইরে রাখুন।
দাবির সীমা
- Native public e-invoice output হলো EN 16931 CII XML-সহ Factur-X বা ZUGFeRD।
- gPdf government বা buyer portal-এ invoice submit করে না।
- Business, tax এবং XML correctness আপনার system own করে।
Factur-X একটি e-invoice packaging workflow
Factur-X human-readable PDF-এর সাথে machine-readable EN 16931 CII XML combine করে। Public gPdf endpoint সেই combination-কে PDF/A-3b output-এ package করে। এটি invoice semantics decide করে না বা file portal-এ submit করে না।
FAQ
- কোন endpoint Factur-X render করে?
- settings.e_invoice.standard factur_x করে POST /api/v1/e-invoice/render ব্যবহার করুন।
- gPdf কি EN 16931 XML generate করে?
- আপনার system CII XML দেয় এবং তার business correctness own করে। gPdf সেটিকে hybrid PDF-এ package করে।
- এই page-এ কি gPdf XRechnung support করে?
- না। এই page OpenAPI-তে listed public Factur-X contract-এ সীমিত।
- gPdf কি Factur-X invoice portal-এ submit করে?
- না। Submission এবং recipient routing render API-এর বাইরে থাকে।