新增员工资料
| 基本信息
信息 | 值 | 备注 |
---|---|---|
接口名称 | 新增员工资料 | 根据员工代号新增员工资料(包括修改) |
请求状态 | POST | RESTful方式 |
接口路径 | http://localhost:23798/api/Salm/AppendToSalm | 向服务器地址发送POST请求 |
远程模式 | http://www.linkerplus.com/api/ext_erp/Salm/AppendToSalm | 远程模式向服务器地址发送POST请求,需要ERP注册号注册远程模式,并在Headers添加sn参数 |
| 请求参数
Headers
参数名称 | 是否必须 | 参数值 | 备注 |
---|---|---|---|
Content-Type | 是 | application/json | 用于指定数据的传输类型 |
LoginId | 是 | e835943e-55c2-4bf0-832d-6f4166592941 | 用户登录的LoginId,取用户登录或账套验证接口返回的LoginId |
UsrNo | 否 | ADMIN | 账套验证的LoginId需添加UsrNo,用户登录的LoginId则无需添加UsrNo |
sn | 否 | MGR_REST_1001 | 远程模式需添加sn参数,MGR_REST_+ERP注册号 |
Body
参数名称 | 类型 | 是否必须 | 参数值 | 备注 | 其它信息 |
---|---|---|---|---|---|
object [] | 是 | 员工数据 | item 类型: object | ||
SAL_NO | string | 是 | CG001 | 员工代号 | 该员工代号在资料中存在即为修改原数据,不存在为新增 |
NAME | string | 是 | 员工1 | 员工名称 | |
SEX | string | 否 | T | 性别 | "T":是男,"F":是女 |
ID_NUM | string | 否 | 12121212 | 身份证号 | |
MAR | string | 否 | T | 婚姻状况 | "T":是已婚,"F":是未婚 |
BRD_NUM | number | 否 | 1 | 抚养人数 | 为空时默认取1 |
DEP | string | 否 | CGB | 部门代号 | 该部门代号必须在系统部门资料存在,不存在的请先新增部门资料 |
NAT_PLC | string | 否 | XXXXX | 藉贯 | |
CON_ADR | string | 否 | XXXXX | 联络地址 | |
EDU | string | 否 | XXXXX | 教育程度 | |
GRD | string | 否 | XXXXX | 毕业院校 | |
FORN | string | 否 | XXXXX | 外语能力 | |
DRV | string | 否 | XXXXX | 驾照 | |
TEL1 | string | 否 | 1234567 | 电话号码 | |
TEL2 | string | 否 | 1234567 | 手机号码 | |
DUT_IN_D | string | 否 | 2021-12-23 | 到职日 | |
DUT_OT_D | string | 否 | 2021-12-25 | 离职日 | |
UP_SAL_NO | string | 否 | CG002 | 上级业务员 | 该员工代号必须在系统员工资料存在,不存在的请先新增员工资料 |
E_MAIL | string | 否 | XX@XX | 电子邮件地址 | |
REM | string | 否 | 这是摘要 | 摘要 |
| 返回数据
参数名称 | 类型 | 参数值 | 备注 | 其它信息 |
---|---|---|---|---|
OkCount | number | 1 | 新增成功数 | |
ErrorCount | number | 1 | 新增失败数 | |
ErrorData | object | [] | 失败的数据 | "ErrorMsg"字段返回的是错误信息 |
| 调用范例
BODY JSON
[
{
"SAL_NO": "CG001", //必须,仓库代号,该货品代号在资料中存在即为修改原数据,不存在为新增
"NAME": "员工1", //必须,仓库名称
"SEX": "T", //非必须,属性
"ID_NUM": "12121212", //非必须,所属部门代号
"MAR": "T", //非必须,地址
"BRD_NUM": 1, //非必须,电话
"DEP": "CGB", //非必须,传真
"NAT_PLC": "XXXXX", //非必须,上层库位
"CON_ADR": "XXXXX", //非必须,联系人
"EDU": "XXXXX", //非必须,教育程度
"GRD": "XXXXX", //非必须,毕业院校
"FORN": "XXXXX", //非必须,外语能力
"TEL1": "1234567", //非必须,电话号码
"TEL2": "1234567", //非必须,手机号码
"DUT_IN_D": "2021-12-23", //非必须,废品仓否
"DUT_OT_D": "2021-12-25", //非必须,停用日期
"UP_SAL_NO": "CG0025", //非必须,上级业务员
"E_MAIL": "XX@XX", //非必须,电子邮件地址
"REM": "这是摘要" //非必须,摘要
},
{
"SAL_NO": "CG002"
}
]
返回的JSON
{
"OkCount": 1, //新增成功数
"ErrorCount": 1, //新增失败数
"ErrorData": [ //失败的数据
{
"SAL_NO": "CG002" ,
"ErrorMsg": "员工名称[NAME]不能为空." //错误信息
}
]
}
| 备注
必须在Headers里面传入用户登录或账套验证的LoginId。
Body中JSON字段与所需数据库SALM表字段为一样的,列示中没有的字段请按照实际情况进行添加到Body的JSON中。
自定义字段请先在系统中设置,按照一般字段的方式添加到Body的JSON中。
调用新增员工资料接口时如需使用到其它的基础资料的,需要在系统中先添加好或者调用其它基础资料新增接口后再调取新增员工资料接口。
可查看后台表LOG_BILLSAVE查看执行信息。