单据共享人员新增

  • 接口：common/document/share/user
  • 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/user?document_num=REQ0000000007

{
    "bizId": "c39cd6df-0783-4dff-b70c-f5a33e55ed5f",
    "timestamp": 1669187455000,
    "data": [
        {
            "code": "yw@qq.com",
            "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": [
                "人员代码：yw@qq.com1 不存在或未启用"
            ]
        },
        "warnings": {}
    }
}

该单据已存在该员工的共享返回示例

{
    "resCode": 200000,
    "resMsg": "success",
    "bizId": "c39cd6df-0783-4dff-b70c-f5a33e55ed5f",
    "data": {
        "validatorErrors": {
            "REQ0000000007": [
                "人员代码：yw@qq.com 已存在共享"
            ]
        },
        "warnings": {}
    }
}

results matching ""

    No results matching ""