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ác | Endpoint |
|---|---|
| Tra cứu | POST /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ểu | Bắt buộc | Mô tả |
|---|---|---|---|
serial | string | Có | Số serial sản phẩm |
name | string | Có | Họ tên khách |
phone | string | Có | Số điện thoại khách (9–11 số) |
provinceId | string | Có* | Mã tỉnh / thành (/warranty/areas). *Hoặc gửi provinceName |
provinceName | string | Tên tỉnh / thành khi không có mã | |
districtId | string | Mã quận / huyện (chỉ địa bàn cũ, newAreas = false) | |
wardId | string | Mã xã / phường | |
address | string | Tuỳ hãng | Số nhà, đường. Hãng bắt buộc mã số cào thì bắt buộc |
email | string | Email khách (chỉ lưu khi hồ sơ khách chưa có) | |
scratchCode | string | Tuỳ hãng | Mã số cào trên tem / phiếu bảo hành (hãng bắt buộc mã số cào) |
activationPhone | string | Tuỳ hãng | SĐT người kích hoạt (hãng bắt buộc mã số cào) |
serialObjectId | string | Chỉ 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ường | Kiểu | Mô tả |
|---|---|---|
serial | string | Số serial đã kích hoạt |
productCode | string | Mã sản phẩm |
productName | string | Tên sản phẩm |
model | string | Model |
activatedDate | string | Ngày kích hoạt dd/MM/yyyy |
expireDate | string | Ngày hết hạn bảo hành dd/MM/yyyy (trọn đời: rỗng) |
warrantyMonths | integer | Số tháng bảo hành |
lifetime | boolean | true = bảo hành trọn đời |
installedDate | string | Ngày lắp đặt nếu sản phẩm đã kích hoạt lắp đặt, không thì rỗng |
warning | string | Cảnh báo (vd kích hoạt sau hạn lắp đặt), rỗng nếu không có |
confirmMessage | string | Câ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
}