简要描述:

  • 货品档案-创建接口

接口说明

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

备注:

  • 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2026-06-17 09:44   作者:石明科