接口地址 /supplierApi/goods/receive/addGoods

请求方式 POST

consumes ["application/json"]

produces ["*/*"]

接口描述 添加商品信息

请求参数

参数名称 说明 参数类型 是否必须 类型 schema
a_token header中a_token字段用于认证 header true string
goodsInfo 商品信息 body true SupplierGoodsAllInfoApiParam SupplierGoodsAllInfoApiParam

schema属性说明

SupplierGoodsAllInfoApiParam

参数名称 说明 参数类型 是否必须 类型 schema
poolSn 商品池编号 body true string
skuInfoList 商品SKU信息列表 body false array SupplierProductsApiParam
spuInfo 商品信息 body true SupplierGoodsApiParam SupplierGoodsApiParam

SupplierProductsApiParam

参数名称 说明 参数类型 是否必须 类型 schema
barCode 69码 body true string
jdQiPrice 京东旗舰价格(与对应链接同时存在) body false number
jdQiUrl 京东旗舰链接(如果没有线下图片，至少传入一个线上链接) body false string
jdZiPrice 京东自营价格(与对应链接同时存在) body false number
jdZiUrl 京东自营链接(如果没有线下图片，至少传入一个线上链接) body false string
marketPrice 市场售价(元,精确2位小数) body true number
offlineImg 线下图片图片(分辨率:800*800,格式:jpg)(线下图片与线上链接价格上传一个即可) body false string
onStatus 上架状态(0:上架,1下架) body true int32
shopPrice 本店售价(元,精确2位小数) body true number
skuAttrValue 规格参数(格式(颜色:红色,尺码:170)字符串) body true string
skuBannerImgs sku轮播图(5-10张用‘|’分割),(分辨率:800*800,格式:jpg) body true string
skuImg SKU图片(分辨率:800*800,格式:jpg) body true string
stock 库存(件) body true int32
supplierSku 供应商SKU编码 body true string
supplyPrice 供货价(元,精确2位小数) body true number
thirdPrice 三方价格(与对应链接同时存在) body false number
thirdUrl 三方链接(如果没有线下图片，至少传入一个线上链接) body false string
tmallPrice 天猫旗舰价格(与对应链接同时存在) body false number
tmallUrl 天猫旗舰链接(如果没有线下图片，至少传入一个线上链接) body false string
volume 商品体积(m³) body false double
weight 商品重量(kg) body false double

SupplierGoodsApiParam

参数名称 说明 参数类型 是否必须 类型 schema
bannerImgs 轮播图(5-10张用‘|’分割)(分辨率:800*800,格式:jpg) body true string
brandId 品牌ID body true int64
cateId 产品线ID body true int64
deliveryCycle 商品发货时效（单位小时）填24或48 body true int32
deliveryPlace 发货地id body true string
deliveryTemplateId 运费模板ID body true int64
description 描述（不超过1000个字符） body false string
ditchId 渠道id body true int64
expiration 保质期(只填数字，单位:天) body false string
goodsDeliveryIds 商品发货物流类型ID（多值”,”分割） body true string
goodsDetail 商品详图，(分辨率:宽:790,格式:jpg) body true string
goodsImg 商品主图(分辨率:800*800,格式:jpg) body true string
goodsName 商品名称（品牌+空格+名称+空格+货号）如：BENEUNDER蕉下 胶囊伞太阳伞 ST643453 body true string
goodsSn 商品货号(不超过50个字符) body true string
invoiceStatus 开票状态 0是不开票 1是开票 body true int32
isLive 是否支持直播，0 否，1是 body true int32
keywords 搜索关键字 body false string
listedSeason 上市季节（1春季、2夏季、3秋季、4冬季） body true int32
logisticsPrice 京东顺丰增补运费 body false number
material 材质 body false string
noShipRange 不发货区域(以逗号分隔的地址id字符串) body false string
place 产地 body false string
produceSeason 适用季节（0通用、1春季、2夏季、3秋季、4冬季） body true int32
produceYear 上市时间（数字年份,如：2024） body true int32
recordNumber 商品备案号 body false string
sexual 性别，0男女同款，1男款，2女款 body true int32
showCateId 展示分类ID body true int64
supplierSpu 供应商SPU编号(不超过50个字符) body true string
taxCode 税收编码 body true string
taxRate 税率 body true int32
unit 单位 body true string

响应状态

状态码 说明 schema
200 OK 接口统一返回«string»

响应参数

参数名称 说明 类型 schema
code 接口返回码 int32
data 接口返回数据 string
message 接口返回消息 string

响应示例

{
    "code": 0,
    "data": "",
    "message": ""
}
作者：周宁  创建时间：2024-11-13 15:24
最后编辑：周宁  更新时间：2025-07-21 09:14