l 接口名称
jingdong.dropship.dps.search
l 功能说明
检索需要出库的客单
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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
pageSize | Number | 是 | 10 | 每页加载的条数:范围为10—100 |
page | Number | 是 | 1 | 查询的页数必须从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 | 操作状态:5新订单;9正在出库;10 出库成功;15正在发货;16发货成功;23等待退款 |
consigneeName | String | 否 | 收获人姓名 | |
postcode | String | 否 | 邮编 | |
expectedDeliveryTime | Date | 否 | 期望送货时间 | |
telephone | String | 否 | 固定电话 | |
phone | String | 否 | 手机号码 | |
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 | 否 | 商品数量 |
l 返回示例
JSON数据格式
{ |
l 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
203 | 外围系统传入的参数异常! | |
213 | 通过登陆账号pin获取供应商简码异常! |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.dropship.dps.searchsingle
l 功能说明
查询单条客单相关信息
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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
customOrderId | Number | 是 | 170321426 | 客单编号 |
返回结果
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
searchSingleResult | QuerySingleOrderForJosResultDto | 返回值Result |
QuerySingleOrderForJosResultDto 属性
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
status | Number | 否 | 调用接口成功与否的状态,1代表成功 0代表失败。 | 返回结果状态值 |
message | String | 否 | 返回异常消息,例如:内部处理错误。 | 返回结果message |
code | String | 否 | 调用失败,返回异常码例如:201 | 返回异常错误码 |
recordCount | Number | 否 | 返回查询数据结果总数,例如:50 | 返回异常错误码 |
resultSingleDto | QueryOrderForJosResultDto | 否 | 返回结果集对象 |
l 返回示例
JSON数据格式
{ |
l 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
203 | 外围系统传入的参数异常! | |
204 | 厂商登陆账号绑定的ERP账号与客户单的ERP账号不匹配! |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.dropship.dps.searchpre
l 功能说明
检索售前退款的客单
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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
pageSize | Number | 是 | 10 | 每页加载的条数:范围为10—100 |
page | Number | 是 | 1 | 查询的页数必须从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 | 否 | 退货数量 |
l 返回示例
JSON数据格式
{ |
l 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
203 | 外围系统传入的参数异常! | |
204 | 厂商登陆账号绑定的ERP账号与客户单的ERP账号不匹配! |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.dropship.dps.prerefund
l 功能说明
售前退货审核
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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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 |
l 返回示例
JSON数据格式
{ |
l 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
203 | 外围系统传入的参数异常! | |
204 | 厂商登陆账号绑定的ERP账号与客户单的ERP账号不匹配! | |
205 | 客单号不能为空! | |
215 | 审核意见包含特殊字符! | |
214 | 审核状态异常! |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.dropship.dps.outbound
l 功能说明
厂商直送出库
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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
customOrderId | Number | 是 | 170439197 | 客单编号 |
返回结果
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
outBoundResult | OutBoundResultDto | 点出库操作后返回的结果值。 |
OutBoundResultDto 属性
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
status | Number | 否 | 调用接口成功与否的状态,1代表成功 0代表失败。 | |
message | String | 否 | 返回异常消息,例如:内部处理错误。 | |
code | String | 否 | 调用失败,返回异常码例如:201 |
l 返回示例
JSON数据格式
{ |
l 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
203 | 外围系统传入的参数异常! | |
204 | 厂商登陆账号绑定的ERP账号与客户单的ERP账号不匹配! |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.dropship.dps.delivery
l 功能说明
厂商直送发货
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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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 |
l 返回示例
JSON数据格式
{ |
l 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
211 | 承运商包含特殊字符! | |
212 | 承运人包含特殊字符! | |
203 | 外围系统传入的参数异常! | |
204 | 厂商登陆账号绑定的ERP账号与客户单的ERP账号不匹配! | |
205 | 客单号不能为空! | |
213 | 3pl承运商编号不能为空! | |
206 | 发货操作承运商为其它,则承运商不能为空! | |
207 | 运单号不能为空! | |
208 | 发货操作,预计到货日期不能为空! | |
209 | 运单号不能包含特殊字符! |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.dropship.dps.refuse
l 功能说明
客单拒送操作
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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
customOrderId | Number | 是 | 170439197 | 客单编号 |
refuseReason | String | 是 | 无货 | 拒送原因 |
返回结果
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
refuseResult | RefuseResult | 返回值Result | 返回值Result |
RefuseResult 属性
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
status | Number | 否 | 返回异常消息,例如:内部处理错误。 | 调用接口成功与否的状态,1代表成功 0代表失败。 |
message | String | 否 | 返回异常消息,例如:内部处理错误。 | 返回结果message |
code | String | 否 | 调用失败,返回异常码例如:201 | 返回异常错误码 |
l 返回示例
JSON数据格式
{ |
l 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
203 | 外围系统传入的参数异常! | |
204 | 厂商登陆账号绑定的ERP账号与客户单的ERP账号不匹配! |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.dropship.dps.currenttime
l 功能说明
时间同步
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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
|
| 此接口无需输入应用级参数,但需要构建空参数360buy_param_json={} |
返回结果
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
currentTime | Date | 返回当前时间 |
l 返回示例
JSON数据格式
{ |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
接口名称
jingdong.userCategory3.info.get
功能说明
根据pin返回供应商简码和三级分类列表
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
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={} |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
userCategory3Info | UserCategory3InfoDto | 三级分类信息 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
providerCode | String | 否 | 供应商简码 | |
userCategory3Dtos | UserCategory3Dto[] | 否 | 三级分类列表 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
code | String | 否 | 三级分类编码 | |
name | String | 否 | 三级分类名称 |
{ "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); |
l 接口名称
jingdong.vc.stock.sales.get
l 功能说明
获取销量库存汇总(仅返回以往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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
|
| 此接口无需输入应用级参数,但需要构建空参数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订单满足率 |
l 返回示例
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": "" } } ] } } |
l 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
500 | 服务器端异常 |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.vc.stock.sales.detail.get
l 功能说明
获取销量库存明细
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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
product_code | String | 否 | 231606 | 商品编号 |
返回结果
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
arg43 | JosStockSalesDetail[] | 返回结果列表 |
JosStockSalesDetail属性
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
product_code | String | 否 | 商品编号 | |
product_name | String | 否 | 商品名称 | |
stock_count | Number | 否 | 库存 | |
sales | Number | 否 | 销量 |
l 返回示例
JSON数据格式
{ "jingdong_vc_stock_sales_detail_get_response": { "arg43": [ { "jos_stock_sales_detail": { "stock_count": "", "sales": "", "product_code": "", "product_name": "" } } ] } } |
l 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
500 | 服务器端异常 | |
501 | 校验数据类型异常 | |
502 | (采购单绑定的采销员不存在,采销员简码为:test;该商品不属于该供应商,商品编号为:123456;该用户没有回告权限等) | 根据返回的异常信息调整数据,如果还未来解决,请联系对应的采购员解 |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.procurement.order.create
l 功能说明
创建采购单
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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
deliverCenterId | Number | 是 | 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,烟台) |
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列表 |
l 返回示例
JSON数据格式
{ "jingdong_procurement_order_create_response": { "purchaseOrderCodes": [ { "orderId": "" } ] } } |
l 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
500 | 服务器端异常 | |
501 | 校验数据类型异常 | |
502 | (采购单绑定的采销员不存在,采销员简码为:test;该商品不属于该供应商,商品编号为:123456;该用户没有回告权限等) | 根据返回的异常信息调整数据,如果还未来解决,请联系对应的采购员解 |
l SDK调用示例(java)
l 接口名称
jingdong.procurement.order.confirm
l 功能说明
采购单回告
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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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订单满足率 |
l 返回示例
JSON数据格式
{ "jingdong_procurement_order_confirm_response": { "result": "true" } } |
l 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
500 | 服务器端异常 | |
501 | 校验数据类型异常 | |
502 | (采购单绑定的采销员不存在,采销员简码为:test;该商品不属于该供应商,商品编号为:123456;该用户没有回告权限等) | 根据返回的异常信息调整数据,如果还未来解决,请联系对应的采购员解 |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.po.detail.page.get
l 功能说明
根据采购单单号获取采购单明细列表(分页查询且至多支持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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
orderId | Number | 是 | 1234567 | 采购单单号 |
sortFiled | String | 否 | originalNum | 排序字段(按照商品采购价、原始预计采购数量排序,分别对应字段:jiage、originalNum) |
sortMode | String | 否 | DESC | 排序方式(按照升序或降序,分别对应字段:ASC、DESC) |
pageIndex | Number | 是 | 1 | 当前页码(从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 | 否 | 主图连接地址 |
l 返回示例
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": "" } } } |
l 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
500 | 服务器端异常 | |
501 | 校验数据类型异常 | |
502 | (采购单绑定的采销员不存在,采销员简码为:test;该商品不属于该供应商,商品编号为:123456;该用户没有回告权限等) | 根据返回的异常信息调整数据,如果还未来解决,请联系对应的采购员解 |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.po.list.page.get
l 功能说明
根据条件分页查询采购单列表(至多支持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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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 | 当前页码(从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 | 否 | 采购单状态名称 |
l 返回示例
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": "" } } } |
l 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
500 | 服务器端异常 | |
501 | 校验数据类型异常 | |
502 | (采购单绑定的采销员不存在,采销员简码为:test;该商品不属于该供应商,商品编号为:123456;该用户没有回告权限等) | 根据返回的异常信息调整数据,如果还未来解决,请联系对应的采购员解 |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.vc.create.return.order
l 功能说明
创建退货单
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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
fromDeliverCenterId | Number | 是 | 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,烟台) |
toDeliverCenterId | Number | 是 | 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,烟台)(备注:与fromDeliverCenterId值相同,因为京东暂不支持异地退货) |
purchaseErpCode | String | 是 | bjjdz | 采销简码(京东人员的ERP帐号) |
balanceType | Number | 否 | 2 | 结算类型(运输方式只有两种:1,普通快递,2,自提,不填则默认2) |
transportType | Number | 否 | 1 | 运输方式(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[][] | 退货单号列表 |
l 返回示例
JSON数据格式
{ "jingdong_vc_create_return_order_response": { "returnOrderIds": [ { "returnOrderId": [ { } ] } ] } } |
l 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
500 | 服务器端异常 | |
501 | 校验数据类型异常 | |
502 | (采购单绑定的采销员不存在,采销员简码为:test;该商品不属于该供应商,商品编号为:123456;该用户没有回告权限等) | 根据返回的异常信息调整数据,如果还未来解决,请联系对应的采购员解 |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.vc.get.return.order.detail
l 功能说明
根据退货单号取得退货单明细
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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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 | 否 | 退货单创建时定价,限图书音像类型商品,否则为空 |
l 返回示例
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": "" } } } |
l 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
500 | 服务器端异常 | |
501 | 校验数据类型异常 | |
502 | (采购单绑定的采销员不存在,采销员简码为:test;该商品不属于该供应商,商品编号为:123456;该用户没有回告权限等) | 根据返回的异常信息调整数据,如果还未来解决,请联系对应的采购员解 |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |
l 接口名称
jingdong.vc.return.order.list.page.get
l 功能说明
分页查询退货单列表
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 |
l 应用级输入参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
returnId | Number | 否 | 123456 | 退货单号 |
fromDeliverCenterId | Number | 否 | 6 | 退货地配送中心 |
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 | 是 | 1 | 分页大小 |
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 | 否 | 退货单结算时间(财务接口返回,如果无相关数据,则为空) |
l 返回示例
JSON数据格式
124 |
l 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
500 | 服务器端异常 | |
501 | 校验数据类型异常 | |
502 | (采购单绑定的采销员不存在,采销员简码为:test;该商品不属于该供应商,商品编号为:123456;该用户没有回告权限等) | 根据返回的异常信息调整数据,如果还未来解决,请联系对应的采购员解 |
l SDK调用示例(java)
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); |