单据共享人员新增
- 接口:common/document/share/department
- Method:POST
- 接口说明:根据单据号增加单据的人员共享信息
请求参数
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度 |
document_num |
String |
单据号(放在requestParam上) |
true |
64 |
bizId |
String |
当前次接口同步的唯一标识 |
TRUE |
36 |
timestamp |
long |
当前次接口同步对应的时间戳 |
TRUE |
13 |
data |
JSONArray |
当前次接口同步的数据集合 |
TRUE |
无 |
data.code |
String |
部门代码 |
true |
64 |
data.sequence_num |
String |
序号 |
false |
10 |
返回参数
默认返参
字段名称 |
字段类型 |
字段描述 |
bizId |
String |
当前次接口同步的唯一标识 |
resCode |
Integer |
状态码 |
resMsg |
String |
描述 |
data.validatorErrors |
JSONArray |
字段强校验不合格的数据 |
请求示例
/common/document/share/department?document_num=REQ0000000007
{
"bizId": "c39cd6df-0783-4dff-b70c-f5a33e55ed5f",
"timestamp": 1669187455000,
"data": [
{
"code": "D010",
"sequence_num": 99
}
]
}
返回示例
正常返回示例
{
"resCode": 200000,
"resMsg": "success",
"bizId": "c39cd6df-0783-4dff-b70c-f5a33e55ed5f",
"data": {
"validatorErrors": {},
"warnings": {}
}
}
单据号不存在返回示例
{
"resCode": 200000,
"resMsg": "success",
"bizId": "c39cd6df-0783-4dff-b70c-f5a33e55ed5f",
"data": {
"validatorErrors": {
"REQ00000000071": [
"单据号:REQ00000000071 不存在!"
]
},
"warnings": {}
}
}
该单据状态下无法共享返回示例
{
"resCode": 200000,
"resMsg": "success",
"bizId": "c39cd6df-0783-4dff-b70c-f5a33e55ed5f",
"data": {
"validatorErrors": {
"REQ00000000071": [
"单据号:REQ0000000007 非approved/closed状态,无法共享"
]
},
"warnings": {}
}
}
该单据未开启可共享配置
{
"resCode": 200000,
"resMsg": "success",
"bizId": "c39cd6df-0783-4dff-b70c-f5a33e55ed5f",
"data": {
"validatorErrors": {
"REQ00000000071": [
"单据号:REQ0000000007 未启用共享配置,请先启用"
]
},
"warnings": {}
}
}
部门不存在返回示例
{
"resCode": 200000,
"resMsg": "success",
"bizId": "c39cd6df-0783-4dff-b70c-f5a33e55ed5f",
"data": {
"validatorErrors": {
"REQ0000000007": [
"部门代码:D010 不存在或未启用"
]
},
"warnings": {}
}
}
该单据已存在该部门的共享返回示例
{
"resCode": 200000,
"resMsg": "success",
"bizId": "c39cd6df-0783-4dff-b70c-f5a33e55ed5f",
"data": {
"validatorErrors": {
"REQ0000000007": [
"部门代码:D010 已存在共享"
]
},
"warnings": {}
}
}