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ác | Endpoint |
|---|---|
| Danh sách | GET /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ểu | Bắt buộc | Mô tả |
|---|---|---|---|
serial | string | Có* | Số serial. *Hoặc phone |
phone | string | Có* | Số điện thoại khách. *Hoặc serial |
onlyActivated | boolean | true = chỉ sản phẩm đã kích hoạt | |
page | integer | Trang, từ 1 | |
size | integer | Số 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ường | Kiểu | Mô tả |
|---|---|---|
records[].serial | string | Số serial |
records[].productCode | string | Mã sản phẩm |
records[].productName | string | Tên sản phẩm |
records[].productGroup | string | Nhóm sản phẩm |
records[].productImage | string | Ảnh sản phẩm (URL) |
records[].manufacturer | string | Hãng sản xuất |
records[].model | string | Model |
records[].activated | boolean | Đã kích hoạt bảo hành |
records[].activatedDate | string | Ngày kích hoạt dd/MM/yyyy (chưa kích hoạt: rỗng) |
records[].expireDate | string | Ngày hết hạn dd/MM/yyyy |
records[].warrantyMonths | integer | Số tháng bảo hành |
records[].lifetime | boolean | Bảo hành trọn đời |
records[].warrantyLabel | string | Nhãn thời hạn để hiển thị (vd 24 tháng, Trọn đời) |
records[].inWarranty | boolean | true = đã kích hoạt và còn hạn |
records[].shippedDate | string | Ngày xuất kho |
records[].purchaseDate | string | Ngày mua (nếu có) |
records[].dealerName | string | Đại lý / kho bán |
records[].customerName | string | Tên khách đã kích hoạt |
records[].customerPhone | string | SĐT khách đã che, vd 091****678 |
records[].note | string | Ghi 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
}
}