# 待办推送规范

注: 所有时间均为毫秒单位时间戳

# 推送待办数据接口

该接口为业务系统向代办中心推送数据,提供具体业务系统的待办信息。

# 请求路径:

/business/batch

# 请求方法:

POST

# 请求参数:

名称 是否必填 类型 字段名
systemCode String 待办对应的应用系统编号
systemName String 待办对应的应用系统名称
bizCode String 业务功能编码
ptype String 待办类别
workflowId String 流程ID
pid String 待办ID
ptitle String 待办标题
pdatetime long 待办发起时间 (接收时间,指当前登录用户接收待办、待阅的时间,按该时间倒序排列;比如:当前登录用户为叶英杰,该时间为叶英杰接收到待办、待阅的时间;)
pcreatorId String 发起人ID
pcreator String 发起人姓名
ptoUserId String 办理人ID
ptoUserName String 办理人姓名
pendDatetime long 截至时间
preDatetime long 催办时间
pcUrl String PC端URL
mobileUrl String MOBIL端URL
auditNode String 处理节点
auditView String 处理意见 (指当前登录用户处理待办、待阅的操作时所填写的意见;比如:当前登录用户为叶英杰,在点击“办毕”前填写的处理意见;)
auditTime long 处理时间 (指当前登录用户处理待办、待阅的操作时间,并按该时间倒序排列;比如:当前登录用户为叶英杰,点击“办毕”按钮的操作时间;)
emergencyType String 紧急程度 特急、加急、紧急、正常
sendMsg boolean true表示提醒,false表示不提醒(null为false)
readed boolean 是否已读,true表示已读,false表示未读(null为false)

# 示例

  • 请求范例:
POST /business/batch
Host: server.example.com
1
2
  • 请求参数范例:
[
    {
        "systemCode": "SPEED_DOG",
        "systemName": "快狗配送",
        "bizCode": null,
        "ptype": "DS",
        "workflowId": "5",
        "pid": "1",
        "ptitle": "关于持续强化落实疫情防控措施---4",
        "pdatetime": 1647855667000,   
        "pcreatorId": "17126",
        "pcreator": "王琳",
        "ptoUserId": "1",
        "ptoUserName": "叶英杰",
        "pendDatetime": null,
        "preDatetime": null,
        "pcUrl": "1",
        "mobileUrl": "2",
        "auditNode": "1.政务审查",
        "auditTime": 1645750098000,
        "auditView": "",
        "emergencyType": "正常",
        "sendMsg": true
    },
    {
        ...
    }
]

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
  • 响应范例:
{
    "uuid": "8c04446b-fa04-4490-812e-0b2522957283",
    "code": "000000",
    "msg": "成功",
    "data": true,
    "ok": true
}
1
2
3
4
5
6
7

# 更新待办数据接口

该接口为业务系统向代办中心更新数据,提供具体业务系统的待办信息。

# 请求路径:

/business/batch

# 请求方法:

PUT

# 请求参数:

名称 是否必填 类型 字段名
systemCode String 待办对应的应用系统编号
systemName String 待办对应的应用系统名称
bizCode String 业务功能编码
ptype String 待办类别
workflowId String 流程ID
pid String 待办ID
ptitle String 待办标题
pdatetime Date 待办发起时间 (接收时间,指当前登录用户接收待办、待阅的时间,按该时间倒序排列;比如:当前登录用户为叶英杰,该时间为叶英杰接收到待办、待阅的时间;)
pcreatorId String 发起人ID
pcreator String 发起人姓名
ptoUserId String 办理人ID
ptoUserName String 办理人姓名
pendDatetime Date 截至时间
preDatetime Date 催办时间
pcUrl String PC端URL
mobileUrl String MOBIL端URL
auditNode String 处理节点
auditView String 处理意见 (指当前登录用户处理待办、待阅的操作时所填写的意见;比如:当前登录用户为叶英杰,在点击“办毕”前填写的处理意见;)
auditTime Date 处理时间 (指当前登录用户处理待办、待阅的操作时间,并按该时间倒序排列;比如:当前登录用户为叶英杰,点击“办毕”按钮的操作时间;)
emergencyType String 紧急程度 特急、加急、紧急、正常
sendMsg boolean true表示提醒,false表示不提醒(null为false)
readed boolean 是否已读,true表示已读,false表示未读(null为false)

# 示例

  • 请求范例:
PUT /business/batch
Host: server.example.com
1
2
  • 请求参数范例:
[
    {
        "systemCode": "SPEED_DOG",
        "systemName": "快狗配送",
        "bizCode": null,
        "ptype": "YS",
        "workflowId": "5",
        "pid": "1",
        "ptitle": "关于持续强化落实疫情防控措施---5",
        "pdatetime": 1647855668000,
        "pcreatorId": "17126",
        "pcreator": "王琳",
        "ptoUserId": "1",
        "ptoUserName": "叶英杰",
        "pendDatetime": null,
        "preDatetime": null,
        "pcUrl": "1",
        "mobileUrl": "2",
        "auditNode": "1.政务审查",
        "auditTime": 1645750098000,
        "auditView": "",
        "emergencyType": "正常",
        "sendMsg": true
    },
    {
        ...
    }
]

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
  • 响应范例:
{
    "uuid": "7178e5ec-dfa3-475e-b65c-56896500db4a",
    "code": "000000",
    "msg": "成功",
    "data": true,
    "ok": true
}
1
2
3
4
5
6
7

# 催办接口

该接口为业务系统向代办中心推送数据,提供具体业务系统的待办信息。

# 请求路径:

/business/press

# 请求方法:

POST

# 请求参数:

名称 是否必填 类型 字段名
workflowId String 流程ID
pid String 待办ID
systemCode String 待办对应的应用系统编号
ptoUserId String 办理人ID

# 示例

  • 请求范例:
POST /business/press
Host: server.example.com
1
2
  • 请求参数范例:
systemCode=SPEED_DOG&workflowId=13&pid=1&ptoUserId=1
1
  • 响应范例:
{
    "uuid": "a3ab02bc-31e8-4c85-8e65-6cfad02c540e",
    "code": "000000",
    "msg": "成功",
    "data": true,
    "ok": true
}
1
2
3
4
5
6
7

# 删除待办数据接口

该接口为业务系统向代办中心删除数据,提供具体业务系统的必要信息。

# 请求路径:

/business/batch

# 请求方法:

DELETE

# 请求参数:

名称 是否必填 类型 字段名
systemCode String 待办对应的业务系统编码
workflowId String 流程ID
pid String 待办ID
ptoUserId String 办理人ID

# 示例

  • 请求范例:
DELETE /business/batch
Host: server.example.com
1
2
  • 请求参数范例:
[
    {
        "systemCode": "SPEED_DOG",
        "workflowId": "15",
        "pid": "1",
        "ptoUserId": "1"
    },
     {
        "systemCode": "SPEED_DOG",
        "workflowId": "5",
        "pid": "1",
        "ptoUserId": "1"
    }
]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
  • 响应范例:
{
    "uuid": "a37fdf28-f2c2-4fd1-b57b-840d68bb7745",
    "code": "000000",
    "msg": "成功",
    "data": true,
    "ok": true
}
1
2
3
4
5
6
7

# 数据查询接口

该接口为业务系统向代办中心删除数据,提供具体业务系统的必要信息。

# 请求路径:

business/query

# 请求方法:

GET

# 请求参数:

名称 是否必填 类型 字段名
systemCode String 待办对应的业务系统编码
workflowId String 流程ID
pid String 待办ID
ptoUserId String 办理人ID
ptype String 待办类别
startTime String 开始时间[yyyy-MM-dd HH:mm:ss]
endTime String 结束时间[yyyy-MM-dd HH:mm:ss]

查询只支持一年内数据查询

startTime与endTime且存在,时间查询生效,开始时间与结束时间跨度不能超过1月

# 示例

  • 请求范例:
GET /pre-deal/business/query?systemCode=JJHT
Host: server.example.com
1
2
  • 响应范例:
{
    "uuid": "f307e7ae-5592-4910-a9aa-584cbf5930aa",
    "code": "000000",
    "msg": "成功",
    "data": {
        "id": "1496775041512652806",
        "systemCode": "JJHT",
        "systemName": "计价合同",
        "bizCode": null,
        "ptype": "YS",
        "workflowId": "1",
        "pid": "1",
        "ptitle": "政策信息研究(基建投资专辑)",
        "pdatetime": 1645350067000,
        "pcreator": "王琳",
        "pcreatorId": "17126",
        "ptoUserCode": null,
        "ptoUserId": "1",
        "ptoUserName": "叶英杰",
        "pendDatetime": null,
        "preDatetime": null,
        "pcUrl": "http://www.baidu.com",
        "mobileUrl": "http://www.baidu.com",
        "auditNode": "6.部门传阅",
        "auditTime": 1645750098000,
        "auditView": "",
        "emergencyType": "正常",
        "sendMsg": false,
        "readed":true
    },
    "ok": true
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32