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

Kích hoạt bảo hành

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

Kích hoạt bảo hành 1 sản phẩm theo số serial cho khách hàng. Thành công: serial chuyển trạng thái đã kích hoạt, ngày kích hoạt = hôm nay, QBIS gửi tin xác nhận cho khách theo mẫu của hãng.

Thao tác và endpoint

Thao tácEndpoint
Tra cứuPOST /warranty/activate
Gọi lại với serial đã kích hoạt trả 409 SERIAL_ALREADY_ACTIVATED — website hiển thị message cho khách.
?dryRun=1: chỉ kiểm trường bắt buộc + tra serial (data.found, data.activated), chưa xét mã số cào, chưa ghi.

Tham số (query)

Tham sốKiểuBắt buộcMô tả
serialstringCóSố serial sản phẩm
namestringCóHọ tên khách
phonestringCóSố điện thoại khách (9–11 số)
provinceIdstringCó*Mã tỉnh / thành (/warranty/areas). *Hoặc gửi provinceName
provinceNamestringTên tỉnh / thành khi không có mã
districtIdstringMã quận / huyện (chỉ địa bàn cũ, newAreas = false)
wardIdstringMã xã / phường
addressstringTuỳ hãngSố nhà, đường. Hãng bắt buộc mã số cào thì bắt buộc
emailstringEmail khách (chỉ lưu khi hồ sơ khách chưa có)
scratchCodestringTuỳ hãngMã số cào trên tem / phiếu bảo hành (hãng bắt buộc mã số cào)
activationPhonestringTuỳ hãngSĐT người kích hoạt (hãng bắt buộc mã số cào)
serialObjectIdstringChỉ khi lần gửi trước trả SERIAL_MULTI: serialObjectId của sản phẩm khách chọn trong data.choices[]

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

TrườngKiểuMô tả
serialstringSố serial đã kích hoạt
productCodestringMã sản phẩm
productNamestringTên sản phẩm
modelstringModel
activatedDatestringNgày kích hoạt dd/MM/yyyy
expireDatestringNgày hết hạn bảo hành dd/MM/yyyy (trọn đời: rỗng)
warrantyMonthsintegerSố tháng bảo hành
lifetimebooleantrue = bảo hành trọn đời
installedDatestringNgày lắp đặt nếu sản phẩm đã kích hoạt lắp đặt, không thì rỗng
warningstringCảnh báo (vd kích hoạt sau hạn lắp đặt), rỗng nếu không có
confirmMessagestringCâu xác nhận theo mẫu của hãng — website có thể hiện cho khách

Ví dụ

POST /open/api/v1/warranty/activate
{
  "serial": "KP79A0001234",
  "name": "Nguyễn Văn A",
  "phone": "0912345678",
  "provinceId": "01",
  "wardId": "00004",
  "address": "12 Trần Phú",
  "scratchCode": "123456",
  "activationPhone": "0912345678"
}

200
{
  "status": 200,
  "success": true,
  "code": "SERIAL_ACTIVATED",
  "message": "",
  "data": {
    "serial": "KP79A0001234",
    "productCode": "KP - IH 79",
    "productName": "Bếp từ Kappo IH 79",
    "model": "",
    "activatedDate": "21/11/2026",
    "expireDate": "21/11/2028",
    "warrantyMonths": 24,
    "lifetime": false,
    "installedDate": "",
    "warning": "",
    "confirmMessage": "San pham KP79A0001234 da kich hoat bao hanh den 21/11/2028"
  }
}

400
{
  "status": 400,
  "success": false,
  "code": "SCRATCH_CODE_INVALID",
  "message": "Mã số cào không đúng",
  "data": null
}
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ợ →