Điểm thu mua / đại lý / hộ bán sắn.
Thao tác và endpoint
| Thao tác | Endpoint |
|---|---|
| Xem một | GET /raw_points/{id} |
| Danh sách | GET /raw_points?updatedSince=…&page=1&size=50 |
| Định nghĩa trường | GET /_schema/raw_points |
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) | |
code | chuỗi | không | có | Mã người bán | |
name | chuỗi | có | có | Tên điểm | |
ownerName | chuỗi | không | có | Chủ điểm / người bán | |
region | mã danh mục | có | có | Vùng. Gửi code, trả về {code, name} — mã ở mục 7.8.2 | |
type | mã danh mục | không | có | Loại. Gửi code, trả về {code, name} — mã ở mục 7.8.2 | |
rank | mã danh mục | không | có | Hạng. Gửi code, trả về {code, name} — mã ở mục 7.8.2 | |
address | chuỗi | không | Địa chỉ | ||
location | chuỗi | không | Toạ độ | ||
active | true/false | không | có | Đang hoạt động | |
openingDebt | số | không | Nợ đầu kỳ | ||
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
region — Vùng
type — Loại
| code | name |
|---|---|
Đại lý | Đại lý |
Hộ dân | Hộ dân |
HTX | HTX |
Thương lái | Thương lái |
rank — Hạng
| code | name |
|---|---|
A | A |
B | B |
C | C |
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_points (thuộc tính values của trường).Ví dụ tra cứu
curl https://db.qbis.vn/open/api/v1/raw_points/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",
"code": "QB000123",
"name": "Nguyễn Văn An",
"ownerName": "Nguyễn Văn An",
"region": {
"code": "CODE",
"name": "Vùng"
},
"type": {
"code": "Đại lý",
"name": "Đại lý"
},
"rank": {
"code": "A",
"name": "A"
},
"address": "12 Lê Lợi, Phường Bến Nghé, Quận 1, TP.HCM",
"location": "Nội dung toạ độ",
"active": true,
"openingDebt": 0,
"updatedAt": "06/11/2026 14:30"
}
}Ví dụ danh sách
curl "https://db.qbis.vn/open/api/v1/raw_points?updatedSince=05%2F11%2F2026%2008%3A00&type=%C4%90%E1%BA%A1i%20l%C3%BD&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: code, name, ownerName, region, type, rank, active.