1. 检索需要出库的客单

接口名称

    

jingdong.dropship.dps.search


功能说明

              

检索需要出库的客单


l API用户授权类型

 

需要

 

l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称 类型 是否必须 示例值 描述
pageSize  Number  10  每页加载的条数:范围为10—100 
page  Number  查询的页数必须从1开始,且必须大于等于1 
beginDate  Date  2011-06-16 13:23:30  开始时间(格式 yyyy-MM-dd HH:mm:ss) 
endDate  Date  2013-06-16 13:23:30  结束时间(格式 yyyy-MM-dd HH:mm:ss) 

返回结果


名称 类型 示例值 描述
searchResult  QueryOrderForJosResultListDto    返回值Result 


QueryOrderForJosResultListDto 属性

 

名称 类型 是否必须 示例值 描述
status  Number    调用接口成功与否的状态,1代表成功 0代表失败。 
message  String    返回异常消息,例如:内部处理错误。 
code  String    调用失败,返回异常码例如:201 
recordCount  Number    返回查询数据结果总数,例如:50 
resultDtoList  QueryOrderForJosResultDto[]    返回结果集合 


QueryOrderForJosResultDto 结构

 

名称 类型 是否必须 示例值 描述
customOrderId  Number    客单编号 
pay  Number    支付金额 
operatorState  Number  操作状态:5新订单;9正在出库;10 出库成功;15正在发货;16发货成功;23等待退款 
consigneeName  String    收获人姓名 
postcode  String    邮编 
expectedDeliveryTime  Date    期望送货时间 
telephone  String    固定电话 
phone  String    手机号码 
email  String    电子邮件 
address  String    收获地址 
orderTime  Date    下单时间 
orderRemark  String    订单备注 
orderCreateDate  Date    订购日期/订单生成时间 
isNotice  Number    是否送货前通知 1:是 0:否 
sendPay  String    送货时间段:第二位为2时夜间送货;其他情况为白天送货; 
paymentCategory  String  支付分类: COD, NON_COD  支付分类: COD, NON_COD 
paymentCategoryDispName  String  支付分类名称: 货到付款, 在线支付  支付分类名称: 货到付款, 在线支付 
createDate  Date    创建日期 
pin  String    下单账号 
refundSourceFlag  Number    退款来源:0无退款;1售前退款;2售后退款 
provinceName  Number    省 
cityName  Number    市 
countyName  Number    县 
townName  Number    镇 
orderDetailList  OrderDetailForJosDto[]    返回商品结果集合 


OrderDetailForJosDto 属性

名称 类型 是否必须 示例值 描述
skuId  String    商品编号 
commodityName  String    商品名称 
commodityNum  Number    商品数量 

   

返回示例 

JSON数据格式

{
"jingdong_dropship_dps_search_response": {
"searchResult": {
"recordCount": "",
"message": "",
"status": "",
"resultDtoList": [
{
"phone": "",
"townName": "",
"cityName": "",
"orderCreateDate": "",
"provinceName": "",
"paymentCategoryDispName": "支付分类名称: 货到付款, 在线支付",
"orderRemark": "",
"sendPay": "",
"countyName": "",
"isNotice": "",
"pay": "",
"createDate": "",
"consigneeName": "",
"paymentCategory": "支付分类: COD, NON_COD",
"expectedDeliveryTime": "",
"orderTime": "",
"postcode": "",
"customOrderId": "",
"refundSourceFlag": "",
"address": "",
"email": "",
"pin": "",
"orderDetailList": [
{
"commodityNum": "",
"skuId": "",
"commodityName": ""
}
],
"telephone": "",
"operatorState": "5"
}
],
"code": ""
}
}
}


错误码

错误码 错误描述 解决方案
203  外围系统传入的参数异常!   
213  通过登陆账号pin获取供应商简码异常!   

 

SDK调用示例(java)


public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
DropshipDpsSearchRequest request=new DropshipDpsSearchRequest();
request.setPageSize( 123 );
request.setPage( 123 );
request.setBeginDate( "2012-12-12 12:12:12" );
request.setEndDate( "2012-12-12 12:12:12" );
DropshipDpsSearchResponse response=client.execute(request);

  
2. 查询单条客单相关信息

接口名称

    

jingdong.dropship.dps.searchsingle


功能说明

              

查询单条客单相关信息


l API用户授权类型

 

需要


l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称 类型 是否必须 示例值 描述
customOrderId  Number  170321426  客单编号 

返回结果


名称 类型 示例值 描述
searchSingleResult  QuerySingleOrderForJosResultDto    返回值Result 


QuerySingleOrderForJosResultDto 属性

 

名称 类型 是否必须 示例值 描述
status  Number  调用接口成功与否的状态,1代表成功 0代表失败。  返回结果状态值 
message  String  返回异常消息,例如:内部处理错误。  返回结果message 
code  String  调用失败,返回异常码例如:201  返回异常错误码 
recordCount  Number  返回查询数据结果总数,例如:50  返回异常错误码 
resultSingleDto  QueryOrderForJosResultDto    返回结果集对象 

 

返回示例 

JSON数据格式

{
"jingdong_dropship_dps_searchsingle_response": {
"searchSingleResult": {
"recordCount": "返回查询数据结果总数,例如:50",
"message": "返回异常消息,例如:内部处理错误。",
"status": "调用接口成功与否的状态,1代表成功 0代表失败。",
"code": "调用失败,返回异常码例如:201",
"resultSingleDto": {
"phone": "",
"townName": "",
"cityName": "",
"orderCreateDate": "",
"provinceName": "",
"paymentCategoryDispName": "支付分类名称: 货到付款, 在线支付",
"orderRemark": "",
"sendPay": "",
"countyName": "",
"isNotice": "",
"pay": "",
"createDate": "",
"consigneeName": "",
"paymentCategory": "支付分类: COD, NON_COD",
"expectedDeliveryTime": "",
"orderTime": "",
"postcode": "",
"customOrderId": "",
"refundSourceFlag": "",
"address": "",
"email": "",
"pin": "",
"orderDetailList": [
{
"commodityNum": "",
"skuId": "",
"commodityName": ""
}
],
"telephone": "",
"operatorState": ""
}
}
}
}


错误码

错误码 错误描述 解决方案
203  外围系统传入的参数异常!   
204  厂商登陆账号绑定的ERP账号与客户单的ERP账号不匹配!   

 

SDK调用示例(java)


public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
DropshipDpsSearchsingleRequest request=new DropshipDpsSearchsingleRequest();
request.setCustomOrderId( 123 );
DropshipDpsSearchsingleResponse response=client.execute(request);

  
3. 检索售前退款的客单

接口名称

    

jingdong.dropship.dps.searchpre


功能说明

              

检索售前退款的客单


l API用户授权类型

 

需要


l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称 类型 是否必须 示例值 描述
pageSize  Number  10  每页加载的条数:范围为10—100 
page  Number  查询的页数必须从1开始,且必须大于等于1 
beginDate  Date  2013-06-16 13:23:30  开始时间(格式 yyyy-MM-dd HH:mm:ss) 
endDate  Date  2013-09-16 13:23:30  结束时间(格式 yyyy-MM-dd HH:mm:ss) 

返回结果


名称 类型 示例值 描述
searchPreResult  ReturnOrderPreForJosResultListDto    返回查询的售前退款的结果集。 


ReturnOrderPreForJosResultListDto 属性

 

名称 类型 是否必须 示例值 描述
status  Number    调用接口成功与否的状态,1代表成功 0代表失败。 
message  String    返回异常消息,例如:内部处理错误。 
code  String    调用失败,返回异常码例如:201 
recordCount  Number    返回结果条数 
resultDtoList  ReturnOrderPreForJosResultDto[]    返回结果集合 

ReturnOrderPreForJosResultDto 属性

名称 类型 是否必须 示例值 描述
id  Number    售前退款数据唯一标示 
customOrderId  Number    客户订单号 
roApplyFee  Number    退款申请金额 
roApplyDate  Date  2013-10-01 11:44:11  退款申请时间 
orderCreateDate  Date  2013-10-01 11:44:11  订单生成时间 
approvalState  Number    审核状态 
orderState  Number    订单状态 
roPreNo  Number    申请单号 
roAccount  String    退款申请账户 
roReason  String    退款申请理由 
approvalSuggestion  String    审核意见 
orderDetailList  ReturnOrderDetailForJosDto[]    返回商品结果集合 

ReturnOrderDetailForJosDto 属性

名称 类型 是否必须 示例值 描述
skuId  String    商品编码 
commodityName  String    商品名称 
commodityNum  Number    退货数量 

 

返回示例 

JSON数据格式

{
"jingdong_dropship_dps_searchpre_response": {
"searchPreResult": {
"recordCount": "",
"message": "",
"status": "",
"resultDtoList": [
{
"roPreNo": "",
"id": "",
"orderState": "",
"roReason": "",
"orderCreateDate": "2013-10-01 11:44:11",
"orderDetailList": [
{
"commodityNum": "",
"skuId": "",
"commodityName": ""
}
],
"roApplyFee": "",
"approvalState": "",
"approvalSuggestion": "",
"roApplyDate": "2013-10-01 11:44:11",
"customOrderId": "",
"roAccount": ""
}
],
"code": ""
}
}
}


错误码

错误码 错误描述 解决方案
203  外围系统传入的参数异常!   
204  厂商登陆账号绑定的ERP账号与客户单的ERP账号不匹配!   

 

SDK调用示例(java)

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
DropshipDpsSearchpreRequest request=new DropshipDpsSearchpreRequest();
request.setPageSize( 123 );
request.setPage( 123 );
request.setBeginDate( "2012-12-12 12:12:12" );
request.setEndDate( "2012-12-12 12:12:12" );
DropshipDpsSearchpreResponse response=client.execute(request);

  
4. 售前退货审核

接口名称

    

jingdong.dropship.dps.prerefund


功能说明

              

售前退货审核


l API用户授权类型

 

需要


l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称 类型 是否必须 示例值 描述
customOrderId  Number    客单编号 
approvalSuggestion  String    审核意见 
approvalState  String    审核状态 1:审核通过 2:审核不通过 
id  Number    售前退款数据唯一标示 
operatorState  Number    操作状态:5新订单;9正在出库;10 出库成功;15正在发货;16发货成功;23等待退款 

返回结果


名称 类型 示例值 描述
prerefundResult  PreRefundResult    返回值Result 


PreRefundResult 属性

名称 类型 是否必须 示例值 描述
status  Number    调用接口成功与否的状态,1代表成功 0代表失败。 
message  String    返回异常消息,例如:内部处理错误。 
code  String    调用失败,返回异常码例如:201 

 

返回示例 

JSON数据格式

{
"jingdong_dropship_dps_prerefund_response": {
"prerefundResult": {
"message": "",
"status": "",
"code": ""
}
}
}


错误码

错误码 错误描述 解决方案
203  外围系统传入的参数异常!   
204  厂商登陆账号绑定的ERP账号与客户单的ERP账号不匹配!   
205  客单号不能为空!   
215  审核意见包含特殊字符!   
214  审核状态异常!   

 

SDK调用示例(java)

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
DropshipDpsPrerefundRequest request=new DropshipDpsPrerefundRequest();
request.setCustomOrderId( 123 );
request.setApprovalSuggestion( "jingdong" );
request.setApprovalState( "jingdong" );
request.setId( 123 );
request.setOperatorState( 123 );
DropshipDpsPrerefundResponse response=client.execute(request);

  
5. 厂商直送出库

接口名称

    

jingdong.dropship.dps.outbound


功能说明

              

厂商直送出库


l API用户授权类型

 

需要


l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称 类型 是否必须 示例值 描述
customOrderId  Number  170439197  客单编号 

返回结果


名称 类型 示例值 描述
outBoundResult  OutBoundResultDto    点出库操作后返回的结果值。 


OutBoundResultDto 属性

 

名称 类型 是否必须 示例值 描述
status  Number    调用接口成功与否的状态,1代表成功 0代表失败。 
message  String    返回异常消息,例如:内部处理错误。 
code  String    调用失败,返回异常码例如:201 

 

返回示例 

JSON数据格式

{
"jingdong_dropship_dps_outbound_response": {
"outBoundResult": {
"message": "",
"status": "",
"code": ""
}
}
}


错误码

错误码 错误描述 解决方案
203  外围系统传入的参数异常!   
204  厂商登陆账号绑定的ERP账号与客户单的ERP账号不匹配!   

 

SDK调用示例(java)


public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
DropshipDpsOutboundRequest request=new DropshipDpsOutboundRequest();
request.setCustomOrderId( 123 );
DropshipDpsOutboundResponse response=client.execute(request);

  
6. 厂商直送发货

接口名称

    

jingdong.dropship.dps.delivery


功能说明

              

厂商直送发货


l API用户授权类型

 

需要


l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称 类型 是否必须 示例值 描述
customOrderId  Number  170439197  客单编号 
carrierId  Number  2100  承运商Id 
carrierBusinessName  String  国通快递  承运商名称 
shipNo  String  2304891274  运单号 
estimateDate  Date  2013-09-29  预计到货时间 

返回结果


名称 类型 示例值 描述
deliverResult  DeliverDoResultSetDto    返回操作后返回的结果。 


DeliverDoResultSetDto 属性

名称 类型 是否必须 示例值 描述
status  Number    调用接口成功与否的状态,1代表成功 0代表失败。 
message  String    返回异常消息,例如:内部处理错误。 
code  String    调用失败,返回异常码例如:201 

 

返回示例 

JSON数据格式

{
"jingdong_dropship_dps_delivery_response": {
"deliverResult": {
"message": "",
"status": "",
"code": ""
}
}
}


错误码

错误码 错误描述 解决方案
211  承运商包含特殊字符!   
212  承运人包含特殊字符!   
203  外围系统传入的参数异常!   
204  厂商登陆账号绑定的ERP账号与客户单的ERP账号不匹配!   
205  客单号不能为空!   
213  3pl承运商编号不能为空!   
206  发货操作承运商为其它,则承运商不能为空!   
207  运单号不能为空!   
208  发货操作,预计到货日期不能为空!   
209  运单号不能包含特殊字符!   

 

SDK调用示例(java)

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
DropshipDpsDeliveryRequest request=new DropshipDpsDeliveryRequest();
request.setCustomOrderId( 123 );
request.setCarrierId( 123 );
request.setCarrierBusinessName( "jingdong" );
request.setShipNo( "jingdong" );
request.setEstimateDate( "2012-12-12 12:12:12" );
DropshipDpsDeliveryResponse response=client.execute(request);

  
7. 客单拒送操作

接口名称

    

jingdong.dropship.dps.refuse


功能说明

              

客单拒送操作


l API用户授权类型

 

需要


l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称 类型 是否必须 示例值 描述
customOrderId  Number  170439197  客单编号 
refuseReason  String  无货  拒送原因 

返回结果


名称 类型 示例值 描述
refuseResult  RefuseResult  返回值Result  返回值Result 


RefuseResult 属性

 

名称 类型 是否必须 示例值 描述
status  Number  返回异常消息,例如:内部处理错误。  调用接口成功与否的状态,1代表成功 0代表失败。 
message  String  返回异常消息,例如:内部处理错误。  返回结果message 
code  String  调用失败,返回异常码例如:201  返回异常错误码 

 

返回示例 

JSON数据格式

{
"jingdong_dropship_dps_refuse_response": {
"refuseResult": {
"message": "返回异常消息,例如:内部处理错误。",
"status": "返回异常消息,例如:内部处理错误。",
"code": "调用失败,返回异常码例如:201"
}
}
}


错误码

错误码 错误描述 解决方案
203  外围系统传入的参数异常!   
204  厂商登陆账号绑定的ERP账号与客户单的ERP账号不匹配!   

 

SDK调用示例(java)


public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
DropshipDpsRefuseRequest request=new DropshipDpsRefuseRequest();
request.setCustomOrderId( 123 );
request.setRefuseReason( "jingdong" );
DropshipDpsRefuseResponse response=client.execute(request);

  
8. 时间同步

接口名称

    

jingdong.dropship.dps.currenttime


功能说明

              

时间同步


l API用户授权类型

 

需要


l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称

类型

是否必须

示例值

描述


   


此接口无需输入应用级参数,但需要构建空参数360buy_param_json={}

返回结果


名称 类型 示例值 描述
currentTime  Date    返回当前时间 

 

返回示例 

JSON数据格式

{
"jingdong_dropship_dps_currenttime_response": {
"currentTime": ""
}
}


 

SDK调用示例(java)

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); 
DropshipDpsCurrenttimeRequest request=new DropshipDpsCurrenttimeRequest();
DropshipDpsCurrenttimeResponse response=client.execute(request);

  
9. 查询供应商简码和三级分类列表

接口名称

jingdong.userCategory3.info.get

功能说明

根据pin返回供应商简码和三级分类列表

API用户授权类型

需要

系统级别输入参数

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

应用级输入参数

名称类型是否必须示例值描述
    此接口无需输入应用级参数,但需要构建空参数360buy_param_json={}

返回结果

名称类型示例值描述
userCategory3Info  UserCategory3InfoDto    三级分类信息 

UserCategory3InfoDto属性

名称类型是否必须示例值描述
providerCode String   供应商简码 
userCategory3Dtos UserCategory3Dto[]   三级分类列表 

UserCategory3Dto属性

名称类型是否必须示例值描述
code String   三级分类编码 
name String   三级分类名称 

返回示例

JSON数据格式

 {
  "jingdong_userCategory3_info_get_response":{
  "userCategory3Info":{
  "providerCode":"",
"userCategory3Dtos":[{
  "name":"",
"code":""
  }]
  }
  }
  } 

SDK调用示例(java)

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
UserCategory3InfoGetRequest request=new UserCategory3InfoGetRequest();
UserCategory3InfoGetResponse response=client.execute(request);
  
10. 获取销量库存汇总

接口名称

    

jingdong.vc.stock.sales.get


功能说明

              

获取销量库存汇总(仅返回以往8周数据,每周汇总一条记录)


l API用户授权类型

 

需要

 

l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称

类型

是否必须

示例值

描述


   


此接口无需输入应用级参数,但需要构建空参数360buy_param_json={}

返回结果


名称 类型 示例值 描述
arg36  JosStockSales[]    返回结果列表 

 

JosStockSales属性

名称 类型 是否必须 示例值 描述
stock_count  Number    库存 
sales  Number    销量 
stock_turnover_days  Number    周转天数 
stock_rate  Number    现货率 
manual_vlt  Number    手工六仓平均 
auto_vlt  Number    自动六仓平均 
week  String    所属周 
manual_sku_order_fill_rate  Number    手工sku订单满足率 
manual_units_order_fill_rate  Number    手工units订单满足率 
auto_sku_order_fill_rate  Number    自动sku订单满足率 
auto_units_order_fill_rate  Number    自动units订单满足率 
sku_order_fill_rate  Number    总计sku订单满足率 
units_order_fill_rate  Number    总计units订单满足率 


返回示例 

JSON数据格式

{
    "jingdong_vc_stock_sales_get_response": {
        "arg36": [
            {
                "jos_stock_sales": {
                    "manual_vlt": "",
                    "auto_vlt": "",
                    "auto_sku_order_fill_rate": "",
                    "sku_order_fill_rate": "",
                    "auto_units_order_fill_rate": "",
                    "stock_rate": "",
                    "manual_sku_order_fill_rate": "",
                    "stock_count": "",
                    "manual_units_order_fill_rate": "",
                    "sales": "",
                    "stock_turnover_days": "",
                    "units_order_fill_rate": "",
                    "week": ""
                }
            }
        ]
    }
}

错误码

错误码 错误描述 解决方案
500  服务器端异常   

 

SDK调用示例(java)


public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
VcStockSalesGetRequest request=new VcStockSalesGetRequest();
VcStockSalesGetResponse response=client.execute(request);

  
11. 获取销量库存明细

接口名称

    

jingdong.vc.stock.sales.detail.get


功能说明

              

获取销量库存明细


l API用户授权类型

 

需要

 

l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称 类型 是否必须 示例值 描述
product_code  String  231606  商品编号 

返回结果


名称 类型 示例值 描述
arg43  JosStockSalesDetail[]    返回结果列表 

 

JosStockSalesDetail属性

名称 类型 是否必须 示例值 描述
product_code  String    商品编号 
product_name  String    商品名称 
stock_count  Number    库存 
sales  Number    销量 


返回示例 

JSON数据格式

{
    "jingdong_vc_stock_sales_detail_get_response": {
        "arg43": [
            {
                "jos_stock_sales_detail": {
                    "stock_count": "",
                    "sales": "",
                    "product_code": "",
                    "product_name": ""
                }
            }
        ]
    }
}

错误码

错误码 错误描述 解决方案
500  服务器端异常   
501  校验数据类型异常    
502 (采购单绑定的采销员不存在,采销员简码为:test;该商品不属于该供应商,商品编号为:123456;该用户没有回告权限等) 根据返回的异常信息调整数据,如果还未来解决,请联系对应的采购员解

 

SDK调用示例(java)


public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
VcStockSalesDetailGetRequest request=new VcStockSalesDetailGetRequest();
request.setProductCode( "jingdong" );
VcStockSalesDetailGetResponse response=client.execute(request);

  
12. 创建采购单

接口名称

    

jingdong.procurement.order.create


功能说明

              

创建采购单


l API用户授权类型

 

需要

 

l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称 类型 是否必须 示例值 描述
deliverCenterId  Number  订购城市,京东的配送中心编号(3,上海 4,成都 5,武汉 6,北京 7,南京 8, 济南 9,沈阳 10,广州 316,西安 322, 福州 545, 杭州 601,天津 603,深圳 605,重庆 606,苏州 607,宁波 608,郑州 609,厦门 610,青岛 614,石家庄 615,太原 616,南宁 617,哈尔滨 618,大连 619,长沙 625,EPT配送中心628,兰州 629,包头 630,乌鲁木齐 631,合肥 632,宿迁 633,昆明 634,贵阳 636,长春 644,佛山 648,烟台) 
purchaserErpCode  String  bjyy  采销ErpCode 
remark  String  手动补货单  备注 
wareId  Number[]  1,2,3  京东商品Id(备注:多个以逗号隔开,且中间不能有空格) 
allocationDeliverCenterId  Number[]  6,6,6  分配机构,京东的配送中心编号,填写要求必须是对应商品的库房属性维护的范围内(3,上海 4,成都 5,武汉 6,北京 7,南京 8, 济南 9,沈阳 10,广州 316,西安 322, 福州 545, 杭州 601,天津 603,深圳 605,重庆 606,苏州 607,宁波 608,郑州 609,厦门 610,青岛 614,石家庄 615,太原 616,南宁 617,哈尔滨 618,大连 619,长沙 625,EPT配送中心628,兰州 629,包头 630,乌鲁木齐 631,合肥 632,宿迁 633,昆明 634,贵阳 636,长春 644,佛山 648,烟台)(备注:多个以逗号隔开,且中间不能有空格,与wareId顺序和个数保持一致) 
originalNum  Number[]  10,11,12  采购数量,要求必须大于0(备注:多个以逗号隔开,且中间不能有空格,与wareId顺序和个数保持一致) 

返回结果


名称 类型 示例值 描述
purchaseOrderCodes  Number[]    采购定单ID列表 


返回示例 

JSON数据格式

{
    "jingdong_procurement_order_create_response": {
        "purchaseOrderCodes": [
            {
                "orderId": ""
            }
        ]
    }
}

错误码

错误码 错误描述 解决方案
500  服务器端异常   
501  校验数据类型异常    
502 (采购单绑定的采销员不存在,采销员简码为:test;该商品不属于该供应商,商品编号为:123456;该用户没有回告权限等) 根据返回的异常信息调整数据,如果还未来解决,请联系对应的采购员解

 

SDK调用示例(java)


  
13. 采购单回告

接口名称

    

jingdong.procurement.order.confirm


功能说明

              

采购单回告


l API用户授权类型

 

需要

 

l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称 类型 是否必须 示例值 描述
orderId  Number  123456  订单id 
deliveryTime  Date  2014-03-25 12:06:24  预计送货日期 
wareId  Number[]  123,456  商品编号(备注:多个以逗号隔开,且中间不允许有空格) 
deliverCenterId  Number[]  6,6  分配机构,京东配送中心(3,上海 4,成都 5,武汉 6,北京 7,南京 8, 济南 9,沈阳 10,广州 316,西安 322, 福州 545, 杭州 601,天津 603,深圳 605,重庆 606,苏州 607,宁波 608,郑州 609,厦门 610,青岛 614,石家庄 615,太原 616,南宁 617,哈尔滨 618,大连 619,长沙 625,EPT配送中心628,兰州 629,包头 630,乌鲁木齐 631,合肥 632,宿迁 633,昆明 634,贵阳 636,长春 644,佛山 648,烟台)(备注:多个以逗号隔开,且中间不允许有空格,与wareId个数保持一致) 
backExplanationType  Number[]  1,2  不发货原因类型(1:停产不加印 2:暂时缺货 3:新品未出印厂 4:非本社图书)(备注:多个以逗号隔开,且中间不允许有空格,与wareId个数保持一致 
confirmNum  Number[]  11,12  确认数量(备注:多个以逗号隔开,且中间不允许有空格,与wareId个数保持一致 

返回结果


名称 类型 示例值 描述
result  Boolean  true  是否回告成功,true表示成功,否则抛出异常信息 

 

JosStockSales属性

名称 类型 是否必须 示例值 描述
stock_count  Number    库存 
sales  Number    销量 
stock_turnover_days  Number    周转天数 
stock_rate  Number    现货率 
manual_vlt  Number    手工六仓平均 
auto_vlt  Number    自动六仓平均 
week  String    所属周 
manual_sku_order_fill_rate  Number    手工sku订单满足率 
manual_units_order_fill_rate  Number    手工units订单满足率 
auto_sku_order_fill_rate  Number    自动sku订单满足率 
auto_units_order_fill_rate  Number    自动units订单满足率 
sku_order_fill_rate  Number    总计sku订单满足率 
units_order_fill_rate  Number    总计units订单满足率 


返回示例 

JSON数据格式

{
    "jingdong_procurement_order_confirm_response": {
        "result": "true"
    }
}

错误码

错误码 错误描述 解决方案
500  服务器端异常   
501  校验数据类型异常    
502 (采购单绑定的采销员不存在,采销员简码为:test;该商品不属于该供应商,商品编号为:123456;该用户没有回告权限等) 根据返回的异常信息调整数据,如果还未来解决,请联系对应的采购员解

 

SDK调用示例(java)


public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
ProcurementOrderConfirmRequest request=new ProcurementOrderConfirmRequest();
request.setOrderId( 123 );
request.setDeliveryTime( "2012-12-12 12:12:12" );
request.setWareId( "123,234,345" );
request.setDeliverCenterId( "123,234,345" );
request.setBackExplanationType( "123,234,345" );
request.setConfirmNum( "123,234,345" );
ProcurementOrderConfirmResponse response=client.execute(request);

  
14. 根据采购单单号获取采购单明细列表

接口名称

    

jingdong.po.detail.page.get


功能说明

              

根据采购单单号获取采购单明细列表(分页查询且至多支持100条)


l API用户授权类型

 

需要

 

l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称 类型 是否必须 示例值 描述
orderId  Number  1234567  采购单单号 
sortFiled  String  originalNum  排序字段(按照商品采购价、原始预计采购数量排序,分别对应字段:jiage、originalNum) 
sortMode  String  DESC  排序方式(按照升序或降序,分别对应字段:ASC、DESC) 
pageIndex  Number  当前页码(从1开始) 
pageSize  Number  50  每页大小(最大支持100) 

返回结果


名称 类型 示例值 描述
detailResultDto  DetailResultDto    采购单明细查询结果 

 

DetailResultDto 属性

recordCount  Number    总记录数 
totalPage  Number    总页数 
orderId  Number    订单号 
deliveryTime  Date    预计送货时间 
allocationDetailList  PurchaseAllocationDetailDto[]    采购单明细 


PurchaseAllocationDetailDto 属性

名称 类型 是否必须 示例值 描述
wareId  Number    商品编号 
deliverCenterId  Number    配送中心编号 
deliverCenterName  String    配送中心名称 
wareName  String    商品名称 
purchasePrice  Number    采购价格 
totoalPrice  Number    商品总金额 
makePrice  Number    下采购单时候的定价,只针对图书音像商品 
currentMakePrice  Number    当前定价 
discount  Number    定价 
originalNum  Number    原始采购数量 
confirmNum  Number    确认数量/预计采购数量 
actualNum  Number    实际采购数量 
nonDeliveryReason  String    不发货原因 
remark  String    商品备注 
isbn  String    isbn 
brandName  String    品牌名称 
brandId  String    品牌编号 
purchaseWareProperty  PurchaseWarePropertyDto    EPT定制采购单特有的属性 

PurchaseWarePropertyDto 属性

名称 类型 是否必须 示例值 描述
wareId  Number    商品编号 
chest  Number    胸围 
waistline  Number    腰围 
hip  Number    臀围 
dressLength  Number    衣长 
height  Number    身高 
color  String    颜色 
mainPictureLink  String    主图连接地址 

 

返回示例 

JSON数据格式

{
    "jingdong_po_detail_page_get_response": {
        "detailResultDto": {
            "recordCount": "",
            "deliveryTime": "",
            "pageSize": "",
            "allocationDetailList": [
                {
                    "poDetailAllocationDto": {
                        "actualNum": "",
                        "makePrice": "",
                        "currentMakePrice": "",
                        "remark": "",
                        "originalNum": "",
                        "deliverCenterName": "",
                        "brandId": "",
                        "brandName": "",
                        "discount": "",
                        "purchaseWareProperty": {
                            "dressLength": "",
                            "height": "",
                            "waistline": "",
                            "mainPictureLink": "",
                            "color": "",
                            "hip": "",
                            "chest": "",
                            "wareId": ""
                        },
                        "wareName": "",
                        "isbn": "",
                        "nonDeliveryReason": "",
                        "wareId": "",
                        "confirmNum": "",
                        "deliverCenterId": "",
                        "totoalPrice": "",
                        "purchasePrice": ""
                    }
                }
            ],
            "totalPage": "",
            "orderId": "",
            "pageIndex": ""
        }
    }
}

错误码

错误码 错误描述 解决方案
500  服务器端异常   
501  校验数据类型异常    
502 (采购单绑定的采销员不存在,采销员简码为:test;该商品不属于该供应商,商品编号为:123456;该用户没有回告权限等) 根据返回的异常信息调整数据,如果还未来解决,请联系对应的采购员解

 

SDK调用示例(java)


public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
PoDetailPageGetRequest request=new PoDetailPageGetRequest();
request.setOrderId( 123 );
request.setSortFiled( "jingdong" );
request.setSortMode( "jingdong" );
request.setPageIndex( 123 );
request.setPageSize( 123 );
PoDetailPageGetResponse response=client.execute(request);

  
15. 分页查询采购单列表

接口名称

    

jingdong.po.list.page.get


功能说明

              

根据条件分页查询采购单列表(至多支持100条)


l API用户授权类型

 

需要

 

l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称 类型 是否必须 示例值 描述
deliverCenterId  Number    订购城市(3,上海 4,成都 5,武汉 6,北京 7,南京 8, 济南 9,沈阳 10,广州 316,西安 322, 福州 545, 杭州 601,天津 603,深圳 605,重庆 606,苏州 607,宁波 608,郑州 609,厦门 610,青岛 614,石家庄 615,太原 616,南宁 617,哈尔滨 618,大连 619,长沙 625,EPT配送中心628,兰州 629,包头 630,乌鲁木齐 631,合肥 632,宿迁 633,昆明 634,贵阳 636,长春 644,佛山 648,烟台) 
status  Number    是否删除(0:删除 1:正常) 
createdDateStart  Date  2013-12-26 16:09:07  创建日期-开始时间 
createdDateEnd  Date  2013-12-26 16:09:10  创建日期-结束时间 
isEptCustomized  Boolean  true  是否定制(不填:全部 false:EPT非定制 true:EPT定制) 
pageIndex  Number  当前页码(从1开始) 
pageSize  Number  50  每页大小(最大支持100) 
orderIds  Number[]  1016886,575391  采购订单编号列表(不填默认全部) 
wareIds  Number[]  1000248,1000247  商品编号列表(不填默认全部) 
states  Number[]  0,2  采购单状态列表(不填默认全部 0:新采购单;2:等待入库;3:已完成 ;5:等待摆货;6:等待审核;7:审核不通过;8:等待签收;10:等待经理审核;11:等待经理审核;12:等待总监审核;15:待确认;16:暂停 订单) 
confirmStates  Number[]  1,2,3  回告状态列表(不填默认全部 0:未确认;1:回告成功;2:回告中;3:回告失败) 
orderAttributes  Number[]  1,2,3  订单属性列表(不填默认全部 (1:新品订单、2:手工补货单、3:自动补货单、4:问题区补单 5:有单备货单、6:自动补货补给单、7:手工下单补给单、8:新品订单补给单、9:有单备货补给单) 

返回结果


名称 类型 示例值 描述
orderResultDto  OrderResultDto    采购单列表查询结果 

 

OrderResultDto 属性

名称 类型 是否必须 示例值 描述
recordCount  Number    总记录数 
totalPage  Number    总页数 
purchaseOrderList  PurchaseOrderDto[]    采购单列表 


PurchaseOrderDto 属性

名称 类型 是否必须 示例值 描述
orderId  Number    订单号 
createdDate  Date    创建时间 
completeDate  Date    完成日期(订单完成后,才有更新时间) 
providerCode  String    供应商简码 
providerName  String    供应商在京东注册名称 
deliverCenterId  Number    配送中心编号 
deliverCenterName  String    供应商在京东注册名称 
totalPrices  Number    订单总金额 
purchaserErpCode  String    采销员ERPCODE 
purchaserName  String    采销员姓名 
isCanConfirm  Boolean    是否能回告(true表示能回告,false表示不能回告) 
status  Number    是否删除标志 
statusName  String    是否删除标志名称 
accountPeriod  Number    账期 
ou  String    供应商结算主体 
ynPaid  String    是否付款 
ynContainTax  String    是否含税 
chargeTransit  String    承担运费 
transitType  String    运送方式 
arrivalDays  Number    预计到达天数 
checkType  Number    票款方式 
checkTypeName  String    票款方式名称 
deliveryAddress  String    送货地点 
receiverName  String    收货人姓名 
warehousePhone  String    收货库房电话 
address  String    收货详细地址 
purchaseType  Number    采购类型ID(0:正常 1:特价产品 2:季节性产品 3:尾货产品 4:其它) 
purchaseTypeName  String    采购类型名称 
orderType  Number    采购类型ID( 0:正常采购单 1:虚拟采购单 2:厂商直送 1000:POP采购单 2000:EPT定制 2001:EPT非定制 3000:自动采购单) 
orderTypeName  String    采购类型名称 
orderAttribute  Number    订单属性(1:新品订单、2:手工补货单、3:自动补货单、4:问题区补单 5:有单备货单、6:自动补货补给单、7:手工下单补给单、8:新品订单补给单、9:有单备货补给单) 
orderAttributeName  String    订单属性名称 
originalTotalNum  Number    采购总数量 
wareVariety  Number    商品品种数 
customOrderId  Number    顾客单号 
confirmState  Number    回告状态 (0:未确认;1:回告成功;2:回告中;3:回告失败) 
confirmStateName  String    回告状态名称 
state  Number    采购单状态 
stateName  String    采购单状态名称 

 

返回示例 

JSON数据格式

{
    "jingdong_po_list_page_get_response": {
        "orderResultDto": {
            "recordCount": "",
            "pageSize": "",
            "totalPage": "",
            "purchaseOrderList": [
                {
                    "purchaseOrderDto": {
                        "confirmStateName": "",
                        "ynPaid": "",
                        "purchaseTypeName": "",
                        "statusName": "",
                        "state": "",
                        "totalPrices": "",
                        "purchaserErpCode": "",
                        "completeDate": "",
                        "checkTypeName": "",
                        "confirmState": "",
                        "receiverName": "",
                        "ynContainTax": "",
                        "createdDate": "",
                        "checkType": "",
                        "orderTypeName": "",
                        "orderId": "",
                        "isCanConfirm": "",
                        "ou": "",
                        "purchaserName": "",
                        "orderType": "",
                        "status": "",
                        "transitType": "",
                        "purchaseType": "",
                        "arrivalDays": "",
                        "warehousePhone": "",
                        "deliverCenterName": "",
                        "customOrderId": "",
                        "providerCode": "",
                        "orderAttribute": "",
                        "address": "",
                        "providerName": "",
                        "stateName": "",
                        "orderAttributeName": "",
                        "wareVariety": "",
                        "chargeTransit": "",
                        "originalTotalNum": "",
                        "accountPeriod": "",
                        "deliverCenterId": "",
                        "deliveryAddress": ""
                    }
                }
            ],
            "pageIndex": ""
        }
    }
}

错误码

错误码 错误描述 解决方案
500  服务器端异常   
501  校验数据类型异常    
502 (采购单绑定的采销员不存在,采销员简码为:test;该商品不属于该供应商,商品编号为:123456;该用户没有回告权限等) 根据返回的异常信息调整数据,如果还未来解决,请联系对应的采购员解

 

SDK调用示例(java)


public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
PoListPageGetRequest request=new PoListPageGetRequest();
request.setDeliverCenterId( 123 );
request.setStatus( 123 );
request.setCreatedDateStart( "2012-12-12 12:12:12" );
request.setCreatedDateEnd( "2012-12-12 12:12:12" );
request.setIsEptCustomized( true );
request.setPageIndex( 123 );
request.setPageSize( 123 );
request.setOrderIds( "123,234,345" );
request.setWareIds( "123,234,345" );
request.setStates( "123,234,345" );
request.setConfirmStates( "123,234,345" );
request.setOrderAttributes( "123,234,345" );
PoListPageGetResponse response=client.execute(request);

  
16. 创建退货单

接口名称

    

jingdong.vc.create.return.order


功能说明

              

创建退货单


l API用户授权类型

 

需要

 

l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称 类型 是否必须 示例值 描述
fromDeliverCenterId  Number  退货发货地(3,上海 4,成都 5,武汉 6,北京 7,南京 8, 济南 9,沈阳 10,广州 316,西安 322, 福州 545, 杭州 601,天津 603,深圳 605,重庆 606,苏州 607,宁波 608,郑州 609,厦门 610,青岛 614,石家庄 615,太原 616,南宁 617,哈尔滨 618,大连 619,长沙 625,EPT配送中心628,兰州 629,包头 630,乌鲁木齐 631,合肥 632,宿迁 633,昆明 634,贵阳 636,长春 644,佛山 648,烟台) 
toDeliverCenterId  Number  退货目的地(3,上海 4,成都 5,武汉 6,北京 7,南京 8, 济南 9,沈阳 10,广州 316,西安 322, 福州 545, 杭州 601,天津 603,深圳 605,重庆 606,苏州 607,宁波 608,郑州 609,厦门 610,青岛 614,石家庄 615,太原 616,南宁 617,哈尔滨 618,大连 619,长沙 625,EPT配送中心628,兰州 629,包头 630,乌鲁木齐 631,合肥 632,宿迁 633,昆明 634,贵阳 636,长春 644,佛山 648,烟台)(备注:与fromDeliverCenterId值相同,因为京东暂不支持异地退货) 
purchaseErpCode  String  bjjdz  采销简码(京东人员的ERP帐号) 
balanceType  Number  结算类型(运输方式只有两种:1,普通快递,2,自提,不填则默认2) 
transportType  Number  运输方式(1,月结订单 2,货到付款 3,无需结算,不填则默认1) 
receiverName  String  张三  取货人姓名 
receiverCell  String  18600781245  取货人电话 
pikerID  String  657284987121456874  证件号 
reservedPickUpDate  Date  2014-03-26 15:38:30  预约取货时间 
receiverAddress  String  北京市朝阳区北辰西路8号北辰世纪中心A座1层  收件人地址 
postCode  String  100000  邮编 
wareId  Number[]  123456,123456  商品id(备注:多个以逗号隔开,中间不允许有空格) 
returnNum  Number[]  1,2  退货数量(备注:多个以逗号隔开,中间不允许有空格,且与wareId个数保持一致) 

返回结果


名称 类型 示例值 描述
returnOrderIds  Number[][]    退货单号列表 

 

返回示例 

JSON数据格式

{
    "jingdong_vc_create_return_order_response": {
        "returnOrderIds": [
            {
                "returnOrderId": [
                    {
                        
                    }
                ]
            }
        ]
    }
}

错误码

错误码 错误描述 解决方案
500  服务器端异常   
501  校验数据类型异常    
502 (采购单绑定的采销员不存在,采销员简码为:test;该商品不属于该供应商,商品编号为:123456;该用户没有回告权限等) 根据返回的异常信息调整数据,如果还未来解决,请联系对应的采购员解

 

SDK调用示例(java)


public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
VcCreateReturnOrderRequest request=new VcCreateReturnOrderRequest();
request.setFromDeliverCenterId( 123 );
request.setToDeliverCenterId( 123 );
request.setPurchaseErpCode( "jingdong" );
request.setBalanceType( 123 );
request.setTransportType( 123 );
request.setReceiverName( "jingdong" );
request.setReceiverCell( "jingdong" );
request.setPikerID( "jingdong" );
request.setReservedPickUpDate( "2012-12-12 12:12:12" );
request.setReceiverAddress( "jingdong" );
request.setPostCode( "jingdong" );
request.setWareId( "123,234,345" );
request.setReturnNum( "123,234,345" );
VcCreateReturnOrderResponse response=client.execute(request);

  
17. 根据退货单号取得退货单明细

接口名称

    

jingdong.vc.get.return.order.detail


功能说明

              

根据退货单号取得退货单明细


l API用户授权类型

 

需要

 

l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称 类型 是否必须 示例值 描述
returnId  Number  123456  退货单号 

返回结果


名称 类型 示例值 描述
detailResultDto  DetailResultDto    退货单详情 

 

DetailResultDto 属性

名称 类型 是否必须 示例值 描述
returnId  Number    退货单号 
createDate  Date    退货单生成的时间 
providerCode  String    供应商简码 
providerName  String    供应商名称 
fromDeliverCenterName  String    退货地配送中心名称 
toDeliverCenterName  String    目的地配送中心名称 
totalNum  Number    退货单数量 
totalPrice  Number    退货单总金额 
wareVariety  Number    品种 
bookingDate  Date    预计取货时间 
deliverTime  Date    送货时间 
balanceState  Number    退货单结算状态(来自京东财务数据包括0:未结算、1、已结算、2 无需结算,如果查找不到相关财务结算数据,则为空) 
balanceStateName  String    退货单结算状态名称(来自京东财务数据,包括未结算、已结算、无需结算,如果查找不到相关财务结算数据,则为空) 
balanceDate  Date    退货单结算时间 
opinion  String    审核意见 
outStoreRoomDate  Date    退货单出库时间 
detailDtoList  RoDetailDto[]    退货单明细列表 

 

RoDetailDto 属性

名称 类型 是否必须 示例值 描述
wareId  Number    商品编号 
wareName  String    商品名称 
brandName  String    品牌名称 
returnsPrice  Number    申请退货价格 
returnsNum  Number    申请退货数量 
factNum  Number    实际退货数量 
totalPrice  Number    退货总金额 
isbn  String    商品ISBN,限图书音像类型商品,否则为空 
discount  Number    退货单创建时折扣,限图书音像类型商品,否则为空 
makePrice  Number    退货单创建时定价,限图书音像类型商品,否则为空 

 

返回示例 

JSON数据格式

{
    "jingdong_vc_get_return_order_detail_response": {
        "detailResultDto": {
            "bookingDate": "",
            "balanceState": "",
            "toDeliverCenterName": "",
            "balanceDate": "",
            "outStoreRoomDate": "",
            "returnId": "",
            "providerCode": "",
            "totalNum": "",
            "providerName": "",
            "balanceStateName": "",
            "detailDtoList": [
                {
                    "roDetailDto": {
                        "makePrice": "",
                        "returnsNum": "",
                        "wareName": "",
                        "isbn": "",
                        "returnsPrice": "",
                        "factNum": "",
                        "wareId": "",
                        "brandName": "",
                        "discount": "",
                        "totalPrice": ""
                    }
                }
            ],
            "fromDeliverCenterName": "",
            "opinion": "",
            "wareVariety": "",
            "createDate": "",
            "deliverTime": "",
            "totalPrice": ""
        }
    }
}

错误码

错误码 错误描述 解决方案
500  服务器端异常   
501  校验数据类型异常    
502 (采购单绑定的采销员不存在,采销员简码为:test;该商品不属于该供应商,商品编号为:123456;该用户没有回告权限等) 根据返回的异常信息调整数据,如果还未来解决,请联系对应的采购员解

 

SDK调用示例(java)


public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
VcGetReturnOrderDetailRequest request=new VcGetReturnOrderDetailRequest();
request.setReturnId( 123 );
VcGetReturnOrderDetailResponse response=client.execute(request);

18. 分页查询退货单列表

接口名称

    

jingdong.vc.return.order.list.page.get


功能说明

              

分页查询退货单列表


l API用户授权类型

 

需要

 

l 系统级别输入参数


名称 类型 是否必须 描述
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


应用级输入参数


名称 类型 是否必须 示例值 描述
returnId  Number  123456  退货单号 
fromDeliverCenterId  Number  退货地配送中心 
returnStates  String  13  退货单状态(支持多个,如果查询全部,则不需要赋值,其中1,初始退货单 2,等待经理审核 3,等待总监审核 4,等待质控审核 5,审核通过 9,等待退货机构出库 10,等待目的机构入库 11,等待退货区收货 13,等待供应商收货 17,报废等待结算 18,提货等待结算 20,已完成 21,等待删除确认 22,已删除) 
createDateBegin  Date  2014-01-20 17:45:56  退货单创建时间(开始时间) 
createDateEnd  Date  2014-03-27 9:24:07  退货单创建时间(截止时间,如果输入截止时间,则必须输入开始时间) 
pageSize  Number  分页大小 
pageIndex  Number  50  页码 

返回结果

 

名称 类型 示例值 描述
roResultDto  RoResultDto    退货单返回结果集 

 

RoResultDto 属性

名称 类型 是否必须 示例值 描述
recordCount  Number    总记录数 
roDtoList  RoDto[]    退货单列表 

 

RoDto 属性

名称 类型 是否必须 示例值 描述
returnId  Number    退货单号 
providerCode  String    供应商简码 
providerName  String    供应商名称 
createDate  Date    创建日期 
fromDeliverCenterName  String    退货地配送中心名称 
toDeliverCenterName  String    目的地配送中心名称 
returnStateName  String    退货单状态名称 
totalNum  Number    退货总数量 
totalPrice  Number    退货总金额 
stockName  String    商品库房名称 
wareHouseAddress  String    退货地仓库地址 
wareHouseCell  String    仓储联系人电话 
wareHouseContact  String    仓储联系人 
outStoreRoomDate  Date    退货单出库时间 
wareVariety  Number    退货单品种数 
balanceStateName  String    退货结算状态名称(财务接口返回,如果无相关数据,则为空) 
balanceDate  Date    退货单结算时间(财务接口返回,如果无相关数据,则为空) 

 

返回示例 

JSON数据格式

124

错误码

错误码 错误描述 解决方案
500  服务器端异常   
501  校验数据类型异常    
502 (采购单绑定的采销员不存在,采销员简码为:test;该商品不属于该供应商,商品编号为:123456;该用户没有回告权限等) 根据返回的异常信息调整数据,如果还未来解决,请联系对应的采购员解

 

SDK调用示例(java)


public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
VcReturnOrderListPageGetRequest request=new VcReturnOrderListPageGetRequest();
request.setReturnId( 123 );
request.setFromDeliverCenterId( 123 );
request.setReturnStates( "jingdong" );
request.setCreateDateBegin( "2012-12-12 12:12:12" );
request.setCreateDateEnd( "2012-12-12 12:12:12" );
request.setPageSize( 123 );
request.setPageIndex( 123 );
VcReturnOrderListPageGetResponse response=client.execute(request);

返回顶部