Mọi xe qua trạm cân: xe sắn thu mua (loại 1), nguyên liệu không mua (2), hàng khác vào (3), xe ra (4). Loại 3, 4 chỉ có khối lượng. Phiếu cân của một lô: /raw/lots?include=slips; phiếu đã thanh toán: status=paid.
Thao tác và endpoint
| Thao tác | Endpoint |
|---|---|
| Xem một | GET /raw_weigh_slips/{id} |
| Danh sách | GET /raw_weigh_slips?updatedSince=…&page=1&size=50 |
| Định nghĩa trường | GET /_schema/raw_weigh_slips |
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 phiếu cân. Gửi code, trả về {code, name} — mã ở mục 7.11.2 | |
status | mã danh mục | không | có | Trạng thái. Gửi code, trả về {code, name} — mã ở mục 7.11.2 | |
day | ngày giờ dd/MM/yyyy HH:mm | — | có | Thời điểm tạo bản ghi trên QBIS | |
timeIn | ngày dd/MM/yyyy | có | có | Giờ vào | |
timeOut | chuỗi dài | — | có | Chuỗi quy đổi (JSON) | |
vehicle.plate | chuỗi | — | có | có | Biển số |
vehicle.driver | chuỗi | — | có | Lái xe | |
vehicle.kind | chuỗi dài | — | có | Chuỗi quy đổi (JSON) | |
vehicle.type | chuỗi dài | — | có | Chuỗi quy đổi (JSON) | |
vehicle.volumeM3 | chuỗi dài | — | có | Chuỗi quy đổi (JSON) | |
vehicle.freightType.id | chuỗi dài | — | có | Chuỗi quy đổi (JSON) | |
vehicle.freightType.name | chuỗi dài | — | có | Chuỗi quy đổi (JSON) | |
vehicle.driverWage | chuỗi dài | — | có | Chuỗi quy đổi (JSON) | |
material | chuỗi | — | có | có | Nguyên liệu |
goods | chuỗi | không | có | Mặt hàng (ghi chữ) | |
owner | chuỗi | không | có | Chủ hàng / khách hàng | |
weights.firstKg | số | — | có | có | Cân lần 1 (kg) |
weights.secondKg | số | — | có | có | Cân lần 2 (kg) |
weights.netKg | số | — | có | có | Khối lượng tịnh (kg) |
weights.impurityPct | số | — | có | có | Tạp chất (%) |
weights.payWeightKg | số | — | có | có | Khối lượng thanh toán (kg) |
quality.starchPct | số | — | có | có | Hàm lượng |
quality.starchSamples | chuỗi dài | — | có | Chuỗi quy đổi (JSON) | |
quality.moisturePct | số | — | có | có | Độ ẩm (%) |
price.method | chuỗi dài | — | có | Chuỗi quy đổi (JSON) | |
price.unitPrice | số | — | có | có | Đơn giá |
price.amount | số | — | có | có | Thành tiền |
price.bonus | chuỗi dài | — | có | Chuỗi quy đổi (JSON) | |
price.freight | số | — | có | có | Cước xe |
price.deduction | số | — | có | có | Khấu trừ |
price.payable | số | — | có | có | Thực trả |
note | chuỗi dài | — | có | Chuỗi quy đổi (JSON) | |
createdAt | ngày giờ dd/MM/yyyy HH:mm | — | có | Thời điểm tạo bản ghi trên QBIS | |
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) |
Mã danh mục
type — Loại phiếu cân
| code | name |
|---|---|
1 | Thu mua nguyên liệu |
2 | Nguyên liệu không mua |
3 | Hàng khác vào |
4 | Xe ra (xuất hàng) |
status — Trạng thái
| code | name |
|---|---|
Đã vào | Đã vào |
Chờ KCS | Chờ KCS |
Chờ cân 2 | Chờ cân 2 |
Đã tính tiền | Đã tính tiền |
Đã thanh toán | Đã thanh toán |
Trả hàng | Trả hàng |
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/raw_weigh_slips (thuộc tính values của trường).Ví dụ tra cứu
curl https://db.qbis.vn/open/api/v1/raw_weigh_slips/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": {
"id": "8812345",
"no": "Nội dung số phiếu",
"type": {
"code": "1",
"name": "Thu mua nguyên liệu"
},
"status": {
"code": "Đã vào",
"name": "Đã vào"
},
"day": "05/11/2026 09:15",
"timeIn": "05/11/2026",
"timeOut": "",
"vehicle.plate": "Nội dung biển số",
"vehicle.driver": "Nội dung lái xe",
"vehicle.kind": "Nội dung chuỗi quy đổi (JSON)",
"vehicle.type": "Nội dung chuỗi quy đổi (JSON)",
"vehicle.volumeM3": "Nội dung chuỗi quy đổi (JSON)",
"vehicle.freightType.id": "Nội dung chuỗi quy đổi (JSON)",
"vehicle.freightType.name": "Nguyễn Văn An",
"vehicle.driverWage": "Nội dung chuỗi quy đổi (JSON)",
"material": "Nội dung nguyên liệu",
"goods": "Nội dung mặt hàng (ghi chữ)",
"owner": "Trần Văn Bình",
"weights.firstKg": 1,
"weights.secondKg": 1,
"weights.netKg": 1,
"weights.impurityPct": 1,
"weights.payWeightKg": 1,
"quality.starchPct": 1,
"quality.starchSamples": "Nội dung chuỗi quy đổi (JSON)",
"quality.moisturePct": 1,
"price.method": "Nội dung chuỗi quy đổi (JSON)",
"price.unitPrice": 150000,
"price.amount": 300000,
"price.bonus": "Nội dung chuỗi quy đổi (JSON)",
"price.freight": 150000,
"price.deduction": 150000,
"price.payable": 150000,
"note": "Liên hệ trước khi giao",
"createdAt": "05/11/2026 09:15",
"updatedAt": "06/11/2026 14:30"
}
}Ví dụ danh sách
curl "https://db.qbis.vn/open/api/v1/raw_weigh_slips?updatedSince=05%2F11%2F2026%2008%3A00&status=%C4%90%C3%A3%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: no, type, status, timeIn, vehicle.plate, material, goods, owner, weights.firstKg, weights.secondKg, weights.netKg, weights.impurityPct, weights.payWeightKg, quality.starchPct, quality.moisturePct, price.unitPrice, price.amount, price.freight, price.deduction, price.payable.