Mỗi báo cáo là 1 ngày × 1 ca × 1 xưởng. Dòng số liệu chia nhóm: output thành phẩm (mỗi hạng 1 dòng), byproduct phụ phẩm, consumption vật tư tiêu hao (điện, than, nước, hoá chất…), indicator chỉ số (độ ẩm, độ trắng…).
Thao tác và endpoint
| Thao tác | Endpoint |
|---|---|
| Xem một | GET /prod_shift_reports/{id} |
| Danh sách | GET /prod_shift_reports?updatedSince=…&page=1&size=50 |
| Danh sách lines của một báo cáo ca | GET /prod_shift_reports/{id}/lines |
| Định nghĩa trường | GET /_schema/prod_shift_reports |
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ố báo cáo | |
day | ngày dd/MM/yyyy | có | có | Ngày | |
factory | mã danh mục | không | có | Xưởng / dây chuyền. Gửi code, trả về {code, name} — mã ở mục 7.12.2 | |
team | mã danh mục | không | có | Tổ / kíp. Gửi code, trả về {code, name} — mã ở mục 7.12.2 | |
reporter | chuỗi | không | có | Người báo | |
present | số | không | Có mặt | ||
absent | số | không | Vắng | ||
runHours | số | không | Giờ chạy | ||
stopHours | số | không | Giờ dừng | ||
incident | chuỗi dài | không | Sự cố | ||
status | mã danh mục | không | có | Trạng thái. Gửi code, trả về {code, name} — mã ở mục 7.12.2 | |
approvedBy | chuỗi | không | Người duyệt | ||
approvedAt | ngày dd/MM/yyyy | không | Ngày duyệt | ||
handover | chuỗi dài | không | Ghi chú bàn giao ca | ||
updatedAt | ngày giờ dd/MM/yyyy HH:mm | — | có | Thời điểm cập nhật gần nhất (mốc so với updatedSince) (mục 3.3) | |
lines[] | 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 /prod_shift_reports/{id}/lines. Trường: xem prod_shift_report_lines |
Mã danh mục
factory — Xưởng / dây chuyền
team — Tổ / kíp
status — Trạng thái
| code | name |
|---|---|
Nháp | Nháp |
Chờ duyệt | Chờ duyệt |
Đã duyệt | Đã duyệt |
Trả lại | Trả lại |
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_reports (thuộc tính values của trường).Ví dụ tra cứu
curl https://db.qbis.vn/open/api/v1/prod_shift_reports/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 lines[]. Không có → 404 NOT_FOUND.
{
"status": 200,
"success": true,
"code": "OK",
"message": "",
"data": {
"id": "8812345",
"no": "Nội dung số báo cáo",
"day": "05/11/2026",
"factory": {
"code": "CODE",
"name": "Xưởng / dây chuyền"
},
"team": {
"code": "CODE",
"name": "Tổ / kíp"
},
"reporter": "Nội dung người báo",
"present": 1,
"absent": 1,
"runHours": 1,
"stopHours": 1,
"incident": "Nội dung sự cố",
"status": {
"code": "Nháp",
"name": "Nháp"
},
"approvedBy": "Nội dung người duyệt",
"approvedAt": "05/11/2026",
"handover": "Nội dung ghi chú bàn giao ca",
"updatedAt": "06/11/2026 14:30",
"lines": [
{
"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_reports?updatedSince=05%2F11%2F2026%2008%3A00&status=Nh%C3%A1p&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, day, factory, team, reporter, status.