# 供应计划模块
API域名以及签名 统一签名, 此模块路由地址为/scp
测试环境:https://openapi-test.babycare.com/api/gateway/scp
生产环境:https://gateway.babycare.com/scp
全局响应参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 0:成功 其他失败 |
| data | Object | 返回数据 |
| message | String | 错误信息 |
# 1、新品商品保存
(1)接口地址:/open/sku/save
(2)请求方式:POST
(3)请求数据类型:application/json
(4)响应数据类型:application/json
(5)请求参数:
| 参数名称 | 数据类型 | 是否必须 | 参数说明 |
|---|---|---|---|
| brandName | String | false | 品牌 |
| categoryLv1Code | String | false | 一级类目编码 |
| categoryLv1Name | String | false | 一级类目名称 |
| categoryLv2Code | String | false | 二级类目编码 |
| categoryLv2Name | String | false | 二级类目名称 |
| categoryLv3Code | String | false | 三级类目编码 |
| categoryLv3Name | String | false | 三级类目名称 |
| goodsType | String | false | 商品类型 |
| goodsTypeName | String | false | 商品类型名称 |
| mainPic | String | false | 商品主图 |
| normsName | String | false | 规格名称 |
| productStatus | String | false | 商品状态 |
| purchaseDeliver | String | false | 采购交付员名称 |
| purchaseDeliverJob | String | false | 采购交付员工号 |
| purchaseDeliverPrincipal | String | false | 采购交付负责人名称 |
| purchaseDeliverPrincipalJob | String | false | 采购交付负责人工号 |
| purchaseStatus | String | false | 供应采购状态 |
| remark | String | false | 备注说明 |
| season | String | false | 适用季节 |
| skuBarCode | String | true | 商品条码 |
| skuCtn | String | false | 箱规 |
| skuName | String | true | 商品名称 |
| skuRowHeight | String | false | 陈列高 |
| skuRowLength | String | false | 陈列长 |
| skuRowWidth | String | false | 陈列宽 |
| spuCode | String | false | SPU编码 |
| spuId | Integer | false | SPU_ID |
| supplyMainCategory | String | false | 供应大类 |
| supplyPlanPrincipal | String | false | 供应计划负责人名称 |
| supplyPlanPrincipalJob | String | false | 供应计划负责人工号 |
| supplyPlanner | String | false | 供应计划员名称 |
| supplyPlannerJob | String | false | 供应计划员工号 |
注:请求body为数组,可批量保存。
(6)请求示例:
[
{
"brandName": "",
"categoryLv1Code": "",
"categoryLv1Name": "",
"categoryLv2Code": "",
"categoryLv2Name": "",
"categoryLv3Code": "",
"categoryLv3Name": "",
"goodsType": "",
"goodsTypeName": "",
"mainPic": "",
"normsName": "",
"productStatus": "",
"purchaseDeliver": "",
"purchaseDeliverId": "",
"purchaseDeliverJob": "",
"purchaseDeliverPrincipal": "",
"purchaseDeliverPrincipalId": "",
"purchaseDeliverPrincipalJob": "",
"purchaseStatus": "",
"remark": "",
"season": "",
"skuBarCode": "",
"skuCtn": "",
"skuName": "",
"skuRowHeight": "",
"skuRowLength": "",
"skuRowWidth": "",
"spuCode": "",
"spuId": 0,
"supplyMainCategory": "",
"supplyMainCategoryId": "",
"supplyPlanPrincipal": "",
"supplyPlanPrincipalId": "",
"supplyPlanPrincipalJob": "",
"supplyPlanner": "",
"supplyPlannerId": "",
"supplyPlannerJob": ""
}
]
(7)响应参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 0:成功 其他失败 |
| data | Object | 无返回数据 |
| message | String | 错误信息 |
(8)响应示例:
{
"code": 0,
"data": {},
"message": ""
}
# 2、提报单位-列表
(1)接口地址:/open/unit/all
(2)请求方式:GET
(3)请求数据类型:application/x-www-form-urlencoded
(4)响应数据类型:application/json
(5)接口描述: 查询供应链提报单位
(6)请求参数:
| 参数名称 | 数据类型 | 是否必须 | 参数说明 |
|---|---|---|---|
| reportUnitCode | String | false | 提报单位编号 |
| reportUnitName | String | false | 提报单位名称 |
| reportUnitStatus | String | false | 状态:ENABLED(启用)/DISABLED(禁用) |
(7)响应参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 0:成功 其他失败 |
| data | List | 提报单位列表 |
| └ channelCodeLv1 | String | 一级渠道编号 |
| └ reportUnitCode | String | 提报单位编号 |
| └ reportUnitName | String | 提报单位名称 |
| └ reportUnitStatus | String | 状态:ENABLED(启用)/DISABLED(禁用) |
| └ unitType | String | 单位类型:2B/2C |
| message | String | 错误信息 |
(8)响应示例:
{
"code": 0,
"data": [
{
"channelCodeLv1": "",
"reportUnitCode": "",
"reportUnitName": "",
"reportUnitStatus": "",
"unitType": ""
}
],
"message": ""
}
# 3、店铺-渠道关系映射
(1)接口地址:/open/store/mapping
(2)请求方式:POST
(3)请求数据类型:application/json
(4)响应数据类型:application/json
(5)接口描述: 保存店铺提报单位渠道开店状态
(6)请求参数:
| 参数名称 | 数据类型 | 是否必须 | 参数说明 |
|---|---|---|---|
| storeCode | String | true | 店铺编码 |
| storeName | String | true | 店铺名称 |
| storeStatus | String | false | 店铺开店状态,CLOSED:关店,OPEN:开店 |
| detailList | List | true | 提报单位信息 |
| └ channelLv2Code | String | true | 二级渠道货主编码 |
| └ orderCollection | String | false | 订单归集维度,SHOP/ORDER |
| └ reportUnitCode | String | true | 提报单位编码 |
(7)请求示例:
{
"detailList": [
{
"channelLv2Code": "",
"orderCollection": "",
"reportUnitCode": ""
}
],
"storeCode": "",
"storeName": "",
"storeStatus": ""
}
(8)响应参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 0:成功 其他失败 |
| data | Object | 无返回数据 |
| message | String | 错误信息 |
(9)响应示例:
{
"code": 0,
"data": {},
"message": ""
}
# 4、品供配额-导入
(1)接口地址:/open/quota/save
(2)请求方式:POST
(3)请求数据类型:application/json
(4)响应数据类型:application/json
(5)请求参数:
| 参数名称 | 数据类型 | 是否必须 | 参数说明 |
|---|---|---|---|
| skuBarCode | String | true | 商品条码 |
| supplierNo | String | true | 供应商编码 |
| quota | Number | false | 配比(%)默认100% |
| status | String | false | 关系状态:ENABLED:启用/DISABLED:禁用 默认启用ENABLED |
注:请求body为数组,可批量保存。
(6)请求示例:
[
{
"skuBarCode": "",
"supplierNo": "",
"quota": 100,
"status": "ENABLED"
}
]
(7)响应参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 0:成功 其他失败 |
| data | Object | 无返回数据 |
| message | String | 错误信息 |
(8)响应示例:
{
"code": 0,
"data": {},
"message": ""
}
← TMS对接模块 北森-飞书组织架构模块 →