Lưới con — đọc kèm bản ghi cha.
Thao tác và endpoint
| Thao tác | Endpoint |
|---|---|
| Xem một | GET /prod_shift_report_lines/{id} |
| Danh sách | GET /prod_shift_report_lines?updatedSince=…&page=1&size=50 |
| Định nghĩa trường | GET /_schema/prod_shift_report_lines |
Khoá tra cứu: id (vd 8812345). Tạo: là dòng con của prod_shift_reports — không tạo lẻ bằng POST /prod_shift_report_lines (trả 405); xem mục 3.6.
Trường dữ liệu
| Trường | Kiểu | Bắt buộc | Chỉ đọc | Lọc | Mô tả |
|---|---|---|---|---|---|
group | mã danh mục | không | có | Nhóm. Gửi code, trả về {code, name} — mã ở mục 7.2.2 | |
item | chuỗi | có | có | Chỉ tiêu | |
value | số | không | có | Giá trị | |
unit | chuỗi | không | có | Đơn vị | |
note | chuỗi | không | Ghi chú |
Mã danh mục
group — Nhóm
| code | name |
|---|---|
Nguyên liệu vào | Nguyên liệu vào |
Thành phẩm ra | Thành phẩm ra |
Phụ phẩm | Phụ phẩm |
Tiêu hao | Tiêu hao |
Kiểm nghiệm | Kiểm nghiệm |
Vận hành | Vận hành |
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/prod_shift_report_lines (thuộc tính values của trường).Ví dụ tra cứu
curl https://db.qbis.vn/open/api/v1/prod_shift_report_lines/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. Không có → 404 NOT_FOUND.
{
"status": 200,
"success": true,
"code": "OK",
"message": "",
"data": {
"group": {
"code": "Nguyên liệu vào",
"name": "Nguyên liệu vào"
},
"item": "Nội dung chỉ tiêu",
"value": 300000,
"unit": "Cái",
"note": "Dán tại cửa hàng"
}
}Ví dụ danh sách
curl "https://db.qbis.vn/open/api/v1/prod_shift_report_lines?updatedSince=05%2F11%2F2026%2008%3A00&group=Nguy%C3%AAn%20li%E1%BB%87u%20v%C3%A0o&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: group, item, value, unit.