Phiếu kiểm nghiệm thành phẩm với từng chỉ tiêu, ngưỡng và kết luận.
Thao tác và endpoint
| Thao tác | Endpoint |
|---|---|
| Xem một | GET /qc_tests/{id} |
| Danh sách | GET /qc_tests?updatedSince=…&page=1&size=50 |
| Danh sách criteria của một phiếu kiểm nghiệm thành phẩm | GET /qc_tests/{id}/criteria |
| Định nghĩa trường | GET /_schema/qc_tests |
Khoá tra cứu: id — ID bản ghi do QBIS cấp (vd 8812345).
Trường dữ liệu
| Trường | Kiểu | Bắt buộc | Chỉ đọc | Lọc | Mô tả |
|---|---|---|---|---|---|
id | chuỗi | — | có | ID bản ghi do QBIS cấp. Khoá tra cứu (vd 8812345) | |
no | chuỗi | không | có | Số phiếu | |
type | mã danh mục | không | có | Loại. Gửi code, trả về {code, name} — mã ở mục 7.13.2 | |
day | ngày dd/MM/yyyy | có | có | Ngày | |
inspector | chuỗi | không | có | Người kiểm | |
lotNo | chuỗi | không | có | Số lô | |
conclusion | mã danh mục | không | có | Kết luận. Gửi code, trả về {code, name} — mã ở mục 7.13.2 | |
criteria[] | mảng | không | Gửi kèm khi tạo (tối đa 50 dòng); trả về khi xem một, đọc riêng bằng GET /qc_tests/{id}/criteria. Trường: xem qc_test_criteria |
Mã danh mục
type — Loại
| code | name |
|---|---|
Sản phẩm | Sản phẩm |
Lô | Lô |
Mẫu nguyên liệu | Mẫu nguyên liệu |
conclusion — Kết luận
| code | name |
|---|---|
Đạt | Đạt |
Không đạt | Không đạt |
Giữ | Giữ |
Bảng trên là mã mặc định của QBIS. Đơn vị có thể ẩn / thêm mã, và trường lấy từ danh mục riêng của đơn vị không in ở đây — danh sách đúng của đơn vị bạn:
GET /_schema/qc_tests (thuộc tính values của trường).Ví dụ tra cứu
curl https://db.qbis.vn/open/api/v1/qc_tests/8812345 \
-H "X-Store-Key: YOUR_STORE_KEY" -H "X-Api-Key: YOUR_API_KEY" -H "X-Secret-Key: YOUR_SECRET_KEY"HTTP 200, data là bản ghi kèm criteria[]. Không có → 404 NOT_FOUND.
{
"status": 200,
"success": true,
"code": "OK",
"message": "",
"data": {
"id": "8812345",
"no": "Nội dung số phiếu",
"type": {
"code": "Sản phẩm",
"name": "Sản phẩm"
},
"day": "05/11/2026",
"inspector": "Nội dung người kiểm",
"lotNo": "Nội dung số lô",
"conclusion": {
"code": "Đạt",
"name": "Đạt"
},
"criteria": [
{
"name": {
"code": "CODE",
"name": "Chỉ tiêu"
},
"value": "Nội dung giá trị",
"threshold": "Nội dung ngưỡng",
"pass": true
}
]
}
}Ví dụ danh sách
curl "https://db.qbis.vn/open/api/v1/qc_tests?updatedSince=05%2F11%2F2026%2008%3A00&type=S%E1%BA%A3n%20ph%E1%BA%A9m&page=1&size=50" \
-H "X-Store-Key: YOUR_STORE_KEY" -H "X-Api-Key: YOUR_API_KEY" -H "X-Secret-Key: YOUR_SECRET_KEY"Trả data.records[] (mỗi phần tử như data ở ví dụ tra cứu, không kèm dòng con), page, size, count, hasMore — mục 3.3. Lọc đúng bằng theo: no, type, day, inspector, lotNo, conclusion.