一、说明
此接口主要用于第三方系统新增货品资料。
二、参数说明
1、请求方式
请求方式 |
POST |
接口地址 |
http://服务器IP或机器名或域名/WMS/API/SYS/CreateProduct |
格式 |
JSON |
编码类型 |
UTF-8 |
2、header参数
KEY |
VALUE |
Content-Type |
application/json |
Authorization |
token值 |
说明:授权接口所获取的值 |
3、请求参数
字段 |
字段名 |
字段类型 |
长度 |
必填 |
说明 |
owner_code |
货主编码 |
String |
30 |
是 |
如未启用多货主,则默认赋值为“OWNER”,反之,则传货主编码 |
item_code |
货品代号 |
String |
50 |
是 |
|
item_name |
货品名称 |
String |
160 |
是 |
|
short_name |
货品简称 |
String |
100 |
|
|
english_name |
英文名称 |
String |
200 |
|
|
specifications |
货品规格 |
String |
|
|
|
warehouse_staff |
仓管人员 |
String |
30 |
|
|
batch_control_erp |
ERP批号管制 |
String |
1 |
|
当批号需要回传ERP系统时,则该选项设置为T,反之,则视为批号在WMS系统管理; |
batch_control |
批号管制 |
String |
1 |
|
当“ERP批号管制”=T时,则该栏位必须为T;
当该货品在WMS系统启用批号管理时,则该栏位为T,当货品不启用批号管理,则值为空或F; |
serial_number_control |
序列号管制 |
String |
1 |
|
当货品需要启用序列号管制,则设置为T,反之,则值为空或F |
kinds |
大类 |
String |
1 |
是 |
1商品;2制成品;3半成品;4原料;5物料;6下脚器;7包装物;A人工;B费用;C包装 |
category_code |
中类 |
String |
50 |
是 |
|
unit_name |
主单位名称 |
String |
8 |
是 |
|
remark |
摘要 |
String |
|
|
|
warehouse_code |
预设仓库 |
String |
30 |
|
|
department |
所属部门 |
String |
30 |
|
|
valid_days |
有效天数 |
int |
|
|
|
start_date |
货品创建日 |
Datatime |
|
|
|
stop_date |
货品停用日期 |
Datatime |
|
|
|
item_properties |
货品模版 |
String |
3 |
是 |
默认为001,001为一般货品,002为特征货品 |
template_code |
货品特征模版 |
String |
50 |
|
|
non_barcode_goods |
非条码货品 |
String |
1 |
|
当货品为非条码货品时,则该栏位为T,反之,则值为空或F; |
allow_shipment |
允许从收货区直接发货 |
String |
1 |
|
当货品允许从收货区直接发货时,则该栏位为T,反之,则值为空或F; |
storage_control |
货品储存管制 |
String |
1 |
|
允许不传,不传则视为1;1为不管制,2为管制; |
storage_properties_code |
储存性质代号 |
String |
20 |
|
|
package_unit1 |
包装(一)单位 |
String |
8 |
|
|
package_quantity1 |
包装(一)数量 |
Float |
|
|
|
package_unit2 |
包装(二)单位 |
String |
8 |
|
|
package_quantity2 |
包装(二)数量 |
Float |
|
|
|
weight |
货品单重 |
Float |
|
|
|
unit_weight |
货品单重单位 |
String |
10 |
|
允许不传,不传则视为kg;kg为千克,g为克,t为吨 |
packing_unit_min |
最小领料单位 |
String |
1 |
|
允许不传,不传视1;1为主单位、2为包装(一)单位,3为包装(二)单位; |
package_unit |
包装单位 |
String |
8 |
|
|
packaging_conversion |
包装换算 |
Float |
|
|
|
package_net_weight |
包装净重 |
Float |
|
|
|
package_net_weight_unit |
包装净重单位 |
String |
8 |
|
|
package_gross_weight |
包装毛重 |
Float |
|
|
|
package_size |
包装大小 |
Float |
|
|
|
package_size_unit |
包装大小单位 |
String |
8 |
|
|
box_barcode_method |
箱条码生效方式 |
String |
1 |
|
允许不传,不传视1;1.立即生效,2.装箱检验后生效; |
enable_inspection_type |
启用检验类型 |
String |
10 |
|
多个之间用;隔开,RK入库检验、CK出库检验、KC库存检验 |
inspection_cycle |
仓库检验周期 |
int |
|
|
不传,则视为30天;以天为单位 |
drawing_number |
图号 |
String |
100 |
|
|
operator_code |
录入员 |
String |
30 |
|
|
operate_time |
输入日期 |
Datatime |
|
|
|
extend_props |
自定义字段明细 |
|
|
|
|
4、返回参数
字段 |
字段名 |
说明 |
code |
处理结果 |
0视为成功,其他视为失败 |
message |
处理说明 |
|
owner_code |
货主编码 |
|
item_code |
货品代号 |
|
三、请求JSON范例
{
"owner_code": "OWNER", //必填,如未启用多货主,则默认赋值为“OWNER”,反之,则传货主编码
"item_code": "A001", //代号,必须唯一,必填
"item_name": "可达ya", //名称,必填
"short_name": "ya", //简称
"english_name": "KDya", //英文名称
"specifications": "30*15", //货品规格
"warehouse_staff": "", //仓管人员
"batch_control_erp": "", //ERP批号管制,当批号需要回传ERP系统时,则该选项设置为T,反之,则视为批号在WMS系统管理;
"batch_control": "", //批号管制,当“ERP批号管制”=T时,则该栏位必须为T;当批号在WMS系统管理时,则该栏位为T,当货品不启用批号管理,则值为空或F;
"serial_number_control": "", //序列号管制
"kinds": "1", //大类,1商品;2制成品;3半成品;4原料;5物料;6下脚器;7包装物;A人工;B费用;C包装,必填
"category_code": "ALL", //中类代号,必填
"unit_name": "只", //单位名称,必填
"warehouse_code": "", //预设仓库
"valid_days": "", //有效天数
"start_date": "", //启用日期
"stop_date": "", //停用日期
"department": "00000000", //部门代号
"remark": "", //备注
"item_properties": "001", //货品模版,默认为001,001为一般货品,002为特征货品
"template_code": "", //货品特征模版
"non_barcode_goods": "", //非条码货品,当货品为非条码货品时,则该栏位为T,反之,则值为空或F;
"allow_shipment": "", //允许从收货区直接发货,当货品允许从收货区直接发货时,则该栏位为T,反之,则值为空或F;
"storage_control": "", //货品储存管制,允许不传,不传则视为1;1为不管制,2为管制;
"storage_properties_code": "", //储存性质代号
"package_unit1": "", //包装(一)单位
"package_quantity1": "", //包装(一)数量
"package_unit2": "", //包装(二)单位
"package_quantity2": "", //包装(二)数量
"weight": "", //货品单重
"unit_weight": "", //货品单重单位,允许不传,不传则视为kg;kg为千克,g为克,t为吨
"packing_unit_min": "", //最小领料单位,允许不传,不传视1;1为主单位、2为包装(一)单位,3包装(二)单位;
"package_unit": "", //包装单位
"packaging_conversion": "", //包装换算
"package_net_weight": "", //包装净重
"package_net_weight_unit": "", //包装净重单位
"package_gross_weight": "", //包装毛重
"package_size": "", //包装大小
"package_size_unit": "", //包装大小单位
"box_barcode_method": "", //箱条码生效方式,允许不传,不传视1;1.立即生效,2.装箱检验后生效;
"enable_inspection_type": "", //启用检验类型,多个之间用;隔开,RK入库检验、CK出库检验、KC库存检验
"inspection_cycle": "", //仓库检验周期,不传,则视为30天;以天为单位
"drawing_number": "", //图号
"operator_code": "ADMIN", //录入人员;
"operate_time": "2024-08-05 14:00:00", //录入时间
"extend_props": {
"A1": "自定义字段1", //自定义字段1
"A2": "自定义字段2" //自定义字段2
}
}
四、返回JSON范例
{
"code": 0,
"message": "新增成功!",
"owner_code": "OWNER",
"item_code": "A001"
}