新增货品资料接口
一、说明
此接口主要用于第三方系统新增货品资料。
二、参数说明
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 | 是 | |
deputy_unit_name | 副单位名称 | String | 10 | ||
deputy_formula | 副单位公式 | String | 210 | 需按“X;X;X;X;X;X;X”格式赋值,以分号分隔每一段,如“1;0;0;1;1;主单位数量*4;副单位数量/4” 第一段:默认为1,即主副互推; 第二段:默认为0,变量默认为不保存; 第三段:数量取整,0为四舍五入、1为向上取整、2为向下取整; 第四段:主单位数量小数位长度; 第五段:副单位数量小数位长度; 第六段:主推副公式; 第七段:副推主公式; |
|
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": "只", //单位名称,必填 "deputy_unit_name": "卷", //副单位名称 "deputy_formula": "1;0;0;1;1;主单位数量*4;副单位数量/4", //副单位公式,允许不传,不传则视为没有主副互推公式;第一段:默认为1,即主副互推;第二段:默认为0,变量默认为不保存;第三段:数量取整,0为四舍五入、1为向上取整、2为向下取整;第四段:主单位数量小数位长度;第五段:副单位数量小数位长度;第六段:主推副公式;第七段:副推主公式; "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" }