技术文档

服务目录

公告栏

接入流程

开发指南

常用工具

业务流程

常见问题

面向买家服务

面向商家服务

京麦服务市场

供应商服务

供应商服务

京东云服务

【工单服务】接口导航

由客服发起创建的工作单据，可能是售前问题，也可能是售后问题，需要商家限时解决。

工单处理流程请参考：http://help.jd.com/jos/question-873.html

1. 获取工单列表

接口名称

jingdong.wos.worklist.get

API用户授权类型

需要

系统级别输入参数

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

应用级输入参数

名称	类型	是否必须	示例值	描述
status	Number	否		工单状态(1代表待回复,2代表待确认,3代表已作废,4代表已关闭,5代表已驳回)
order_id	Number	否		订单号
begin_date	Date	是		查询开始时间(不能早于60天)
end_date	Date	是		查询结束时间(不能早于60天)
page_number	Number	是		分页页码
page_size	Number	是		每页显示条数(范围为10-30条)

返回结果

名称	类型	示例值	描述
page	SafWorkPage		商家工单列表分页返回结果

SafWorkPage 属性

名称	类型	是否必须	示例值	描述
result	SafWorkDTO[]	否		工单列表
total_count	Number	否	工单总量

SafWorkDTO属性

名称	类型	是否必须	示例值	描述
work_id	Number	否		工单号
order_id	Number	否		订单号
status_name	String	否		工单状态名
create_date	Long	否		工单创建时间 (此处返回的是长整型数据，单位是"毫秒"，需要自行转换为Date类型)
content	String	否		工单发起内容

返回示例

JSON数据格式

{
  "jingdong_wos_worklist_get_response":{
  "page":{
  "result":[{
  "content":"测试",
"create_date":"2013-08-15 10:00:00",
"status_name":"待回复",
"work_id":10000000,
"order_id":405594578
  },

{
  "content":"测试",
"create_date":"2013-08-2011:00:00",
"status_name":"待回复",
"work_id":10000001,
"order_id":405594578
  }],
"total_count":"12"
  }
  }
  }

SDK调用示例

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WosWorklistGetRequest request=new WosWorklistGetRequest();
request.setStatus( 80 );
request.setOrderId(405594578L);
request.setBeginDate( "2013-08-01 00:00:00" );
request.setEndDate( "2013-08-30 12:00:00" );
request.setPageNumber( 2 );
request.setPageSize( 10 );
WosWorklistGetResponse response=client.execute(request);

2. 获取工单信息

接口名称

jingdong.wos.workinfo.get

API用户授权类型

需要

系统级别输入参数

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

应用级输入参数

名称

类型

是否必须

示例值

描述

work_id

Number

是

工单号

(通过jingdong.wos.worklist.get接口获取)

返回结果

名称	类型	示例值	描述
result	SafWorkInfoDTO[ ]		工单信息列表(只返回近60天的数据)

SafWorkInfoDTO属性

名称	类型	是否必须	示例值	描述
send_biztype_id	Number	否		发起业务类型ID
send_biztype_name	String	否		发起业务类型名称
reply_biztype_name	String	否		回复业务类型名称
reply_sub_biztype_name	String	否		二级回复业务类型
santisfaction	String	否		满意度评价
create_date	Date	否		工单创建时间 (此处返回的是长整型数据，单位是“毫秒”，需要自行转换为Date类型)
oper_logs	SafWoOperDTO[ ]	否		工单操作记录

SafWoOperDTO属性

名称	类型	是否必须	示例值	描述
oper_user	String	否		操作人
oper_date	Date	否		操作时间
oper_type	String	否		操作类型
oper_content	String	否		操作内容

返回示例

JSON数据格式

{
  "jingdong_wos_workinfo_get_response":{
  "result":[{
  "reply_sub_biztype_name":"发票类催单",
"send_biztype_id":1,
"create_date":"2013-08-15 10:00:00",
"oper_logs":[{
  "oper_user":"POP客服",
"oper_content":"客户张三说订单都三天了还没收到",
"oper_type":” 发起工单”,
"oper_date":"2013-08-15 10:00:00"
  },{
  "oper_user":" POP商家",

"oper_content":null,
"oper_type":” 领取工单”,
"oper_date":"2013-08-1510:00:12"
},{
"oper_user":" POP商家",

"oper_content":”货物已发出，快递员正在派件途中”,
"oper_type":” 回复工单”,
"oper_date":"2013-08-1510:05:34"
},{
"oper_user":" POP客服",

"oper_content":null,
"oper_type":” 关闭工单”,
"oper_date":"2013-08-1510:08:35"
  }],
"reply_biztype_name":"发票类催单",
"send_biztype_name":"催单类问题",
"santisfaction":"非常满意"
  }]
  }
  }

SDK调用示例

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WosWorkinfoGetRequest request=new WosWorkinfoGetRequest();
request.setWorkId( 10000000L );
WosWorkinfoGetResponse response=client.execute(request);

3. 获取二级业务类型列表

接口名称

jingdong.wos.subbiztypelist.get

API用户授权类型

不需要

系统级别输入参数

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

应用级输入参数

名称

类型

是否必须

示例值

描述

biztype_id

Number

是

一级业务类型ID

(通过jingdong.wos.workinfo.get接口send_biztype_id字段获取)

返回结果

名称	类型	示例值	描述
saf_biztype_Dtos	SafBiztypeDTO[]		二级业务类型列表

SafBiztypeDTO属性

名称	类型	是否必须	示例值	描述
sub_biztype_id	Number	否		二级业务类型ID
sub_biztype_name	String	否		二级业务类型名称

返回示例

JSON数据格式

{
  "jingdong_wos_subbiztypelist_get_response":{
  "saf_biztype_Dtos":[{
  "sub_biztype_name":"发票类催单",
"sub_biztype_id":13
  },{
  "sub_biztype_name":"货款类催单",
"sub_biztype_id":53
  }]
  }
  }

SDK调用示例

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WosSubbiztypelistGetRequest request=new WosSubbiztypelistGetRequest();
request.setBiztypeId( 3L );
WosSubbiztypelistGetResponse response=client.execute(request);

4. 商家回复工单

接口名称

jingdong.rest.workorder.reply

API用户授权类型

需要

系统级别输入参数

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

应用级输入参数

名称	类型	是否必须	示例值	描述
work_id	Number	是		工单id
reply_content	String	是		工单回复内容，不能超过1000个字节，也就是500个汉字，或1000个英文。
work_type	Number	是		一级业务类型 (通过jingdong.wos.workinfo.get 接口send_biztype_id字段获取)
work2_type	Number	是		二级业务类型 (通过jingdong.wos.subbiztypelist.get 接口sub_biztype_id字段获取)

返回结果

名称	类型	示例值	描述
work_order	WorkOrderResponse		返回结果 resultCode[执行结果标识。1:代表执行成功，2：代表执行异常，3：有时候工单回复因为网络原因没有拿到结果，此状态代表工单已经是商家已回复状态，不需要再次回复。],resultMsg [执行结果的参考信息]

WorkOrderResponse属性

名称	类型	是否必须	示例值	描述
result_code	Number	否		执行结果标识。1:代表执行成功，2：代表执行异常，3：有时候工单回复因为网络原因没有拿到结果，此状态代表工单已经是商家已回复状态，不需要再次回复。
result_msg	String	否		执行结果参考信息

返回示例

JSON数据格式

{

"jingdong_rest_workorder_reply_response":{

work_order{

"result_code":"1",

"result_msg":"执行成功"

}

SDK调用示例

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
RestWorkorderReplyRequest request=new RestWorkorderReplyRequest();
request.setWorkId( 123 );
request.setReplyContent( "jingdong" );
request.setWorkType( 123 );
request.setWork2Type( 123 );
RestWorkorderReplyResponse response=client.execute(request);