首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >京东工业商品详情 API 技术解析|B2B 工业品数据对接方案(含标准 JSON 返回示例)

京东工业商品详情 API 技术解析|B2B 工业品数据对接方案(含标准 JSON 返回示例)

原创
作者头像
Anzexi58
发布2026-07-24 16:10:47
发布2026-07-24 16:10:47
140
举报
文章被收录于专栏:API接口开发API接口开发

一、接口基础概述

接口名称:京东工业单品详情查询接口

区分:京东工业(B2B 工业品)≠京东零售 C 端联盟接口,工业品接口面向企业采购、MRO 物料管理、工业供应链系统,具备含税价、起订量、工业技术参数、交期、资质文件等 B 端独有字段。

  • 网关地址:o0b.cn/anzexi
  • 请求方式:HTTPS POST
  • 返回格式:标准 JSON
  • 鉴权方式:appKey + appSecret MD5 签名 + access_token 授权
  • 核心入参:skuId(工业品唯一 SKU 编码)
  • 接口能力:传入 SKU,获取工业品标题、品牌、工业类目、阶梯采购价、含税单价、起订量、实时库存、多规格 SKU、技术参数、物料交期、质保信息、商品图文。

主流落地业务场景

  1. 企业 MRO 采购 ERP:物料库自动同步京东工业货源,实现线上比价、自动寻源
  2. 工业供应链集采平台:搭建工业品商城,商品一键采集上架、价格库存持续同步
  3. 制造业物料管理系统:备品备件价格监控,采购成本预警
  4. 工业品比价工具:批量抓取多品牌物料报价,筛选最优供应商
  5. 第三方采购服务商:对接京东工业货源,实现代下单、统一对账

二、标准成功返回 JSON 示例(工业品完整脱敏样例)

代码语言:javascript
复制
{
    "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. 签名校验失败

代码语言:javascript
复制
{
    "industrial_product_detail_get_response": {
        "code": "15",
        "msg": "签名校验错误,请核对appSecret、服务器时间",
        "requestId": "req_202607241512001133"
    }
}

2. SKU 不存在 / 商品下架

代码语言:javascript
复制
{
    "industrial_product_detail_get_response": {
        "code": "400",
        "msg": "skuId无效或工业品已下架归档",
        "requestId": "req_202607241513002244"
    }
}

3. 接口权限未开通

代码语言:javascript
复制
{
    "industrial_product_detail_get_response": {
        "code": "403",
        "msg": "应用未开通京东工业商品接口权限",
        "requestId": "req_202607241514003355"
    }
}

4. 请求限流

代码语言:javascript
复制
{
    "industrial_product_detail_get_response": {
        "code": "429",
        "msg": "调用频率超限,请延长请求间隔",
        "requestId": "req_202607241515004466"
    }
}

五、开发接入重点注意事项

  1. 所有价格字段为字符串,含税价计算时务必转换数值,避免精度丢失;
  2. ladderPriceList、skuList、techParams为数组,代码强制判空,防止解析异常;
  3. 京东工业接口 QPS 管控严格,批量物料同步建议分级轮询;
  4. 库存、阶梯报价存在短暂延迟,大批量采购场景下单前二次校验;
  5. 接口仅面向企业认证开发者开放,个人账号无法开通权限;
  6. 严禁采集物料数据对外售卖,仅允许企业内部采购系统合规使用。

六、全文总结

京东工业商品详情 API 是面向 MRO、制造业、政企集采的 B2B 标准化数据源,相比京东零售 C 端接口,重点强化含税阶梯价、起订量、技术参数、交期、开票质保等工业采购核心信息。统一 JSON 结构化输出,可快速实现企业 ERP 物料寻源、商城铺货、采购价格监控、供应链比价,是工业品数字化采购系统主流对接方案。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 一、接口基础概述
  • 主流落地业务场景
  • 二、标准成功返回 JSON 示例(工业品完整脱敏样例)
  • 三、核心字段精简释义
  • 1. B 端工业特有核心板块
  • 2. 通用业务模块
  • 四、高频异常 JSON 示例
  • 1. 签名校验失败
  • 2. SKU 不存在 / 商品下架
  • 3. 接口权限未开通
  • 4. 请求限流
  • 五、开发接入重点注意事项
  • 六、全文总结
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档