宁波银行开放接口
  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/list/decoration

请求参数

Query 参数
keyword
string 
可选
size
integer <int64>
可选
>= 1<= 200
current
integer <int64>
可选
>= 1
merchantName
string 
按所属商户名字搜索
可选
merchantId
string 
按所属商户id搜索
可选
categoryName
string 
按类目名字搜索
可选
categoryId
string 
按类目id搜索
可选
stockStatus
integer 
可选
按库存搜索标记 0:小于 1:大于
priceStatus
string 
可选
按价格搜索标记 0:降序 1:升序
saleStatus
string 
可选
按销量搜索标记 0:降序 1:升序
conditionSort
integer 
可选
按特定条件排序搜索 0-实际销量升序、1-实际销量降序、2-销售价升序、3-销售价降序、4-GMV升序、5-GMV降序、6-上架时间升序、7-上架时间降序
stockNum
integer 
按库存数量搜索
可选
stockNumMin
integer 
可选
按库存数量搜索-最小值
stockNumMax
integer 
可选
按库存数量搜索-最大值
sellPriceMin
string 
可选
按销售价搜索-最小值
sellPriceMax
string 
可选
按销售价搜索-最大值
settlementPriceMin
string 
可选
按结算价搜索-最小值
settlementPriceMax
string 
可选
按结算价搜索-最大值
actualSalesVolumeMin
integer 
可选
按实际销量搜索-最小值
actualSalesVolumeMax
integer 
可选
按实际销量搜索-最大值
merManagerId
string 
可选
按商户管户人行内工号搜索
merIntroducerId
string 
可选
按商户引入人行内工号搜索
affiliatedInstitutionId
integer <int64>
按所属机构id搜索
可选
productStatus
string 
可选
按上下架状态搜索 0:下架 1:上架
auditStatus
integer 
可选
按审核状态搜索 1:添加审核 2:定价审核
auditResult
integer 
可选
按审核结果搜索 0:审核拒绝 1:审核通过 2:待审核 3:审核中
leadingPriceStatus
string 
可选
是否导价 0:否 1:是
name
string 
按商品名称搜索
可选
activityId
string 
按参与活动id搜索
可选
spu
string 
按spu搜索
可选
spuCodeList
string 
可选
准确的spuCode,支持多个 用逗号分割
skuCodeList
string 
可选
准确的skuCode,支持多个 用逗号分割
tagId
integer <int64>
可选
标签id; 一般用于专题,分组
sku
string 
按sku搜索
可选
spuId
string 
按spuId搜索
可选
userLevel
string 
可选
storeId
integer <int64>
可选
stateSubsidy
boolean 
可选
是否只查询国补商品;默认只查询非国补商品
stateSubsidyProvinceCode
string 
可选
按特定国补运营区域搜索,该值有效则暗示{@link #stateSubsidy}
stateSubsidyCategoryCode
string 
可选
按特定国补品类搜索,该值有效则暗示{@link #stateSubsidy}

示例代码

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/list/decoration'

返回响应

🟢200成功
application/json
Body
pages
integer <int64>
可选
current
integer <int64>
可选
size
integer <int64>
可选
total
integer <int64>
可选
records
array[object (ProductVo) {86}] 
可选
id
integer <int64>
可选
code
string 
可选
supplierCode
string 
可选
供应商那边提供的code
imageUrl
string 
可选
brandName
string 
可选
categoryName
string 
可选
categorysName
string 
可选
minMarketPrice
number 
可选
这个spu的最低市场价;普通商品有效
maxMarketPrice
number 
可选
这个spu的最高市场价;普通商品有效
minSellPrice
number 
可选
这个spu的最低销售价;普通商品有效
maxSellPrice
number 
可选
这个spu的最高销售价;普通商品有效
minSupplyPrice
number 
可选
这个spu的最低会员价/供应价;普通商品有效
maxSupplyPrice
number 
可选
这个spu的最高会员价/供应价;普通商品有效
minUseableStock
integer 
可选
这个spu的最低可用库存;普通商品有效
maxUseableStock
integer 
可选
这个spu的最高可用库存;普通商品有效
sumMarketPrice
number 
可选
这个spu的市场价;组合商品有效
sumSellPrice
number 
可选
这个spu的销售价;组合商品有效
sumSupplyPrice
number 
可选
这个spu的会员价/供应价;组合商品有效
sumUseableStock
integer 
可选
这个spu的可用库存;组合商品有效
minCentralizedSupplyPrice
number 
最低集采价格
可选
maxCentralizedSupplyPrice
number 
最大集采价格
可选
minCentralizedSupplySettlementPrice
number 
最低集采结算价格
可选
maxCentralizedSupplySettlementPrice
number 
最高集采结算价格
可选
centralizedInitialPurchaseQuantity
integer 
可选
集中采购最小起购数量,为 null or 小于等于 0 就是无限定
minMemberPrice
number 
最低会员价
可选
minMemberIntegralPrice
number 
最低会员价-波豆
可选
minUnderlinedPrice
number 
最低划线价
可选
minUnderlinedIntegralPrice
number 
最低划线价-波豆
可选
minStandardPrice
number 
最低普通价
可选
minStandardIntegralPrice
number 
最低普通价-波豆
可选
minPlatinumPrice
number 
最低白金价
可选
minPlatinumIntegralPrice
number 
最低白金价-波豆
可选
minExclusivePrice
number 
最低尊享价
可选
minExclusiveIntegralPrice
number 
最低尊享价-波豆
可选
maxUnderlinedPrice
number 
最高划线价
可选
maxUnderlinedIntegralPrice
number 
最高划线价-波豆
可选
maxStandardPrice
number 
最高普通价
可选
maxStandardIntegralPrice
number 
最高普通价-波豆
可选
maxPlatinumPrice
number 
最高白金价
可选
maxPlatinumIntegralPrice
number 
最高白金价-波豆
可选
maxExclusivePrice
number 
最高尊享价
可选
maxExclusiveIntegralPrice
number 
最高尊享价-波豆
可选
updateTime
string 
可选
skuCount
integer 
可选
允许可见的范围内 sku的数量
supplierDisabled
boolean 
可选
disabled
boolean 
内部上下架
可选
disabledForSolo
boolean 
是否单独禁售
可选
auditStatus
enum<string> 
审核状态
可选
枚举值:
ADDPRICE
auditResult
enum<string> 
审核结果
可选
枚举值:
REFUSEAPPROVEDWAITIN_REVIEW
usableBoDou
boolean 
是否支持波豆抵扣
可选
activityStatus
boolean 
是否关联活动
可选
merchantName
string 
所属商户
可选
merchantId
string 
所属商户id
可选
merManagerId
string 
商户管户人行内工号
可选
merIntroducerId
string 
商户引入人行内工号
可选
paymentType
string 
可选
userSalesVolume
integer 
对客销量
可选
salesVolume
integer 
实际销量
可选
standardMinPrice
number 
可选
platinumMinPrice
number 
可选
exclusiveMinPrice
number 
可选
preferentialAmount
number 
可选
最低价值 sku的 最多可优惠金额
usableGiftCard
boolean 
是否礼金卡可用
可选
name
string 
可选
sellingPoint
string 
可选
custom
boolean 
是否自建商品
可选
hide
boolean 
可选
是否隐藏,隐藏的商品即使上架状态也不会在列表中展示。
usableUpdateProduct
boolean 
是否能编辑商品
可选
departmentName
string 
添加商品的部门
可选
departmentId
integer <int64>
添加商品的部门id
可选
productDetailUrl
string 
详情页地址
可选
productDetailShowUrl
string 
详情页展示地址
可选
enableInstalment
boolean 
可选
bestPeriod
integer 
可选
minExchangeCouponSalesPrice
number 
可选
兑换券列表专用 该spu的最小兑换券售价
minExchangeCouponUnderlinePrice
number 
可选
兑换券列表专用 该spu的最小兑换券划线价
productType
enum<string> 
商品类型
可选
枚举值:
NORMAL_PRODUCTGIFT_PRODUCT
storeId
integer <int64>
店铺id
可选
storeName
string 
店铺名称
可选
lastOnSaleTime
string 
可选
newProduct
boolean 
是否新品
可选
categoryRankData
object (ProductInCategoryRankDataVO) 
热销信息,可空
可选
stateSubsidyProvinceData
object (ChinaProvinceData) 
国补运营区域
可选
stateSubsidyCategoryData
object (StateSubsidyCategoryData) 
国补品类
可选
idAsText
string 
可选
enabled
boolean 
可选
示例
{
  "pages": 0,
  "current": 0,
  "size": 0,
  "total": 0,
  "records": [
    {
      "id": 0,
      "code": "",
      "supplierCode": "",
      "imageUrl": "",
      "brandName": "",
      "categoryName": "",
      "categorysName": "",
      "minMarketPrice": 0.0,
      "maxMarketPrice": 0.0,
      "minSellPrice": 0.0,
      "maxSellPrice": 0.0,
      "minSupplyPrice": 0.0,
      "maxSupplyPrice": 0.0,
      "minUseableStock": 0,
      "maxUseableStock": 0,
      "sumMarketPrice": 0.0,
      "sumSellPrice": 0.0,
      "sumSupplyPrice": 0.0,
      "sumUseableStock": 0,
      "minCentralizedSupplyPrice": 0.0,
      "maxCentralizedSupplyPrice": 0.0,
      "minCentralizedSupplySettlementPrice": 0.0,
      "maxCentralizedSupplySettlementPrice": 0.0,
      "centralizedInitialPurchaseQuantity": 0,
      "minMemberPrice": 0.0,
      "minMemberIntegralPrice": 0.0,
      "minUnderlinedPrice": 0.0,
      "minUnderlinedIntegralPrice": 0.0,
      "minStandardPrice": 0.0,
      "minStandardIntegralPrice": 0.0,
      "minPlatinumPrice": 0.0,
      "minPlatinumIntegralPrice": 0.0,
      "minExclusivePrice": 0.0,
      "minExclusiveIntegralPrice": 0.0,
      "maxUnderlinedPrice": 0.0,
      "maxUnderlinedIntegralPrice": 0.0,
      "maxStandardPrice": 0.0,
      "maxStandardIntegralPrice": 0.0,
      "maxPlatinumPrice": 0.0,
      "maxPlatinumIntegralPrice": 0.0,
      "maxExclusivePrice": 0.0,
      "maxExclusiveIntegralPrice": 0.0,
      "updateTime": "",
      "skuCount": 0,
      "supplierDisabled": false,
      "disabled": false,
      "disabledForSolo": false,
      "auditStatus": "",
      "auditResult": "",
      "usableBoDou": false,
      "activityStatus": false,
      "merchantName": "",
      "merchantId": "",
      "merManagerId": "",
      "merIntroducerId": "",
      "paymentType": "",
      "userSalesVolume": 0,
      "salesVolume": 0,
      "standardMinPrice": 0.0,
      "platinumMinPrice": 0.0,
      "exclusiveMinPrice": 0.0,
      "preferentialAmount": 0.0,
      "usableGiftCard": false,
      "name": "",
      "sellingPoint": "",
      "custom": false,
      "hide": false,
      "usableUpdateProduct": false,
      "departmentName": "",
      "departmentId": 0,
      "productDetailUrl": "",
      "productDetailShowUrl": "",
      "enableInstalment": false,
      "bestPeriod": 0,
      "minExchangeCouponSalesPrice": 0.0,
      "minExchangeCouponUnderlinePrice": 0.0,
      "productType": "",
      "storeId": 0,
      "storeName": "",
      "lastOnSaleTime": "",
      "newProduct": false,
      "categoryRankData": {
        "id": "",
        "name": "",
        "rank": 0
      },
      "stateSubsidyProvinceData": {
        "code": "",
        "lowercasePy": "",
        "name": ""
      },
      "stateSubsidyCategoryData": {
        "type": "",
        "comment": "",
        "productSelectable": false,
        "parentCode": "",
        "code": "",
        "name": "",
        "reg3c": false,
        "activityType": "",
        "activityCode": "",
        "taxCode": "",
        "taxRateWith100": 0.0,
        "wpMerchantCode": "",
        "wpServiceCode": ""
      },
      "idAsText": "",
      "enabled": false
    }
  ]
}
修改于 2025-07-09 07:06:45
上一页
🫥 通过code更新隐藏状态
下一页
获取商品(sku)列表
Built with