API mã vạch DataMatrix cho đầu ra PDF vector
Kết xuất mã vạch DataMatrix và GS1 DataMatrix trong nhãn và tài liệu PDF cho quy trình sản phẩm, y tế, bán lẻ và kho.
/api/v1/pdf/render Kết xuất payload DataMatrix hoặc GS1 DataMatrix dưới dạng mã vạch element vector trong nhãn sản phẩm, nhãn kho hoặc tài liệu, trong khi hệ thống của bạn sở hữu payload nghiệp vụ được encode.
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 DataMatrix đú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 DataMatrix trong PDF.
{
"pages": [
{
"size": "label_100_100",
"elements": [
{
"type": "barcode",
"format": "gs1-datamatrix",
"content": "(01)09506000134352(10)LOT26A",
"x": 10,
"y": 14,
"width": 34,
"height": 34
},
{
"type": "text",
"x": 10,
"y": 56,
"content": "GTIN 09506000134352\nLOT LOT26A",
"style": { "font_size": 9, "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.
DataMatrix trong PDF là phần việc kết xuất
API mã vạch DataMatrix 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 đã đúng, còn gPdf vẽ mã vạch dưới dạng vector trong PDF cùng text, đường kẻ và bố cục nhãn cần thiết.
Điểm cần giữ rõ là ngữ nghĩa dữ liệu không nằm trong renderer. Prefix, mã định danh ứng dụng, check digit, dữ liệu sản phẩm, kiểm thử acceptance và quy trình downstream vẫn thuộc hệ thống gọi.
FAQ
- Đây có phải API mã vạch DataMatrix độc lập không?
- Có. Trang này ánh xạ quy trình mã vạch DataMatrix 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.