新增货品资料接口

一、说明

此接口主要用于第三方系统新增货品资料。

二、参数说明

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"
}