简要描述:
接口说明
- 1.1接口描述:①批量推送货品资料给ERP②批量更新ERP货品档案资料(支持已经存在的货品(spu),新增单品(sku),good_list中good_no确定sku新增在哪个货品之下,将新增的spec_no以及对应信息放在spec_list,推送成功以后,sku将新增到对应的货品档案(spu)下。)
- 1.2调用建议:支持批量推送数据,每个请求建议包含100条以下的“goods_list+spec_list”数据;goods_list下的spec_list条数不要超过2000条
- 1.3注意事项:更新货品档案时,good_no确认要更新的spu属性信息,good_no+spec_no确认要更新的sku属性信息。更新货品(spu)数据时,good_list中good_no对应的数据做变更,spec_list要包含至少一个已经存在的单品(sku)数据。更新单品(sku)数据时,good_list中good_no对应的数据不变,spec_list中spec_no对应的数据做变更,重新推送成功后,变更部分将会更新到ERP
概念介绍
1. ERP货品档案的货品编号与商家编码定义如下
- 货品编号(goods_no)代表SPU所有属性信息的唯一编号,ERP内货品编号之间不重复。
- 商家编码(spec_no)代表SKU所有属性信息的唯一编号,ERP商家编码之间不重复。
2. SPU、SKU的通用定义如下:
- 概念 : SPU = Standard Product Unit (标准产品单位),SPU 是商品信息聚合的最小单位,是一组可复用、易检索的标准化信息的集合,该集合描述了一个产品的特性。通俗点讲,属性值、特性相同的货品就可以称为一个 SPU,与商家、颜色、款式、套餐都无关。例如:华为P20和华为Mate20是两款不同的货品,定义华为P20的编号为HUAWEI-P20,定义华为Mate20的编号为HUAWEI-Mate20,HUAWEI-Mate20和HUAWEI-P20就是ERP系统的货品编号(goods_no)。
- 概念:SKU=stock keeping unit( 库存量单位),SKU 即库存进出计量的单位, 可以是以件、盒、托盘等为单位,SKU 是物理上不可分割的最小存货单元。通俗点将,属性值、特性相同的一个SPU再细化粒度到商家、颜色、款式、套餐等就是一个SKU,华为P20的颜色属性其中有两个颜色宝蓝色(Royal blue)与亮黑色(Bright black),定义华为P20宝蓝色的编码为HUAWEI-P20-Royal blue,定义华为P20宝蓝色的编码为HUAWEIP20-Bright black,HUAWEI-P20-Royal blue和HUAWEI-P20-Royal blue都是下属货品编号HUAWEI-P20的两个商家编码(spec_no)。
接口版本:
| 版本号 |
制定人 |
制定日期 |
修订日期 |
| 1.0.0 |
石明科 |
2020-07-20 |
2020-07-20 |
请求URL:
请求方式:
请求头:
| 参数名 |
是否必须 |
类型 |
说明 |
| X-AUTH-TOKEN |
是 |
string |
令牌 |
| Content-Type |
是 |
string |
请求类型,统一是 application/json |
请求参数:
| 参数名 |
字段 |
是否必须 |
类型 |
长度 |
说明 |
| 货品节点 |
goods_list |
是 |
data[] |
|
|
goods_list
| 参数名 |
字段 |
是否必须 |
类型 |
长度 |
说明 |
| 货品编码 |
goods_no |
是 |
varchar |
40 |
代表货品(spu)所有属性的唯一编号,用于系统货品区分 |
| 货品类别 |
goods_type |
是 |
int |
1 |
货品类别 1销售商品 2原材料 3包装 4周转材料5虚拟商品6固定资产 0其它 |
| 货品名称 |
goods_name |
是 |
varchar |
255 |
货品名称 |
| 货品简称 |
short_name |
否 |
varchar |
255 |
货品简称 |
| 货品别名 |
alias |
否 |
varchar |
255 |
货品别名 |
| 拼音名称 |
pinyin |
否 |
varchar |
40 |
拼音名称 |
| 年份 |
year |
是 |
varchar |
64 |
年份 (如:2020) |
| 季节 |
season |
是 |
varchar |
64 |
季节(春季,夏季,秋季,冬季) |
| 性别 |
sex |
否 |
varchar |
64 |
性别 |
| 流水号 |
serial_number |
否 |
varchar |
255 |
流水号 |
| 分类 |
class_name |
否 |
varchar |
64 |
分类 |
| 品牌 |
brand_name |
否 |
varchar |
64 |
品牌 |
| 基本单位 |
unit_name |
否 |
varchar |
20 |
基本单位 |
| 备注 |
remark |
否 |
varchar |
512 |
备注 |
| 自定义属性1 |
props1 |
否 |
varchar |
255 |
自定义属性1 |
| 自定义属性2 |
props2 |
否 |
varchar |
255 |
自定义属性2 |
| 自定义属性3 |
props3 |
否 |
varchar |
255 |
自定义属性3 |
| 自定义属性4 |
props4 |
否 |
varchar |
255 |
自定义属性4 |
| 自定义属性5 |
props5 |
否 |
varchar |
255 |
自定义属性5 |
| 自定义属性6 |
props6 |
否 |
varchar |
255 |
自定义属性6 |
| 辅助单位名称 |
aux_unit_name |
否 |
varchar |
255 |
|
| 标记名称 |
flag_name |
否 |
varchar |
255 |
|
| 单品节点 |
spec_list |
是 |
data[] |
|
|
spec_list
| 参数名 |
字段 |
是否必须 |
类型 |
长度 |
说明 |
| 商家编码 |
spec_no |
是 |
varchar |
40 |
代表单品(sku)所有属性的唯一编码,用于系统单品区分,SKU概念介绍 |
| 规格码 |
spec_code |
是 |
varchar |
40 |
规格编码 |
| 主条码 |
barcode |
否 |
varchar |
50 |
主条码 |
| 规格名称 |
spec_name |
否 |
varchar |
100 |
规格名称 |
| 允许负库存 |
is_allow_neg_stock |
否 |
int |
1 |
是否允许负库存1允许,0不允许(默认为1) |
| 是否启用序列号 |
is_sn_enable |
否 |
|
1 |
是否启用序列号,默认不启用,0不启用序列号 1强序列号 2弱序列 |
| 是否启用同一批次出库 |
is_single_batch |
否 |
int |
1 |
是否启用同一批次出库,默认不启用,0不启用1启用 |
| 是否出库不用验货 |
is_not_need_examine |
否 |
int |
1 |
是否出库不用验货,默认不开启该配置,0出库不验货未开启 1出库不验货开启 |
| 是否允许0成本 |
is_zero_cost |
否 |
int |
1 |
是否允许0成本,默认允许,0不允许1允许 |
| 是否允许低于成本价 |
is_lower_cost |
否 |
int |
1 |
是否允许低于成本价,默认不允许,0不允许1允许 |
| 是否航空禁运 |
is_not_use_air |
否 |
int |
1 |
是否航空禁运,默认不开启,0不开启1开启 |
| 是否畅销品 |
is_popular |
否 |
int |
1 |
是否畅销品,默认非畅销,0非畅销 1畅销 |
| 补货 |
replenish_type |
否 |
int |
1 |
补货,默认低于警戒库存补货,0持续补货1不补货2低于警戒库存补货 |
| 拆分 |
large_type |
否 |
int |
1 |
默认普通件,-1非单发件(需和其他类型货品一起发) 0普通件 1普通大件(可与非大件一起发) 2独立大件(必须单独发) |
| 基本单位 |
spec_unit_name |
否 |
varchar |
20 |
基本单位名称 |
| 最低价 |
lowest_price |
否 |
decimal |
19,4 |
最低价 |
| 图片url地址 |
img_url |
否 |
varchar |
40 |
图片url地址 |
| 零售价 |
retail_price |
否 |
decimal |
19,4 |
商品标价,系统内手工建单时使用,传值时需谨慎 |
| 批发价 |
wholesale_price |
否 |
decimal |
19,4 |
批发价 |
| 会员价 |
member_price |
否 |
decimal |
19,4 |
会员价 |
| 市场价 |
market_price |
否 |
decimal |
19,4 |
市场价 |
| 销售积分 |
sale_score |
否 |
decimal |
19,4 |
销售积分 |
| 打包积分 |
pack_score |
否 |
decimal |
19,4 |
打包积分 |
| 拣货积分 |
pick_score |
否 |
decimal |
19,4 |
拣货积分 |
| 有效期天数 |
validity_days |
否 |
int |
11 |
保质期,天数 |
| 重量 |
weight |
否 |
decimal |
19,4 |
ERP默认重量单位:kg |
| 长 |
length |
否 |
decimal |
19,4 |
长(CM) |
| 宽 |
width |
否 |
decimal |
19,4 |
宽(CM) |
| 高 |
height |
否 |
decimal |
19,4 |
高(CM) |
| 税率 |
tax_rate |
否 |
varchar |
255 |
税率 |
| 自定义1 |
prop1 |
否 |
varchar |
255 |
自定义属性1 |
| 自定义2 |
prop2 |
否 |
varchar |
255 |
自定义属性2 |
| 自定义3 |
prop3 |
否 |
varchar |
255 |
自定义属性3 |
| 自定义4 |
prop4 |
否 |
varchar |
255 |
自定义属性4 |
| 自定义5 |
prop5 |
否 |
varchar |
255 |
自定义属性5 |
| 自定义6 |
prop6 |
否 |
varchar |
255 |
自定义属性6 |
| 自定义价格1 |
custom_price1 |
否 |
decimal |
19,4 |
自定义价格1 |
| 自定义价格2 |
custom_price2 |
否 |
decimal |
19,4 |
自定义价格2 |
| 单品辅助单位名称 |
spec_aux_unit_name |
否 |
varchar |
255 |
单品辅助单位名称 |
| 税务编码 |
tax_code |
否 |
varchar |
40 |
税务编码 |
| 备注 |
spec_remark |
否 |
varchar |
512 |
备注 |
请求参数示例
{
"goods_list": [{
"alias": "",
"brand_name": "衣品天成男装",
"class_name": "T恤",
"goods_name": "衣品天成男装T恤",
"goods_no": "JP20080501",
"goods_type": 1,
"pinyin": "",
"props1": "2020",
"props2": "冬季",
"props3": "男装",
"props4": "20000001",
"props5": "",
"props6": "",
"remark": "",
"season": "冬季",
"serial_number": "20000001",
"sex": "男装",
"short_name": "加厚T恤",
"spec_list": [{
"barcode": "JP20080501BS",
"height": 0,
"img_url": "",
"is_allow_neg_stock": 0,
"length": "0",
"lowest_price": 10.0,
"market_price": 0,
"member_price": 0,
"pack_score": "1",
"pick_score": "3",
"prop1": "2020",
"prop2": "冬季",
"prop3": "男装",
"prop4": "20000001",
"prop5": "黑色",
"prop6": "S",
"spec_remark": "什么呀",
"retail_price": "179.0",
"sale_score": "2",
"spec_code": "B_S",
"spec_name": "黑色_S",
"spec_no": "JP20080501BS",
"spec_unit_name": "",
"tax_rate": "0",
"validity_days": 0,
"weight": 0,
"wholesale_price": 0,
"width": 0
}],
"unit_name": "",
"year": "2020"
}]
}
返回参数说明:
| 参数名 |
字段 |
是否必须 |
类型 |
长度 |
说明 |
| 错误码 |
code |
是 |
int |
11 |
状态码:1表示成功,其他表示失败 |
| 错误原因 |
message |
是 |
varchar |
255 |
错误原因 |
| 请求id |
requestId |
是 |
varchar |
255 |
请求后,返回唯一id(成功与否都会返回) |
返回示例:
正确时返回:
{
"code": "1",
"msg": "SUCCESS",
"requestId": "7e528a541b91447086a9d62a8857c4d8"
}
错误时返回:
{
"code": "100001",
"msg": "[goods_no]参数校验失败,不能为空",
"requestId": "bb3ed906b9fd4289b71a5240178623e1"
}
备注:
文档更新时间: 2020-08-13 18:54 作者:石明科