POST 质保规则匹配试算

POST 按「客户规则 → 产品规则 → 默认规则」优先级试算命中的质保规则（只读，不落库）。body 为 JSON：可选 productCategory（产品品类，匹配规则 scope）、customerType（战略客户/VIP客户）、orderType（项目类合同/电商订单），以及仅回显的 productName、productModel、customerId、customerName、salesOrderNo、contractNo。

接口编码	所需范围	后端接口
sales.service-warranty-rule.match	sales:read	POST /v1/service-orders/warranty-rule/match（comap-sales）

请求体字段（body）

字段	类型	必填	说明
productCategory	string	—	产品品类/分类，PRODUCT 层按此与规则 scope 双向包含匹配
productCategoryId	string	—	产品分类 ID，优先于产品分类文本参与逐级匹配
productId	integer(int64)	—	商品 ID；未提供分类时可用于查询商品主数据中的分类
productName	string	—	产品名称，仅回显不参与匹配
productModel	string	—	产品型号，仅回显不参与匹配
customerId	integer(int64)	—	客户ID，仅回显不参与匹配
customerName	string	—	客户名称，仅回显不参与匹配
customerType	string	—	客户类型：战略客户/VIP客户，CUSTOMER 层按此匹配规则 applyTo
orderType	string	—	订单/合同类型：项目类合同/电商订单，CUSTOMER 层按此匹配规则 applyTo
salesOrderNo	string	—	销售订单号，仅回显不参与匹配
contractNo	string	—	合同号，仅回显不参与匹配

「必填」仅反映接口规格声明的部分。服务内还有未体现在规格里的校验， 标「—」不等于可以不传；租户在主站配置的字段必填不约束本接口。 详见必填字段的判定与字段清单与自定义字段。

请求示例

curl -X POST https://open.risemap.cn/v1/api/invoke \
  -H "Authorization: Bearer <访问令牌>" \
  -H "Content-Type: application/json" \
  -d '{
    "apiCode": "sales.service-warranty-rule.match",
    "body": {}
  }'

响应 data 字段

字段	类型	必填	说明
matched	boolean	—	是否匹配到规则
levelCode	string	—	命中层级编码：CUSTOMER/PRODUCT/DEFAULT；未命中为 null
levelName	string	—	命中层级名称：客户特殊规则/产品规则/系统默认规则；未命中为 null
reason	string	—	命中/未命中的原因说明，可直接展示给用户
warrantyStatus	string	—	未命中时的工单质保状态建议值：未配置质保；命中时为 null
rule23	ServiceWarrantyRuleDetailVO	—	质保规则详情
layers5	ServiceWarrantyMatchLayerVO[]	—	逐层试算轨迹，按优先级顺序；用于排查「为什么走了兜底」
productCategory	string	—	回显：产品品类
productName	string	—	回显：产品名称
productModel	string	—	回显：产品型号
customerId	integer(int64)	—	回显：客户ID
customerName	string	—	回显：客户名称
customerType	string	—	回显：客户类型
orderType	string	—	回显：订单/合同类型
salesOrderNo	string	—	回显：销售订单号
contractNo	string	—	回显：合同号

错误处理

响应统一信封 { code, message, data }，code == 200 为成功。以下是本接口可能返回的开放平台层错误：

错误码	说明	可重试
92101	访问凭证无效	否
92201	接口未登记或已停用	否
92202	超出凭证授权范围——本接口需 sales:read	否
92204	绑定员工无此接口的功能权限	否
92203	上游服务调用失败	是
92301	请求过于频繁	是

除此之外，comap-sales 自身的业务校验失败会原样透传其业务码与提示 （如字段校验、状态不允许、数据不存在），这类码不在开放平台的号段内， 以响应里的 message 为准。完整的平台层错误码见错误码说明。

← 返回service-warranty-rule