技术文档

服务目录

公告栏

接入流程

开发指南

常用工具

业务流程

常见问题

面向买家服务

面向商家服务

京麦服务市场

供应商服务

供应商服务

京东云服务

【备件库服务】接口导航

1. 退货信息检索

2. 退货确认

以上两个接口适用于京东售后。即京东负责收取客户退货商品，然后由京东备件库统一发货退给商家，对应商家后台“售后客服-->备件库退货单收货”模块。

自主售后商家请查看【自主售后服务】

1. 退货信息检索

l 接口名称

360buy.after.search

l 功能说明

根据输入条件检索备件库退货单信息。

l 系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
v	String	是	API协议版本，可选值:2.0.

l 应用级输入参数

名称	类型	是否必须	示例值	描述
query_fields	List < Field>	否	字段:值;字段:值 queryField.setKey(return_id) ;queryField.setValue(11231)	查询字段对应Field中的key，查询字段的值对应Field中的value 查询字段键值对，详见"查询字段"
select_fields	String	是		返回字段选择,每个字段以逗号分隔
page	String	是	100	分页号：1-100
page_size	String	是	10	每页的条数（最大page_size 10条）

Field对象结构

名称	类型	是否必须	示例值	描述
key	String	是
value	String	是		返回字段选择,每个字段以逗号分隔

查询字段

字段名称	描述	备注
return_id	退货单号
consignor	发货人
receive_state	退货状态	取值：待收货WAITING、已收货RECEIVED
order_id	订单号
attachment_code	备件条码
time_type	时间类型	发货时间SENDTIME、收货时间RECEIVETIME、修改时间 MODIFIEDTIME 与开始时间，结束时间同时出现
start_time	开始时间	与时间类型，结束时间同时出现
end_time	结束时间	与时间类型，开始时间同时出现

l 返回结果

名称	类型	是否必须	示例值	描述
after	AfterSearch			退货信息
code	String			错误码

AfterSearch结构

名称	类型	是否必须	示例值	描述
return_infos	List			退货信息
total_num	int			总的数量

ReturnInfo结构

名称	类型	是否必须	示例值	描述
return_id	String			退货单号
vender_id	String			商家编号
send_type	String			发货类型
receive_state	String			收货状态:待收货WAITING、已收货RECEIVED
linkman	String			商家联系人姓名
phone	String			商家联系人电话
return_address	String			商家收货地址
consignee	String			实际收货人
consignor	String			京东的发货人姓名
send_time	String			发货的时间
receive_time	String			收货的时间
modifid_time	String			更新时间
return_item_list	List			货物信息列表

ReturnItem结构

名称	类型	是否必须	示例值	描述
return_item_id	String			退货物品信息记录ID
attachment_code	String			备件条码
sku_id	String			京东的SKU
sku_name	String			SKU名称
order_id	String			订单号
price	String			商品的单价
return_type	String			退货类型: 售后RETURNED、拒收REJECTED、大库入FROMWAREHOUSE
return_reason	String			退货原因
modifid_time	String			更新时间

l 返回示例

JSON数据格式

{

"after_search_response": {

"code": "0"

"after": {

"total_num": 5,

"return_infos": [

{

"return_id": "299042",

"vender_id": "20032",

"send_type": "TOVENDER",

"receive_state": "RECEIVED",

"linkman": "zzz",

"phone": "132",

"return_address": "eee",

"consignee": "sop_order",

"consignor": "谭畅",

"send_time": "2011-04-15 11:58:54",

"receive_time": "2011-04-15 12:09:22",

"modifid_time": "2011-04-15 12:09:22",

"return_item_list": [

{

"return_item_id": "1501043",

"attachment_code": "PP1000006897101027101",

"sku_id": "1000006897",

"sku_name": "Giordano/佐丹奴男装厚实御寒四合一功能外套01070521冷灰色深灰 XL",

"order_id": "0",

"price": "390.00",

"return_type": "RETURNED",

"return_reason": "",

"modifid_time": "2011-04-15 12:07:18"

{

"return_item_id": "1501044",

"attachment_code": "PP1000003962101027101",

"sku_id": "1000003962",

"sku_name": "Giordano/佐丹奴男装六条装Logo宽皮筋三角内裤01179514白/中花灰/黑色白色 M",

"order_id": "0",

"price": "71.25",

"return_type": "RETURNED",

"return_reason": "",

"modifid_time": "2011-04-15 12:07:18"

}

]

{

"return_id": "299040",

"vender_id": "20032",

"send_type": "TOVENDER",

"receive_state": "RECEIVED",

"linkman": "ewaetery",

"phone": "22446688",

"return_address": "323w7y4e3",

"consignee": "sop_order",

"consignor": "谭畅",

"send_time": "2011-04-13 16:59:06",

"receive_time": "2011-04-13 17:59:24",

"modifid_time": "2011-04-13 17:59:24",

"return_item_list": [

{

"return_item_id": "1501040",

"attachment_code": "fx1733775",

"sku_id": "1000004665",

"sku_name": "Giordano/佐丹奴男装胜利狮王连帽开胸卫衣01070932爪哇咖啡色咖啡色 L",

"order_id": "0",

"price": "159.00",

"return_type": "FROMWAREHOUSE",

"return_reason": "",

"modifid_time": "2011-04-13 17:06:49"

}

]

{

"return_id": "299039",

"vender_id": "20032",

"send_type": "TOVENDER",

"receive_state": "RECEIVED",

"linkman": "sdgsag",

"phone": "15900883366",

"return_address": "gsdgsdfgh",

"consignee": "sop_order",

"consignor": "谭畅",

"send_time": "2011-04-13 16:50:51",

"receive_time": "2011-04-15 11:56:51",

"modifid_time": "2011-04-15 11:56:51",

"return_item_list": [

{

"return_item_id": "1501039",

"attachment_code": "fx1650253",

"sku_id": "1000005219",

"sku_name": "Hasbro孩之宝-变形金刚 2-加强级横炮 H8397189159",

"order_id": "0",

"price": "119.00",

"return_type": "FROMWAREHOUSE",

"return_reason": "",

"modifid_time": "2011-04-13 16:58:34"

}

]

{

"return_id": "299038",

"vender_id": "20032",

"send_type": "TOVENDER",

"receive_state": "RECEIVED",

"linkman": "zzzz",

"phone": "132",

"return_address": "qqq",

"consignee": "sop_order",

"consignor": "谭畅",

"send_time": "2011-04-13 11:45:06",

"receive_time": "2011-04-13 11:56:00",

"modifid_time": "2011-04-13 11:56:00",

"return_item_list": [

{

"return_item_id": "1501037",

"attachment_code": "fx-pop1689079",

"sku_id": "1000001810",

"sku_name": "一生一石Q暗送秋波满天星绿幽灵手链情侣对11+15mm",

"order_id": "0",

"price": "196.00",

"return_type": "REJECTED",

"return_reason": "",

"modifid_time": "2011-04-13 11:52:44"

{

"return_item_id": "1501038",

"attachment_code": "fx-pop1683333",

"sku_id": "1000002497",

"sku_name": "一生一石一夜暴富貔貅趴叶子3A级天然黄晶挂坠M附权威证书",

"order_id": "0",

"price": "366.00",

"return_type": "REJECTED",

"return_reason": "",

"modifid_time": "2011-04-13 11:52:44"

}

]

{

"return_id": "299037",

"vender_id": "20032",

"send_type": "TOVENDER",

"receive_state": "RECEIVED",

"linkman": "张无忌",

"phone": "1341242432342 --15988006644",

"return_address": "上海宝山区南京西路39号",

"consignee": "sop_order",

"consignor": "张婷",

"send_time": "2011-04-13 14:41:25",

"receive_time": "2011-04-15 12:03:46",

"modifid_time": "2011-04-15 12:03:46",

"return_item_list": [

{

"return_item_id": "1501035",

"attachment_code": "fx1734992",

"sku_id": "1000010418",

"sku_name": "I'd爱帝针织牛仔女裤暗紫罗兰（紫蓝） L",

"order_id": "0",

"price": "99.00",

"return_type": "FROMWAREHOUSE",

"return_reason": "",

"modifid_time": "2011-04-13 14:49:06"

{

"return_item_id": "1501036",

"attachment_code": "fx1734967",

"sku_id": "1000010407",

"sku_name": "I'd爱帝针织牛仔女裤黑色 XL",

"order_id": "0",

"price": "99.00",

"return_type": "FROMWAREHOUSE",

"return_reason": "",

"modifid_time": "2011-04-13 14:49:06"

}

]

}

]

}

l SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

AfterSearchRequest request = new AfterSearchRequest();

request.setSelectFields("consignee");

Field field = new Field("return_id", "299054");

List queryFields = new ArrayList();

queryFields.add(field);

request.setQueryFields(queryFields);

request.setPage("1");

request.setPageSize("3");

AfterSearchResponse response = client.execute(request);

2. 退货确认

l 接口名称

360buy.after.state.update

l 功能说明

根据退货单号确认收货

l 系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	是	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
v	String	是	API协议版本，可选值:2.0.

l 应用级输入参数

名称	类型	是否必须	示例值	描述
return_id	String	是		退货单ID
trade_no	String	是

l 返回结果

名称	类型	是否必须	示例值	描述
return_id	String			return_id
vender_id	String			商家ID
modified	String		2011-06-22 10:14:45	售后确认操作时间
code	String			0为正常，其它值参见错误代码一览表

l 返回示例

JSON数据格式

{

"after_state_update_response": {

"code": "0"

"vender_id": "20032",

"modified": "2011-06-21 15:43:58",

"return_id": "299042",

}

l SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

AfterStateUpdateRequest request = new AfterStateUpdateRequest();

request.setReturnId("299054");

request.setTradeNo(Long.toString(System.currentTimeMillis()));

AfterStateUpdateResponse response = client.execute(request);