Khách báo sản phẩm hỏng. Chọn nơi nhận bằng target: queue (mặc định) — vào danh sách ca báo bảo hành chờ hãng duyệt (trạng thái Pending); ticket — tạo thẳng phiếu yêu cầu sửa chữa / bảo hành (kèm đơn dịch vụ) trong quản lý phiếu của hãng. Serial chưa kích hoạt hoặc chưa có trên QBIS vẫn báo được.
Thao tác và endpoint
| Thao tác | Endpoint |
|---|---|
| Tra cứu | POST /warranty/claims |
Thành công trả HTTP
201: code = CLAIM_CREATED (queue) hoặc TICKET_CREATED (ticket).ticket: khách tìm theo SĐT, chưa có thì tạo mới; mã requestType không có trong danh mục của hãng → 400 INVALID_VALUE.Sản phẩm đang có ca chưa xong →
409 CLAIM_IN_PROGRESS.?dryRun=1: chỉ kiểm trường bắt buộc + tra serial, không tạo ca.Tham số (query)
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
target | string | queue (mặc định) = hàng đợi ca báo bảo hành · ticket = phiếu yêu cầu sửa chữa / bảo hành | |
serial | string | Có | Số serial sản phẩm hỏng |
name | string | Có | Họ tên khách |
phone | string | Có | Số điện thoại khách |
address | string | Có | Số nhà, đường |
provinceId | string | Có | Mã tỉnh / thành (/warranty/areas) |
districtId | string | Mã quận / huyện (chỉ địa bàn cũ) | |
wardId | string | Có | Mã xã / phường |
description | string | Có | Mô tả sự cố / hiện tượng hư hỏng |
serialObjectId | string | Serial trùng nhiều sản phẩm: serialObjectId sản phẩm khách chọn (như kích hoạt) | |
modelId | string | Model khi serial trùng nhiều sản phẩm | |
productName | string | Chỉ target = ticket: tên thiết bị; không gửi thì lấy tên sản phẩm của serial trên QBIS | |
requestType | string | Chỉ target = ticket: mã loại yêu cầu của hãng (vd InWarranty bảo hành, OutOfWarranty hết hạn, Repair sửa chữa). Không gửi: serial còn hạn → InWarranty, đã kích hoạt mà hết hạn → OutOfWarranty, còn lại để hãng chọn |
Trường dữ liệu trả về (data)
| Trường | Kiểu | Mô tả |
|---|---|---|
target | string | queue / ticket — nơi đã nhận ca |
claimCode | string | Mã ca (queue) hoặc mã phiếu yêu cầu (ticket) — đưa cho khách để hỏi tiến độ |
orderCode | string | Mã đơn dịch vụ chứa phiếu (ticket); queue: rỗng |
serial | string | Số serial đã báo |
status | string | queue: Pending = chờ hãng duyệt; ticket: trạng thái phiếu (mới tạo) |
requestType | string | Chỉ ticket: loại yêu cầu đã ghi |
Ví dụ
POST /open/api/v1/warranty/claims
{
"target": "queue",
"serial": "KP79A0001234",
"name": "Nguyễn Văn A",
"phone": "0912345678",
"address": "12 Trần Phú",
"provinceId": "01",
"wardId": "00004",
"description": "Bếp không nhận nồi, báo lỗi E1"
}
201
{
"status": 201,
"success": true,
"code": "CLAIM_CREATED",
"message": "Báo ca bảo hành thành công",
"data": {
"target": "queue",
"claimCode": "2611211530123",
"orderCode": "",
"serial": "KP79A0001234",
"status": "Pending"
}
}
POST /open/api/v1/warranty/claims (target = ticket)
{
"target": "ticket",
"serial": "KP79A0001234",
"name": "Nguyễn Văn A",
"phone": "0912345678",
"address": "12 Trần Phú",
"provinceId": "01",
"wardId": "00004",
"description": "Bếp không nhận nồi, báo lỗi E1"
}
201
{
"status": 201,
"success": true,
"code": "TICKET_CREATED",
"message": "Đã tạo phiếu yêu cầu bảo hành",
"data": {
"target": "ticket",
"serial": "KP79A0001234",
"requestType": "InWarranty",
"claimCode": "Y261121001",
"orderCode": "T261121001",
"status": "new"
}
}