Phương pháp và nguồn taomavach.online: thư viện, chuẩn, cách kiểm

Phương pháp của taomavach.online được mô tả tại trang này: các công cụ được xây dựng thế nào, dựa trên chuẩn nào, kiểm tra ra sao và có giới hạn gì, để bạn đánh giá được mức tin cậy trước khi in mã lên bao bì hoặc tem hàng loạt.

Thư viện mã nguồn mở được dùng

Mọi mã vạch được dựng bằng bwip-js, bản JavaScript của Barcode Writer in Pure PostScript (BWIPP). Đây là thư viện tham chiếu hỗ trợ hơn 100 loại mã theo đúng đặc tả, được dùng rộng rãi trong phần mềm thương mại; quét thử dùng ZXing.

Thư việnViệcGiấy phép
bwip-js 4.x (BWIPP)Tạo mọi mã 1D/2D: Code 128, EAN/UPC, ITF-14, GS1-128, DataMatrix, PDF417, Aztec, QR…MIT
@zxing/library 0.23Quét mã từ camera và ảnh trong trình duyệtApache-2.0
jsPDFDựng PDF tem A4, tem cuộn, thẻMIT
JSZipĐóng gói ZIP khi tạo hàng loạtMIT
SheetJS Community EditionĐọc .xlsx/.csv ngay trong trình duyệtApache-2.0

Các thư viện được tải từ npm và đặt trong plugin của trang, không dùng CDN bên ngoài; phiên bản chính xác ghi trong tệp VERSIONS.md của plugin và tại trang Cập nhật. Toàn bộ xử lý diễn ra trong trình duyệt, không có máy chủ trung gian; xem Chính sách bảo mật.

Chuẩn tham chiếu

Thuật toán mã hóa, số kiểm tra, vùng trắng và kích thước lấy từ các chuẩn sau. Tham số nghiệp vụ (prefix quốc gia, bảng AI, khổ tem, phí GS1) được lưu trong cấu hình của trang và chủ trang cập nhật khi chuẩn thay đổi.

  • ISO/IEC 15417:2007 Code 128; ISO/IEC 15420 EAN/UPC; ISO/IEC 16388 Code 39; ISO/IEC 16390 ITF; ISO/IEC 16022 Data Matrix; ISO/IEC 15438 PDF417; ISO/IEC 24778 Aztec; ISO/IEC 18004 QR Code; ISO/IEC 24724 GS1 DataBar.
  • GS1 General Specifications (bản hiện hành): cấu trúc GTIN, GLN, SSCC; bảng Application Identifier; số kiểm tra mod 10; kích thước và độ phóng EAN/UPC 80–200 %, ITF-14 50–100 %; vùng trắng; dải 200–299 nội bộ.
  • Nghị định 74/2018/NĐ-CP, 13/2022/NĐ-CP (mã số mã vạch, Mẫu số 12), Thông tư 232/2016/TT-BTC (phí), Thông tư 18/2022/TT-BKHCN (nhãn điện tử), Nghị định 43/2017/NĐ-CP và 111/2021/NĐ-CP (nhãn hàng hóa).
  • GS1 Sunrise 2027, GS1 Digital Link, GS1 Logistics Label Guideline, GS1 DataMatrix Guideline cho các công cụ 2D và logistics.

Cách kiểm tra công cụ

Mỗi công cụ được kiểm bằng bộ trường hợp cố định trước khi công bố. Giá trị mẫu lấy từ chuẩn (893123456789 → số kiểm tra 7; UPC-A 042100005264 nén UPC-E thành 04252614; ISSN 0378-5955 → 9770378595002) được so khớp với tính tay và với thư viện. Sau đó kiểm round-trip: mã tạo ra được xuất PNG và đọc lại bằng tool quét của trang, nội dung phải trùng tuyệt đối.

Giới hạn đã biết: ZXing không đọc UPC-E, Micro QR, rMQR, MSI, Pharmacode, Code 11, Telepen, Plessey, nên các mã này được kiểm bằng giải mã thủ công từ dãy vạch thay vì round-trip; DataMatrix chứa chữ có dấu được mã hóa UTF-8 không khai báo ECI nên một số máy quét đọc sai dấu, công cụ cảnh báo và khuyên dùng QR. Kết quả quét chỉ xác nhận cấu trúc mã, không thay thế kiểm tra chất lượng in theo ISO/IEC 15416.

Tham số đang chờ xác minh

Một số tham số lấy từ nguồn thứ cấp và được đánh dấu cần đối chiếu văn bản gốc. Gồm: mức phí GS1 theo Thông tư 232/2016 (phí hồ sơ xác nhận mã nước ngoài dưới 50 mã lệch giữa các nguồn), lề của giấy decal Tomy theo lô, yêu cầu GTIN của từng sàn thương mại điện tử (thay đổi thường xuyên). Các trang liên quan ghi rõ điều này và ngày cập nhật; sai sót xin báo qua trang Liên hệ.