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

Danh mục địa bàn

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

Danh mục tỉnh / huyện / xã theo cấu hình địa bàn của hãng, để form trên website gửi đúng mã provinceId, districtId, wardId. Nên lưu đệm trên website (ít thay đổi).

Thao tác và endpoint

Thao tácEndpoint
Tra cứuGET /warranty/areas

Tham số (query)

Tham sốKiểuBắt buộcMô tả
levelstringprovince (mặc định) · district (chỉ địa bàn cũ) · ward
parentIdstringKhi level ≠ provinceĐịa bàn mới: mã tỉnh. Địa bàn cũ: mã tỉnh khi lấy huyện, mã huyện khi lấy xã

Trường dữ liệu trả về (data)

TrườngKiểuMô tả
levelstringCấp đã lấy
newAreasbooleantrue = địa bàn mới 2 cấp (tỉnh → xã), false = 3 cấp (tỉnh → huyện → xã)
records[].idstringMã — gửi vào provinceId / districtId / wardId
records[].namestringTên hiển thị

Ví dụ

GET /open/api/v1/warranty/areas?level=ward&parentId=01

{
  "status": 200,
  "success": true,
  "code": "OK",
  "message": "",
  "data": {
    "level": "ward",
    "newAreas": true,
    "records": [
      { "id": "00004", "name": "Phường Ba Đình" }
    ]
  }
}
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ợ →