改派工单

将流程工单当前节点改派给其他坐席或客服组，面向流程工单当前节点改派，与 /transfer 的普通转交不同。toStaffId 和 toGroupId 二选一，两者同时为空或同时不为空均会报错；改派前会校验工单是否已被删除。processInstanceExeId 为流程节点执行记录 ID，可选，传入后定向改派指定节点。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和
checksumAlgorithm	int32	否	签名算法：0 - 默认(SHA1)，1 - SHA256

请求体

名称	类型	必填	描述	示例值
ticketId	int64	是	工单 ID	123456
staffId	int64	是	操作坐席 ID	10001
processInstanceExeId	int64	否	画布流程节点执行记录 ID	567890
comment	string	否	改派原因	当前节点需由财务专员跟进退款到账。
attachments	string	否	附件列表 JSON 字符串，每项：{type, payload, fileName}	[{"type":2,"payload":"openapi/attachments/2024/07/refund-proof.pdf","fileName":"退款凭证.pdf"}]
toStaffId	int64	否	改派目标坐席 ID（与 toGroupId 二选一）	10002
toGroupId	int64	否	改派目标客服组 ID（与 toStaffId 二选一）	20001

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
message	string	提示信息：成功时为业务数据，失败时为错误描述	true

错误码

状态码	描述
14004	ticketId 或 staffId 为空；toStaffId 与 toGroupId 同时为空或同时存在；JSON 格式错误
14100	staffId 不存在或已停用
14106	工单已被删除
14500	服务内部异常

postEndpoint

/openapi/v2/ticket/reassign

curl -X POST "https://qiyukf.com/openapi/v2/ticket/reassign?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "ticketId": 123456,    "staffId": 10001  }'

{
  "code": 200,
  "message": "true"
}

{
  "code": 14004,
  "message": "ticketId 或 staffId 为空；toStaffId 与 toGroupId 同时为空或同时存在；JSON 格式错误"
}

{
  "code": 14100,
  "message": "staffId 不存在或已停用"
}

{
  "code": 14106,
  "message": "工单已被删除"
}

{
  "code": 14500,
  "message": "服务内部异常"
}