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

Báo ca bảo hành

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

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ácEndpoint
Tra cứuPOST /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ểuBắt buộcMô tả
targetstringqueue (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
serialstringCóSố serial sản phẩm hỏng
namestringCóHọ tên khách
phonestringCóSố điện thoại khách
addressstringCóSố nhà, đường
provinceIdstringCóMã tỉnh / thành (/warranty/areas)
districtIdstringMã quận / huyện (chỉ địa bàn cũ)
wardIdstringCóMã xã / phường
descriptionstringCóMô tả sự cố / hiện tượng hư hỏng
serialObjectIdstringSerial trùng nhiều sản phẩm: serialObjectId sản phẩm khách chọn (như kích hoạt)
modelIdstringModel khi serial trùng nhiều sản phẩm
productNamestringChỉ 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
requestTypestringChỉ 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ườngKiểuMô tả
targetstringqueue / ticket — nơi đã nhận ca
claimCodestringMã ca (queue) hoặc mã phiếu yêu cầu (ticket) — đưa cho khách để hỏi tiến độ
orderCodestringMã đơn dịch vụ chứa phiếu (ticket); queue: rỗng
serialstringSố serial đã báo
statusstringqueue: Pending = chờ hãng duyệt; ticket: trạng thái phiếu (mới tạo)
requestTypestringChỉ 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"
  }
}
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ợ →