GET 质保卡详情
GET 查询质保卡详情（含覆盖产品清单、调整/延保/终止审计记录）。query 参数：id（必填，质保卡ID）。
| 接口编码 | 所需范围 | 后端接口 |
|---|---|---|
sales.service-warranty-card.detail | sales:read | GET /v1/service-orders/warranty-card/detail（comap-sales） |
请求参数（query）
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | integer(int64) | 是 | — |
「必填」仅反映接口规格声明的部分。服务内还有未体现在规格里的校验， 标「—」不等于可以不传；租户在主站配置的字段必填不约束本接口。 详见必填字段的判定与字段清单与自定义字段。
请求示例
curl -X POST https://open.risemap.cn/v1/api/invoke \
-H "Authorization: Bearer <访问令牌>" \
-H "Content-Type: application/json" \
-d '{
"apiCode": "sales.service-warranty-card.detail",
"query": {
"id": "1961000000000000001"
}
}'
响应 data 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | integer(int64) | — | 质保卡ID |
cardNo | string | — | 质保卡号，如 WC-20260201-019 |
granularity | string | — | 颗粒度：SN级/订单行级/订单级/合同级/服务级 |
customerId | integer(int64) | — | 客户ID |
customerName | string | — | 客户名称（快照） |
customerPhone | string | — | 客户手机号 |
productName | string | — | 产品名称 |
productModel | string | — | 型号 |
productCategory | string | — | 产品品类 |
sn | string | — | SN |
batchNo | string | — | 批次号 |
qty | number | — | 数量 |
startDate | string(date-time) | — | 起保日；「按激活日期」起算且未激活时为空 |
endDate | string(date-time) | — | 到保日（已含历次延保） |
startMethod | string | — | 起算方式 |
months | integer(int32) | — | 质保月数 |
graceDays | integer(int32) | — | 过保宽限天数 |
activatedAt | string(date-time) | — | 客户激活时间 |
activationFallbackDays | integer(int32) | — | 未激活兜底天数 |
daysRemaining | integer(int64) | — | 距到保日剩余天数，负数为已超期；待激活时为空 |
coverage | string[] | — | 覆盖范围 |
responsible | string | — | 责任主体：我方/原厂/代理商 |
exclusions | string[] | — | 免责条款，一行一条 |
policyId | integer(int64) | — | 命中的质保规则ID |
policyName | string | — | 规则名称（快照） |
salesOrderNo | string | — | 来源销售订单号 |
contractNo | string | — | 合同号 |
projectName | string | — | 项目名 |
supplierName | string | — | 供应商（原厂） |
supplierWarrantyEnd | string(date-time) | — | 供应商质保截止 |
supplierGap | boolean | — | 上游断保风险：供应商质保截止早于本卡到保日 |
serviceCount | integer(int32) | — | 累计服务次数 |
status | string | — | 状态：待激活/在保/即将到期/宽限期/已过保/已终止 |
isTerminated | integer(int32) | — | 是否已终止：0否 1是 |
source | string | — | 来源：销售单生成/手工补录/服务级换新 |
originalMonths | integer(int32) | — | 调整前月数 |
originalStartDate | string(date-time) | — | 调整前起保日 |
originalEndDate | string(date-time) | — | 调整前到保日 |
originalStartMethod | string | — | 调整前起算方式 |
adjustedBy | string | — | 调整人 |
adjustedAt | string(date-time) | — | 调整时间 |
adjustReason | string | — | 调整/终止/恢复原因 |
note | string | — | 备注 |
createdBy | string | — | 创建人 |
createTime | string(date-time) | — | 创建时间 |
items8 | ServiceWarrantyCardItemVO[] | — | 覆盖产品清单（订单级质保卡） |
extensions12 | ServiceWarrantyCardExtensionVO[] | — | 延保记录，按操作时间正序 |
audits8 | ServiceWarrantyCardAuditVO[] | — | 状态变更审计（终止/恢复/改期），按操作时间正序 |
错误处理
响应统一信封 { code, message, data }，code == 200 为成功。以下是本接口可能返回的开放平台层错误：
| 错误码 | 说明 | 可重试 |
|---|---|---|
| 92101 | 访问凭证无效 | 否 |
| 92201 | 接口未登记或已停用 | 否 |
| 92202 | 超出凭证授权范围——本接口需 sales:read | 否 |
| 92204 | 绑定员工无此接口的功能权限 | 否 |
| 92203 | 上游服务调用失败 | 是 |
| 92301 | 请求过于频繁 | 是 |
除此之外，comap-sales 自身的业务校验失败会原样透传其业务码与提示
（如字段校验、状态不允许、数据不存在），这类码不在开放平台的号段内，
以响应里的 message 为准。完整的平台层错误码见错误码说明。