微盟添加在售商品_v1API接口文档
添加在售商品_v1
接口地址：/apigw/weimob_shop/v2.0/goods/create
请求方法： POST
加工厂： {"operation":{"method":"none"}}
接口请求参数
| 序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
|---|---|---|---|---|---|---|
| 1 | basicInfo | basicInfo | object | 1 | 基础信息 | 是 |
| 2 | vid | vid | string | 1 | 组织结构节点 ID。组织的唯一标识，是 创建组织 时自动生成的 ID，也可以通过 bos/organization/getList 接口获取该 ID。 | 是 |
| 3 | brandId | brandId | string | 1 | 商品品牌 ID，可以通过 weimob_shop/goods/brand/getList 接口获取该 ID。 | 否 |
| 4 | categoryId | categoryId | string | 1 | 商品类目 ID。可以通过 weimob_shop/goods/category/getList接口获取该 ID。 | 是 |
| 5 | categoryPropertyList | categoryPropertyList | array | 1 | 商品参数信息列表，可以通过 weimob_shop/goods/category/property/content/getList 接口获取。 | 否 |
| 6 | categoryId | categoryId | string | 1 | 商品类目 ID。可以通过 weimob_shop/goods/category/getList接口获取该 ID。 | 是 |
| 7 | propId | propId | string | 1 | 商品参数 ID。可以通过 weimob_shop/goods/category/property/getList 接口获取该 ID。 | 是 |
| 8 | propValueId | propValueId | string | 1 | 商品参数值 ID。可以通过 weimob_shop/goods/category/property/content/getList 接口获取该 ID。 | 是 |
| 9 | deductStockType | deductStockType | string | 1 | 商品库存减扣方式。方式包括：1-下单减扣；2-支付减扣。 | 是 |
| 10 | defaultImageUrl | defaultImageUrl | string | 1 | 默认图片 | 是 |
| 11 | goodsClassifyIdList | goodsClassifyIdList | array | 1 | 商品分组 ID，是 添加商家分组 时自动生成的 ID，也可以通过 weimob_shop/goods/classify/getList 接口获取该 ID。 | 否 |
| 12 | goodsDesc | goodsDesc | string | 1 | 商品描述 | 否 |
| 13 | goodsImageUrl | goodsImageUrl | array | 1 | 商品图片 | 否 |
| 14 | goodsPropertyList | goodsPropertyList | array | 1 | 商品属性列表，可以通过 weimob_shop/goods/property/getList 接口获取。 | 否 |
| 15 | propId | propId | string | 1 | 商品属性 ID。可以通过 weimob_shop/goods/property/getList接口获取该 ID。 | 是 |
| 16 | propValueId | propValueId | string | 1 | 商品属性值 ID。可以通过 weimob_shop/goods/property/content/getList 接口获取该 ID。 | 是 |
| 17 | goodsRightsList | goodsRightsList | array | 1 | 商品服务列表 | 否 |
| 18 | propId | propId | string | 1 | 商品服务 ID。可以通过 weimob_shop/goods/service/getList 接口获取该 ID。 | 是 |
| 19 | propValueId | propValueId | string | 1 | 商品服务值 ID。可以通过 weimob_shop/goods/service/content/getList 接口获取该 ID。 | 是 |
| 20 | goodsTemplateId | goodsTemplateId | string | 1 | 商品模板 ID。可以通过 weimob_shop/goods/goodtemplate/getList 接口获取该 ID。 | 是 |
| 21 | goodsType | goodsType | string | 1 | 商品类型。类型包括：1-普通商品；2-虚拟商品。 | 是 |
| 22 | goodsVideoImageUrl | goodsVideoImageUrl | string | 1 | 商品视频图片链接 | 否 |
| 23 | goodsVideoUrl | goodsVideoUrl | string | 1 | 商品视频链接 | 否 |
| 24 | initSales | initSales | string | 1 | 初始销量 | 是 |
| 25 | innerPropertyList | innerPropertyList | array | 1 | 商品内部属性列表 | 否 |
| 26 | propId | propId | string | 1 | 内部属性 ID。可以通过 weimob_shop/goods/property/getList接口获取该 ID。 | 是 |
| 27 | propValueId | propValueId | string | 1 | 内部属性值 ID。可以通过 weimob_shop/goods/property/content/getList 接口获取该 ID。 | 是 |
| 28 | invoiceTitle | invoiceTitle | string | 1 | 发票名称 | 否 |
| 29 | invoiceTitleType | invoiceTitleType | string | 1 | 商品开票名称类型。类型包括：1-同商品名称； 2-自定义名称。 | 否 |
| 30 | isCanSell | isCanSell | string | 1 | 商品是否可售。false-禁售；true-可售。 | 是 |
| 31 | isMultiSku | isMultiSku | string | 1 | 商品是否多规格。 false-单规格；true-多规格。 | 是 |
| 32 | isOnline | isOnline | string | 1 | 商品是否上架。false-下架；true 上架。 | 是 |
| 33 | limitInfo | limitInfo | string | 1 | 限购信息。当 limitSwitch 为 true 时，才生效。 | 否 |
| 34 | goodsLimitNum | goodsLimitNum | string | 1 | 限购数量 | 是 |
| 35 | goodsLimitCycle | goodsLimitCycle | string | 1 | 限购周期 | 是 |
| 36 | limitSwitch | limitSwitch | string | 1 | 限购开关。false-关闭； true-开启。 | 是 |
| 37 | outerGoodsCode | outerGoodsCode | string | 1 | 商品编码 | 是 |
| 38 | performanceWay | performanceWay | object | 1 | 履约方式 | 是 |
| 39 | deliveryList | deliveryList | array | 1 | 配送方式。配送方式与商品类型关联，普通实物商品：只能设置商家配送、同城限时达、到底自提。 虚拟商品：只能设置无需物流配送方式。 | 是 |
| 40 | deliveryId | deliveryId | string | 1 | 配送方式 ID。可以通过 weimob_shop/fulfill/goods/fulfilltype/getList 接口获取该 ID。 | 是 |
| 41 | deliveryNodeShipId | deliveryNodeShipId | string | 1 | 配送方式关系节点 ID。可以通过 weimob_shop/fulfill/goods/fulfilltype/getList 接口获取该 ID。 | 是 |
| 42 | deliveryType | deliveryType | string | 1 | 配送类型。类型包括：1-商家配送；2-同城限时达；3-到店自提；4-门店交易；5-无需物流；6-门店自助。 | 是 |
| 43 | templateId | templateId | string | 1 | 配送模板 ID | 是 |
| 44 | mallCycleGoodsConfig | mallCycleGoodsConfig | object | 1 | 周期购配送信息 | 否 |
| 45 | fulfillCycleInt | fulfillCycleInt | string | 1 | 配送周期。1-每日一次；2-每周一次；3-每月一次；4-多周一次；5-多月一次；6-每周多次；7-每月多次。 | 否 |
| 46 | fulfillCycleConfig | fulfillCycleConfig | object | 1 | 配送周期详细配置 | 否 |
| 47 | cycleUnit | cycleUnit | string | 1 | 周期单位。单位包括：1-日；2-周；3-月；4-年。 | 否 |
| 48 | cycleValues | cycleValues | array | 1 | 可配送时间。示例：当 cycleUnit=1(日)时，传 [1]；当 cycleUnit=2(周)时，传 [1，2，3，4，5，6，7]；当 cycleUnit=3(月)时，传 [1，2，3，4，5，6，7，8，9，10，....]。 | 否 |
| 49 | cycleInterval | cycleInterval | string | 1 | 周期间隔,每日每周每月 传 1，多周多月 传 单位周期 | 否 |
| 50 | cycleTimes | cycleTimes | string | 1 | 每个周期配送次数。一个周期内次数，当每周多次或每月多次时传具体次数，其余情况传 1。 | 否 |
| 51 | removeWeekend | removeWeekend | string | 1 | 是否除去周末。0-不去除周末；1-去除周末（重复配送）；2-去除周末（不重复配送）。 | 否 |
| 52 | fulfillTimeOptions | fulfillTimeOptions | array | 1 | 可配送时间段，24 小时制。 | 否 |
| 53 | delayFulfill | delayFulfill | string | 1 | 是否延期配送。0-不延期；1-延期。 | 否 |
| 54 | delayCurrFulfill | delayCurrFulfill | string | 1 | 是否只延当期配送。0-顺延；1-只延当期。 | 否 |
| 55 | delayDay | delayDay | string | 1 | 可延期天数（毫秒值） | 否 |
| 56 | closingTime | closingTime | string | 1 | 截单时间（天数，毫秒值） | 否 |
| 57 | closingTimeDetail | closingTimeDetail | string | 1 | 截单时间，格式为“HH:mm”。 | 否 |
| 58 | alterAddress | alterAddress | string | 1 | 配送地址是否可修改。0-不可修改；1-可修改。 | 否 |
| 59 | sellUnitId | sellUnitId | string | 1 | 销售单位 ID。可以通过 weimob_shop/goods/unit/getList 接口获取该 ID。 | 否 |
| 60 | specInfoList | specInfoList | array | 1 | 商品规格列表。可以通过 weimob_shop/goods/category/skuspec/getList 接口获取商品规格列表。 | 否 |
| 61 | specId | specId | string | 1 | 商品规格 ID | 是 |
| 62 | specName | specName | string | 1 | 商品规格名称 | 是 |
| 63 | specImgEnable | specImgEnable | string | 1 | 是否允许商品规格添加图片。true-允许添加；false-不允许添加。多规格场景下只允许一个规格开启图片添加，如果开启了图片添加，包含了当前规格值的 SKU 的图片需要和规格对应规格值的图片相同。 | 否 |
| 64 | skuSpecValueList | skuSpecValueList | array | 1 | 规格值列表 | 是 |
| 65 | specValueName | specValueName | string | 1 | 规格值名称 | 是 |
| 66 | imageUrl | imageUrl | string | 1 | 图片链接 | 是 |
| 67 | specValueId | specValueId | string | 1 | 商品规格值 ID | 是 |
| 68 | sort | sort | string | 1 | 排序 | 是 |
| 69 | isOpenSizeRecommend | isOpenSizeRecommend | string | 1 | 是否开启尺码推荐，默认为 false。true-开启尺码推荐，尺码表信息不能为空；fasle-不开启尺码推荐。多规格场景下只能有一个规格开启尺码推荐。 | 否 |
| 70 | skuList | skuList | array | 1 | 商品规格 SKU 列表 | 是 |
| 71 | imageUrl | imageUrl | string | 1 | 图片 URL | 否 |
| 72 | costPrice | costPrice | string | 1 | 成本价 | 否 |
| 73 | skuStockNum | skuStockNum | string | 1 | SKU 库存数量 | 是 |
| 74 | marketPrice | marketPrice | string | 1 | 市场价 | 否 |
| 75 | outerSkuCode | outerSkuCode | string | 1 | 商家编码 | 是 |
| 76 | salePrice | salePrice | string | 1 | 销售价 | 是 |
| 77 | volume | volume | string | 1 | 体积 | 否 |
| 78 | weight | weight | string | 1 | 重量 | 否 |
| 79 | cycleSkuList | cycleSkuList | array | 1 | 周期购 SKU 信息 | 否 |
| 80 | cycleNum | cycleNum | string | 1 | 周期规格（期数） | 否 |
| 81 | cycleName | cycleName | string | 1 | 展示名称 | 否 |
| 82 | cycleMarkingPrice | cycleMarkingPrice | string | 1 | 划线价 | 否 |
| 83 | cyclePrice | cyclePrice | string | 1 | 周期价 | 否 |
| 84 | cycleStockNum | cycleStockNum | string | 1 | 可售库存 | 否 |
| 85 | skuSpecValueList | skuSpecValueList | array | 1 | SKU 规格值列表 | 是 |
| 86 | specId | specId | string | 1 | 规格 ID | 否 |
接口响应参数
| 序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
|---|
微盟的接口：添加在售商品_v1（/apigw/weimob_shop/v2.0/goods/create），由轻易云数据集成平台API资产管理模块整理收纳，并且根据微盟版本更新同步实时更新。通过API资产管理，企业能够实现API的集中监控和分析，及时发现并解决潜在的性能瓶颈和安全风险，保障业务的连续性和稳定性。
