首页 > API调用场景 > 订单调用场景文档 > Pop订单接口接入说明

Pop订单接口接入说明

一、业务说明

Pop订单类接口提供了外部调用方获取pop订单数据的能力以及一些关于pop订单一些基础类能力,如物流发货(回传状态)、商家自主拆单等功能。

 

二、  主要流程说明

1.     获取订单

1)      未付款订单获取:

只能查到当前处于未付款状态的订单,如果处于已付款或者未付款已取消则无法查询到。

jingdong.pop.order.notPayOrderInfo批量查询未付款订单;jingdong.pop.order.notPayOrderById未付款订单单条记录查询

2)      已付款订单获取:

请注意以下几点:

A search接口时间类型datetype按修改时间查询。

B 获取订单接入方需要自排重。

C.不要使用深分页方式获取订单,性能较差。

D.请用时间滚动方式获取订单,并且增加迁移量,防止漏单

 

涉及接口

jingdong.pop.order.search根据条件检索订单信息;

jingdong.pop.order.get检索单个SOP订单信息

jingdong.pop.order.fbp.search新接口fbp查询订单;jingdong.pop.order.fbp.get  fbp订单单个检索

 

 

2.物流发货:

   1.操作步骤:

1)使用search接口检索出状态为WAIT_SELLER_STOCK_OUT 等待出库的订单。

2)请商家或isv提前获取物流信息,包括物流公司以及运单号。

3)调用下述接口操作sop订单出库发货,jingdong.pop.order.shipment -> sop出库发货接口。

4)调用出库发货成功后,再次调用订单查询接口,订单状态将会变为WAIT_GOODS_RECEIVE_CONFIRM 等待确认收货。

3.自主拆单

              1.当商家需要继续拆分订单分别发货时,可调用此接口。

                   jingdong.pop.order.orderSplitCommitXmlApi主动拆分,xml参数的拆单描述见以下示例

示例:

<OrderSplitApplyParam>
<orderId>53010767266</orderId> <!--
将要拆单的订单id,必填 -->
<systemName>poporderjos</systemName> <!--
固定值,必填 -->
<systemId>42e755522c2ca734fc35983c4692380d</systemId> <!--
固定值,必填 -->
<type>11</type> <!--
固定值,必填 -->
<skuGroups> <!--
预期拆完后子单列表 -->
<SkuGroup> <!--
预期拆完后子单对象,返回结果时,groupId=1,自增 -->
<skuInfoList> <!--
预期拆完后的子单的sku列表 -->
<SkuInfo>
<skuId>10000140052</skuId>
<num>1</num>
</SkuInfo>
</skuInfoList>
<groupContent/> <!--
将要修改的子单属性,现不支持,必须空 -->
</SkuGroup>
<SkuGroup> <!--
预期拆完后子单对象,返回结果时,groupId=2,自增 -->
<skuInfoList>
<SkuInfo>
<skuId>10000161271</skuId>
<num>1</num>
</SkuInfo>
</skuInfoList>
<groupContent/> <!--
用户修改子单属性,现不支持必须空 -->
</SkuGroup>
</skuGroups>
<code>1</code> <!--
拆单原因id,必填,固定值传1 -->
<desc>
主动拆单</desc> <!-- 拆单原因详细,重要,必填-->
</OrderSplitApplyParam>

 

自营订单数据暂不开放。