API mã vạch GS1 cho nhãn PDF vector
Kết xuất mã vạch GS1 vector trong PDF, bao gồm GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 và quy trình nhãn SSCC-18.
/api/v1/pdf/render Kết xuất payload mã vạch GS1 thành nhãn hoặc tài liệu PDF vector, trong khi hệ thống product, warehouse hoặc retail của bạn vẫn chịu trách nhiệm về application identifiers, check digits và máy quét acceptance.
Khi nào dùng API này
- Bạn cần module mã vạch được vẽ dưới dạng nội dung PDF vector thay vì ảnh bitmap.
- Hệ thống của bạn đã có payload mã vạch GS1 đúng và phần diễn giải human-readable.
- Bạn cần quy trình nhãn hoặc tài liệu có thể in, quét và kiểm thử lặp lại.
- Bạn muốn bố cục nhãn mã vạch dùng lặp lại được đưa vào Template Render.
Những gì không thay thế
- Bạn cần gPdf chứng nhận hoặc xác thực ngữ nghĩa dữ liệu ngành.
- Bạn cần gPdf cấp mã định danh, prefix, GTIN, SSCC hoặc check digit.
- Bạn cần quản lý dữ liệu master sản phẩm, tồn kho hoặc nghiệp vụ downstream.
Endpoint cần gọi
/api/v1/pdf/render
JSON Render là đường mặc định cho quy trình này.
/api/v1/template-render
Dùng khi quy trình cần API liên quan, hợp đồng mẫu hoặc truy vấn năng lực.
Request tối thiểu
POST /api/v1/pdf/render - mã vạch GS1 trong PDF.
{
"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 xử lý gì
- Kết xuất mã vạch vector bên trong đầu ra PDF.
- Đặt mã vạch cùng text, đường kẻ, dữ liệu sản phẩm và cấu trúc label.
- Template Render cho nhãn sản phẩm, pallet, carton hoặc kho dùng lặp lại.
- Đầu ra PDF phù hợp để kiểm thử scan và in.
Hệ thống của bạn quản lý gì
- Mã định danh ứng dụng, prefix công ty, GTIN, SSCC, check digit hoặc payload tương ứng.
- Dữ liệu mã vạch đúng, dữ liệu sản phẩm, text pháp lý/vận hành và máy quét acceptance tests.
- Quy trình in, vật liệu nhãn, quiet zone và QA vận hành.
Checklist đưa vào production
- Tạo payload upstream và giữ khả năng test.
- In và quét trên máy in và máy quét production.
- Xác thực quiet zone, module size, human-readable text và vật liệu nhãn.
- Dùng Template Render khi bố cục nhãn đã được duyệt.
- Ghi rõ gPdf kết xuất mã vạch nhưng không chứng nhận tuân thủ nghiệp vụ hoặc GS1.
Ranh giới tuyên bố
- gPdf kết xuất mã vạch PDF vector; gPdf không phải cơ quan chứng nhận GS1 hoặc ngành.
- Hệ thống gọi sở hữu ngữ nghĩa dữ liệu, check digits và payload.
- Máy quét acceptance phải được xác thực trong môi trường production của hệ thống gọi.
Kết xuất mã vạch GS1 là phần việc tạo PDF
API mã vạch GS1 xử lý phần kết xuất PDF của quy trình mã vạch. Hệ thống của bạn cung cấp payload GS1 đã đúng; gPdf vẽ mã vạch dưới dạng vector trong PDF cùng text, đường kẻ và cấu trúc label.
Dùng JSON Render hoặc Template Render
Dùng JSON Render khi bố cục đang được sinh bằng mã hoặc còn thay đổi. Dùng Template Render khi bố cục nhãn GS1 đã được duyệt và nhiều hệ thống chỉ nên gửi dữ liệu nghiệp vụ theo template_id.
Xác thực bằng máy quét thật
GS1 acceptance phụ thuộc dữ liệu, check digit, quiet zone, module size, vật liệu nhãn, máy in và máy quét thật. gPdf kết xuất mã vạch; máy quét acceptance và chứng nhận nghiệp vụ vẫn thuộc hệ thống gọi.
FAQ
- Đây có phải API mã vạch GS1 độc lập không?
- Có. Trang này ánh xạ quy trình mã vạch GS1 vào endpoint công khai POST /api/v1/pdf/render. Hệ thống của bạn vẫn sở hữu dữ liệu nghiệp vụ, còn gPdf chỉ tạo PDF từ request hợp lệ.
- Khi nào nên dùng Template Render?
- Dùng Template Render khi bố cục đã được duyệt và bạn muốn gọi bằng template_id cùng data thay vì gửi toàn bộ tọa độ ở mỗi request.
- API có trả PDF trực tiếp không?
- Có. Khi kết xuất thành công, API trả về application/pdf. Khi lỗi, API dùng JSON error envelope chung với mã API-XXX và req_id.
- Cần kiểm tra gì trước production?
- Hãy in và quét trên thiết bị production, kiểm tra quiet zone, module size và dữ liệu human-readable.