SUPPORT QBIS.VNTrung tâm trợ giúp
Gửi yêu cầu hỗ trợ

Xưởng

mfg_factoriesPhiên bản v1Cập nhật 11/11/2026

Các xưởng của nhà máy.

Thao tác và endpoint

Thao tácEndpoint
Xem mộtGET /mfg_factories/{id}
Danh sáchGET /mfg_factories?updatedSince=…&page=1&size=50
Định nghĩa trườngGET /_schema/mfg_factories

Khoá tra cứu: id — ID bản ghi do QBIS cấp (vd 8812345).

Trường dữ liệu

TrườngKiểuBắt buộcChỉ đọcLọcMô tả
idchuỗi—cóID bản ghi do QBIS cấp. Khoá tra cứu (vd 8812345)
codechuỗikhôngcóMã xưởng
namechuỗicócóTên xưởng

Ví dụ tra cứu

curl https://db.qbis.vn/open/api/v1/mfg_factories/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"
  }
}

Ví dụ danh sách

curl "https://db.qbis.vn/open/api/v1/mfg_factories?updatedSince=05%2F11%2F2026%2008%3A00&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.

Cần khoá API?Gửi yêu cầu để QBIS bật kết nối API cho đơn vị của bạn, sau đó quản trị đơn vị xem 3 khoá trong Cấu hình phần mềm → API tích hợp QBIS. Gửi yêu cầu hỗ trợ →