商品信息的结构体说明

BrandItemBo 商品信息结构体

字段类型 item 字段 说明
BrandItemBaseBo base 商品的基础属性
BrandItemStockBo stocks 商品的库存结构
ItemPictureBo pics 商品的主图结构
ItemDescriptionBo descs 商品的详情描述结构
StockPicturesBo stock_pics 商品的库存图片
BrandItemGroupBo groups 商品对应的分组结构

BrandItemBaseBo 商品的基础属性

字段类型 base 字段 说明
string item_code 商品编码,固定长度32个字符串
string item_name 商品名称,最大256个字符
uint64 category_id 商品所属的分类编码
string attribute 商品属性值,最大512个字符,不同类目会有不同的属性值,格式为 属性ID:属性值ID|属性ID:属性值ID|。。。
uint64 multi_stock 是否多库存商品:0=否;1=是
int32 status -1=已删除; 0=初始状态;1=已上架;2=已下架;
uint64 create_time 创建时间 时间戳(只用作返回字段)
uint64 update_time 修改时间 时间戳(只用作返回字段)
uint32 is_repair 是否保修:0=否;1=是
string merchant_code 商家自己的商品编码,最长支持64个字符
uint32 return_goods 支持无理由退货的天数,0表示不支持退货: 7, 15, 30
string bar_code 条形码,必填字段,最大64个字符
uint32 shipping_id 运费模板id
string after_market 售后服务模板id列表,格式使用下划线分隔

BrandItemStockBo 商品的库存结构

字段类型 stocks 字段 说明
string item_code 商品编码,最大32个字符
string sku_code 库存编码,最大32个字符
string merchant_sku_code 商家自己的库存编码,最大32个字符
string bar_code 商家库存的条形码,最大128个字符
string stock_attr 库存属性,最大256个字符
uint32 stock_number 库存数量
uint64 stock_price 库存价格 (价格单位:分)
uint64 market_price 市场价格 (价格单位:分)
uint64 update_time 最后更新时间或创建时间,以秒为单位的时间戳

ItemPictureBo 商品的主图结构

字段类型 pics 字段 说明
uint32 type 1=商品主图;0=其他图片
string pic_url 图片的链接,最大256个字符
uint32 index 图片顺序
uint32 width 图片的宽度
uint32 height 图片的高度

ItemDescriptionBo 商品的详情描述结构

字段类型 descs 字段 说明
uint32 type 1=文本描述;0=图片
string info 文本内容,最大2048个字符
string pic 图片的链接,最大256个字符

StockPicturesBo 商品的库存图片

字段类型 stock_pics 字段 说明
uint32 attr_key_id 属性ID
uint32 attr_val_id 属性值ID
ItemPictureBo stock_pic_info 库存属性对应的图片信息

BrandItemGroupBo 商品对应的分组结构

字段类型 groups 字段 说明
string item_code 商品编码,最大32个字符
uint32 group_id 商品分组ID
string group_name 分组名称,最大64个字符

BrandItemModifyStockBo 商品库存价格修改结构

字段类型 groups 字段 说明
string sku_code sku编码
uint32 stock_number 最终库存数量,结合ori_stock_number字段来实现加库存和扣减库存
uint32 ori_stock_number 修改时库存数量,结合stock_number字段来实现加库存和扣减库存
uint32 stock_price 商品价格,以分为单位