Archival PDF generation-এর জন্য PDF/A API
PDF/A profile ও e-invoice packaging-এর boundary পরিষ্কার রেখে archival workflow-এর জন্য JSON Render request থেকে PDF/A output তৈরি করুন।
/api/v1/pdf/render Business workflow archival-friendly PDF চাইলে structured document request থেকে PDF/A-profile output তৈরি করুন; embedded XML invoice packaging দরকার হলেই শুধু E-Invoice Render বেছে নিন।
কখন এই API ব্যবহার করবেন
- আপনার workflow render setting-এ selected PDF/A profile চায়।
- Archival invoice, statement, report বা document output দরকার।
- PDF/A-3b e-invoice packaging-এর চেয়ে broad general PDF/A page চান।
- Produced file আপনার নিজের archival acceptance workflow দিয়ে validate করতে পারেন।
এটি কী replace করে না
- Embedded EN 16931 CII XML-সহ Factur-X বা ZUGFeRD দরকার। E-Invoice Render ব্যবহার করুন।
- Validator-only workflow দরকার। Validation context-এর জন্য validator page ব্যবহার করুন।
- একই request-এ encrypted output এবং PDF/A দরকার। Public Render API security setting ও PDF/A profile setting-কে mutually exclusive হিসেবে treat করে।
কোন 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 - সাধারণ PDF/A output setting।
{
"settings": {
"profile": "pdfa-2b"
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Archive-ready document",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf কী করে
- JSON Render request-এ PDF/A profile setting।
- Text, table, image, barcode, metadata এবং profile output-সহ document rendering।
- শুধু E-Invoice Render path দিয়ে PDF/A-3b e-invoice packaging।
- Shared error behavior-সহ binary PDF response।
আপনার system-এর দায়িত্ব
- Archival policy, profile selection, validation workflow, retention এবং legal acceptance।
- Document semantics, business data এবং required external evidence।
- Storage, access control এবং future migration policy।
Production checklist
- আপনার archive বা customer যে PDF/A profile চায়, সেটি select করুন।
- আপনার validator এবং retention acceptance workflow দিয়ে output চালান।
- Public docs compatible contract যোগ না করা পর্যন্ত PDF/A ও security setting আলাদা render flow-তে রাখুন।
- Embedded CII XML দরকার হলে E-Invoice Render ব্যবহার করুন।
- Retention policy অনুযায়ী source data বা returned PDF store করুন।
দাবির সীমা
- PDF/A output legal e-invoice packaging-এর মতো নয়।
- gPdf আপনার archival acceptance বা validator workflow replace করে না।
- Retention এবং compliance interpretation আপনার system own করে।
PDF/A একটি profile choice
সাধারণ archival document-এর জন্য PDF/A render setting দিয়ে select করা হয়। এতে workflow JSON Render-এর কাছাকাছি থাকে: আপনার system document বর্ণনা করে এবং যে profile দরকার তা set করে।
E-invoice packaging আলাদা। Document-এ embedded CII XML-সহ Factur-X বা ZUGFeRD দরকার হলে E-Invoice Render endpoint ব্যবহার করুন।
FAQ
- General PDF/A output-এর জন্য কোন endpoint ব্যবহার করব?
- সাধারণ PDF/A output-এর জন্য উপযুক্ত settings.profile value-সহ POST /api/v1/pdf/render ব্যবহার করুন।
- কখন E-Invoice Render দরকার?
- Document-কে embedded CII XML-সহ Factur-X বা ZUGFeRD PDF/A-3b package হতে হলে E-Invoice Render ব্যবহার করুন।
- gPdf কি archival acceptance validate করে?
- না। gPdf PDF/A output render করে। আপনার system archive বা customer acceptance policy-এর against output validate করবে।
- PDF/A কি security setting-এর সঙ্গে combine করা যায়?
- Current public Render API-তে নয়। settings.profile এবং settings.security mutually exclusive; invalid combination validation fail করে।