In tem nhãn PDF (máy in nhiệt) API

Tem cho máy in nhiệt dạng PDF: tem vận đơn có COD, Code 128, QR; tem giá có EAN-13; tem phụ hàng nhập khẩu; tem tuỳ chỉnh; in hàng loạt nhiều trang.

POSThttps://apibox.io.vn/v1/label-pdf

Chọn template và khổ size (100x150, 100x100, 76x130, 75x50, 50x30, a6 hoặc RỘNGxCAO tính bằng mm), gửi một tem bằng các trường hoặc nhiều tem trong labels (mỗi tem một trang, copies số bản mỗi tem, tối đa 500 trang). Mẫu: shipping (tem vận đơn tự giao: tên shop / hãng, ngày, mã đơn dạng Code 128, người nhận chữ lớn, người gửi, tiền thu hộ COD kèm số tiền bằng chữ, khối lượng, nội dung hàng, ghi chú và mã QR), price (tên hàng, giá VND, giá cũ gạch ngang và đơn vị tuỳ chọn, mã EAN-13 khi mã vạch có 12–13 chữ số, ngược lại Code 128), aux (nhãn phụ tiếng Việt cho hàng nhập khẩu, cùng trường dữ liệu với vn-label-rules; trường bắt buộc còn thiếu được báo trong header x-warnings) và custom (tiêu đề, các dòng, mã vạch, QR).

Chữ dùng font Be Vietnam Pro (đủ dấu tiếng Việt, nhúng dạng subset) và tự thu nhỏ cho vừa tem; mã vạch và QR là hình vector nên in sắc nét ở 203 hoặc 300 dpi. Số kiểm tra EAN-13 được kiểm tra (gửi 12 chữ số thì API tự thêm). Kết quả là application/pdf, hoặc JSON chứa PDF base64 khi format=json. Khi in chọn tỉ lệ 100 % (không "vừa trang") đúng khổ giấy tem.

Tham số

TênVị tríKiểuBắt buộcMặc định
templatebodystringkhôngshippingshipping, price, aux hoặc custom (có thể đặt riêng từng tem).
sizebodystringkhông100x150100x150, 100x100, 76x130, 75x50, 50x30, a6 hoặc RỘNGxCAO (mm).
labelsbodyarraykhôngCác tem (mỗi tem một trang). Vận đơn: sender, receiver {name, phone, address}, order_code, cod, weight (g), items / content, note, shop, date, qr. Tem giá: name, price, old_price, unit, barcode. Tem phụ: group + các trường nhãn của vn-label-rules. Tuỳ chỉnh: title, lines, barcode, qr. copies: số bản mỗi tem.
rotatebodybooleankhôngfalseĐổi chiều rộng và cao (nằm ngang).
formatbodystringkhôngpdfpdf hoặc json (base64).

Ví dụ

curl -X POST "https://apibox.io.vn/v1/label-pdf" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template":"shipping","size":"100x150","labels":[{"shop":"Shop Hoa Mai","date":"11/11/2026","order_code":"DH20261111-001","sender":{"name":"Shop Hoa Mai","phone":"0901234567","address":"12 Nguyễn Huệ, Phường Sài Gòn, TP. Hồ Chí Minh"},"receiver":{"name":"Nguyễn Thị Lan","phone":"0912345678","address":"Số 5 ngõ 12 Phố Huế, Phường Hai Bà Trưng, Hà Nội"},"cod":350000,"weight":1200,"items":[{"name":"Áo thun","quantity":2}],"note":"Cho xem hàng"}]}' \
  -o output

Kết quả trả về

binary application/pdf

Ứng dụng

  • In tem vận đơn cho đơn shop tự giao
  • Làm tem giá có mã vạch cho cửa hàng nhỏ
  • In nhãn phụ tiếng Việt cho hàng nhập khẩu
  • In hàng loạt tem vị trí kho có mã QR

Hỏi đáp

Dùng được với máy in nào?

Mọi máy in được PDF lên giấy tem: máy in nhiệt (Xprinter, HPRT, Zebra…) 203 hoặc 300 dpi, hoặc giấy decal A4 nếu chọn khổ tuỳ chỉnh. In ở tỉ lệ 100 %.

In nhiều tem một lần được không?

Được: gửi "labels" là một mảng (tối đa 500 trang, "copies" cho số bản mỗi tem). Mỗi tem là một trang PDF.

Hỗ trợ loại mã vạch nào?

Code 128 (mã đơn, SKU) và EAN-13 (mã vạch sản phẩm, có kiểm tra số kiểm tra), cùng mã QR.

API liên quan

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →