API mã DataMatrix trong PDF cho hệ thống production
Tạo mã DataMatrix trong PDF từ dữ liệu backend có cấu trúc, không cần browser. gPdf xử lý PDF rendering; logic nghiệp vụ nằm trong hệ thống của bạn.
/api/v1/pdf/render Tạo mã DataMatrix trong PDF thành PDF có thể tái tạo từ dữ liệu có cấu trúc. gPdf render tài liệu; hệ thống của bạn giữ ngữ nghĩa dữ liệu và trạng thái quy trình.
Khi nào dùng API này
- Backend đã có dữ liệu mã DataMatrix trong PDF và cần phản hồi PDF ổn định.
- Bạn muốn tránh Chromium hoặc HTML-to-PDF cho tài liệu vận hành.
- Bạn cần output lặp lại được cho in lại, audit hoặc batch.
Những gì không thay thế
- gPdf không mua vận chuyển, khai thuế, tạo đơn hàng ngoài hoặc đóng vai trò hệ thống thuế.
- Không thay thế validation dữ liệu, business rules hoặc tích hợp marketplace.
Endpoint cần gọi
/api/v1/pdf/render
JSON Render là đường mặc định cho workflow này.
/api/v1/template-render
Dùng khi workflow cần API liên quan, hợp đồng template hoặc truy vấn capability.
Request tối thiểu
/api/v1/pdf/render - mã 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ì
- PDF rendering cho mã DataMatrix trong PDF từ request có cấu trúc.
- Text, bảng, đường kẻ, barcode, trang, metadata và tùy chọn output theo request.
- Output deterministic cho retry, in lại và audit.
Hệ thống của bạn quản lý gì
- Dữ liệu đúng của mã DataMatrix trong PDF, business rules và trạng thái vận hành.
- Authentication, lưu trữ, workflow bên ngoài và kiểm tra với hệ thống nhận.
Checklist production
- Test bằng dữ liệu thật và hệ thống sẽ nhận PDF.
- Lưu request ID và bằng chứng validation cho support, audit và in lại.
- Chuyển layout đã duyệt thành template khi nhiều hệ thống dùng lại.
Ranh giới cam kết
- gPdf vẽ barcode vector trong PDF; không chứng nhận chất lượng dữ liệu GS1 hoặc chấp nhận retail.
- Payload, identifiers, quiet zones và scan test thuộc hệ thống của bạn.
Dạng API
API mã DataMatrix trong PDF là workflow production chạy trên public APIs của gPdf. Request mô tả dữ liệu, layout, settings và các phần PDF cần render. gPdf tạo PDF; hệ thống của bạn giữ ngữ nghĩa nghiệp vụ.
Chọn endpoint
Endpoint mặc định của workflow này là /api/v1/pdf/render. Dùng Template Render khi layout đã duyệt và tái sử dụng giữa nhiều hệ thống. Chỉ dùng E-Invoice Render khi cần gói Factur-X / ZUGFeRD PDF/A-3b với EN 16931 CII XML nhúng.
Kiểm tra trước production
Kiểm tra mã DataMatrix trong PDF bằng dữ liệu thật và downstream systems. Lưu request ID, output đã render và bằng chứng validation cho support, audit và in lại.
FAQ
- Đây có phải endpoint riêng không?
- API mã DataMatrix trong PDF ánh xạ workflow vào một API công khai của gPdf. Trang này chỉ rõ path cần gọi và request phải sở hữu dữ liệu gì.
- Có dùng templates được không?
- Có. Dùng JSON Render khi layout còn thay đổi; dùng Template Render khi layout đã duyệt và callers chỉ gửi dữ liệu nghiệp vụ.
- Cần kiểm tra gì trước production?
- Kiểm tra bằng dữ liệu thật và printer, scanner, validator, kế toán hoặc marketplace tùy workflow.