状态码

true;false

无法对接其余所有接口

注意事项：获取授权后，有效期24小时，超期后需要重新获取。

1、项目组完成主数据申请后，需要尽快创建PIN和申请clientid，以便配合客户侧进行IOP对接和联调。

2、信息准备流程：项目组创建PIN和密码——>项目组向JDKA发起IOP对接申请——>JDKA提供client_id、client_secret和接口最新文档给客户，项目组提供PIN和密码给客户。

增大获取AccessToken的请求量，增大系统压力

无法获取一级地址列表，导致二、三、四级地址也无法获取，京东的四级地址在查询商品库存、限售、下单时均需要用到，不对接此接口会导致下单失败

无法获取二级地址列表，导致三、四级地址也无法获取，京东的四级地址在查询商品库存、限售、下单时均需要用到，不对接此接口会导致下单失败

无法获取三级地址列表，导致四级地址也无法获取，京东的四级地址在查询商品库存、限售、下单时均需要用到，不对接此接口会导致下单失败

无法获取四级地址列表，京东的四级地址在查询商品库存、限售、下单时均需要用到，不对接此接口会导致下单失败

京东的四级地址在查询商品库存、限售、下单时均需要用到，若四级地址无效会导致下单失败

该接口的使用场景是：当无法逐级获取地址信息时，可根据地址详情调用该接口获取对应的京东地址，但是该方案无法保证所有地址都匹配上京东地址，也无法保证所有匹配的京东地址都正确，当该未接入该接口时，可能会由于地址获取失败导致后续校验库存，可售，下单等环节出现异常

下架商品查不到价格等商品信息，下架商品会导致下单失败，需要过滤掉

因为业务逻辑较多，限制销售的因素比较多，除了库存原因和区域限制配送，验证商品可售性api还会校验其它因素，如商品在主站下架，不在商品池，合同限制，商品是黑名单，主站做预约抢购活动等等，如果不对接该api，可能会由于某些限售因素导致商品可见不可采，影响用户体验

导致下单失败，商详页、结算页、下单前需要校验商品是否区域购买限制

无法通过主商品获取赠品sku，导致下单成功，无赠品

无法获取主商品下诸如延保等服务类的商品信息，导致无法购买延保等服务类的商品，会影响用户体验，也会导致GMV的减少

无法获取商品是否支持货到付款的信息，可能导致支付方式减少，因此导致GMV的降低（可能客户就想用货到付款支付方式）

无法批量获取商品是否支持货到付款的信息，可能导致支付方式减少，因此导致GMV的降低（可能客户就想用货到付款支付方式）

无法按特定条件去搜索满足条件的商品，例如按照价格区间，品牌，类目等搜索，导致无法快速定位商品

该接口可根据商品所在的分类编号，获取商品对应的分类信息，若未接入该接口，则无法获取相关信息

导致下单失败，下单前实时调用此接口进行下单前的校验

需在下单前，在商品详情页实时调取最新的商品价格，如果不接入，可能导致生成订单后的价格和商品详情的价格不一致，导致下单失败，影响用户体验，减少GMV

在下单前，需通过该接口实时校验商品库存，若不对接该api会导致商品可见不可采（提交订单时商品库存不足，提交订单失败）

导致下单后金额和提交时金额不一致，影响客户体验。

该接口可查询准备购买商品的可选收货时间（预约上门派送），若未接入该接口，则无法使用该服务

如果因为超时等原因，调用“提交订单接口”未收到订单号，重新下单之前，需先调用“反查订单接口”检验订单是否生成，若未接入该接口，可能导致订单重复提交

接口对接的口令，客户通过此接口获取京东侧的授权后，才能进行对接。

注意：token有效期是24小时，失效后需要重新获取或通过“刷新授权”接口更新授权信息

地址接口，在查询商品库存、限售、下单和售后等场景中，需要调用地址接口获取地址信息。

注意事项：

1、在上述业务场景中，系统需要逐级查询1-4级地址，获取地址信息。

2、下单前调用地址校验接口校验地址准确性。

3、如果三级地址下有四级地址，则四级地址在下单接口和售后接口中必填，否则会下单失败或者申请售后失败。

4、建议调用京东四级地址获取接口将数据存到本地数据库中，并且务必接入type50京东地址变更消息，及时对地址库进行更新。

5、若系统无法逐级获取地址信息，可根据地址详情调用“地址详情转换京东地址编码”接口，解析并转换为京东的地址信息。

通过此接口，获取客户商品池编号

如不对接，项目组为客户创建新的商品池时，客户侧无法获取商品池中全量商品

通过此接口，获取客户商品池中的全量商品

如不对接，项目组为客户创建新的商品池时，客户侧无法获取商品池中全量商品

获取商品信息在客户侧平台展示

如不对接，客户侧无法展示商品信息

获取商品图片在客户侧平台展示

如不对接，客户侧无法无法展示商品图片

获取商品的上下架状态

如不对接，下架商品查不到价格等商品信息，下架商品会导致下单失败，需要过滤掉

校验商品的可售性，

在商详页、结算页、提单时系统会通过此接口，查询商品是否有区域购买限制。

如不对接，导致客户侧下单失败，商详页、结算页、下单前需要校验商品是否区域购买限制

通过主商品查询是否有赠品

依赖主数据勾选“货到付款”

通过主商品查询商品的延保等服务类商品信息

验证商品是否支持货到付款

依赖主数据勾选“货到付款”

批量验证商品是否支持货到付款

通过此接口搜索商品

注意事项：此搜索范围仅限京东范围，因此不建议客户侧对接

通过skuId可以聚合查询被指定为同一类的商品，如同一款式不同颜色的商品。调用“查询同类商品接口。

查询商品对应的分类信息

客户商品详情页面、加入购物车以及下单的时候，校验商品是不是可采购：包括是否在商品池、是否主站上架状态、是否预约预售、是否合同支持购买此商品、是否区域限售。所以整合商品可售验证+商品上下架接口+商品区域销售限制的校验，上述校验全都通过才会告诉客户商品可采购。

如不对接，导致客户侧下单失败，下单前实时调用此接口进行下单前的校验

客户调用此接口，查询第三方关联数据，例如：商品映射方案，包括：类目映射、SKU映射等。

查询商品的售卖价格。查询在客户商品池中的商品价格。

特殊说明：

京东价（京东主站前台红字价）对应出参字段“jdPrice”

采购价对应出参字段“price”

税率，对应出参字段“tax”，当入参有“containstax”时，出参中有此字段，例如：此值为16时，代表税率为“16%”。

根据此接口查询主商品附带的赠品。

特殊说明：

①区域项目组需要先在主数据勾选“有赠品”后，客户采购商品时才能看到&购买时附带赠品。

②购买主商品数量大于赠品要求最多购买数量，不加赠品；

③购买数量小于赠品要求最少购买数量，不加赠品；

④下单时间不在促销时间范围内，不加赠品；

查询商品库存

查询商品是否有区域购买限制。

验证商品是否支持货到付款

通过skuId可以聚合查询被指定为同一类的商品，如同一款式不同颜色的商品。调用“查询同类商品接口

通过接口，获取无理由退货类型

依赖项：主数据>退换货勾选的值

查询商品的售卖价格

需在下单前，在商品详情页实时调取最新的商品价格，如果不接入，可能导致生成订单后的价格和商品详情的价格不一致，导致下单失败，影响用户体验，减少GMV

具体取值依赖于客户主数据勾选的价格类型

查询商品库存

在下单前，需通过该接口实时校验商品库存，如果不接入，会导致商品可见不可采（提交订单时商品库存不足，提交订单失败）

查询准备提交的订单的运费

如不对接，导致客户侧下单后金额和提交时金额不一致，影响客户体验。

查询准备购买的商品可选收货时间

提交订单信息，生成京东订单。

如不对接，客户侧无法下单，是交易的核心接口

订单反查接口，根据第三方订单号反查京东的订单号。

如果因为超时等原因，调用“提交订单接口”未收到订单号，重新下单之前，需先调用“反查订单接口”检验订单是否生成， 若未接入该接口，可能导致订单重复提交

取消未确认订单

注意事项：只针对未支付订单，如已支付，客户需要取消，需要联系客服申请

查询京东订单明细信息

如不对接，客户侧无法查看订单明细，导致订单信息不清晰，影响客户体验

查询京东订单的配送信息。

该接口可查询订单的配送信息， 若未接入，则无法查询相关的配送信息

通过主商品查询是否有赠品

此接口 仅适用于厂商直送订单。

厂商直送订单可使用此接口确认收货并将订单置为完成状态。

如不对接，导致三方物流配送的订单状态客户侧与京东存在差异

同上

更新订单上的PO单号，可选择用于配送单、发票等票面展示。

如不对接，无法更新采购单号（采购单号可能用于配送单，发票等票面展示）

更新订单扩展字段，对于有订单扩展字段需求的客户，生成订单后调用此接口更新订单或者sku扩展字段

如不对接，无法更新订单扩展字段

查询所有新建的订单列表，可用于核对订单。

如不对接，无法查询新建订单列表，则无法核对相关的订单状态

查询所有妥投的订单列表，可用于核对订单。

如不对接，无法查询妥投订单列表，无法核对订单妥投的状态

查询所有拒收的订单列表，可用于核对订单。

如不对接，无法查询拒收订单列表，则无法核对订单拒收状态

查询所有完成的订单列表，可用于核对订单。

查询商品的配送预计送达时间。

如不对接，无法查询订单的预计配送达时间，降低用户体验

查询金采和预存款的余额。

如不对接，客户侧无法知晓金采和预存款的余额，当余额不足时会导致下单失败

仅支持预存款余额明细查询，不支持金采余额明细查询。

如不对接，无法获取余额（预存款）的变动明细 ，即无法核对支付状态，退款状态等

客户在提单成功但支付失败的情况，可以调用此接口重新支付

如不对接，针对下单成功但支付失败的订单，无法再次发起支付

通过此接口，校验某订单中某商品是否可以提交售后服务

如不对接，当客户选择了不支持售后的商品进行售后申请时，会导致售后失败

通过此接口，可基于订单号、商品编号查询支持的售后服务类型

如不对接，当客户选择了不支持的售后类型时，会导致申请售后失败

通过此接口，可基于订单号、商品编号查询支持的商品返回京东方式

通过此接口，客户可发起售后申请（*需要订单已妥投）。

如不对接，客户侧无法进行线上售后，增加了运营工作量

如果商品需要逆向发往京东，当选择第三方配送时，使用此接口填写配送信息。

通过此接口，可查询订单，申请单，商品维度的售后概要

如不对接，则无发获取相关信息

通过此接口，可查询申请单维度的售后明细信息。

该接口可查询申请单维度的售后明细信息，包括用户发货，退款明细，售后地址，操作信息等，若不对接该接口，则无法获取相关信息

通过此接口，可取消已经生成的服务单。

如不对接，则无法取消售后服务单

通过此接口，可确认售后服务单。

如不对接，客户侧无法查询售后成功的内容

通过此接口，可查询订单下服务单汇总列表信息。

如不对接，会导致售后单完成有延迟

通过此接口，可批量查询订单下商品可售后数量、支持的售后类型、支持的返回京东的方式。售后服务类型：退、换、修

如不对接，则无法获取相关信息，导致后续客户发起售后失败

通过此接口，客户可发起售后申请（*需要订单已妥投）。

如不对接，客户侧无法进行线上售后，增加了运营工作量

通过此接口，可查询订单售后情况概要。

如不对接，客户侧无法掌握售后信息

如果商品需要逆向发往京东，当选择第三方配送时，使用此接口填写配送信息。申请售后需要退换货时，如果需要使用第三方物流将商品寄回，则需调用该接口，若不对接该接口 可能会导致售后失败

通过此接口，可批量确认售后完成。如果售后申请单在待确认状态超过15天，则会自动确认。

如不对接，导致售后单完成有延迟

通过此接口，可取消售后申请。按照申请批次取消已发起的售后申请。返回京东方式为客户发货，客服审核完成前可执行取消操作；返回京东方式为上门取件时，配送员取件完成前可以执行取消操作。

该接口可取消已经申请的售后服务单，若不对接该接口，则无法取消售后服务单

通过此接口，可基于申请单+订单号维度查询出所对应的物流信息。

该接口可按申请单+订单号维度查询出对应的售后物流信息，若不对接该接口，则无法查询相关的物流信息

通过此接口，可查询申请单维度售后明细信息，包括客户发货退款明细、售后地址操作信息。该接口可查询申请单维度的售后明细信息，包括用户发货，退款明细，售后地址，操作信息等，若不对接该接口， 则无法获取相关信息

通过此接口，可查询售后换新订单号。可以在查询到type=116后，然后根据原始订单号查此接口获取新订单号

如不对接，无法获取售后换新后的新单订单号并造成订单状态不一致

通过此接口，客户可发起线上开票申请

如不对接，无法进行线上开票，降低用户体验，也增加了运营工作量

通过此接口，可基于订单号查询对应的第三方申请单号（申请发票的唯一id标识）。

如不对接，则无法获取相关信息

通过此接口，可查询第三方申请单号下的发票概要信息，如：发品号码、发票代码等。

如不对接，则会导致相关信息无法获取

通过此接口，可查询纸质发票明细信息，如：发票抬头、纳税人识别号等。

如不对接，则会导致相关信息无法获取

通过此接口，可查询电子发票明细信息，如：发票抬头、纳税人识别号等。

如不对接，则无法获取相关信息

针对纸质发票如果需要邮寄，可使用此接口查询配送单号。

如不对接，则会导致无法获取相关信息

通过此接口，可查询发票的物流信息

如不对接，则会导致无法获取相关信息

通过此接口，可取消开票申请。

该接口可取消已经生成的发票申请，注意：只能用于取消“驳回状态”或是“异常状态”的申请单，如果markid已经在京东系统录入对应的发票申请单，则无法取消，如不对接， 则无法发起取消发票申请

通过此接口，可根据发票号查询发票的物流信息

如不对接， 则无法根据发票号获取发票物流信息 （对于一个发票对应一个订单或者一个发票对应多个订单的情况，均可查询出来物流信息，物流信息包括物流单号、操作时间、操作备注、操作用户等）

通过此接口，获取京东侧推送的消息，包括：商品价格变更、商品上下架变更、订单拆分、订单妥投等信息。

如不对接，商品状态、商品信息、订单状态等内容不同步，导致下单失败

通过此接口，删除京东侧推送的消息，避免消息积压。

如不对接，客户侧无法获取到最新的消息