单据共享人员查询

  • 接口:common/document/share/findByCode
  • Method:GET
  • 接口说明:根据单据号查询单据的人员共享信息(include_users超过200条,仅返回前200条数据;因会distinct查询的结果,实际数据可能会不足200条)

请求参数

字段名称 字段类型 字段描述 是否必填 长度
bizId String 业务唯一识别码 true 255
timestamp long 时间戳 true 无
code String 单据号 true 64

返回参数

默认返参

字段名称 字段类型 字段描述
resCode Integer 状态码
resMsg String 描述
data.all_users_flag String 全部用户的标签,Y表示该公司所有用户均被共享该单据
data.include_users JSONArray 被共享的用户
data.include_departments JSONArray 被共享的用户

被共享的用户返参

字段名称 字段类型 字段描述
include_users.full_name String 全名
include_users.code String 用户名
include_users.user_name String 用户名
include_users.employee_number String 员工号
include_users.email_address String 邮箱
include_users.creation_date date 创建日期
include_users.last_update_date date 最后更新日期

请求示例

/common/document/share/findByCode?code=REQ0000000007&bizId=d06ad8ed-902e-4417-848d-cdf5ef723fa2&timestamp=1657629989000

返回示例

正常返回示例

{
    "resCode": 200000,
    "resMsg": "success",
    "bizId": "d06ad8ed-902e-4417-848d-cdf5ef723fa2",
    "data": {
        "include_users": [
            {
                "code": "yrhch10@163.com",
                "gender": "M",
                "nationality": "CHN",
                "creation_date": 1616633572000,
                "last_update_date": 1691459134000,
                "email_address": "yrhch10@163.com",
                "full_name": "测试小号006",
                "employee_number": "yrhch10@163.com",
                "user_name": "yrhch10@163.com",
                "start_work_date": "2021-06-07 00:00:00",
                "credit_score": -30,
                "default_language": "zh_CN",
                "equipment_type": "",
                "equipment_id": ""
            },
            {
                "mobile": "13112345671",
                "gender": "F",
                "surname": "一1",
                "nationality": "CHN",
                "creation_date": 1675561846000,
                "last_update_date": 1678347766000,
                "email_address": "yrhch1@163.com4",
                "full_name": "多租户025",
                "user_name": "yrhch1025@cp",
                "given_name": "二2",
                "equipment_type": "",
                "equipment_id": "",
                "description": "测试用户1"
            }
        ],
        "include_departments": [
            {
                "code": "D010",
                "column7": "",
                "column10": "212956",
                "type": "B",
                "phone": "121223333",
                "department_name": "方外人事有限公司",
                "department_code": "D010",
                "sequence_num": 630,
                "approval_level": 10,
                "company_name": "方外人事有限公司",
                "tax_number": "FY00000000001",
                "tax_address": "方外人事有限公司",
                "bank_name": "阿斯顿发送到发送到发",
                "account_number": "123123123213",
                "currency_code": "CNY",
                "receipt_currency": "CNY",
                "invoicing_limit_number": 10000.00,
                "invoicing_limit_number_common": 10000.00,
                "invoicing_limit_number_roll": 10000.00,
                "cost_center_flag": "Y",
                "budget_flag": "Y",
                "budget_control": "Y",
                "ledger_id": 17589,
                "enabled_flag": "Y"
            },
            {
                "code": "C010103",
                "column1": "1",
                "column10": "212956",
                "type": "B",
                "ledger2": 35213,
                "department_name": "北京仁科互动网络技术有限公司",
                "department_code": "C010103",
                "sequence_num": 30,
                "company_name": "北京仁科互动网络技术有限公司",
                "tax_number": "49092489939209946YKM",
                "currency_code": "TWD",
                "cost_center_flag": "Y",
                "budget_flag": "Y",
                "budget_control": "Y",
                "ledger_id": 34717,
                "enabled_flag": "Y"
            }
        ]
    }
}

单据号不存在返回示例

{
    "resCode": 400000,
    "resMsg": "单据号:REQ00000000071不存在",
    "bizId": "d06ad8ed-902e-4417-848d-cdf5ef723fa2"
}

include_users查询出来的数量超过200条返回示例

{
    "resCode": 200000,
    "resMsg": "include_users超过200条,仅返回前200条数据",
    "bizId": "d06ad8ed-902e-4417-848d-cdf5ef723fa2",
    "data": {
        "include_users": [
            {
                "code": "test23",
                "column2": "1888990889",
                "mobile": "11111111111",
                "gender": "M",
                "nationality": "ABW",
                "last_update_date": 1671174176000,
                "email_address": "room_yuy@hotmail.com",
                "full_name": "tes23",
                "employee_number": "test23",
                "user_name": "room_yuy@hotmail.com",
                "given_name": "",
                "wechatqy_name": "gfdsdfsg",
                "dingtalk_name": "fsdfsdg",
                "default_language": "zh_CN",
                "description": "Yuyang"
            }
          // ...
        ]
    }
}

results matching ""

    No results matching ""