GET 服务工单详情

GET 查询服务工单详情（含设备明细、服务项目/收费行、附件、自定义字段、可执行动作）。query 参数：id（必填，服务工单ID）。

接口编码	所需范围	后端接口
sales.service-order.detail	sales:read	GET /v1/service-orders/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-order.detail",
    "query": {
      "id": "1961000000000000001"
    }
  }'

响应 data 字段

字段	类型	必填	说明
id	integer(int64)	—	工单ID
orderNo	string	—	工单编号
title	string	—	工单标题
type	string	—	工单类型
source	string	—	报修来源
primarySourceType	string	—	主要关联来源类型
primarySourceNo	string	—	主要关联来源单号
status	string	—	工单状态（原始值）
canonicalStatus	string	—	归一后的规范状态
derivedView	string	—	派生视图码：appointment（待预约），其余为空
urgency	string	—	紧急程度
isShutdown	integer(int32)	—	是否停机：0否 1是
customerId	integer(int64)	—	客户ID
customerName	string	—	客户名称
contactPerson	string	—	联系人
contactPhone	string	—	联系电话
usageLocation	string	—	产品使用地
usageLocationCorrected	integer(int32)	—	使用地是否由现场提交人纠正：0否 1是
repairTicketId	integer(int64)	—	来源报修单ID
repairTicketNo	string	—	来源报修单号
productName	string	—	主产品名称
productModel	string	—	主产品型号
sn	string	—	主产品SN
warrantyStatus	string	—	质保状态：质保内/已过保/未配置质保/需人工判断
assigneeId	integer(int64)	—	负责工程师ID
assignee	string	—	负责工程师姓名
dept	string	—	所属服务团队
serviceMode	string	—	服务方式
needAppointment	integer(int32)	—	是否需要预约：0否 1是
planStart	string(date-time)	—	计划上门时间
isOvertime	integer(int32)	—	是否超时：0否 1是
slaDeadlineAt	string(date-time)	—	响应截止时间
slaPausedAt	string(date-time)	—	当前暂停开始时间
slaBreachedAt	string(date-time)	—	实际超时时间点
responseMins	integer(int32)	—	响应时长（分钟）
mergedIntoId	integer(int64)	—	被合并到的目标工单ID
splitFromId	integer(int64)	—	拆分来源父工单ID
isChargeable	integer(int32)	—	是否有偿服务：0否 1是
serviceLiability	string	—	服务责任：free免费服务 / quote需要报价 / pending待人工判定
chargeStatus	string	—	商业状态
partRequestCount	integer(int32)	—	关联备件申请数量
unreconciledPartQty	number	—	备件未闭环数量合计
confirmStatus	string	—	客户确认状态
createdBy	string	—	创建人
createTime	string(date-time)	—	创建时间
customFields	object	—	自定义字段值，key 为字段名；无读权限的字段不会出现
serviceAddress	string	—	服务地址
salesOrderId	integer(int64)	—	关联销售订单ID
salesOrderNo	string	—	关联销售订单号
contractId	integer(int64)	—	关联合同ID
contractNo	string	—	关联合同号
projectId	integer(int64)	—	关联项目ID
projectName	string	—	关联项目名称
warrantyStart	string(date-time)	—	质保起始（快照）
warrantyEnd	string(date-time)	—	质保截止（快照）
warrantyCardId	integer(int64)	—	主质保卡ID
warrantyCardIds	string	—	全部匹配到的质保卡ID，逗号分隔
faultDescription	string	—	问题描述 / 服务内容
symptom	string	—	故障现象
impact	string	—	影响范围
expectedTime	string(date-time)	—	客户期望时间
planEnd	string(date-time)	—	预计结束时间
handleHours	number	—	处理时长（小时）
submittedDevice	string	—	提交渠道设备
rejectReason	string	—	驳回/拒单原因
slaLevel	string	—	SLA 等级
slaTotalPausedMins	integer(int32)	—	累计暂停分钟数
slaPauseReason	string	—	暂停原因
splitNote	string	—	拆分说明
mergedFromIds	integer(int64)[]	—	合并进来的源工单ID列表
childIds	integer(int64)[]	—	拆分出的子工单ID列表
items30	ServiceOrderItemVO[]	—	涉及产品明细
primarySourceId	integer(int64)	—	主要关联来源ID
primarySourceStorageType	string	—	主要关联来源存储类型
acceptanceChannel	string	—	受理渠道
serviceCustomerId	integer(int64)	—	服务客户ID
serviceCustomerName	string	—	服务客户名称
contractCustomerId	integer(int64)	—	合同客户ID
contractCustomerName	string	—	合同客户名称
settlementCustomerId	integer(int64)	—	结算客户ID
settlementCustomerName	string	—	结算客户名称
sourceVersion	integer(int32)	—	来源版本（来源重确认乐观锁，重确认时需原样回传）
fees27	ServiceOrderFeeVO[]	—	费用行（含五态收费责任，逐项核定用）
attachments8	ServiceAttachmentVO[]	—	工单附件
allowedActions	string[]	—	当前允许的操作动作码
closeType	string	—	关闭类型
closeReason	string	—	关闭原因
closedAt	string(date-time)	—	关闭时间
closedBy	string	—	关闭操作人
closedFromStatus	string	—	关闭前的工单状态
serviceCycleNo	integer(int32)	—	服务周期号
updateTime	string(date-time)	—	更新时间
version	integer(int32)	—	乐观锁版本，编辑时需原样回传

错误处理

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

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

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

← 返回服务工单