新增部门资料
| 基本信息
信息 | 值 | 备注 |
---|---|---|
接口名称 | 新增部门资料 | 根据部门代号新增部门资料(包括修改) |
请求状态 | POST | RESTful方式 |
接口路径 | http://localhost:23798/api/Dept/AppendToDept | 向服务器地址发送POST请求 |
远程模式 | http://www.linkerplus.com/api/ext_erp/Dept/AppendToDept | 远程模式向服务器地址发送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 | ||
DEP | string | 是 | CG1 | 部门代号 | 该部门代号在资料中存在即为修改原数据,不存在为新增 |
NAME | string | 是 | 采购1部 | 部门名称 | |
ENG_NAME | string | 否 | Pd1 | 英文名称 | |
UP | string | 否 | 0000 | 上层部门代号 | 该部门代号必须在系统部门资料存在,不存在的请先新增部门资料。为空时默认取0000 |
STOP_DD | string | 否 | 2021-12-23 | 停用日期 | |
SAL_NO | string | 否 | YG1 | 负责人 | 该员工代号必须在系统员工资料存在,不存在的请先新增员工资料 |
TEL | string | 否 | 0756-0000000 | 电话 | |
IS_COMPDEP | string | 否 | F | 分支机构 | "T":是,空或者"F":否;默认为空 |
| 返回数据
参数名称 | 类型 | 参数值 | 备注 | 其它信息 |
---|---|---|---|---|
OkCount | number | 1 | 新增成功数 | |
ErrorCount | number | 1 | 新增失败数 | |
ErrorData | object | [] | 失败的数据 | "ErrorMsg"字段返回的是错误信息 |
| 调用范例
BODY JSON
[
{
"DEP": "CG1", //必须,部门代号,该部门代号在资料中存在即为修改原数据,不存在为新增
"NAME": "采购1部", //必须,部门名称
"ENG_NAME": "Pd1", //非必须,英文名称
"UP": "0000", //非必须,上层部门代号
"STOP_DD": "2021-12-23", //非必须,停用日期
"SAL_NO": "YG1", //非必须,员工代号
"TEL": "0756-0000000", //非必须,电话
"IS_COMPDEP": "F" //非必须,分支机构
},
{
"DEP": "CG2" //必须,部门代号
}
]
返回的JSON
{
"OkCount": 1, //新增成功数
"ErrorCount": 1, //新增失败数
"ErrorData": [
{
"DEP": "CG2",
"UP": "0000",
"MAKE_ID": "3",
"USR": "ADMIN",
"ErrorMsg": "部门名称[NAME]不能为空." //错误信息
}
]
}
| 备注
必须在Headers里面传入用户登录或账套验证的LoginId。
Body中JSON字段与所需数据库DEPT表字段为一样的,列示中没有的字段请按照实际情况进行添加到Body的JSON中。
接口程序不处理审核,没有审核流直接终审,有审核流就处于未审状态。
调用新增部门资料接口时如需使用到其它的基础资料的,需要在系统中先添加好或者调用其它基础资料新增接口后再调取新增部门资料接口。
可查看后台表LOG_BILLSAVE查看执行信息。