新增货品资料
| 基本信息
信息 | 值 | 备注 |
---|---|---|
接口名称 | 新增货品资料 | 根据货品代号新增货品资料(包括修改) |
请求状态 | POST | RESTful方式 |
接口路径 | http://localhost:23798/api/Prdt/AppendToPrdt | 向服务器地址发送POST请求 |
远程模式 | http://www.linkerplus.com/api/ext_erp/Prdt/AppendToPrdt | 远程模式向服务器地址发送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 | ||
PRD_NO | string | 是 | YL1 | 货品代号 | 该货品代号在资料中存在即为修改原数据,不存在为新增 |
NAME | string | 是 | 原料1 | 货品名称 | |
UT | string | 是 | KG | 主单位 | |
SNM | string | 否 | 原料1 | 简称 | 为空时截取长度为8的货品名称 |
IDX1 | string | 否 | ZL1 | 中类代号 | 该中类代号必须在系统中类资料存在,不存在的请先新增中类资料 |
BOM_ID | string | 否 | A | 分类 | A:A类货物,B:B类货物,C:C类货物,Y:虚拟键 |
OBJ_TYPE | string | 否 | 1 | 科目分类 | 该科目分类必须在系统科目分类资料存在,不存在的请先新增科目分类资料 |
UT1 | string | 否 | G | 副单位 | |
DFU_UT | string | 否 | 1 | 计量单位 | 1:主单位 2:包装(一)单位 3:包装(二)单位;为空时默认取1 |
SPC | string | 否 | 24cm | 规格 | |
SPC_TAX | string | 否 | 17 | 商品税率 | 为空时默认取17 |
PK2_UT | string | 否 | 包 | 包装(一)单位 | 计量单位为2时不能为空 |
PK2_QTY | number | 否 | 6 | 包装(一)数量 | 计量单位为2且包装(一)单位不为空时不能为空 |
PK3_UT | string | 否 | 袋 | 包装(二)单位 | 计量单位为3时不能为空 |
PK3_QTY | number | 否 | 8 | 包装(二)数量 | 计量单位为3且包装(二)单位不为空时不能为空 |
SUP1 | string | 否 | CS1 | 主供应商 | 该厂商代号必须在系统厂商资料存在,不存在的请先新增厂商资料 |
UPR | number | 否 | 20 | 统一定价 | |
REM | string | 否 | 这是货品摘要 | 摘要 | |
NOUSE_DD | string | 否 | 2021-12-23 | 货品停用日期 | |
CHK_BAT | string | 否 | T | 批号管制否 | "T":启用,空或者"F":不启用 |
WH | string | 否 | CK1 | 预设仓库 | 该仓库代号必须在系统仓库资料存在,不存在的请先新增仓库资料 |
CHK_NUM | string | 否 | T | 序列号管制否 | "T":启用,空或者"F":不启用 |
VALID_DAYS | string | 否 | 30 | 有效天数 | |
DEP | string | 否 | CGB | 所属部门 | 该部门代号必须在系统部门资料存在,不存在的请先新增部门资料 |
PRD_DD | string | 否 | 2021-06-01 | 货品创建时间 | 为空时取当前时间 |
PRD_CHK | string | 否 | T | 需检验 | "T":需检验,空或者"F":不控制 |
CHK_MARK | string | 否 | T | 特征管制 | "T":管制,空或者"F":不控制 |
MARK_NO | string | 否 | YS1 | 特征组 | 该特征组代号必须在系统特征组资料存在,不存在的请先新增特征组资料 |
PRD_ML | string | 否 | T | 倒冲领料 | "T":启用,空或者"F":不启用 |
| 返回数据
参数名称 | 类型 | 参数值 | 备注 | 其它信息 |
---|---|---|---|---|
OkCount | number | 1 | 新增成功数 | |
ErrorCount | number | 1 | 新增失败数 | |
ErrorData | object | [] | 失败的数据 | "ErrorMsg"字段返回的是错误信息 |
| 调用范例
BODY JSON
[
{
"PRD_NO": "YL1", //必须,货品代号,该货品代号在资料中存在即为修改原数据,不存在为新增
"NAME": "原料1", //必须,货品名称
"UT": "KG", //必须,主单位
"SNM": "原料1", //非必须,简称
"IDX1": "ZL1", //非必须,中类代号
"BOM_ID": "A", //非必须,分类
"OBJ_TYPE": "1", //非必须,科目分类
"UT1": "G", //非必须,副单位
"DFU_UT": "1", //非必须,计量单位
"SPC": "24cm", //非必须,规格
"SPC_TAX": "17", //非必须,商品税率
"PK2_UT": "包", //非必须,包装(一)单位
"PK2_QTY": "6", //非必须,包装(一)数量
"PK3_UT": "袋", //非必须,包装(二)单位
"PK3_QTY": "8", //非必须,包装(二)数量
"SUP1": "CS1", //非必须,主供应商
"UPR": "20", //非必须,统一定价
"REM": "这是货品摘要",//非必须,摘要
"NOUSE_DD": "2021-12-23",//非必须,货品停用日期
"CHK_BAT": "T", //非必须,批号管制否
"WH": "CK1", //非必须,预设仓库
"CHK_NUM": "T", //非必须,序列号管制否
"VALID_DAYS": "30", //非必须,有效天数
"DEP": "CGB", //非必须,所属部门
"PRD_DD": "2021-06-01",//非必须,货品创建时间
"PRD_CHK": "T", //非必须,需检验
"CHK_MARK": "T", //非必须,特征管制
"MARK_NO": "YS1", //非必须,特征组
"PRD_ML": "T" //非必须,倒冲领料
},
{
"PRD_NO": "YL2", //必须,货品代号
"NAME": "原料2" //必须,货品名称
}
]
返回的JSON
{
"OkCount": 1, //新增成功数
"ErrorCount": 1, //新增失败数
"ErrorData": [ //失败的数据
{
"PRD_NO": "YL2",
"NAME": "原料2",
"ErrorMsg": "主单位[UT]不能为空." //错误信息
}
]
}
| 备注
必须在Headers里面传入用户登录或账套验证的LoginId。
Body中JSON字段与所需数据库PRDT表字段为一样的,列示中没有的字段请按照实际情况进行添加到Body的JSON中。
自定义字段请先在系统中设置,按照一般字段的方式添加到Body的JSON中。
接口程序不处理审核,没有审核流直接终审,有审核流就处于未审状态。
调用新增货品资料接口时如需使用到其它的基础资料的,需要在系统中先添加好或者调用其它基础资料新增接口后再调取新增货品资料接口。
可查看后台表LOG_BILLSAVE查看执行信息。