getGoodsList：批量获取商品列表
入参
|
参数名称 |
是否必须 |
类型 |
描述 |
|
sKey |
Y |
String |
令牌 |
|
begin |
N |
int |
起始位置，默认0； |
|
step |
N |
int |
商品数量，默认100，最大1000 |
|
status |
N |
String |
C：全部；T：正常； F：回收站； A：待审； N：未通过；R：撤销； 默认值：T |
|
putaway |
N |
String |
A：全部；T：上架；F：下架；默认值：T |
|
goodsCode |
N |
String |
商品编号 |
|
updateGe |
N |
String |
修改时间大于 格式：YYYY-MM-DD HH:ii:ss，系统按照有效时间计算，G8区时间 |
|
updateLe |
N |
String |
修改时间小于 格式：YYYY-MM-DD HH:ii:ss，系统按照有效时间计算，G8区时间 |
入参示例:
{
"f":"getGoodsList",
"v":{
"sKey":"2328a84d56fcfa89b1fdb688fc435c45",
"begin":0,
"step":100,
"status":"C",
"putaway":"A",
"goodsCode":"2020050701"
}
}返回参数:
|
参数名称 |
类型 |
描述 |
|
rStatus |
String |
100：正常，其他：异常 |
|
message |
String |
信息描述 |
|
rTotal |
String |
商品总数 |
|
rData |
String |
具体信息 |
rData参数明细
|
参数名称 |
类型 |
描述 |
|
guid |
String |
值为客户ERP系统中唯一值,用做关系对应，没有查询到guid则返回订货宝的商品ID |
|
isTrueGuid |
boolean |
是否为真实的guid，false则为订货宝的商品ID |
|
isTrueSiteID |
boolean |
是否为真实的siteID，false则为订货宝的分类ID |
|
isTrueBrandID |
boolean |
是否为真实的brandID，false则为订货宝的品牌ID |
|
name |
String |
商品名称 |
|
siteID |
String |
商品分类ID 如果已同步ERP数据，则为ERP对应分类ID，否则为订货宝分类ID |
|
brandID |
String |
商品品牌ID 如果已同步ERP数据，则为ERP对应品牌ID，否则为订货宝品牌ID |
|
goods_allocation |
String(30) |
货位号 |
|
model |
String |
型号 |
|
coding |
String |
商品编号，系统唯一（联营版除外） |
|
barcode |
String |
小单位条码 |
|
goods_picture |
String |
商品主图 |
|
price1 |
String |
小单位订货价 |
|
price2 |
String |
市场价 |
|
price3 |
String |
进货价 |
|
putaway |
String |
上下架状态 |
|
units |
String |
小单位 |
|
bigunits |
String |
大单位 |
|
conversionnumber |
decimal |
小单位到大单位换算关系 |
|
package |
decimal |
最低订量（min_order） |
|
minorder |
String |
起订单位 默认小单位('base_units','container_units','middle_units') |
|
orderID |
String |
系统排序值，默认500，最小0。排序优先级：系统排序值-->商品录入系统时间 |
|
librarydown |
String |
库存下限 默认0 |
|
libraryup |
String |
库存上限 默认0 |
|
librarysafe |
String |
安全库存 默认0 |
|
multi_id |
string |
多规格id 多规格值，为0时代表无规格，否则多规格 |
|
multi |
Object |
商品多规格档案 |
|
goods_imgs |
Object |
商品图集 |
|
field_1 |
String |
自定义字段 |
|
field_2 |
String |
自定义字段 |
|
field_3 |
String |
自定义字段 |
|
field_4 |
String |
自定义字段 |
|
field_5 |
String |
自定义字段 |
|
field_6 |
String |
自定义字段 |
|
subtitle |
String |
商品营销子标题 |
|
middle_units |
String |
中单位 |
|
middle_barcode |
String |
中单位条码 |
|
conversion_barcode |
String |
大单位条码 |
|
base2middle_unit_rate |
decimal |
小单位转中单位换算关系 |
|
middle_unit_whole_price |
decimal |
中单位订货价 |
|
big_unit_whole_price |
decimal |
大单位订货价 |
|
keywords |
String |
关键词 |
|
collaborator_id |
Int |
联营商ID，只针对联营版有意义；0表示自营 |
|
source_id |
Int |
对应联营商的商品ID，只针对联营版有意义；0表示自营 |
multi子元素
|
参数名称 |
类型 |
描述 |
|
multiFirst |
String |
子规格GUID，ERP唯一编号。 |
|
multiSecond |
String |
子规格GUID，ERP唯一编号。 |
|
multiName |
String |
规格名称：S,上海 |
|
barcode |
String |
子规格商品条形码 |
|
whole |
String |
订货价 |
|
selling |
String |
市场价 |
|
purchase |
String |
进货价 |
|
options_goods_num |
String |
规格商品编号 |
|
middle_unit_whole_price |
decimal |
规格中单位订货价 |
|
big_unit_whole_price |
decimal |
规格大单位订货价 |
|
options_middle_barcode |
String |
规格中单位条形码 |
|
options_big_barcode |
String |
规格大单位条形码 |
goods_imgs子元素
|
参数名称 |
参数类型 |
参数说明 |
|
resource_id |
Int |
资源Id,传入resource_id将更新对应的图片信息，没有传入resource_id的记录为新增图片。 |
|
goods_id |
Int |
商品Id |
|
old_name |
String |
图片原名 |
|
file_name |
String |
图片完整路径，如：https://img.dhb168.com/1/2/3/4.png |
|
order_num |
Int |
图片排序值，如：1. |
返参示例：
{
"rStatus": 100,
"message": "获取商品列表成功",
"rTotal": "1",
"rData": [
{
"guid": "2020050701",
"isTrueGuid": true,
"isTrueSiteID": false,
"isTrueBrandID": false,
"name": "测试商品1",
"siteID": "6",
"brandID": "1",
"goods_allocation": "xxmm",
"model": "1*12",
"coding": "2020050701",
"barcode": "aaaaaa",
"price1": "11.1100",
"price2": "12.0500",
"price3": "10.0800",
"price4": "0.0000",
"putaway": "T",
"units": "只",
"bigunits": "箱",
"conversionnumber": "12.0000",
"package": "1.0000",
"minorder": "base_units",
"orderID": "1",
"librarydown": "0",
"libraryup": "0",
"librarysafe": "0",
"field_1": "自定义字段1",
"field_2": "自定义字段2",
"field_3": "自定义字段3",
"field_4": "自定义字段4",
"field_5": "自定义字段5",
"field_6": "自定义字段6",
"multi_id": "9478,9479",
"subtitle": "测试",
"middle_units": "打",
"middle_barcode": "ccccccc",
"conversion_barcode": "bbbbbb",
"base2middle_unit_rate": "6.0000",
"middle_unit_whole_price": "60.0000",
"big_unit_whole_price": "100.0000",
"multi": [
{
"options_id": "356912,356916",
"multiFirst": "356912",
"multiSecond": "356916",
"multiName": "S,北京",
"barcode": "base_00021002",
"whole": "11.1100",
"selling": "12.1200",
"purchase": "10.1000",
"options_goods_num": "00021002",
"middle_unit_whole_price": "61.6100",
"big_unit_whole_price": "101.1000",
"options_middle_barcode": "middle_00021002",
"options_big_barcode": "big_00021002"
},
{
"options_id": "356912,356917",
"multiFirst": "356912",
"multiSecond": "356917",
"multiName": "S,上海",
"barcode": "base_00021003",
"whole": "11.1200",
"selling": "12.1300",
"purchase": "10.2000",
"options_goods_num": "00021003",
"middle_unit_whole_price": "61.6200",
"big_unit_whole_price": "101.2000",
"options_middle_barcode": "middle_00021003",
"options_big_barcode": "big_00021003"
},
{
"options_id": "356913,356917",
"multiFirst": "356913",
"multiSecond": "356917",
"multiName": "M,上海",
"barcode": "base_00031003",
"whole": "11.1300",
"selling": "12.1400",
"purchase": "10.3000",
"options_goods_num": "00031003",
"middle_unit_whole_price": "61.6300",
"big_unit_whole_price": "101.3000",
"options_middle_barcode": "middle_00031003",
"options_big_barcode": "big_00031003"
}
]
}
]
}