一、前置说明
很多开发者接入京东商品详情接口后最头疼三个数据：多 SKU 规格映射、真实券后到手价、实时库存。接口原始返回字段嵌套层级深，促销、满减、优惠券分散在不同节点，直接取 price 字段很容易拿到标价，不是用户最终成交价；库存也区分仓库存、可售、预售库存，不做处理容易失真。
二、整体返回结构概览
- API接口名称：jd.item_get（Taobaoapi2014前往体验）；
- 请求地址：c0b.cc/R4rbK2；
- 理解接口限流频次、权限范围，不同应用权限可返回字段存在差异。
接口返回主体一般包含：商品基础信息、sku 集合、促销集合、优惠券列表、库存节点。 核心链路：goodsInfo → skuList（SKU 数组）、promotionInfo（促销活动）、couponInfo（优惠券）、stockInfo（库存）
三、SKU 相关字段拆解
核心字段
skuId：SKU 唯一 ID，查询价格、库存、下单都依赖这个 idskuName：SKU 规格名称（颜色、尺寸、版本等）skuPic：SKU 对应缩略图originalPrice：SKU 原价 / 划线价price：联盟价 / 销售标价（不等于券后价）skuStatus：SKU 状态，1 = 正常可售，0 = 下架
提取思路
遍历 skuList 数组，以 skuId 作为主键建立映射表；把规格名称做结构化拆分，例如 颜色:黑色;容量:256G，方便存入数据库用于筛选；- 过滤掉下架 SKU，避免无效数据入库；
- 注意：同一个 spu 下不同 sku 的价格、库存、促销相互独立，不能拿 SPU 价格覆盖所有 SKU。
踩坑点：部分商品 SKU 规格是组合式，接口返回文本没有固定分隔符，需要自己做清洗，直接前端展示容易乱码。
四、券后价提取思路（重点难点）
京东联盟接口的优惠分为三层：单品直降、店铺满减、单品优惠券，优惠可叠加，不能简单拿一个字段。
相关字段
price：基础销售价couponInfoList：优惠券数组promotionList：促销活动（直降、满减、限时价）
计算逻辑（工程上通用简化方案）
先取 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 最终券后价” 字段，需要我们根据促销、优惠券规则自行计算；库存受地域仓影响存在偏差，业务上要明确数据边界，避免业务误判。
