宁波银行开放接口
  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. 后台接口-商品模块

🌕 通过code获取商品详情

GET
/products/byCode/{id}

请求参数

Path 参数
id
string 
商品code
必需

示例代码

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/byCode/'

返回响应

🟢200成功
application/json
Body
展示一个商品的详情咯
code
string 
spu code
可选
name
string 
可选
merchantCode
string 
可选
merchantId
string 
可选
merchantName
string 
可选
category
integer <int64>
前端类目id
可选
categoryName
string 
前端类目名称
可选
categorys
string 
可选
前端类目id用逗号合并的字符串
categorysName
string 
可选
前端类目名称用逗号合并的字符串
frontCategories
array[string]
类目名称-数组
可选
frontCategoryIds
array[string]
类目id-数组
可选
brand
integer <int64>
品牌id
可选
brandName
string 
品牌名称
可选
sellingPoint
string 
可选
长度不超过60 商品卖点
supplyChainVoucher
string 
可选
供应链凭证图片 支持多个,用半角分号间隔
供应链凭证图片 支持多个,用半角分号间隔
imageUrl
string 
URL 缩略图地址
可选
taxRate
number 
可选
不超过100 税率 税率100
如果税率是7%,那么该值会是7而非0.07
不超过100,税率
100 如果税率是7%,那么该值会是7而非0.07
taxClassCode
string 
税收分类编码
可选
initialPurchaseQuantity
integer 
可选
起购数量, 0 表示不限制
limitedPurchaseQuantity
integer 
可选
限购数量 0 表示不限制
centralizedInitialPurchaseQuantity
integer 
可选
集中采购最小起购数量,为 null or 小于等于 0 就是无限定
detail
object (ProductDetail) 
商品详情
可选
carouselImages
string 
可选
轮播图片地址 支持多个,用半角分号间隔
轮播图片地址,支持多个,用半角分号间隔
detailImages
string 
可选
商品详情图 支持多个,用半角分号间隔
商品详情图,支持多个,用半角分号间隔
detailHtml
string 
可选
html code 详情HTML
video
string 
可选
URL 商品视频地址
videoCover
string 
可选
URL 商品视频封面图片地址
afterSalesType
integer <int64>
可选
售后服务类别
0 或者空就表示没有,理论上是不会允许已设置售后的变更为没有的,所以如果存在空值覆盖有值应当被过滤
enableStateSubsidy
boolean 
可选
是否为国补商品
这是一个不接受更新的字段
otherSharingProperties
object (MapObject) 
可选
展示一个商品的详情咯
key
object (key) 
可选
展示一个商品的详情咯
createTime
string 
可选
version
integer 
可选
updateTime
string 
可选
id
integer <int64>
可选
idAsText
string 
可选
就是id,文本格式而已
nameEdit
string 
可选
sellingPointEdit
string 
可选
supplierDisabled
boolean 
可选
基于任何原因,供应平台下架了该商品;若该值为true 则不应该继续参与任何业务。
disabled
boolean 
可选
我方是否已经下架,默认就是下架状态
platform
enum<string> 
可选
枚举值:
LecaiMallCombined
owner
integer <int64>
可选
supplierCode
string 
可选
供应商那边提供的code
auditStatus
integer 
可选
审核状态
其值于{@link ProductAuditEnums.AuditStatus#getCode()}相等
auditResult
integer 
可选
审核结果
其值于{@link ProductAuditEnums.AuditResult#getCode()}相等
auditId
integer <int64>
审核id
可选
disabledForSolo
boolean 
是否单独不可售
可选
custom
boolean 
是否自建商品
可选
hide
boolean 
可选
是否隐藏,隐藏的商品即使上架状态也不会在列表中展示。
departmentId
integer <int64>
部门Id
可选
parentDepartmentId
integer <int64>
上级部门Id
可选
rootDepartmentId
integer <int64>
顶级部门ID
可选
storeId
integer <int64>
关联店铺
可选
minSkuInfo
string 
可选
sku各价位的最小价格信息json
prdInstalmentConfig
object (PrdInstalmentConfig) 
可选
展示一个商品的详情咯
enableInstalment
boolean 
是否支持分期
可选
items
array[object (InstalmentConfigItem) {5}] 
分期配置
可选
bestPeriod
integer 
可选
最长免息期数,没有则为0
enableInstalment
boolean 
是否支持分期
可选
stateSubsidyProduct
object (StateSubsidyProductDataSuite) 
国补商品信息
可选
data
object (ProductStateSubsidyExtraEntity) 
国补商品信息
可选
provinceData
object (ChinaProvinceData) 
行政区明细
可选
categoryData
object (StateSubsidyCategoryData) 
国补品类明细
可选
skuList
array[object (ProductSkuEntity) {54}] 
相关sku
可选
code
string 
可选
长度不大于10 sku code
sku code
barCode
string 
条形码
可选
merchantCode
string 
商家自编码
可选
imageUrl
string 
URL 商品图片
可选
marketPrice
number 
可选
价格 市场价格
市场价
sellPrice
number 
可选
价格 建议零售价
建议零售价 销售价
supplyPrice
number 
可选
价格 结算价格
供货价(结算价) 会员价
centralizedSupplyPrice
number 
可选
价格 集采价格
集采价格
centralizedSupplySettlementPrice
number 
可选
价格 集采结算价格
集采结算价格
quantityCentralizedPrices
array[object (QuantityCentralizedPrice) {3}] 
可选
paymentTypeList
array[integer]
可选
新增字段
商品支付类型list
underlinedPrice
number 
划线价
可选
standardPrice
number 
普通价
可选
underlinedIntegralPrice
number 
划线价-波豆
可选
standardIntegralPrice
number 
普通价-波豆
可选
platinumPrice
number 
白金价
可选
platinumIntegralPrice
number 
白金价-波豆
可选
exclusivePrice
number 
尊享价
可选
exclusiveIntegralPrice
number 
尊享价-波豆
可选
memberPrice
number 
会员价
可选
memberIntegralPrice
number 
会员价-波豆
可选
salesProperties
array[object (ProductProperty) {5}] 
可选
作为输入数据时,这个字段是不可缺省,若无属性必须是一个空组。
销售属性
factStock
integer 
实际库存
可选
useableStock
integer 
可用库存
可选
createTime
string 
可选
version
integer 
可选
updateTime
string 
可选
id
integer <int64>
可选
idAsText
string 
可选
就是id,文本格式而已
supplierDisabled
boolean 
可选
基于任何原因,供应平台下架了该商品;若该值为true 则不应该继续参与任何业务。
disabled
boolean 
可选
supplierCode
string 
可选
供应商那边提供的code
这个绝对不是sku code别弄错了
productId
integer <int64>
可选
paymentType
enum<string> 
可选
枚举值:
ONLINE_CREDIT_CARDONLINE_DEBIT_CARDOTHER_DEBIT_CARDPAY_METHOD_BONUSPAY_METHOD_COUPON
firstOnSaleTime
string 
首次上架时间
可选
lastOnSaleTime
string 
最后上架时间
可选
firstOffSaleTime
string 
首次下架时间
可选
lastOffSaleTime
string 
最后下架时间
可选
taxRate
number 
可选
不超过100 税率 税率*100
如果税率是7%,那么该值会是7而非0.07如果为 null则应该去{@link SpuImportable#getTaxRate() spu数据}
taxClassCode
string 
可选
税收分类编码
如果为 null则应该去{@link SpuImportable#getTaxClassCode() spu数据}
auditResult
enum<string> 
可选
枚举值:
REFUSEAPPROVEDWAITIN_REVIEW
activityProductSkuId
integer <int64>
可选
salesVolumeAdjust
integer 
销量增额
可选
salesVolume
integer 
实际销量
可选
userSalesVolume
integer 
对客销量
可选
preferentialAmount
number 
可选
非持久化字段
最多可优惠金额
usableGiftCard
boolean 
是否礼金卡可用
可选
usableUpdateProduct
boolean 
是否能编辑商品
可选
departmentName
string 
添加商品的部门
可选
departmentId
integer <int64>
添加商品的部门id
可选
exchangeCouponSalesPrice
number 
兑换券售价
可选
exchangeCouponUnderlinePrice
number 
兑换券划线价
可选
exchangeCouponStock
integer 
可选
兑换券库存,当库存填写为0时,移动端对客不展示该SKU,所有sku均为0时显示商品已售罄
enabled
boolean 
可选
combinedElements
array[object (CombinedElementVo) {33}] 
可选
作为一个组合商品,这是它所关联的实际sku
id
integer <int64>
可选
idAsText
string 
可选
productId
integer <int64>
可选
spuCode
string 
可选
sellingPoint
string 
可选
skuCode
string 
可选
name
string 
可选
nameEdit
string 
可选
imageUrl
string 
可选
marketPrice
number 
市场价格
可选
sellPrice
number 
建议零售价 销售价
可选
supplyPrice
number 
供应价 会员价
可选
supplierSkuCode
string 
可选
这个绝对不是sku code别弄错了
platform
enum<string> 
可选
枚举值:
LecaiMallCombined
ownerId
integer <int64>
可选
afterSalesLabel
string 
售后标签
可选
attributes
string 
销售属性
可选
useableStock
integer 
可选
factStock
integer 
可选
createTime
string 
可选
disabledForSolo
boolean 
是否单独禁售
可选
initialPurchaseQuantity
integer 
可选
limitedPurchaseQuantity
integer 
可选
paymentType
string 
可选
商品的支付方式,目前是 5 位
userSalesVolume
integer 
对客销量
可选
salesVolume
integer 
实际销量
可选
storeId
integer <int64>
可选
illegalPrices
array[object (PriceWarnRuleResult) {5}] 
可选的违约价格明细
可选
stockWarnReference
integer 
可选
可选的库存预警参考值
lastStockUpdateTime
string 
可选
可选的库存最后更新时间
merchantName
string 
所属商户
可选
amount
integer 
数量
可选
enabled
boolean 
可选
tags
array[string]
分组标签
可选
afterSalesLabel
string 
售后label
可选
usableBoDou
boolean 
是否支持波豆抵扣
可选
paymentType
string 
可选
activityProductId
integer <int64>
活动商品spuId
可选
activityId
integer <int64>
活动id
可选
isAddCart
boolean 
可否添加购物车
可选
startTime
string 
可售开始时间
可选
endTime
string 
可售结束时间
可选
giftProductId
string 
礼包商品id
可选
productType
enum<string> 
商品类型
可选
枚举值:
NORMAL_PRODUCTGIFT_PRODUCT
lastOnSaleTime
string 
可选
newProduct
boolean 
是否新品
可选
categoryRankData
object (ProductInCategoryRankDataVO) 
热销信息,可空
可选
id
string 
顶级类目 id
可选
name
string 
顶级类目名称
可选
rank
integer 
排名
可选
selectedActivityInfoVoList
array[object (EffectiveSelectedActivityInfoVO) {9}] 
精选活动满减
可选
activityId
integer <int64>
活动id
可选
selectedActivityProductId
integer <int64>
精选活动商品id
可选
spuId
integer <int64>
商品spuId
可选
totalStock
integer 
精选商品总库存
可选
usedNum
integer 
已购买数量
可选
fullReductionPrice
number 
可选
满减价格 满多少可减免
fullReductionAmount
number 
可选
满减金额 可减免多少钱
startTime
string 
活动开始时间
可选
endTime
string 
活动结束时间
可选
frontCategoryPairs
array[object (PairString) {2}] 
可选
key
string 
可选
value
string 
可选
enabled
boolean 
可选
userSalesVolume
integer 
对客销量
可选
示例
{
  "code": "",
  "name": "",
  "merchantCode": "",
  "merchantId": "",
  "merchantName": "",
  "category": 0,
  "categoryName": "",
  "categorys": "",
  "categorysName": "",
  "frontCategories": [
    ""
  ],
  "frontCategoryIds": [
    ""
  ],
  "brand": 0,
  "brandName": "",
  "sellingPoint": "",
  "supplyChainVoucher": "",
  "imageUrl": "",
  "taxRate": 0.0,
  "taxClassCode": "",
  "initialPurchaseQuantity": 0,
  "limitedPurchaseQuantity": 0,
  "centralizedInitialPurchaseQuantity": 0,
  "detail": {
    "carouselImages": "",
    "detailImages": "",
    "detailHtml": "",
    "video": "",
    "videoCover": ""
  },
  "afterSalesType": 0,
  "enableStateSubsidy": false,
  "otherSharingProperties": {
    "": {}
  },
  "createTime": "",
  "version": 0,
  "updateTime": "",
  "id": 0,
  "idAsText": "",
  "nameEdit": "",
  "sellingPointEdit": "",
  "supplierDisabled": false,
  "disabled": false,
  "platform": "",
  "owner": 0,
  "supplierCode": "",
  "auditStatus": 0,
  "auditResult": 0,
  "auditId": 0,
  "disabledForSolo": false,
  "custom": false,
  "hide": false,
  "departmentId": 0,
  "parentDepartmentId": 0,
  "rootDepartmentId": 0,
  "storeId": 0,
  "minSkuInfo": "",
  "prdInstalmentConfig": {
    "enableInstalment": false,
    "items": [
      {
        "id": "",
        "period": 0,
        "interestCostType": "",
        "costRate": 0.0,
        "mrcCostRate": 0.0
      }
    ]
  },
  "bestPeriod": 0,
  "enableInstalment": false,
  "stateSubsidyProduct": {
    "data": {
      "id": 0,
      "provinceCode": "",
      "categoryCode": "",
      "preferentialCode": "",
      "a05Type": "",
      "ai": false,
      "energyEfficiencyGrade": 0,
      "energyEfficiencyLevel": 0,
      "communication": false,
      "dualSim": false,
      "manufacturerCertCode": "",
      "properties": {
        "": {}
      }
    },
    "provinceData": {
      "code": "",
      "lowercasePy": "",
      "name": ""
    },
    "categoryData": {
      "type": "",
      "comment": "",
      "productSelectable": false,
      "parentCode": "",
      "code": "",
      "name": "",
      "reg3c": false,
      "activityType": "",
      "activityCode": "",
      "taxCode": "",
      "taxRateWith100": 0.0,
      "wpMerchantCode": "",
      "wpServiceCode": ""
    }
  },
  "skuList": [
    {
      "code": "",
      "barCode": "",
      "merchantCode": "",
      "imageUrl": "",
      "marketPrice": 0.0,
      "sellPrice": 0.0,
      "supplyPrice": 0.0,
      "centralizedSupplyPrice": 0.0,
      "centralizedSupplySettlementPrice": 0.0,
      "quantityCentralizedPrices": [
        {
          "startQuantity": 0,
          "price": 0.0,
          "settlementPrice": 0.0
        }
      ],
      "paymentTypeList": [
        0
      ],
      "underlinedPrice": 0.0,
      "standardPrice": 0.0,
      "underlinedIntegralPrice": 0.0,
      "standardIntegralPrice": 0.0,
      "platinumPrice": 0.0,
      "platinumIntegralPrice": 0.0,
      "exclusivePrice": 0.0,
      "exclusiveIntegralPrice": 0.0,
      "memberPrice": 0.0,
      "memberIntegralPrice": 0.0,
      "salesProperties": [
        {
          "id": 0,
          "name": "",
          "value": "",
          "imageUrl": "",
          "idAsText": ""
        }
      ],
      "factStock": 0,
      "useableStock": 0,
      "createTime": "",
      "version": 0,
      "updateTime": "",
      "id": 0,
      "idAsText": "",
      "supplierDisabled": false,
      "disabled": false,
      "supplierCode": "",
      "productId": 0,
      "paymentType": "",
      "firstOnSaleTime": "",
      "lastOnSaleTime": "",
      "firstOffSaleTime": "",
      "lastOffSaleTime": "",
      "taxRate": 0.0,
      "taxClassCode": "",
      "auditResult": "",
      "activityProductSkuId": 0,
      "salesVolumeAdjust": 0,
      "salesVolume": 0,
      "userSalesVolume": 0,
      "preferentialAmount": 0.0,
      "usableGiftCard": false,
      "usableUpdateProduct": false,
      "departmentName": "",
      "departmentId": 0,
      "exchangeCouponSalesPrice": 0.0,
      "exchangeCouponUnderlinePrice": 0.0,
      "exchangeCouponStock": 0,
      "enabled": false
    }
  ],
  "combinedElements": [
    {
      "id": 0,
      "idAsText": "",
      "productId": 0,
      "spuCode": "",
      "sellingPoint": "",
      "skuCode": "",
      "name": "",
      "nameEdit": "",
      "imageUrl": "",
      "marketPrice": 0.0,
      "sellPrice": 0.0,
      "supplyPrice": 0.0,
      "supplierSkuCode": "",
      "platform": "",
      "ownerId": 0,
      "afterSalesLabel": "",
      "attributes": "",
      "useableStock": 0,
      "factStock": 0,
      "createTime": "",
      "disabledForSolo": false,
      "initialPurchaseQuantity": 0,
      "limitedPurchaseQuantity": 0,
      "paymentType": "",
      "userSalesVolume": 0,
      "salesVolume": 0,
      "storeId": 0,
      "illegalPrices": [
        {
          "rule": "",
          "current": 0.0,
          "reference": 0.0,
          "humanReadReason": "",
          "willDisable": false
        }
      ],
      "stockWarnReference": 0,
      "lastStockUpdateTime": "",
      "merchantName": "",
      "amount": 0,
      "enabled": false
    }
  ],
  "tags": [
    ""
  ],
  "afterSalesLabel": "",
  "usableBoDou": false,
  "paymentType": "",
  "activityProductId": 0,
  "activityId": 0,
  "isAddCart": false,
  "startTime": "",
  "endTime": "",
  "giftProductId": "",
  "productType": "",
  "lastOnSaleTime": "",
  "newProduct": false,
  "categoryRankData": {
    "id": "",
    "name": "",
    "rank": 0
  },
  "selectedActivityInfoVoList": [
    {
      "activityId": 0,
      "selectedActivityProductId": 0,
      "spuId": 0,
      "totalStock": 0,
      "usedNum": 0,
      "fullReductionPrice": 0.0,
      "fullReductionAmount": 0.0,
      "startTime": "",
      "endTime": ""
    }
  ],
  "frontCategoryPairs": [
    {
      "key": "",
      "value": ""
    }
  ],
  "enabled": false,
  "userSalesVolume": 0
}
修改于 2025-07-09 07:06:45
上一页
🌕 通过id获取商品详情
下一页
🔖 通过id更新标签
Built with