Kiểm tra mã vạch API

Kiểm tra mã vạch sản phẩm (EAN-8, EAN-13, UPC-A, GTIN-14, ISBN-10/13, ISSN), tính số kiểm tra và tra tổ chức cấp mã theo tiền tố GS1, ví dụ 893 = GS1 Việt Nam.

GETPOSThttps://apibox.io.vn/v1/gtin-check
Dữ liệu & JSON▶ Dùng thử online

API kiểm tra mã vạch xác nhận dãy số in dưới mã vạch sản phẩm. API nhận diện EAN-8, UPC-A (12 số), EAN-13 và GTIN-14 / ITF-14, kiểm tra số kiểm tra mod-10 của GS1 và trả về mã GTIN 14 số chuẩn hoá dùng trong trao đổi dữ liệu GS1. Với compute=true, API tính số kiểm tra còn thiếu cho mã bạn đang tạo.

Ba chữ số đầu được tra trong bảng tiền tố GS1: 893 là GS1 Việt Nam, 690–699 Trung Quốc, 885 Thái Lan, 450–459 và 490–499 Nhật Bản, 978–979 sách (ISBN), 977 tạp chí (ISSN), 200–299 mã dùng nội bộ cửa hàng. Lưu ý tiền tố cho biết tổ chức thành viên GS1 nào cấp mã doanh nghiệp, không phải nơi sản xuất. Sách có thêm dạng ISBN-10 / ISBN-13 và ấn phẩm định kỳ có ISSN; số ISBN-10 (có X) cũng được nhận trực tiếp.

Bảng tiền tố lấy từ danh sách chính thức của GS1 và được tự động cập nhật hằng tuần.

Tham số

TênVị tríKiểuBắt buộcMặc định
codequery|pathstringcóDãy số mã vạch (8, 12, 13, 14 số hoặc ISBN-10).
computequerybooleankhôngfalseMã chưa có số kiểm tra: tính số kiểm tra.

Ví dụ

curl "https://apibox.io.vn/v1/gtin-check?code=8934588012228" \
  -H "Authorization: Bearer YOUR_API_KEY"

Kết quả trả về

{
  "input": "8934588012228",
  "type": "EAN-13 (GTIN-13)",
  "valid": true,
  "check_digit": 8,
  "expected_check_digit": 8,
  "gtin14": "08934588012228",
  "gs1_prefix": {
    "prefix": "893",
    "range": "893",
    "name": "GS1 Vietnam",
    "country_code": "VN"
  },
  "note": "The prefix tells which GS1 member organisation issued the company prefix, not where the product was made.",
  "vietnam": {
    "gs1_prefix": "893",
    "organisation": "GS1 Việt Nam (Trung tâm Mã số Mã vạch Quốc gia)"
  }
}

Ứng dụng

  • Kiểm tra mã vạch nhập tay hoặc quét trong app bán hàng, kho
  • Kiểm tra dữ liệu sản phẩm đăng lên sàn (Shopee, Lazada, Tiki)
  • Tính số kiểm tra cho mã sản phẩm mới
  • Đổi qua lại ISBN-10 và ISBN-13

Hỏi đáp

Mã 893 có nghĩa là “sản xuất tại Việt Nam” không?

Không hẳn. 893 nghĩa là mã doanh nghiệp do GS1 Việt Nam cấp; sản phẩm có thể sản xuất ở nơi khác, và hàng Việt Nam cũng có thể mang tiền tố khác.

Số kiểm tra được tính thế nào?

Các chữ số được nhân lần lượt 3 và 1 từ phải sang; số kiểm tra làm tổng chia hết cho 10.

API có cho biết tên sản phẩm không?

Không, API chỉ kiểm tra dãy số và tiền tố. Thông tin sản phẩm nằm trong cơ sở dữ liệu của GS1 và nhà bán lẻ.

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í →