基础档案类

    person/edit


    目录

    1.接口说明

    1.1接口描述

         修改一个人员

    1.2适用版本

         支持U8/12.0及以上版本

    2.使用场景

    基础数据同步或前端展示

    3.接口调用说明

    3.1请求说明

    url https://api.yonyouup.com/api/person/edit
    格式 JSON
    https请求方式 POST
    编码类型 UTF-8


    3.2url参数说明

    参数 类型 是否必填 描述
    from_account string 调用方id
    to_account string 提供方id
    app_key string 应用编码
    token string api调用唯一识别码
    ds_sequence number 数据源序号(默认取应用的第一个数据源)


    3.3请求体参数说明

    参数 类型 参数路径 是否必填 描述
    code string 人员编码
    name string 人员名称
    cdept_num string 部门编码
    cdept_name string 部门名称
    cpsnproperty string 人员属性
    rsex string 人员性别(1:男 2:女)
    cpsnmobilephone string 人员手机号
    cpsnemail string 人员邮箱
    cjobcode string 职位编码
    vjobname number 职位名称
    cpsnpostaddr string 通讯地址
    rpersontype number 人员类型
    rpersontypename string 人员类型名称
    rIDType number 证件类型(0:身份证 1:护照 2:军人证 3:港澳身份证 4:台胞证 9:其他)
    rEmployState number 雇佣状态(10:在职 20:离退 30:离职)
    cpsnqqcode number QQ号
    vIDNo string 证件号码
    bpsnperson string 0=非业务员;1=非业务员;

    3.4请求示例

    POST https://api.yonyouup.com/api/person/edit?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&biz_id=0971&ds_sequence=1
    
    POST 内容:
    {
    	"person":{
    		"cdept_name":"总裁会",
    		"cdept_num":"01",
    		"cjobcode":"0101",
    		"code":"00001",
    		"cpsnemail":"wming@yonyou.com",
    		"cpsnmobilephone":"18698085765",
    		"cuser_id":"demo",
    		"name":"王铭",
    		"remploystate":"10",
    		"ridtype":"1",
    		"rpersontype":"10",
    		"rpersontypename":"正式员工",
    		"rsex":"1",
    		"vidno":"130903197208072011",
    		"vjobname":"总裁"
    	}
    }
    


    3.5返回参数说明

    参数说明 类型 描述
    errcode string 错误码,0 为正常。
    errmsg string 错误信息。

    3.6正确返回示例

    JSON示例:

    {
      "errcode" : "0", 
      "errmsg" : ""
    }  
    

    3.7错误返回示例

    application/json;charset=UTF-8
    {
    	"errcode" : "30021",
    	"errmsg" : "此应用未上线"
    } 

    4.API测试

    API测试 SDK下载