# 供应计划模块

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": ""
}