开放接口API说明-员工帐号接口

参数名称 参数描述
应用编码 employee
应用版本 v2
接口名称 新增员工
接口编码 addEmployee
接口URL https://openapi.waiqin365.com/api/employee/v2/addEmployee/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
emp_id VARCHAR(32) 来源第三方系统的员工唯一标识
emp_code VARCHAR(100) 员工登录帐号,必须唯一,有效字符详见附录:编码类型参照表
emp_password VARCHAR(32) 员工登录帐号密码
force_modify_password CHAR(1) 首次登陆客户端是否强制修改密码,1-强制修改 0-不强制修改,默认值:1
emp_name VARCHAR(100) 员工名称,唯一,有效字符详见附录:编码类型参照表
emp_sex CHAR(1) 员工性别,F-女性 M-男性,默认值:M
emp_mobile VARCHAR (12) 员工手机号码,默认值:11111111111
emp_tel VARCHAR (13) 固定电话,示例:025-68736873
emp_idcard VARCHAR(20) 身份证号码
emp_birthday CHAR(10) 生日,格式:yyyy-MM-dd
emp_email VARCHAR(100) 邮箱
emp_addr VARCHAR(500) 地址
emp_qq VARCHAR(100) QQ
emp_weixin VARCHAR(100) 微信
emp_org_id VARCHAR(32) 隶属部门,来源第三方系统的部门ID,参考部门信息接口中的org_id字段说明
emp_is_org_learder CHAR(1) 是否部门领导, 0-否 1-是,默认值:0
emp_parent_id VARCHAR(32) 来源第三方系统的员工上级唯一标识,和员工信息接口中的emp_id字段相对应
emp_imsi_binding CHAR(1) 账号绑定手机卡,0不绑定 1绑定。默认值:1
emp_position VARCHAR(100) 职务名称
emp_job VARCHAR(100) 岗位名称
emp_status CHAR(1) 员工账号状态,0-销户 1-正常 2-停用 ,默认值:1
emp_roles VARCHAR(500) 同步员工角色名称,多个角色用“,”分割,如:“考勤员,员工(系统)”。
默认开通角色为:员工(系统)
emp_products VARCHAR(500) 同步员工开通的产品名称,多个产品用“,”分割,如:“商贸版,定位版”。
默认不开通产品
emp_model VARCHAR(100) 开通定位版时指定定位组名称
emp_attendance_group VARCHAR(100) 指定员工考勤组名称
exts[].ext_key VARCHAR(1000) 扩展字段名称
exts[].ext_value VARCHAR(1000) 扩展字段值
响应信息 参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明

// 请求消息体示例:
{
    "emp_id": "EMP0001",
    "emp_code": "zhangsan",
    "emp_password": "123456",
    "emp_name": "张三",
    "emp_sex": "F",
    "emp_mobile": "13812301230",
    "emp_tel": "025-88888888",
    "emp_idcard": "323089198305161234",
    "emp_birthday": "1983-05-16",
    "emp_email": "niubi@waiqin365.com",
    "emp_addr": "南京市建邺区云龙山路88号",
    "emp_org_id": "ORG0001",
    "emp_is_org_learder": "0",
    "emp_parent_id": "EMP001",
    "emp_imsi_binding": "1",
    "emp_position": "研发",
    "emp_job": "测试工程师",
    "emp_roles": "领导(系统)",
    "emp_products": "商贸版,DMS,定位版",
    "emp_model": "销售任务模板",
    "exts": [
        {
            "ext_key": "考勤ID号",
            "ext_value": "123456789"
        },
        {
            "ext_key": "字段名称",
            "ext_value": "字段值"
        }
    ]
}

// 成功响应信息示例
{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

// 失败响应信息示例
{
    "msg_id": "X000001",
    "return_code": 100201,
    "return_msg": "员工唯一标识已经存在!"
}
                  
参数名称 参数值
应用编码 employee
应用版本 v2
接口名称 修改员工信息
接口编码 modifyEmployee
接口URL https://openapi.waiqin365.com/api/employee/v2/modifyEmployee/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
emp_id VARCHAR(32) 需要修改的员工来源第三方系统的员工唯一标识和id字段二者至少填一个,
同时存在时以id优先
id VARCHAR(32) 需要修改的员工外勤365唯一ID,和emp_id只需要其中任意一个,
同时存在时以id优先
emp_code VARCHAR(100) 员工登录帐号,唯一,有效字符详见附录:编码类型参照表
emp_password VARCHAR(32) 员工登录帐号密码
force_modify_password CHAR(1) 首次登陆客户端是否强制修改密码,1-强制修改 0-不强制修改,默认值:1
emp_name VARCHAR(100) 员工名称,唯一,有效字符详见附录:编码类型参照表
emp_sex CHAR(1) 员工性别,F-女性 M-男性,默认值:M
emp_mobile VARCHAR (12) 员工手机号码,默认值:11111111111
emp_tel VARCHAR(13) 固定电话,示例:025-68736873
emp_idcard VARCHAR(20) 身份证号码
emp_birthday CHAR(10) 生日,格式:yyyy-MM-dd
emp_email VARCHAR(100) 邮箱
emp_addr VARCHAR(500) 地址
emp_qq VARCHAR(100) QQ
emp_weixin VARCHAR(100) 微信
emp_org_id VARCHAR(32) 来源第三方系统的部门ID
waiqin365_org_id VARCHAR(32) 外勤365中部门唯一标识ID,
和emp_org_id同时存在时优先取waiqin365_org_id值
emp_is_org_learder CHAR(1) 是否部门领导, 0-否 1-是,默认值:0
emp_parent_id VARCHAR(32) 来源第三方系统的员工上级唯一标识,有效字符详见附录:编码类型参照表
waiqin365_parent_id VARCHAR(32) 外勤365员工上级唯一标识,
和emp_parent_id同时存在时优先取waiqin365_parent_id值
emp_imsi_binding CHAR(1) 手机卡绑定,0-不绑定 1-绑定,默认值:1
emp_position VARCHAR(100) 职务名称
emp_job VARCHAR(100) 岗位名称
emp_status CHAR(1) 员工账号状态,0-销户 1-正常 2-停用 ,默认值:1
emp_attendance_group VARCHAR(100) 设置员工考勤组名称
exts[].ext_key VARCHAR(1000) 扩展字段名称
exts[].ext_value VARCHAR(1000) 扩展字段值
响应信息 参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明

// 请求消息体示例:
{
    "emp_id": "EMP0001",
    "emp_code": "zhangsan",
    "emp_password": "123456",
    "emp_name": "张三",
    "emp_sex": "F",
    "emp_tel": "025-88888888",
    "emp_idcard": "323089198305161234",
    "emp_birthday": "1983-05-16",
    "emp_email": "niubi@waiqin365.com",
    "emp_addr": "南京市建邺区云龙山路88号",
    "emp_org_id": "ORG0001",
    "emp_is_org_learder": "0",
    "emp_parent_id": "EMP001",
    "emp_status": "1",
    "emp_imsi_binding": "true",
    "emp_position": "研发",
    "emp_job": "测试工程师",
    "exts": [
        {
            "ext_key": "考勤ID号",
            "ext_value": "123456789"
        },
        {
            "ext_key": "字段名称",
            "ext_value": "字段值"
        }
    ]
}

// 成功响应信息示例
{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

// 失败响应信息示例
{
    "msg_id": "X000001",
    "return_code": 100205,
    "return_msg": "员工唯一标识不存在"
}
                  
参数名称 参数值
应用编码 employee
应用版本 v2
接口名称 删除员工帐号
接口编码 removeEmployee
接口URL https://openapi.waiqin365.com/api/employee/v2/removeEmployee/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
emp_id VARCHAR(32) 第三方系统员工唯一标识,有效字符详见附录:编码类型参照表
id VARCHAR(32) 外勤365员工唯一ID,和emp_id仅传其中之一即可,优先使用id
响应信息 参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明

// 请求消息体示例:
{
    "emp_id": "EMP0001"
}

// 响应信息示例:
{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}
                  
参数名称 参数值
应用编码 employee
应用版本 v2
接口名称 查询员工帐号
接口编码 queryEmployee
接口URL https://openapi.waiqin365.com/api/employee/v2/queryEmployee/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
id VARCHAR(19) 根据来源外勤365的员工唯一标识精确查询
emp_id VARCHAR(32) 根据来源第三方系统的员工唯一标识精确查询,如果查询条件包含id参数,优先根据id查询
emp_code VARCHAR(100) 根据员工登录帐号精确查询
emp_name VARCHAR(100) 根据员工名称模糊查询
emp_status CHAR(1) 根据员工状态查询
create_date CHAR(10) 根据创建日期查询用户,格式:“yyyy-MM-dd”
modify_date CHAR(10) 根据修改日期查询用户,格式:“yyyy-MM-dd”
响应信息 参数 类型 必填 说明
id VARCHAR(32) 外勤365的员工唯一标识
emp_id VARCHAR(32) 来源第三方系统的员工唯一标识
emp_code VARCHAR(100) 员工登录帐号
emp_name VARCHAR(100) 员工名称
emp_sex CHAR(1) 员工性别,F-女性 M-男性
emp_mobile VARCHAR(12) 员工手机号码
emp_tel VARCHAR(13) 固定电话,示例:025-68736873
emp_idcard VARCHAR(20) 身份证号码
emp_birthday CHAR(10) 生日,格式:yyyy-MM-dd
emp_email VARCHAR(100) 邮箱
emp_addr VARCHAR(500) 地址
emp_qq VARCHAR(100) QQ
emp_weixin VARCHAR(100) 微信
emp_org_id VARCHAR(100) 来源第三方系统隶属部门
emp_org_code VARCHAR(100) 隶属部门编码
waiqin365_org_id VARCHAR(32) 外勤365部门唯一标识
emp_is_org_learder CHAR(1) 是否机构领导, 0-否 1-是
emp_parent_id VARCHAR(100) 来源第三方系统,员工上级唯一标识
parent_code VARCHAR(100) 员工上级编码
waiqin365_parent_id VARCHAR(32) 外勤365员工上级唯一标识
emp_imsi_binding CHAR(1) 手机卡绑定,0-不绑定 1-绑定
emp_position VARCHAR(100) 职务名称
emp_job VARCHAR(100) 岗位名称
emp_status CHAR(1) 员工账号状态,0-销户 1-正常 2-停用
create_time VARCHAR(32) 创建时间,格式:“yyyy-MM-dd HH:mm:ss”
modify_time VARCHAR(32) 修改时间,格式:“yyyy-MM-dd HH:mm:ss”
exts[].ext_key VARCHAR(1000) 扩展字段名称
exts[].ext_value VARCHAR(1000) 扩展字段值

// 请求消息体示例:
{
    "emp_id": "ORG00001"
}

// 响应信息示例:
{
    "msg_id": "YY698688888",
    "response_data": "[
        {
            "id": "6526123236734933062",
            "emp_id": "YG0001",
            "emp_code": "zs",
            "emp_name": "张三",
            "emp_sex": "M",
            "emp_mobile": "13122222223",
            "emp_idcard": "",
            "emp_email": "zhangsan@waiqin365.com",
            "emp_addr": "南京市建邺区云龙山路88号",
            "emp_org_id": "ORG001",
            "emp_org_code": "DD001",
            "waiqin365_org_id": "6415931465210350521",
            "emp_parent_id": "YD0002",
            "parent_code": "lb",
            "waiqin365_parent_id": "8479750039739139535",
            "emp_is_org_learder": "false",
            "emp_status": "1",
            "emp_imsi_binding": 1,
            "create_time": "2017-09-09 13:14:11",
            "modify_time": "2018-09-09 13:14:11"
            "exts": [
                {
                    "ext_key": "文本框",
                    "ext_value": ""
                },
                {
                    "ext_key": "单选",
                    "ext_value": ""
                },
                {
                    "ext_key": "下拉框",
                    "ext_value": "选项1"
                },
                {
                    "ext_key": "考勤ID号",
                    "ext_value": ""
                }
            ]
        }
    ]",
    "return_code": 0,
    "return_msg": ""
}