Warehouse label API สำหรับ WMS และ ERP print workflows
สร้าง PDF ฉลาก pallet, case, bin, inventory และ warehouse-operation จากข้อมูล WMS หรือ ERP พร้อม reprint แบบ deterministic
/api/v1/pdf/render เรนเดอร์ฉลากคลังสินค้าจากข้อมูล WMS หรือ ERP สำหรับ pallets, cartons, bins, assets, locations และ inventory movements โดยเก็บ inventory state, picking rules และ warehouse operations ไว้ในระบบของ caller
ควรใช้ API นี้เมื่อใด
- คุณต้องการฉลาก pallet, carton, bin, location, inventory หรือ asset เป็น PDF
- WMS หรือ ERP ของคุณเป็นเจ้าของ SKU, lot, location, SSCC และ inventory data อยู่แล้ว
- คุณต้องการ deterministic reprints เมื่อฉลากเสียหายหรือ station retry งาน
- คุณต้องการนำ layout ฉลากที่อนุมัติแล้วกลับมาใช้ซ้ำผ่าน Template Render
สิ่งที่ไม่ได้ทดแทน
- คุณต้องการให้ gPdf จัดการ inventory, allocate locations หรือรัน warehouse workflows
- คุณต้องการ scanner app, print-station agent หรือ label-routing system จาก gPdf
- คุณต้องการ GS1 certification แทน barcode rendering
ควรเรียก endpoint ใด
/api/v1/pdf/render
JSON Render คือ path หลักสำหรับเวิร์กโฟลว์นี้.
/api/v1/template-render
ใช้เมื่อเวิร์กโฟลว์ต้องการ API path ที่เกี่ยวข้อง สัญญาเทมเพลต หรือการค้นหา capability.
Minimal request
POST /api/v1/pdf/render - pallet label พร้อมข้อมูล SSCC barcode
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "PALLET LAX-01-2026-00042",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "012345678901234567",
"x": 6,
"y": 30,
"width": 88,
"height": 26,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 6,
"y": 70,
"content": "SKU: CASE-001\nQTY: 48\nLOCATION: A-14-02",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf จัดการอะไร
- PDF labels สำหรับ warehouse print workflows
- บาร์โค้ดเวกเตอร์ ข้อความ กล่อง ขนาดหน้าฉลาก และ template binding
- output deterministic สำหรับ reprint และ audit workflows
- JSON Render สำหรับ custom layouts และ Template Render สำหรับ label contracts ที่อนุมัติแล้ว
ระบบของคุณรับผิดชอบอะไร
- inventory state, SKU data, lot/serial data, SSCC values และ location semantics
- printer routing, station setup, scanner validation และ warehouse process rules
- template selection, retries และ storage ของ rendered PDFs หรือ source data
Production checklist
- validate ขนาดฉลากกับ printer และ label stock จริง
- สแกน barcode format ทุกแบบที่ใช้ใน warehouse process
- รักษา WMS/ERP state ให้ authoritative และส่งเฉพาะ final label data ให้ gPdf
- ใช้ Template Render สำหรับฉลากที่หลายระบบหรือหลาย station พิมพ์
- log source document IDs และ request IDs สำหรับ reprint traceability
ขอบเขตของ claim
- gPdf เรนเดอร์ warehouse label PDFs แต่ไม่ได้จัดการ inventory หรือ warehouse state
- caller เป็นเจ้าของ barcode payload semantics และ scanner acceptance
- Template Render ช่วยทำให้ layout ฉลากเสถียร แต่ไม่แทน WMS rules
Warehouse labels คือ operational records
warehouse labels ระบุ pallets, cases, bins, assets, inventory movements และ locations สิ่งเหล่านี้ผูกกับ operational state ใน WMS หรือ ERP ของคุณ gPdf ควรรับ final label data แล้วเรนเดอร์ ไม่ควรตัดสิน inventory meaning หรือ warehouse process state
Template Render ทำให้ print stations เรียบง่าย
สำหรับฉลากที่ใช้ข้ามหลาย station ให้ publish layout ที่อนุมัติแล้วเป็น template จากนั้น print services ส่ง template_id พร้อม WMS data แทนการสร้าง coordinates ใหม่ใน caller ทุกตัว
Reprint determinism
คลังสินค้าต้อง reprint ฉลาก ฉลากเสีย printer jam หรือ station retry ไม่ควรสร้างเอกสารที่ต่างไปเล็กน้อย เก็บ source label data ผูกกับ warehouse record และใช้ render inputs ที่ deterministic สำหรับ reprints
FAQ
- gPdf จัดการ warehouse inventory หรือไม่
- ไม่ WMS หรือ ERP ของคุณเป็นเจ้าของ inventory state, locations, SKUs, lots และ process rules gPdf เรนเดอร์ label PDF จาก final data
- warehouse labels ใช้ GS1 หรือ SSCC barcodes ได้หรือไม่
- ได้ gPdf เรนเดอร์ barcode formats ที่รองรับใน PDF output ระบบของคุณเป็นเจ้าของ barcode payload และ scanner acceptance
- warehouse labels ที่ใช้ซ้ำควรใช้ templates หรือไม่
- โดยทั่วไปใช่ Template Render ให้ print stations ใช้ template_id และ data contract ที่เสถียรหลัง layout ฉลากได้รับอนุมัติ
- reprints ควรทำอย่างไร
- เก็บ source label data หรือ generated PDF กับ warehouse record แล้ว render หรือ retrieve ฉลากเดิมด้วย original operational IDs