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.
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ên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
code | query|path | string | có | Dãy số mã vạch (8, 12, 13, 14 số hoặc ISBN-10). | |
compute | query | boolean | không | false | Mã 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"const res = await fetch('https://apibox.io.vn/v1/gtin-check?code=8934588012228', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/gtin-check?code=8934588012228",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/gtin-check?code=8934588012228');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));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
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.