宁波银行开放接口
  1. 后台接口-商品模块
宁波银行开放接口
  • 面向宁波银行开放接口
    • 蓝喜商品类目
    • 蓝喜商品列表
    • 移动端蓝喜商品列表
  • 后台接口-商品模块
    • 🉑 获取商品(spu)列表
      GET
    • 售后服务类别列表
      GET
    • 将宁波银行的商品同步推送到宁波银行
      POST
    • 查询所有支付方式
      GET
    • 同步商品/新增导入同步商品任务
      POST
    • 通过商品id查询商品价格信息
      GET
    • 同步商品/查看导入任务详情
      GET
    • 通过商品id设置商品价格信息
      PUT
    • 同步商品/分页展示所有导入任务
      GET
    • 通过导入设置商品价格信息
      POST
    • 通过商品id审核商品
      PUT
    • 通过商品id提交审核
      GET
    • 通过商品id查询审核记录
      GET
    • 通过商品id取消审核
      GET
    • 通过商品spuId查询操作记录
      GET
    • 通过商品skuId查询操作记录
      GET
    • 通过商品spuId查询上下架记录
      GET
    • 通过商品skuId查询上下架记录
      GET
    • ✅ 通过id删除商品
      PUT
    • ✅ 删除sku
      PUT
    • ✅ 通过id上架商品
      PUT
    • ❌ 通过id下架商品
      PUT
    • ❌ 通过id批量审核商品
      PUT
    • ❌ 通过id批量上下架商品
      PUT
    • ✅ 通过code上架商品
      PUT
    • ❌ 通过code下架商品
      PUT
    • ✅ 上架sku
      PUT
    • ❌ 下架sku
      PUT
    • ✅ 上架sku
      PUT
    • ❌ 下架sku
      PUT
    • 🌕 通过id获取商品详情
      GET
    • 🌕 通过code获取商品详情
      GET
    • 🔖 通过id更新标签
      PUT
    • 更新某个商品的销量调整
      PUT
    • 🔖 通过code更新标签
      PUT
    • 🇸🇧 通过id禁止单独可售
      PUT
    • 🇸🇧 通过code禁止单独可售
      PUT
    • 🇸🇧 通过id切换是否单独可售
      PUT
    • 🇸🇧 通过code切换是否单独可售
      PUT
    • 🏷️ 通过标签获取商品
      GET
    • listByTagName
      GET
    • 🏷️ 通过标签更新商品标签
      PUT
    • updateByTagName
      PUT
    • 🔖 通过id更新售后服务
      PUT
    • 🔖 通过code更新售后服务
      PUT
    • 🫥 通过id更新隐藏状态
      PUT
    • 🫥 通过code更新隐藏状态
      PUT
    • 装修商品列表
      GET
    • 获取商品(sku)列表
      GET
    • 获取整体前端类目树
      GET
    • 新建(不会自动审核)自建商品,只有审核通过后才可以拥有 code
      POST
    • 对自建商品提起审核
      POST
    • 更新自建商品,并且提交审核,别尝试对非自建商品使用
      PUT
    • 获取自建商品的详情,别尝试对非自建商品使用
      GET
    • 得到基础分期策略配置
      GET
    • 得到商品的分期策略配置
      GET
    • 设置商品分期策略
      POST
  • 后台接口-宁波银行预算
    • 宁波银行预算列表
    • 获取所有预算类型
  • 前端接口-商品模块
    • 获取商品(spu)列表
    • 获取商品(spu)列表
    • 通过id获取商品详情
    • 活动商品详情
    • 活动商品详情-优化版
    • 活动商品的额外信息
    • 活动商品列表
    • 活动详情的部分信息
    • 通过优惠券领取记录id获取可以兑换的商品信息列表(兑换券使用)
    • 兑换券商品详情(兑换券使用)
    • 礼包详情,by礼包商品id
    • 礼包详情,by礼包商品id和发放的优惠券id
    • 获取优惠券可用的商品列表
  • 库存管理
    • 读取实际库存
    • 读取可用库存
    • 读取该库存管理日志
    • 读取该sku订单日志
    • 维护库存
  • 后台接口-活动模块
    • 特定活动库存的管理日志
    • 特定活动库存的订单记录
    • 新增或修改常规活动
    • 新增或修改领券活动
    • 生成UID
    • 活动列表
    • 常规活动详情
    • 领券活动详情
    • 删除活动
    • 活动商品列表
    • 活动商品详情
    • 禁用活动
    • 模糊查询客群标签接口
    • 活动版本列表
    • 活动版本内容详情
    • 活动标签列表
    • 撤回审核
    • 提交审核
    • 计算常规活动预算
    • 计算领券活动预算
    • 释放活动预算
    • 全量同步活动信息
  • 前端商品类目排行
    • 按顶级类目查询商品排行
  • 后台接口-分类接口
    • 变更前端类目映射额外关系
    • 获取分类树
    • 获取指定分类
    • 获取指定分类信息
  • 国补支持
    • 关联动作
      • 宁波方所有上架国补商品的前端类目
      • 宁波方所有上架国补商品的前端类目
      • 转发江苏国补商品信息查询接口
      • 转发江苏国补商品信息查询接口
      • 获取标准的国补商品信息
      • 获取标准的国补商品信息
      • 获取一个省级行政区
      • 获取一个省级行政区
      • 获取所有省级行政区
      • 获取所有省级行政区
      • 获取一个国补品类
      • 获取一个国补品类
      • 获取所有国补品类
      • 获取所有国补品类
  • 江苏国补特有
    • 分页获取商品提交记录
    • 通过上传 execl 文件提交江苏国补商品
  1. 后台接口-商品模块

获取自建商品的详情,别尝试对非自建商品使用

GET
/products/{id}

请求参数

Path 参数
id
integer 
商品 id
必需

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://m1.apifoxmock.com/m1/4737255-0-default/products/'

返回响应

🟢200成功
application/json
Body
完整的自建商品的数据
onlyQuantityCentralizedPricesChanged
boolean 
可选
是否只有阶梯式集采价格变动
limitation
object (PurchaseLimitation) 
购买限定
可选
centralizedMinNum
integer 
可选
集中采购最小起购数量,为 null or 小于等于 0 就是无限定
limitedNum
integer 
可选
永久限购数,为 null or 小于等于 0 就是无限定
minNum
integer 
可选
最小起购数量,为 null or 小于等于 0 就是无限定
stateSubsidyExtra
object (StateSubsidyProductInputData) 
国补数据
可选
provinceCode
string 
省级行政区编码
可选
categoryCode
string 
国补品类编码
可选
preferentialCode
string 
可选
优惠码编码,必填,不超过 32位
a05Type
enum<string> 
可选
仅品类选择A05时出现
枚举值:
LaptopDesktop
ai
boolean 
是否AI产品
可选
energyEfficiencyGrade
integer 
可选
能耗等级
非必填,1-5级选择
energyEfficiencyLevel
integer 
可选
能效等级
《国补品类需求调整 0407》 新增的能效等级
communication
boolean 
是否通讯设备
可选
dualSim
boolean 
是否双卡双待
可选
manufacturerCertCode
string 
可选
厂商统一社会信用代码
properties
object (MapObject) 
可选
国补商品其他属性,必须是键为 string 的 object
otherSharingProperties
object (MapObject) 
可选
LCSAAS-171 新增的额外商品属性字段
key
object (key) 
可选
完整的自建商品的数据
enableStateSubsidy
boolean 
可选
是否为国补商品
这是一个不接受更新的字段
barCode
string 
条形码
可选
quantityCentralizedPrices
array[object (QuantityCentralizedPrice) {3}] 
可选
单 sku阶梯式集采价格
startQuantity
integer 
可选
price
number 
可选
settlementPrice
number 
可选
custom
boolean 
可选
默认值:
true
merchantCode
string 
可选
商户 spu code
传了必须保持唯一,不传是可以的
<= 64 字符
code
string 
可选
taxRate
number 
可选
不超过100 税率 税率*100
如果税率是7%,那么该值会是7而非0.07
id
integer <int64>
可选
单规格商品的 sku id
新增 sku 不要传入值;编辑时必须传入 当时的 id
merchantId
integer <int64>
乐采商户 id
可选
merchantIdInText
string 
可选
乐采商户 id;文本版本兼容前端引擎精度丢失,服务端确保渲染,输入时优先级别高于同字段
merchantName
string 
乐采商户 id
可选
frontCategoryId
integer <int64>
可选
@NotNull 为了草稿可用注释
frontCategoryIdInText
string 
可选
前端类目 Id;文本版本兼容前端引擎精度丢失,服务端确保渲染,输入时优先级别高于同字段
frontCategoryName
string 
可选
@NotNull 为了草稿可用注释
frontCategoryIds
array[integer]
可选
@NotNull @NotEmpty 为了草稿可用注释
frontCategoryIdsInText
array[string]
可选
前端类目 id 组;文本版本兼容前端引擎精度丢失,服务端确保渲染,输入时优先级别高于同字段
frontCategoryNames
array[string]
可选
@NotNull @NotEmpty 为了草稿可用注释
backCategoryId
integer <int64>
必需
backCategoryIds
array [object] 
可选
backCategoryIdInText
string 
可选
后端类目 Id;文本版本兼容前端引擎精度丢失,服务端确保渲染,输入时优先级别高于同字段
backCategory
string 
可选
<= 200 字符
brandName
string 
自营品牌名称
可选
productName
string 
商品名称
必需
<= 40 字符
sellingPoint
string 
卖点
可选
<= 60 字符
noSpecifications
boolean 
是否无规格
可选
paymentTypeList
array[string]
可选
无规格商品 的支付方式;显然无规格的时候是必须的
prices
object (SkuPrices) 
可选
无规格商品 就写这里的价格;显然无规格的时候是必须的
underlined
object (CombinedPrice) 
划线价
必需
standard
object (CombinedPrice) 
普通价
必需
platinum
object (CombinedPrice) 
白金价
必需
exclusive
object (CombinedPrice) 
尊享价
必需
merchantCost
number 
商户结算价
必需
centralizedSupply
number 
* 集采价格
必需
centralizedSupplySettlement
number 
* 集采结算价格
必需
initFactStock
integer 
初始库存
可选
skuList
array[object (CustomProductSku) {12}] 
详细规格
可选
barCode
string 
条形码
可选
skuCode
string 
可选
quantityCentralizedPrices
array[object (QuantityCentralizedPrice) {3}] 
阶梯式集采价格
可选
merchantCode
string 
可选
商户 sku code
选填,填写的话 必须确保 spu 内唯一
<= 64 字符
taxRate
number 
可选
不超过100 税率 税率*100
如果税率是7%,那么该值会是7而非0.07
id
integer <int64>
可选
新增 sku 不要传入值;编辑时必须传入 当时的 id
imageUrl
string 
sku 图片
可选
paymentTypeList
array[string]
支付方式
必需
saleProperties
array[object (ProductProperty) {5}] 
销售属性
可选
prices
object (SkuPrices) 
各种几个
必需
initFactStock
integer 
初始库存
可选
taxClassCode
string 
税收分类编码
可选
detail
object (ProductDetail) 
更多详情
必需
carouselImages
string 
可选
轮播图片地址 支持多个,用半角分号间隔
轮播图片地址,支持多个,用半角分号间隔
detailImages
string 
可选
商品详情图 支持多个,用半角分号间隔
商品详情图,支持多个,用半角分号间隔
detailHtml
string 
可选
html code 详情HTML
video
string 
可选
URL 商品视频地址
videoCover
string 
可选
URL 商品视频封面图片地址
afterSalesLabel
string 
可选
售后服务类别 label
taxClassCode
string 
税收分类编码
可选
示例
{
  "onlyQuantityCentralizedPricesChanged": false,
  "limitation": {
    "centralizedMinNum": 0,
    "limitedNum": 0,
    "minNum": 0
  },
  "stateSubsidyExtra": {
    "provinceCode": "",
    "categoryCode": "",
    "preferentialCode": "",
    "a05Type": "",
    "ai": false,
    "energyEfficiencyGrade": 0,
    "energyEfficiencyLevel": 0,
    "communication": false,
    "dualSim": false,
    "manufacturerCertCode": "",
    "properties": {
      "": {}
    }
  },
  "otherSharingProperties": {
    "": {}
  },
  "enableStateSubsidy": false,
  "barCode": "",
  "quantityCentralizedPrices": [
    {
      "startQuantity": 0,
      "price": 0.0,
      "settlementPrice": 0.0
    }
  ],
  "custom": false,
  "merchantCode": "",
  "code": "",
  "taxRate": 0.0,
  "id": 0,
  "merchantId": 0,
  "merchantIdInText": "",
  "merchantName": "",
  "frontCategoryId": 0,
  "frontCategoryIdInText": "",
  "frontCategoryName": "",
  "frontCategoryIds": [
    0
  ],
  "frontCategoryIdsInText": [
    ""
  ],
  "frontCategoryNames": [
    ""
  ],
  "backCategoryId": 0,
  "backCategoryIds": [],
  "backCategoryIdInText": "",
  "backCategory": "",
  "brandName": "",
  "productName": "",
  "sellingPoint": "",
  "noSpecifications": false,
  "paymentTypeList": [
    ""
  ],
  "prices": {
    "underlined": {
      "price": 0.0,
      "integral": 0,
      "integralCredit": 0
    },
    "standard": {
      "price": 0.0,
      "integral": 0,
      "integralCredit": 0
    },
    "platinum": {
      "price": 0.0,
      "integral": 0,
      "integralCredit": 0
    },
    "exclusive": {
      "price": 0.0,
      "integral": 0,
      "integralCredit": 0
    },
    "merchantCost": 0.0,
    "centralizedSupply": 0.0,
    "centralizedSupplySettlement": 0.0
  },
  "initFactStock": 0,
  "skuList": [
    {
      "barCode": "",
      "skuCode": "",
      "quantityCentralizedPrices": [
        {
          "startQuantity": 0,
          "price": 0.0,
          "settlementPrice": 0.0
        }
      ],
      "merchantCode": "",
      "taxRate": 0.0,
      "id": 0,
      "imageUrl": "",
      "paymentTypeList": [
        ""
      ],
      "saleProperties": [
        {
          "id": 0,
          "name": "",
          "value": "",
          "imageUrl": "",
          "idAsText": ""
        }
      ],
      "prices": {
        "underlined": {
          "price": 0.0,
          "integral": 0,
          "integralCredit": 0
        },
        "standard": {
          "price": 0.0,
          "integral": 0,
          "integralCredit": 0
        },
        "platinum": {
          "price": 0.0,
          "integral": 0,
          "integralCredit": 0
        },
        "exclusive": {
          "price": 0.0,
          "integral": 0,
          "integralCredit": 0
        },
        "merchantCost": 0.0,
        "centralizedSupply": 0.0,
        "centralizedSupplySettlement": 0.0
      },
      "initFactStock": 0,
      "taxClassCode": ""
    }
  ],
  "detail": {
    "carouselImages": "",
    "detailImages": "",
    "detailHtml": "",
    "video": "",
    "videoCover": ""
  },
  "afterSalesLabel": "",
  "taxClassCode": ""
}
修改于 2025-07-09 07:06:45
上一页
更新自建商品,并且提交审核,别尝试对非自建商品使用
下一页
得到基础分期策略配置
Built with