单据共享人员新增

  • 接口：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.validatorErrors 中返回全部重复的员工号。

返回参数

默认返参

字段名称 字段类型 字段描述
bizId String 当前次接口同步的唯一标识
resCode Integer 状态码
resMsg String 描述
data.validatorErrors JSONObject 校验错误；key 为单据号，value 中包含重复员工号等错误信息
data.warnings JSONObject 警告信息

请求示例

/common/document/share/user?document_num=REQ0000000007

{
    "bizId": "c39cd6df-0783-4dff-b70c-f5a33e55ed5f",
    "timestamp": 1669187455000,
    "data": [
        {
            "code": "yw@qq.com"
        },
        {
            "code": "zhangsan"
        }
    ]
}

返回示例

正常返回示例

{
    "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": {
            "REQ0000000007": [
                "报文中存在重复的人员代码：yw@qq.com、zhangsan"
            ]
        },
        "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 ""