简要描述:

  • 货品档案-创建接口

接口说明

  • 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货品档案的货品编号与商家编码定义如下
  1. 货品编号(goods_no)代表SPU所有属性信息的唯一编号,ERP内货品编号之间不重复。
  2. 商家编码(spec_no)代表SKU所有属性信息的唯一编号,ERP商家编码之间不重复。
2. SPU、SKU的通用定义如下:
  1. 概念 : SPU = Standard Product Unit (标准产品单位),SPU 是商品信息聚合的最小单位,是一组可复用、易检索的标准化信息的集合,该集合描述了一个产品的特性。通俗点讲,属性值、特性相同的货品就可以称为一个 SPU,与商家、颜色、款式、套餐都无关。例如:华为P20和华为Mate20是两款不同的货品,定义华为P20的编号为HUAWEI-P20,定义华为Mate20的编号为HUAWEI-Mate20,HUAWEI-Mate20和HUAWEI-P20就是ERP系统的货品编号(goods_no)。
  2. 概念: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:

环境 HTTP地址
测试环境 http://apitest.yptcgroup.com/thirdpart/oms/basic/goods/push
预发布环境 http://apiuat.yptcgroup.com/thirdpart/oms/basic/goods/push
正式环境 http://api.yptcgroup.com/thirdpart/oms/basic/goods/push

请求方式:

  • POST

请求头:

参数名 是否必须 类型 说明
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   作者:石明科