京东工业商品详情 API 技术解析|B2B 工业品数据对接方案(含标准 JSON 返回示例)
一、接口基础概述
接口名称:京东工业单品详情查询接口
区分:京东工业(B2B 工业品)≠京东零售 C 端联盟接口,工业品接口面向企业采购、MRO 物料管理、工业供应链系统,具备含税价、起订量、工业技术参数、交期、资质文件等 B 端独有字段。
网关地址:o0b.cn/anzexi
请求方式:HTTPS POST
返回格式:标准 JSON
鉴权方式:appKey + appSecret MD5 签名 + access_token 授权
核心入参:skuId(工业品唯一 SKU 编码)
接口能力:传入 SKU,获取工业品标题、品牌、工业类目、阶梯采购价、含税单价、起订量、实时库存、多规格 SKU、技术参数、物料交期、质保信息、商品图文。
主流落地业务场景
企业 MRO 采购 ERP:物料库自动同步京东工业货源,实现线上比价、自动寻源
工业供应链集采平台:搭建工业品商城,商品一键采集上架、价格库存持续同步
制造业物料管理系统:备品备件价格监控,采购成本预警
工业品比价工具:批量抓取多品牌物料报价,筛选最优供应商
第三方采购服务商:对接京东工业货源,实现代下单、统一对账
二、标准成功返回 JSON 示例(工业品完整脱敏样例)
{
"industrial_product_detail_get_response": {
"code": "0",
"msg": "success",
"requestId": "req_202607241510007712",
"result": {
"goodsInfo": {
"skuId": "10200987654321",
"title": "3M 6200半面型防毒面具 化工防尘防毒面罩",
"brandName": "3M",
"categoryName": "安全防护 > 呼吸防护 > 防毒面具",
"shopName": "3M工业自营旗舰店",
"isJdIndustrialSelf": true,
"itemUrl": "https://item.jd.com/10200987654321.html",
"priceInfo": {
"taxPrice": "128.50",
"noTaxPrice": "113.72",
"taxRate": "13%",
"ladderPriceList": [
{"minNum": 1, "price": "128.50"},
{"minNum": 50, "price": "116.20"},
{"minNum": 200, "price": "108.60"}
],
"minOrderNum": 1
},
"stockInfo": {
"availableStock": 1560,
"leadTime": "现货48小时内发货",
"isOnSale": true
},
"imageInfo": {
"mainImg": "https://img14.360buyimg.com/industrial/main.jpg",
"detailImgList": [
"https://img14.360buyimg.com/industrial/d1.jpg",
"https://img14.360buyimg.com/industrial/d2.jpg"
]
},
"skuList": [
{
"subSkuId": "1020098765432101",
"specText": "主体面具 中号M",
"taxPrice": "128.50",
"stock": 920
},
{
"subSkuId": "1020098765432102",
"specText": "主体面具 大号L",
"taxPrice": "128.50",
"stock": 640
}
],
"techParams": [
{"name": "适配滤盒", "value": "6001有机蒸汽滤毒盒"},
{"name": "面罩材质", "value": "硅橡胶"},
{"name": "防护类型", "value": 有机气体、粉尘"},
{"name": "执行标准", "value": GB2890-2009}
],
"serviceInfo": {
"warrantyDesc": "原厂质保12个月",
"canInvoice": true,
"invoiceType": ["增值税专用发票","增值税普通发票"]
}
}
}
}
}三、核心字段精简释义
1. B 端工业特有核心板块
taxPrice:含税采购价(企业采购核心)
taxRate:增值税税率
ladderPriceList:阶梯批量采购价格
minOrderNum:最小起订数量
leadTime:物料交期 / 发货周期
techParams:工业品专业技术参数(区别普通零售商品参数)
2. 通用业务模块
skuId:工业品唯一标识
isJdIndustrialSelf:京东工业自营标识
skuList:多规格子物料价格、库存
stockInfo:现货库存与发货时效
serviceInfo:质保、开票资质信息
四、高频异常 JSON 示例
1. 签名校验失败
{
"industrial_product_detail_get_response": {
"code": "15",
"msg": "签名校验错误,请核对appSecret、服务器时间",
"requestId": "req_202607241512001133"
}
}2. SKU 不存在 / 商品下架
{
"industrial_product_detail_get_response": {
"code": "400",
"msg": "skuId无效或工业品已下架归档",
"requestId": "req_202607241513002244"
}
}3. 接口权限未开通
{
"industrial_product_detail_get_response": {
"code": "403",
"msg": "应用未开通京东工业商品接口权限",
"requestId": "req_202607241514003355"
}
}4. 请求限流
{
"industrial_product_detail_get_response": {
"code": "429",
"msg": "调用频率超限,请延长请求间隔",
"requestId": "req_202607241515004466"
}
}五、开发接入重点注意事项
所有价格字段为字符串,含税价计算时务必转换数值,避免精度丢失;
ladderPriceList、skuList、techParams为数组,代码强制判空,防止解析异常;
京东工业接口 QPS 管控严格,批量物料同步建议分级轮询;
库存、阶梯报价存在短暂延迟,大批量采购场景下单前二次校验;
接口仅面向企业认证开发者开放,个人账号无法开通权限;
严禁采集物料数据对外售卖,仅允许企业内部采购系统合规使用。
六、全文总结
京东工业商品详情 API 是面向 MRO、制造业、政企集采的 B2B 标准化数据源,相比京东零售 C 端接口,重点强化含税阶梯价、起订量、技术参数、交期、开票质保等工业采购核心信息。统一 JSON 结构化输出,可快速实现企业 ERP 物料寻源、商城铺货、采购价格监控、供应链比价,是工业品数字化采购系统主流对接方案。