Ecommerce reverse logistics-এর জন্য Return label API
Ecommerce বা support data থেকে label-sized page, barcode এবং template reprint-সহ return label ও return instruction PDF তৈরি করুন।
/api/v1/pdf/render RMA, customer, item, destination এবং barcode data থেকে return label PDF বা return instruction sheet render করুন, যাতে returns portal customer-কে deterministic document দিতে পারে।
কখন এই API ব্যবহার করবেন
- আপনার system আগে থেকেই RMA এবং return authorization তৈরি করেছে।
- Carrier বা returns system আগে থেকেই label payload বা tracking data দিয়েছে।
- Download, email বা reprint করা যায় এমন PDF label বা instruction sheet দরকার।
- একই return label layout Template Render দিয়ে reuse করতে চান।
এটি কী replace করে না
- Return approve করা, postage কেনা বা carrier shipment তৈরি করার কাজ gPdf-কে দিতে চান।
- Direct carrier API orchestration দরকার।
- ZPL-এর মতো printer command output দরকার।
কোন endpoint call করবেন
/api/v1/pdf/render
JSON Render এই workflow-এর default path।
/api/v1/template-render
Workflow-তে related API path, template contract অথবা capabilities lookup দরকার হলে ব্যবহার করুন।
নূন্যতম request
POST /api/v1/pdf/render - RMA barcode-সহ return label।
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 5,
"y": 8,
"content": "RETURN TO",
"style": { "font_size": 9, "font_family": "NotoSans-Regular" }
},
{
"type": "text",
"x": 5,
"y": 18,
"content": "Acme Returns\n500 Dock Door 4\nColumbus OH 43215",
"style": { "font_size": 11, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "code128",
"content": "RMA-2026-77881",
"x": 5,
"y": 70,
"width": 88,
"height": 20,
"barcode_text": { "enabled": true, "position": "bottom" }
}
]
}
]
}
gPdf কী করে
- Label-sized return label এবং instruction page-এর PDF rendering।
- Barcode, text, address, RMA এবং service block।
- Approved return label বা instruction layout-এর জন্য template binding।
- Customer re-download এবং support reprint-এর জন্য deterministic output।
আপনার system-এর দায়িত্ব
- Return eligibility, RMA state, carrier account, postage, tracking number এবং customer messaging।
- সঠিক barcode payload, destination address, item reference এবং return window rule।
- Email delivery, portal download এবং support audit trail।
Production checklist
- Rendering-এর আগে carrier বা returns provider দিয়ে return payload validate করুন।
- Customer বা store যে stock ব্যবহার করবে, একই stock-এ label print ও scan করুন।
- X-Request-Id include করুন এবং support log-এ RMA-to-PDF trace store করুন।
- Customer-এর দৃষ্টিতে repeated download idempotent করুন।
- Label rendering-কে refund approval logic থেকে আলাদা রাখুন।
দাবির সীমা
- gPdf return label PDF render করে; return authorize করে না বা postage কেনে না।
- Carrier acceptance এবং barcode payload correctness আপনার দায়িত্ব।
- Public API PDF return করে, ZPL বা সরাসরি printer command নয়।
Reverse logistics-এ ownership পরিষ্কার হওয়া দরকার
Return label customer experience এবং carrier rule একসাথে ধরে। gPdf PDF rendering own করে। আপনার return system eligibility, RMA state, tracking, carrier payload এবং customer communication own করে।
Integration-এ boundary দৃশ্যমান রাখুন। আগে return decision generate করুন, তারপর finalized data থেকে document render করুন।
FAQ
- gPdf কি return shipment তৈরি করে?
- না। আপনার carrier বা returns platform shipment এবং payload তৈরি করে। gPdf সেই data-কে PDF-এ render করে।
- Return label কি template থেকে তৈরি করা যায়?
- হ্যাঁ। Return label বা instruction layout approved হয়ে গেলে Template Render ব্যবহার করুন।
- PDF-এ কি return instruction রাখা যায়?
- হ্যাঁ। আপনার layout অনুযায়ী একই render request একটি label page, একটি instruction page, বা দুটিই তৈরি করতে পারে।
- gPdf কি carrier certification replace করে?
- না। Carrier acceptance, scanner test এবং payload rule আপনার দায়িত্বেই থাকে।