Vector PDF label-এর জন্য GS1 barcode API
GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 এবং SSCC-18 label workflow-সহ PDF-এ vector GS1 barcode render করুন।
/api/v1/pdf/render GS1 barcode payload-কে vector PDF label বা document-এ render করুন; application identifier, check digit এবং scanner acceptance সঠিক রাখার দায়িত্ব আপনার product, warehouse বা retail system-এর।
কখন এই API ব্যবহার করবেন
- Bitmap image paste না করে barcode module vector PDF content হিসেবে draw করা দরকার।
- আপনার system-এ সঠিক GS1 payload এবং human-readable interpretation আগে থেকেই আছে।
- Label বা document-এ GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 বা SSCC-18 workflow দরকার।
- Repeated barcode label layout Template Render-এ নিতে চান।
এটি কী replace করে না
- gPdf থেকে GS1 certification বা product-data semantics validation দরকার।
- gPdf-কে GS1 company prefix, GTIN, SSCC বা check digit allocate করতে হবে।
- Inventory বা product master data management দরকার।
কোন 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 - GS1-128 style PDF barcode element।
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "barcode",
"format": "gs1-128",
"content": "(00)012345678901234567",
"x": 8,
"y": 22,
"width": 86,
"height": 24,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 8,
"y": 56,
"content": "SSCC pallet label",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf কী করে
- PDF output-এর ভিতরে vector barcode rendering।
- Text, line, product data এবং label structure-এর সাথে barcode placement।
- Repeated product, pallet, carton এবং warehouse label-এর জন্য Template Render।
- Scanner ও print test-এর উপযোগী PDF output।
আপনার system-এর দায়িত্ব
- GS1 application identifier, company prefix, GTIN, SSCC এবং check digit।
- সঠিক barcode data, product data, regulatory text এবং scanner acceptance test।
- Print process, label stock, quiet zone এবং operational QA।
Production checklist
- GS1 payload upstream-এ generate করুন এবং testable রাখুন।
- Production printer ও scanner-এ print এবং scan করুন।
- Quiet zone, module size, human-readable text এবং label stock validate করুন।
- Label layout approved হলে Template Render ব্যবহার করুন।
- Document করুন যে gPdf barcode render করে, কিন্তু GS1 compliance certify করে না।
দাবির সীমা
- gPdf vector PDF barcode render করে; এটি GS1 certification body নয়।
- GS1 data semantics এবং check digit caller own করে।
- Scanner acceptance caller-এর production environment-এ validate করতে হবে।
GS1 barcode rendering একটি PDF rendering job
Barcode PDF-এ আঁকার দায়িত্ব gPdf-এর। কোনো GTIN, SSCC বা application-identifier sequence আপনার business-এর জন্য valid কি না, তা সিদ্ধান্ত নেওয়ার দায়িত্ব gPdf-এর নয়। সেই logic ERP, WMS, product-information system বা GS1 tooling-এ রাখুন।
JSON Render বা Template Render ব্যবহার করুন
Code যদি label বা document layout সরাসরি তৈরি করে, JSON Render ব্যবহার করুন। Repeated label layout-এর ভিতরে barcode যদি একটি field হয়, Template Render ব্যবহার করুন। দুই ক্ষেত্রেই caller সেই payload পাঠায় যা encode করা হবে।
Real scanner দিয়ে validate করুন
Barcode success monitor-এ image ঠিক দেখাচ্ছে কি না দিয়ে মাপা যায় না; scanner acceptance দিয়ে মাপা হয়। Production-এ ব্যবহৃত একই printer, scanner এবং label stock দিয়ে printed output validate করুন।
FAQ
- gPdf কি GS1 label certify করে?
- না। gPdf PDF-এ vector barcode graphic render করে। GS1 payload correctness, scanner test এবং certification workflow আপনার team own করে।
- GS1 barcode কি Template Render-এর সঙ্গে ব্যবহার করা যায়?
- হ্যাঁ। Published template barcode field রাখতে পারে, এবং caller repeated label layout-এর জন্য শুধু variable data পাঠাতে পারে।
- SSCC বা GTIN কে তৈরি করে?
- আপনার product, warehouse বা ERP system identifier তৈরি ও validate করে। gPdf payload গ্রহণ করে এবং render করে।
- Vector barcode কেন ব্যবহার করব?
- Vector module raster scaling artifact এড়ায় এবং printer DPI ও zoom level জুড়ে label PDF sharp রাখে।