Compliance ও archival
PDF/A-3b hybrid invoice-এর জন্য ZUGFeRD API
Public gPdf E-Invoice Render endpoint দিয়ে embedded EN 16931 CII XML-সহ ZUGFeRD PDF/A-3b invoice তৈরি করুন।
প্রাথমিক API E-Invoice Render
Endpoint
/api/v1/e-invoice/render System ERP / billing backend / German finance workflow / compliance automation service
যে কাজটি করতে হবে
ERP বা billing system সঠিক invoice data প্রস্তুত করার পরে invoice PDF output-কে embedded EN 16931 CII XML-সহ ZUGFeRD PDF/A-3b হিসেবে package করুন।
কখন এই API ব্যবহার করবেন
- Public E-Invoice Render endpoint থেকে native ZUGFeRD output দরকার।
- আপনার system-এ invoice-এর valid EN 16931 CII XML আগে থেকেই আছে।
- ZUGFeRD metadata ও associated-file wiring-সহ PDF/A-3b packaging দরকার।
- Broader e-invoice ও Factur-X page-এর clear sibling page দরকার।
এটি কী replace করে না
- Native XRechnung generation বা portal submission দরকার।
- gPdf tax calculate করবে, invoice semantics infer করবে বা accounting record থেকে XML তৈরি করবে চান।
- Public OpenAPI contract-এ list নয় এমন standard দরকার।
কোন 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 ZUGFeRD package shape।
{
"settings": {
"profile": "pdfa-3b",
"e_invoice": {
"standard": "zugferd",
"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": "ZUGFeRD invoice",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf কী করে
- E-Invoice Render দিয়ে ZUGFeRD packaging।
- Hybrid invoice output-এর জন্য PDF/A-3b profile handling।
- ZUGFeRD metadata-সহ CII XML associated file হিসেবে embed করা।
- Documented inline PDF বা object delivery behavior।
আপনার system-এর দায়িত্ব
- EN 16931 CII XML correctness, invoice data, tax logic, buyer ও seller semantics।
- External validation, recipient requirement, portal submission এবং legal interpretation।
- Retry behavior, storage, audit evidence এবং customer delivery।
Production checklist
- settings.e_invoice.standard = zugferd এবং settings.e_invoice.profile = en16931 সেট করুন।
- format = cii এবং encoding = utf8-সহ CII XML ব্যবহার করুন।
- settings.profile pdfa-3b করুন, বা e-invoice default apply করতে omit করুন।
- Returned PDF আপনার ZUGFeRD validation workflow দিয়ে validate করুন।
- XRechnung বা portal submission work এই endpoint-এর বাইরে রাখুন।
দাবির সীমা
- এই page E-Invoice Render দিয়ে ZUGFeRD output cover করে।
- এটি native XRechnung generation claim করে না।
- Invoice business data এবং XML validity আপনার system own করে।
ZUGFeRD e-invoice render path ব্যবহার করে
ZUGFeRD আলাদা root endpoint নয়। POST /api/v1/e-invoice/render-এর
settings.e_invoice.standard field দিয়ে এটি select করা হয়। একই boundary প্রযোজ্য:
gPdf PDF/A-3b hybrid invoice package করে; invoice facts এবং XML validity আপনার
system own করে।
FAQ
- কোন endpoint ZUGFeRD render করে?
- settings.e_invoice.standard zugferd করে POST /api/v1/e-invoice/render ব্যবহার করুন।
- এই page কি XRechnung cover করে?
- না। এই page public ZUGFeRD contract-এ সীমিত। এখানে XRechnung native output হিসেবে claim করা হয়নি।
- gPdf কি CII XML তৈরি করে?
- আপনার system EN 16931 CII XML দেয় এবং তার correctness own করে।
- Result verify করতে পারি?
- Validation context-এর জন্য আপনার ZUGFeRD validation workflow এবং gPdf validator page ব্যবহার করুন।