## **文档说明**

本文档面向对象为标准商品管理的第三方开发者（isv）或者自研商家。



## **使用场景**

1.第三方系统需要上传商品至微盟后台或是要修改已有商品的部分信息（图片/文描/库存等）；
2.将微商城商品下载到第三方系统，建立商品信息（sku/库存等）进行管理；

3.目前服务市场已接入部分商品搬家服务商，支持从天猫/淘宝/京东等平台一键铺货：http://fuwu.weimob.com/product_632.html



## 名词解释

| **名词**     | **字段**          | **含义**                                                     |
| ------------ | ----------------- | ------------------------------------------------------------ |
| SPU编码      | goodscode         | SPU(Standard Product Unit)标准化产品单元，属性值、特性相同的商品就可以称为一个SPU，如：女鞋 |
| 商品id       | goodsid           | 微盟根据商品编码（spu编码）生成的内部商品id                  |
| 商家编码     | skucode           | SKU(Stock Keeping Unit)库存量单位，用来定价和管理库存的，如：36码女鞋、37码女鞋 |
| 规格id       | skuid             | 微盟根据规格编码（商家编码）生成的内部规格id                 |
| 单品条码     | singleProductCode | 【零售】单品的数字身份，智慧零售的商品需要关联单品产生。如：商家的单品有手机和手机壳，商品可以关联单个单品售卖（手机），也可以关联组合单品售卖（手机+手机壳套餐） |
| 单品id       | singleProductid   | 【零售】微盟根据单品条码生成的内部单品id                     |
| 价格         | price             | 3种价格：销售价salePrice，市场价originalPrice，成本价costPrice |
| 库存         | stock             | 可售库存availableStockNum，占用库存frozenStockNum            |
| 类目         | category          | 微盟系统内固定的商品类别分类，如食品、美妆。商家下载类目后与外部类目匹配后选择合适类目上传商品 |
| 规格         | SaleAttrInfo      | 通常表示尺码、颜色、大小等(与库存价格有关）                  |
| 参数         | GoodsAttrInfo     | 通常表示产地，品牌等                                         |
| 分组         | classify          | 分组展示在C端，客户可通过分组快速找到所需商品。              |
| 标签         | Tag               | 可对商品打标签，标签展示在C端 如：热销/新品上架              |
| 商品属性     | GoodsProp         | 商品属性可用于微信端商品列表和分类页的筛选。如：查询进口商品来源 属性：产地 属性值：美国/日本 |
| 内部属性     | InnerGoodsProp    | 内部属性只用于向订单及第三方系统传参，不作为筛选，也不在C端商品详情展示。如：食品供货商是A厂，衣服供货商是B厂 |
| 商品服务     | GoodsRights       | 商家提供的服务。如：七天无理由退货/包邮                      |
| 图片         | ImageUrl          | 分为商品图片goodsImageUrl和sku图片imageUrl，只能使用微盟内链 |
| 视频         | VideoUrl          | 商品视频，只能使用微盟内链                                   |
| 商品类型     | b2cGoodsType      | 3种商品类型：普通商品、海淘商品、无需配送商品                |
| 商品销售模式 | sellModelType     | 2种销售模式：现货销售、预售                                  |
| 配送方式     | deliveryType      | 5种配送方式：商家配送，同城限时达，到店自提，门店交易，无需物流 |
| 上下架状态   | isPutAway         | 上下架状态：上架、下架 （接口暂不支持定时上下架）            |
| 是否可售     | isCanSell         | 【零售】是否可售：禁售、可售                                 |







## 对接方案

**1.初始商品信息导入**



1 可在服务市场上选购第三方服务，支持从天猫/淘宝/京东等平台搬商品至微盟微商城/智慧零售>>http://fuwu.weimob.com/product_632.html

2 可以通过在微盟后台手动添加商品，或使用表格批量导入

3 可通过对接添加商品（ec/goods/addGoods）接口，具体可查看如下调用步骤。

备注：零售只支持添加商品至商家店，需要商家在微盟后台进行商品分配门店的操作。



**2.外部系统同步商品至微盟**

| 调用顺序 | 接口名                                | 备注名                   | 功能描述                                                     |
| -------- | ------------------------------------- | ------------------------ | ------------------------------------------------------------ |
| 1        | ec/category/queryCategoryTree         | 查询一级类目             | 商品类目需要查询至2级                                        |
|          | ec/category/queryChildrenCategory     | 查询二级类目             | 商品类目需要查询至2级                                        |
| 2        | ec/category/addAttribute              | 添加规格/参数            | 多规格商品需要先维护规格及规格值，并在添加商品时传入。       |
|          | ec/category/addAttrValue              | 添加规格值/参数值        | 多规格商品需要先维护规格及规格值，并在添加商品时传入。       |
|          | ec/category/queryCategoryAttrInfo     | 获取类目下的规格/参数值  | 多规格商品需要先维护规格及规格值，并在添加商品时传入。       |
| 3        | ec/goodsImage/uploadImg               | 上传商品图片             | 商品图片/视频禁止使用外链，需先调用接口上传。图片尺寸建议750x750（正方形模式）或750×1000（长图模式），大小2M以下，商品主图最多10张。 |
|          | ec/goodsVideo/uploadVideo             | 上传商品视频             | 商品图片/视频禁止使用外链，需先调用接口上传。图片尺寸建议750x750（正方形模式）或750×1000（长图模式），大小2M以下，商品主图最多10张。 |
| 4        | ec/goods/findFreightTemplateList      | 获取运费列表（商家配送） | 运费模板可在微盟后台设置后，通过接口查询相应的模板id         |
|          | ec/goods/queryCityFreightTemplateList | 查询同城限时达模板列表   | 运费模板可在微盟后台设置后，通过接口查询相应的模板id         |
| 5        | ec/goods/addGoods                     | 添加商品                 |                                                              |

> 备注：如需要在添加商品时传入所对应的商品分组、商品服务、商品属性/参数等，也需要通过接口或微盟后台提前进行维护。



**在初始化导入商品后，微盟接口支持对商品信息的全量更新或更新商品的部分信息。**





| 接口名                          | 备注名           | 功能描述                                                     |
| ------------------------------- | ---------------- | ------------------------------------------------------------ |
| ec/goods/updateGoods            | 更新商品         | 使用该接口更新商品时，如非必填字段未传入，则在更新时将会被抹掉或变为默认值。 |
| ec/goods/updateGoodsTitle       | 更新商品名称     | 更新商品名称                                                 |
| ec/goods/updateGoodsDesc        | 更新商品文描     | 更新商品文描                                                 |
| ec/goods/updateGoodsImage       | 更新商品图片     | 全量更新商品的所有图片，并且取第一张图片为商品主图。图片url请使用微盟内部url。 |
| ec/goods/updateOuterSkuCode     | 更新sku编码      | 更新sku编码：可更新单个商品的多sku编码。                     |
| ec/goods/updateCostPrice        | 修改商品的成本价 | 修改商品的成本价                                             |
| ec/goods/updateGoodsShelfStatus | 批量上下架       | 使用该接口，外部系统可控制商品是否在c端售卖。                |





**3.部系统获取****微盟系统中的商品**

| 接口名                               | 备注名                     | 功能描述                         |
| ------------------------------------ | -------------------------- | -------------------------------- |
| ec/goods/queryGoodsList              | 获取商品列表               | 获取商品列表                     |
| ec/goods/queryGoodsDetail            | 获取商品详情               | 获取商品详情                     |
| ec/goods/queryGoodsUrlList           | 根据商品id列表查询url      | 用于查询购买商品H5地址           |
| ec/goods/queryBaseGoodsListByGoodsId | 根据商品id列表查询基本信息 | 用于查询商品名称以及商品默认图片 |



**微商城/零售-商品模块提供以下消息推送，开发者可通过订阅消息，感知在微盟系统中发生的商品信息变更。**



| 接口名                | 备注名       | 功能描述                                                     |
| --------------------- | ------------ | ------------------------------------------------------------ |
| ec_price/price_update | 价格变更消息 | 触发条件：1、修改商品的销售价、市场价（成本价变更目前不推送）2、新增商品（接口或后台新增）3、调用ec/goods/updateGoods更新商品后 |
| ec_goods/goodsDelete  | 删除商品消息 | 删除商品消息                                                 |
| ec_goods/goodsUpdate  | 修改商品消息 | 触发条件：修改商家编码，批量更新sku相关信息，修改分销商品，修改商品，分配商品（智慧零售）会触发该消息。 |

商品场景

文章是否对你有帮助？