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

Tra cứu bảo hành

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

Tra cứu bảo hành theo số serial hoặc số điện thoại khách. Gửi đúng 1 trong 2 tham số. Kết quả là danh sách sản phẩm (tra theo SĐT có thể nhiều sản phẩm), mới nhất trước.

Thao tác và endpoint

Thao tácEndpoint
Danh sáchGET /warranty/lookup
Không tìm thấy: 200, data.records = [] — website hiện "Không tìm thấy thông tin bảo hành".
Không trả email / địa chỉ khách; SĐT đã che.

Tham số (query)

Tham sốKiểuBắt buộcMô tả
serialstringCó*Số serial. *Hoặc phone
phonestringCó*Số điện thoại khách. *Hoặc serial
onlyActivatedbooleantrue = chỉ sản phẩm đã kích hoạt
pageintegerTrang, từ 1
sizeintegerSố dòng / trang, mặc định 50, tối đa 200

Trường dữ liệu trả về (mỗi phần tử của data.records[])

TrườngKiểuMô tả
records[].serialstringSố serial
records[].productCodestringMã sản phẩm
records[].productNamestringTên sản phẩm
records[].productGroupstringNhóm sản phẩm
records[].productImagestringẢnh sản phẩm (URL)
records[].manufacturerstringHãng sản xuất
records[].modelstringModel
records[].activatedbooleanĐã kích hoạt bảo hành
records[].activatedDatestringNgày kích hoạt dd/MM/yyyy (chưa kích hoạt: rỗng)
records[].expireDatestringNgày hết hạn dd/MM/yyyy
records[].warrantyMonthsintegerSố tháng bảo hành
records[].lifetimebooleanBảo hành trọn đời
records[].warrantyLabelstringNhãn thời hạn để hiển thị (vd 24 tháng, Trọn đời)
records[].inWarrantybooleantrue = đã kích hoạt và còn hạn
records[].shippedDatestringNgày xuất kho
records[].purchaseDatestringNgày mua (nếu có)
records[].dealerNamestringĐại lý / kho bán
records[].customerNamestringTên khách đã kích hoạt
records[].customerPhonestringSĐT khách đã che, vd 091****678
records[].notestringGhi chú (vd đã đổi 1 đổi 1 sang máy mới)

Ví dụ

GET /open/api/v1/warranty/lookup?serial=KP79A0001234

{
  "status": 200,
  "success": true,
  "code": "OK",
  "message": "",
  "data": {
    "records": [
      {
        "serial": "KP79A0001234",
        "productCode": "KP - IH 79",
        "productName": "Bếp từ Kappo IH 79",
        "productGroup": "Bếp từ",
        "productImage": "https://file.qbis.vn/…",
        "manufacturer": "Kappo",
        "model": "",
        "activated": true,
        "activatedDate": "21/11/2026",
        "expireDate": "21/11/2028",
        "warrantyMonths": 24,
        "lifetime": false,
        "warrantyLabel": "24 tháng",
        "inWarranty": true,
        "shippedDate": "10/11/2026",
        "purchaseDate": "",
        "dealerName": "",
        "customerName": "Nguyễn Văn A",
        "customerPhone": "091****678",
        "note": ""
      }
    ],
    "page": 1,
    "size": 50,
    "count": 1,
    "hasMore": false
  }
}
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ợ →