Archival ও e-invoice workflow-এর জন্য PDF/A-3b API
gPdf দিয়ে PDF/A-3b output তৈরি করুন এবং বুঝুন কখন PDF/A-3b শুধু archival profile, আর কখন e-invoice wrapper।
/api/v1/pdf/render Archival workflow-এর জন্য PDF/A-3b document তৈরি করুন এবং PDF/A-3b-কে embedded Factur-X বা ZUGFeRD EN 16931 XML বহন করতে হলে e-invoice endpoint বেছে নিন।
কখন এই API ব্যবহার করবেন
- Rendered document-এর জন্য PDF/A-3b archival profile দরকার।
- সাধারণ PDF/A এবং e-invoice packaging-এর boundary explain করতে হবে।
- আপনার compliance workflow generated PDF veraPDF বা অন্য reference engine দিয়ে validate করে।
- PDF/A-3b search intent-কে correct endpoint-এ route করার public page দরকার।
এটি কী replace করে না
- Public API-তে documented নয় এমন arbitrary file-attachment workflow দরকার।
- JSON Render দিয়ে Factur-X বা ZUGFeRD e-invoice দরকার। E-Invoice Render ব্যবহার করুন।
- Validator API দরকার। Current public validator surface হলো /validator/ page।
কোন endpoint call করবেন
/api/v1/pdf/render
JSON Render এই workflow-এর default path।
/api/v1/e-invoice/render
Workflow-তে related API path, template contract অথবা capabilities lookup দরকার হলে ব্যবহার করুন।
নূন্যতম request
POST /api/v1/pdf/render - rendered document-এর জন্য PDF/A-3b output request।
{
"settings": {
"profile": "pdfa-3b"
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Archive copy",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf কী করে
- JSON Render setting দিয়ে PDF/A profile selection।
- POST /api/v1/e-invoice/render ব্যবহার করলে PDF/A-3b e-invoice packaging।
- External reference-engine validation-এর উপযোগী renderable PDF output।
- Archival profile এবং legal e-invoice workflow-এর পরিষ্কার separation।
আপনার system-এর দায়িত্ব
- Retention policy এবং PDF/A-3b দরকার হওয়ার কারণ।
- Business data, XML semantics এবং external compliance acceptance criteria।
- Rendering-এর পরে validation evidence, audit record এবং long-term storage।
Production checklist
- সাধারণ PDF/A-3b output-এর জন্য JSON Render বেছে নিন।
- Embedded EN 16931 XML দরকার হলে E-Invoice Render বেছে নিন।
- /validator/ বা আপনার নিজের veraPDF workflow দিয়ে PDF/A output validate করুন।
- Stored document-এর সাথে requested profile এবং request ID record করুন।
- Public docs list না করলে arbitrary attachment support claim করা এড়ান।
দাবির সীমা
- PDF/A-3b একটি archival profile; e-invoice packaging তার ওপর narrower workflow।
- প্রতিটি arbitrary embedded-file workflow supported বলে imply করবেন না।
- Factur-X এবং ZUGFeRD PDF/A-3b package-এর জন্য e-invoice route দরকার।
PDF/A-3b wrapper, পুরো workflow নয়
PDF/A-3b একটি PDF archival profile। Hybrid e-invoice-এর wrapper হিসেবে কাজ করতে পারার জন্য এটি গুরুত্বপূর্ণ, কিন্তু profile alone কোনো document-কে legal e-invoice বানায় না। Embedded invoice XML ছাড়াও সাধারণ archived document PDF/A-3b ব্যবহার করতে পারে।
Factur-X এবং ZUGFeRD-এর জন্য POST /api/v1/e-invoice/render ব্যবহার করুন। ওই
endpoint e-invoice-specific metadata এবং associated-file wiring-এর দায়িত্ব নেয়।
Intent অনুযায়ী endpoint বেছে নিন
Goal যদি হয় “এই document PDF/A-3b হিসেবে render করো”, JSON Render ব্যবহার করুন। Goal যদি হয় “এই invoice-কে EN 16931 CII XML-সহ Factur-X বা ZUGFeRD হিসেবে package করো”, E-Invoice Render ব্যবহার করুন। এই distinction code পরিষ্কার রাখে এবং সাধারণ archival job-এ ভুল করে e-invoice assumption ঢোকা ঠেকায়।
External validation করুন
PDF/A marketing claim দিয়ে নয়, reference engine দিয়ে verify করা উচিত। Public validator বা আপনার নিজস্ব validation pipeline ব্যবহার করুন এবং audit evidence-এর সাথে report store করুন।
FAQ
- PDF/A-3b কি সবসময় e-invoice?
- না। PDF/A-3b একটি archival PDF profile। Factur-X এবং ZUGFeRD e-invoice embedded EN 16931 XML-এর wrapper হিসেবে PDF/A-3b ব্যবহার করে।
- কোন endpoint PDF/A-3b তৈরি করে?
- সাধারণ PDF/A-3b-এর জন্য settings.profile সহ POST /api/v1/pdf/render ব্যবহার করুন। Output যদি Factur-X বা ZUGFeRD e-invoice হতে হয়, POST /api/v1/e-invoice/render ব্যবহার করুন।
- এই page দিয়ে কি arbitrary file attach করতে পারি?
- Public API docs workflow list না করলে arbitrary attachment support ধরে নেবেন না। এই page documented PDF/A-3b এবং e-invoice use-এ focus করে।
- PDF/A output কীভাবে verify করব?
- /validator/ বা আপনার নিজের reference-engine pipeline ব্যবহার করুন। E-invoice-এর জন্য PDF/A layer এবং embedded XML layer দুটোই validate করুন।