主题
新增待办
| 接口名称 | url | 请求方式 | 请求数据类型 |
|---|---|---|---|
| 新增待办数据 | /api/todo-center/analyze/todoPush | post | application/json |
请求参数
| 参数名称 | 二级参数 | 参数说明 | 是否必填 | 数据类型 | 备注说明 |
|---|---|---|---|---|---|
| type | 新增待办数据传参 todoSave | 是 | string | 接口类型，todoSave新增待办 | |
| appId | appId | 是 | string | 注册应用返回的client_id | |
| sourceId | 业务记录ID | 是 | string | 应用待办的唯一编号 | |
| batchId | 批次ID | 是 | string | 标识是同一条审批流程的编号，流程审批中，所有的待办batchId必须一致，否则将会出现问题 | |
| content | json字符串 业务处理字段 | 是 | string | 二级参数对象json编码 | |
| appId | appId | 是 | string | 注册应用返回的client_id | |
| type | 待办类型 | 是 | int | 0：审批类；1： 通知类； | |
| sourceId | 业务记录ID | 是 | string | 应用待办的唯一编号 | |
| batchId | 批次ID | 是 | string | 标识是同一条审批流程的编号，同一流程实例不同节点批次ID相同， 同上一级的值 | |
| content | 消息内容 | 否 | string | ||
| title | 标题 | 是 | string | ||
| receptionId | 接收人id，可以传多个逗号分隔 | 是 | string | 内部员工工号，三方人员为人员组织中心中顾问工号 | |
| senderId | 发送人id | 是 | string | 内部员工工号，三方人员为人员组织中心中顾问工号，如果没有发起人 传0为系统发起 | |
| startTime | 流程开始时间 2025-04-01 10:00:00 | 是 | string | ||
| exceedTime | 过期时间 2025-04-01 10:00:00 | 否 | string | ||
| exigency | 紧急程度 | 否 | int | 0普通，1紧急 2.特急（特急状态跟随超时时间去判断，不用传） 默认为0 | |
| asterisk | 星标 | 否 | int | 用户可在待办中心页面设置星标，不用传，0不限，1已设星标 默认为0 | |
| moduleSource | 模块来源 | 否 | string | ||
| url | pc跳转地址 | 是 | string | 用户在待办中心点击待办时跳转地址，跳转时会根据应用注册协议拼接凭证到URL后面，业务系统可根据统一认证相关接口获取用户信息 | |
| urlApp | app跳转地址 | 否 | string | 如果这个urlApp没有传 ITB默认会跳转到url的处理地址上 | |
| sysTag | 系统标识 | 否 | string | 系统标识 标识子系统 | |
| processStatus | 待办中心是否可处理 | 否 | Integer | 0-不可以处理（默认），1-可以处理 (如果设置为1 那么待办中心可以处理待办并修改待办状态,为0则不允许待办中心处理待办。设置为1需要提供回调接口 对接待办中心处理后回调同步待办状态) | |
| urgentStatus | 加急状态 | 否 | Integer | 0普通（默认） 1催办 | |
| pendingStatus | 暂挂状态 | 否 | Integer | 0普通 （默认）1 暂挂 |
发起人规范
- 如果存在明确的发起人（如员工发起）：
- 必须传入该发起人的
工号作为senderId的值。
- 如果是
系统自动触发的待办任务（如定时任务、服务调用等）：
senderId字段传入0即可，表示无明确人工发起人，后续在待办中心中将显示为"系统发起"。
batchId批次Id，一个流程审批上的所有待办节点，batchId必须一致。
json
curl --location '{{url}}/api/todo-center/analyze/todoPush' \
--header 'Content-Type: application/json' \
--data-raw '
{
"type":"todoSave",// 类型
"appId":"app12345",
"sourceId":"source67649",
"batchId":"batch54321",
"content":"{\"appId\":\"app12345\",\"type\":0,\"sourceId\":\"source67649\",\"batchId\":\"batch54321\",\"content\":\"请审批本月的报销申请。\",\"title\":\"报销审批待办\",\"receptionId\":\"user001\",\"senderId\":\"user002\",\"type\":\"0\",\"startTime\":\"2025-04-01 10:00:00\",\"exceedTime\":null,\"exigency\":1,\"asterisk\":0,\"moduleSource\":\"报销zs1\",\"url\":\"https://example.com/todo/12345\",\"urlApp\":\"https://mobile.example.com/todo/12345\"}"
}返回值
json
成功返回
{
"code": 200,
"message": null,
"data": true
}
错误返回
{
"code": 500,
"message": "系统异常",
"data": null
}