健康开普勒商城API帮助文档
文档说明：本文档为面向客户的常规答疑文档，联调过程中存在问题优先查看文档内是否有解决方案#
一.推荐接口交互逻辑#
1.1 实物对接接口交互（待补充）#
1.2 服务对接接口交互-订单模式（待补充）#
二.开放平台常见问题#
如果问题未在以下列表展示，请在客户对接群提供uuid由京东侧研发同学排查问题
2.1 数据解密失败#
- API对接通常使用生产环境进行标准化对接联调，请检查调用域名是否为api.jd.com，而不是api-dev.jd.com
- 确认加解密是否使用京东侧下发的加解密key和偏移量
- 检查加解密流程是否按照文档进行操作：加解密文档
- 在加解密平台中验证加解密是否成功：加解密平台
2.2 超时问题#
尽量保证系统收到请求和返回请求在5s内
2.3 加签验签#
- 支持加签验签：加签验签文档
- SDK调用接口时，自动进行加签，无需手动加签
- Http接口调用时，需手动进行加签调用京东侧接口
2.4 获取token返回304#
报错信息：{"code":304,"msg":"当前会话没有做过授权,请先授权","requestId":"ffd7be00b56241fcafdcb9618f9bf667"}
问题原因：请求token使用的code码仅能使用一次且有效期5分钟
三.实物业务部分#
3.1 拆单相关#
拆单后父单状态？
拆单以后父单状态即失效不会再进行实际业务逻辑操作，后续变化均通过子单id进行，包括发货、取消、售后、开票、结算等操作。
为什么会拆单？
商品属于不同主体仓库，或者库存状态不同需要分开发货时会拆单，按照规则将订单拆分为多个子单，其中寻源按库房拆分是拆单的一种。
什么时候拆单？
订单支付完成以后，进入仓库履约的环节会进行拆单，不会实时拆单，拆单时效不确定。
怎么测试拆单场景？
通常不同商品大类的sku一起下单会发生拆单。
多次拆单情况如何推送拆单？
订单A发生拆单，子单为B、C，推送三方时orderId为A，subOrderList里为B、C，directParentOrderId为A；
订单B发生拆单，子单为D、E，推送三方时orderId为A，subOrderList里为C、D、E，directParentOrderId为B。
3.2 取购物车为空#
报错信息：{"code":"HJB-DM@1012-CD@2.600001","helpMessage":"取购物车为空","msg":"取购物车为空"}
问题原因：sku下架、sku不存在、商城配置下单模式不正确(对接群中联系产品研发看下)
3.3 预提单和提单的地址信息不同#
预提单必须传地址信息
地址信息影响库存、运费等信息
预提单和提单地址信息不同
可能导致预提单时有库存，提单时无库存导致无法下单
3.4 申请开票失败#
日志报错信息：查无当前开票订单
问题原因：
1.订单完成与申请开票存在时间差，订单未流转至结算系统，生产环境一般存在40秒左右延迟
2.排除步骤一后，商城没配置结算开票规则，请联系京东侧
3.5 商品无货#
- 联系京东侧业务同学查看是否有库存
- 业务同学需确认是否支持平行库存
- 可以联系供应链团队或库存指挥中心打开平行库存
- 客户重新下单
四.服务业务部分#
4.1 提交预约-订单模式#
证件类型：仅支持身份证与护照
证件号码：不校验二要素
出生日期：护照时必传，格式yyyy-MM-dd
下单后需要等待几秒再提交预约，原因：ES同步延迟