GS1 barcode API สำหรับฉลาก PDF แบบเวกเตอร์
เรนเดอร์บาร์โค้ด GS1 แบบเวกเตอร์ใน PDF รวมถึง workflow ฉลาก GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 และ SSCC-18
/api/v1/pdf/render เรนเดอร์ GS1 barcode payload เป็นฉลากหรือเอกสาร PDF แบบเวกเตอร์ โดยระบบ product, warehouse หรือ retail ของคุณยังรับผิดชอบ application identifiers, check digits และ scanner acceptance ที่ถูกต้อง
ควรใช้ API นี้เมื่อใด
- คุณต้องการให้ barcode modules ถูกวาดเป็นเนื้อหา PDF เวกเตอร์ ไม่ใช่ภาพ bitmap ที่วางทับ
- ระบบของคุณมี GS1 payload และ human-readable interpretation ที่ถูกต้องอยู่แล้ว
- คุณต้องการ workflow GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 หรือ SSCC-18 ในฉลากหรือเอกสาร
- คุณต้องการย้าย layout ฉลากบาร์โค้ดที่ใช้ซ้ำเข้าสู่ Template Render
สิ่งที่ไม่ได้ทดแทน
- คุณต้องการ GS1 certification หรือ validation ของ product-data semantics จาก gPdf
- คุณต้องการให้ gPdf ออก GS1 company prefixes, GTINs, SSCCs หรือ check digits
- คุณต้องการจัดการ inventory หรือ product master data
ควรเรียก endpoint ใด
/api/v1/pdf/render
JSON Render คือ path หลักสำหรับเวิร์กโฟลว์นี้.
/api/v1/template-render
ใช้เมื่อเวิร์กโฟลว์ต้องการ API path ที่เกี่ยวข้อง สัญญาเทมเพลต หรือการค้นหา capability.
Minimal request
POST /api/v1/pdf/render - องค์ประกอบบาร์โค้ด PDF สไตล์ GS1-128
{
"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 จัดการอะไร
- การเรนเดอร์บาร์โค้ดเวกเตอร์ภายใน output PDF
- การวางบาร์โค้ดร่วมกับข้อความ เส้น ข้อมูลสินค้า และโครงสร้างฉลาก
- Template Render สำหรับฉลากสินค้า pallet carton และคลังสินค้าที่ใช้ซ้ำ
- PDF output ที่เหมาะกับ scanner และ print tests
ระบบของคุณรับผิดชอบอะไร
- GS1 application identifiers, company prefixes, GTINs, SSCCs และ check digits
- ข้อมูลบาร์โค้ด ข้อมูลสินค้า ข้อความ regulatory และ scanner acceptance tests ที่ถูกต้อง
- กระบวนการพิมพ์ stock ฉลาก quiet zones และ operational QA
Production checklist
- สร้าง GS1 payload upstream และทำให้ testable
- พิมพ์และสแกนบน printer และ scanner ที่ใช้จริงใน production
- ตรวจ quiet zones, module size, human-readable text และ stock ฉลาก
- ใช้ Template Render เมื่อ layout ฉลากได้รับอนุมัติแล้ว
- ระบุให้ชัดว่า gPdf เรนเดอร์บาร์โค้ด แต่ไม่ได้ certify GS1 compliance
ขอบเขตของ claim
- gPdf เรนเดอร์บาร์โค้ด PDF แบบเวกเตอร์ ไม่ใช่ GS1 certification body
- caller เป็นเจ้าของ GS1 data semantics และ check digits
- scanner acceptance ต้อง validate ใน production environment ของ caller
การเรนเดอร์บาร์โค้ด GS1 คืองานเรนเดอร์ PDF
gPdf รับผิดชอบการวาดบาร์โค้ดลงใน PDF ไม่ได้เป็นผู้ตัดสินว่า GTIN, SSCC หรือ sequence ของ application identifier ถูกต้องสำหรับธุรกิจของคุณหรือไม่ เก็บ logic นั้นไว้ใน ERP, WMS, product-information system หรือ GS1 tooling ของคุณ
ใช้ JSON Render หรือ Template Render
ใช้ JSON Render เมื่อโค้ดเป็นผู้จัด layout ฉลากหรือเอกสารโดยตรง ใช้ Template Render เมื่อบาร์โค้ดเป็นหนึ่ง field ภายใน layout ฉลากที่ใช้ซ้ำ ในทั้งสองกรณี caller เป็นผู้ส่ง payload ที่ต้อง encode
Validate กับ scanner จริง
ความสำเร็จของบาร์โค้ดวัดจากการยอมรับของ scanner ไม่ใช่จากภาพที่ดูถูกต้องบน monitor ตรวจ output ที่พิมพ์แล้วด้วย printer, scanner และ stock ฉลากเดียวกับที่ใช้ใน production
FAQ
- gPdf certify ฉลาก GS1 หรือไม่
- ไม่ gPdf เรนเดอร์กราฟิกบาร์โค้ดเวกเตอร์ใน PDF ทีมของคุณรับผิดชอบ GS1 payload correctness, scanner tests และ certification workflow ใด ๆ
- ใช้ GS1 barcodes กับ Template Render ได้หรือไม่
- ได้ เทมเพลตที่ publish แล้วสามารถมี barcode fields และ caller ส่งเฉพาะ variable data สำหรับ layout ฉลากที่ใช้ซ้ำ
- ใครสร้าง SSCC หรือ GTIN
- ระบบ product, warehouse หรือ ERP ของคุณสร้างและ validate identifiers ส่วน gPdf รับ payload แล้วเรนเดอร์
- ทำไมต้องใช้บาร์โค้ดเวกเตอร์
- vector modules ช่วยหลีกเลี่ยง artifacts จากการ scale แบบ raster และทำให้ label PDF คมชัดกว่าในหลายระดับ printer DPI และ zoom