京东商品详情API字段拆解：SKU、券后价、库存数据提取思路

一、前置说明

很多开发者接入京东商品详情接口后最头疼三个数据：多 SKU 规格映射、真实券后到手价、实时库存。接口原始返回字段嵌套层级深，促销、满减、优惠券分散在不同节点，直接取 price 字段很容易拿到标价，不是用户最终成交价；库存也区分仓库存、可售、预售库存，不做处理容易失真。

二、整体返回结构概览

• API接口名称：jd.item_get（Taobaoapi2014前往体验）；

• 请求地址：c0b.cc/R4rbK2；

• 理解接口限流频次、权限范围，不同应用权限可返回字段存在差异。

接口返回主体一般包含：商品基础信息、sku 集合、促销集合、优惠券列表、库存节点。 核心链路：goodsInfo → skuList（SKU 数组）、promotionInfo（促销活动）、couponInfo（优惠券）、stockInfo（库存）

三、SKU 相关字段拆解

核心字段

• skuId：SKU 唯一 ID，查询价格、库存、下单都依赖这个 id

• skuName：SKU 规格名称（颜色、尺寸、版本等）

• skuPic：SKU 对应缩略图

• originalPrice：SKU 原价 / 划线价

• price：联盟价 / 销售标价（不等于券后价）

• skuStatus：SKU 状态，1 = 正常可售，0 = 下架

提取思路

• 遍历 skuList 数组，以 skuId 作为主键建立映射表；

• 把规格名称做结构化拆分，例如 颜色:黑色;容量:256G，方便存入数据库用于筛选；

• 过滤掉下架 SKU，避免无效数据入库；

• 注意：同一个 spu 下不同 sku 的价格、库存、促销相互独立，不能拿 SPU 价格覆盖所有 SKU。

踩坑点：部分商品 SKU 规格是组合式，接口返回文本没有固定分隔符，需要自己做清洗，直接前端展示容易乱码。

四、券后价提取思路（重点难点）

京东联盟接口的优惠分为三层：单品直降、店铺满减、单品优惠券，优惠可叠加，不能简单拿一个字段。

相关字段

• price：基础销售价

• couponInfoList：优惠券数组

• couponAmount：优惠券面额

• couponCondition：使用门槛（满 XX 可用）

• promotionList：促销活动（直降、满减、限时价）

• promotionType：活动类型标识

• discountPrice：活动直降后价格

计算逻辑（工程上通用简化方案）

• 先取 SKU 基础售价 price；

• 判断是否存在无门槛券：直接 price - couponAmount；

• 门槛券：判断基础售价是否满足 couponCondition，满足再扣减；

• 如果同时存在平台满减、单品直降，按京东优惠叠加顺序依次扣减；

• 兜底校验：券后价不能低于 0，低于 0 则取最低限价；

• 标注：计算得出的券后价是预估到手价，最终以下单页实时计算为准，适合数据分析、比价监控，不可作为结算价。

踩坑点：优惠券有领取时间、库存限制；部分券是定向券，接口能查到券，但普通用户领不到，会出现 “算出来低价，实际用不了”。

五、库存数据提取思路

库存相关字段

• stockNum：可售库存数量

• stockStatus：库存状态：有货、无货、预售、预约

• shipmentType：发货类型（京东自营仓 / 第三方商家仓）

• preSaleInfo：预售信息，包含预售发货时间

提取思路

• 优先读取对应 SKU 维度的 stock，不要读取 SPU 总库存（多 SKU 商品总库存参考意义很小）；

• 区分状态：有货、缺货、预售；预售商品单独标记发货周期；

• 库存数字只做业务参考，京东库存是动态实时扣减，接口返回存在几十秒～几分钟延迟；

• 做监控系统时，不要高频轮询刷库存，配合缓存 + 限流，防止触发平台风控。

踩坑点：自营商品分区域仓库存，不传地区参数的情况下，接口返回的是默认仓库存，和用户实际收货地址看到的库存不一致。

六、简易 JSON 样例（脱敏简化版，方便调试）

{
  "code": 200,
  "data": {
    "goodsInfo": {
      "skuList": [
        {
          "skuId": 100012345678,
          "skuName": "黑色 8G+256G",
          "originalPrice": 2999,
          "price": 2499,
          "skuStatus": 1
        }
      ],
      "couponInfoList": [
        {
          "couponAmount": 200,
          "couponCondition": 2000
        }
      ],
      "stockInfo": {
        "stockNum": 35,
        "stockStatus": "有货"
      }
    }
  }
}

七、工程落地建议

• 存储设计：skuId 作为唯一主键，单独一张 SKU 明细表，把原价、标价、预估券后价、库存、规格分开存储；

• 增加缓存层：商品基础信息缓存时间长一点，价格、库存缩短缓存 TTL；

• 数据标记：券后价增加字段 calcType，标注是【预估计算】，避免业务方当成实价；

• 异常处理：接口返回促销节点为空、优惠券过期时，降级只展示标价；

• 合规提醒：优先使用京东联盟官方 API，不要使用页面爬虫采集，规避风控与合规风险。

八、文末小结

SKU、券后价、库存是电商竞品监控、ERP 同步、跨境选品最核心的三类指标。京东联盟接口没有直接返回 “finalPrice 最终券后价” 字段，需要我们根据促销、优惠券规则自行计算；库存受地域仓影响存在偏差，业务上要明确数据边界，避免业务误判。