技术文档

【物流服务】接口导航

1. 获取承运商信息列表	2. 获取仓库信息列表
3. 商品资料添加	4. 商品资料修改
5. 商家查询库存	6. 查询商品信息接口
7. 获取采购单信息	8. 新增采购订单
9. 订单取消	10. 获取订单信息
11. 获取多订单信息	12. 退货入库单查询
13. 退货入库单申请	14. 退货入库单取消
15. 新增客户订单	16. 其它入库单申请
17. 其它入库单查询	18. 其他出库订单下传
19. 其它出库单查询

以上为京东仓储系统对应接口，如商家需调取获取物流公司请参考配送服务

京东快递配送对接请参考

相关文档下载：ERP对接方案【11月4日更新】

20. 获取京东物流运单号接口	21. 京东物流接单接口
22. 京东物流全程跟踪查询接口

京东快递常见问题FAQ

1. 获取承运商信息列表

接口名称

jingdong.logistics.carriers.list

功能说明

获取承运商信息列表

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

应用级输入参数

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

返回结果

名称	类型	示例值	描述
carriers_details	CarriersDetail[]

CarriersDetail属性

名称	类型	是否必须	示例值	描述
carriers_id	String	否		承运商编号ID
carriers_name	String	否		承运商名称
carriers_phone	String	否		承运商电话

返回示例

JSON数据格式

{
  "jingdong_logistics_carriers_list_response":{
  "carriers":{
  "carriers_details":{
  "carriers_phone":"",
"carriers_id":"",
"carriers_name":""
  }
  }
  }
  }

SDK调用示例（java）

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsCarriersListRequest request=new LogisticsCarriersListRequest();
LogisticsCarriersListResponse response=client.execute(request);

2. 获取仓库信息列表

接口名称

jingdong.logistics.warehouse.list

功能说明

获取仓库信息列表

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

应用级输入参数

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

返回结果

名称	类型	示例值	描述
warehouse_details	WarehouseDetail[]

WarehouseDetail属性

名称	类型	是否必须	示例值	描述
warehouse_no	String	否		仓库编号
warehouse_name	String	否		仓库名称
warehouse_address	String	否		仓库地址
warehouse_phone	String	否		仓库电话

返回示例

JSON数据格式

{
  "jingdong_logistics_warehouse_list_response":{
  "warehouse":{
  "warehouse_details":[{
  "warehouse_name":"",
"warehouse_no":"",
"warehouse_address":"",
"warehouse_phone":""
  }]
  }
  }
  }

SDK调用示例（java）

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsWarehouseListRequest request=new LogisticsWarehouseListRequest();
LogisticsWarehouseListResponse response=client.execute(request);

3. 商品资料添加

接口名称

jingdong.logistics.sku.add

功能说明

商品资料添加

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

应用级输入参数

名称	类型	是否必须	示例值	描述
bar_code	String	是		条码(外部系统商品唯一标识)
sku_id	String	是		商品编号(外部数据)
name	String	是		商品名称
goods_abbreviation	String	否		商品简称
category_id	String	是		商品分类编号(外部数据)
category_name	String	是		商品分类名称
brand_no	String	否		品牌编号
brand_name	String	否		品牌名称
format	String	否		商品规格
color	String	否		商品颜色
size	String	否		商品尺码
gross_weight	Number	否		商品毛重量
net_weight	Number	否		商品净重量
size_definition	String	是		商品件型(分为9种件型用于计费使用请慎重考虑.)
suppliers_name	String	否		供应商名称
manufacturer	String	否		生产厂商
suppliers_no	String	否		供应商编码
product_area	String	否		产地
length	Number	是		长
width	Number	是		宽
height	Number	是		高
volume	Number	是		体积
is_safe	Number	否		是否保质期管理(1为保质期管理,0为非保质期管理,不强制加入.)
safe_date	String	否		保质期天数(非保质期可不填写,保质期商品请填写保质期为多少天如30天请填写30.)

返回结果

名称	类型	示例值	描述
process_code	Number		处理结果code 1:为成功,其他均为错误
process_status	String		处理状态含义
error_message	String		处理错误信息
result_no	String		商品资料添加的JOSL商品唯一标识.

返回示例

JSON数据格式

{
  "jingdong_logistics_sku_add_response":{
  "processResult":{
  "error_message":"",
"process_code":"",
"process_status":"",
"result_no":""
  }
  }
  }

SDK调用示例（java）

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsSkuAddRequest request=new LogisticsSkuAddRequest();
request.setBarCode( "jingdong" );
request.setSkuId( "jingdong" );
request.setName( "jingdong" );
request.setGoodsAbbreviation( "jingdong" );
request.setCategoryId( "jingdong" );
request.setCategoryName( "jingdong" );
request.setBrandNo( "jingdong" );
request.setBrandName( "jingdong" );
request.setFormat( "jingdong" );
request.setColor( "jingdong" );
request.setSize( "jingdong" );
request.setGrossWeight( 123 );
request.setNetWeight( 123 );
request.setSizeDefinition( "jingdong" );
request.setSuppliersName( "jingdong" );
request.setManufacturer( "jingdong" );
request.setSuppliersNo( "jingdong" );
request.setProductArea( "jingdong" );
request.setLength( 123 );
request.setWidth( 123 );
request.setHeight( 123 );
request.setVolume( 123 );
request.setIsSafe( 123 );
request.setSafeDate( "jingdong" );
LogisticsSkuAddResponse response=client.execute(request);

4. 商品资料修改

接口名称

jingdong.logistics.sku.update

功能说明

商品资料修改（此方法中,不修改的字段请保证添入null或者'null'等,请勿填写为'',可能会引起修改错误）

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

应用级输入参数

名称	类型	是否必须	示例值	描述
goods_no	String	是		JOSL商品唯一标识
bar_code	String	否		条码(外部系统商品唯一标识)
sku_id	String	否		商品编号(外部数据)
name	String	否		商品名称
goods_abbreviation	String	否		商品简称
category_id	String	否		商品分类编号(外部数据)
category_name	String	否		商品分类名称
brand_no	String	否		品牌编号
brand_name	String	否		品牌名称
format	String	否		商品规格
color	String	否		商品颜色
size	String	否		商品尺码
gross_weight	String	否		商品毛重量
net_weight	String	否		商品净重量
size_definition	String	否		商品件型(分为9种件型用于计费使用请慎重考虑.)
suppliers_name	String	否		供应商名称
manufacturer	String	否		生产厂商
suppliers_no	String	否		供应商编码
product_area	String	否		产地
length	Number	否		长
width	Number	否		宽
height	Number	否		高
volume	Number	否		体积
is_safe	Number	否		是否保质期管理(1为保质期管理,0为非保质期管理,不强制加入.)
safe_date	String	否		保质期天数(非保质期可不填写,保质期商品请填写保质期为多少天如30天请填写30.)

返回结果

名称	类型	示例值	描述
process_code	Number		处理结果code 1:为成功,其他均为错误
process_status	String		处理状态含义
error_message	String		处理错误信息

返回示例

JSON数据格式

{
  "jingdong_logistics_sku_update_response":{
  "process_result":{
  "error_message":"",
"process_code":"",
"process_status":""
  }
  }
  }

SDK调用示例（java）

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsSkuUpdateRequest request=new LogisticsSkuUpdateRequest();
request.setGoodsNo( "jingdong" );
request.setBarCode( "jingdong" );
request.setSkuId( "jingdong" );
request.setName( "jingdong" );
request.setGoodsAbbreviation( "jingdong" );
request.setCategoryId( "jingdong" );
request.setCategoryName( "jingdong" );
request.setBrandNo( "jingdong" );
request.setBrandName( "jingdong" );
request.setFormat( "jingdong" );
request.setColor( "jingdong" );
request.setSize( "jingdong" );
request.setGrossWeight( "jingdong" );
request.setNetWeight( "jingdong" );
request.setSizeDefinition( "jingdong" );
request.setSuppliersName( "jingdong" );
request.setManufacturer( "jingdong" );
request.setSuppliersNo( "jingdong" );
request.setProductArea( "jingdong" );
request.setLength( 123 );
request.setWidth( 123 );
request.setHeight( 123 );
request.setVolume( 123 );
request.setIsSafe( 123 );
request.setSafeDate( "jingdong" );
LogisticsSkuUpdateResponse response=client.execute(request);

5. 商家查询库存

接口名称

jingdong.logistics.stock.search

功能说明

商家查询库存

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

应用级输入参数

名称	类型	是否必须	示例值	描述
warehouse_no	String	否		库房编号
goods_no	String	否		商品编号
current_page	Number	是		当前页码

返回结果

名称	类型	示例值	描述
stock	ResponseStock		这个是注释生成doc用的

ResponseStock属性

名称	类型	是否必须	示例值	描述
process_code	String	否	1	处理结果code 1:为成功,其他均为错误
process_status	String	否	1	处理状态含义
error_message	String	否	1	处理错误信息
total_page	Number	否	32	总页数
stock_details	StockDetail[]	否	32	查询结果详细信息

返回示例

JSON数据格式

{
  "jingdong_logistics_stock_search_response":{
  "stock":{
  "total_page":"32",
"error_message":"1",
"process_code":"1",
"process_status":"1",
"stock_details":[{
  "goods_status":"",
"warehouse_no":"",
"goods_no":"",
"available_qty":"",
"preemption_qty":"",
"stock_qty":""
  }]
  }
  }
  }

SDK调用示例（java）

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsStockSearchRequest request=new LogisticsStockSearchRequest();
request.setWarehouseNo( "jingdong" );
request.setGoodsNo( "jingdong" );
request.setCurrentPage( 123 );
LogisticsStockSearchResponse response=client.execute(request);

6. 查询商品信息接口

接口名称

jingdong.logistics.sku.query

功能说明

查询商品信息接口

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

应用级输入参数

名称	类型	是否必须	示例值	描述
josl_good_no	String	否		josl商品编号
isv_good_no	String	否		isv商品编号

返回结果

名称	类型	示例值	描述
process_code	Number		处理结果code 1:为成功,其他均为错误
process_status	String		处理状态含义
error_message	String		处理错误信息
result_no	String		商品json描述

result_no json结构

名称	类型	是否必填	示例值	描述
joslGoodNo	String	Y	JG00000055	JOSL商品编码
isvGoodNo	String	Y	abc005	ISV商品编码
goodName	String	Y	iphonne	商品名称
goodShortName	String	N	苹果手机	商品简称
goodCategoryId	String	N	213	商品类别ID
goodCategoryName	String	N	手机	商品类别名称
brandNo	String	N	123	品牌编码
brandName	String	N	apple	品牌名称
goodStandard	String	N	123.33	规格型号
color	String	N	red	颜色
goodSize	Number	N	4556	尺寸
grossWeight	Number	N	44.4	毛重
netWeight	Number	N	23.3	净重
sizeDefinition	String	N	大件	件型描述
supplierNo	String	N	234567	供应商编码
supplierName	String	N	京东	供应商名称
producer	String	N	76	制造商
produceAddress	String	N	ABC12345	制造商地址
goodLength	Number	N	7	长
goodWidth	Number	N	5	宽
goodHeight	Number	N	3	高
volume	Number	N	105	体积
isSafe	Number	N	1	是否保质期管理
safeDate	Number	N	365	保质期
barCode	String	N	111111	条码

返回示例

JSON数据格式

{
  "jingdong_logistics_sku_query_response":{
  "process_result":{
  "error_message":"",
"process_code":"",
"process_status":"",
"result_no":""
  }
  }
  }

SDK调用示例（java）

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsSkuQueryRequest request=new LogisticsSkuQueryRequest();
request.setJoslGoodNo( "jingdong" );
request.setIsvGoodNo( "jingdong" );
LogisticsSkuQueryResponse response=client.execute(request);

7. 获取采购单信息

接口名称

jingdong.logistics.po.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

应用级输入参数

名称	类型	是否必须	示例值	描述
inbound_no	String	是		JOSL唯一入库单号

返回结果

名称	类型	示例值	描述
inboundNo	String		JOSL唯一采购入库单号
poNo	String		外部系统传入入库单号
receivingStatus	String		采购入库单状态
task_details	ReceivingTask[]

ReceivingTask属性

名称	类型	是否必须	示例值	描述
goods_no	String	否		JOSL唯一编号
goods_status	String	否		商品状态
qty	Number	否		实际验收数量
expected_qty	Number	否		预期数量
difference_remark	String	否		差异备注

返回示例

JSON数据格式

{
  "jingdong_logistics_po_get_response":{
  "po_status":{
  "receivingStatus":"",
"poNo":"",
"task_details":{
  "expected_qty":"",
"goods_status":"",
"goods_no":"",
"difference_remark":"",
"qty":""
  },
"inboundNo":""
  }
  }
  }

SDK调用示例（java）

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsPoGetRequest request=new LogisticsPoGetRequest();
request.setInboundNo( "jingdong" );
request.setPoNo( "jingdong" );
LogisticsPoGetResponse response=client.execute(request);

8. 新增采购订单

接口名称

jingdong.logistics.po.add

功能说明

采购订单

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

应用级输入参数

名称	类型	是否必须	示例值	描述
channels_seller_no	String	是		商家编号
po_no	String	是		入库单号
warehouse_no	String	是		生产库房编号
expect_date	String	是		预计送达日期(yyyy-mm-dd)
supplier_name	String	否		供应商名称
supplier_no	String	否		供应商编码
approver	String	否		审批人
goods_no	String[]	是		JOSL商品编号
expected_qty	Number[]	是		预期入库数量
goods_status	String[]	是		商品状态（1：良品；2：残品；3：样品；4：新品）

返回结果

名称	类型	示例值	描述
process_code	Number		处理结果code 1:为成功,其他均为错误
process_status	String		处理状态含义
error_message	String		处理错误信息
result_no	String		JOSL唯一入库单号.

返回示例

JSON数据格式

{
  "jingdong_logistics_po_add_response":{
  "process_result":{
  "error_message":"",
"process_code":"",
"process_status":"",
"result_no":""
  }
  }
  }

SDK调用示例（java）

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsPoAddRequest request=new LogisticsPoAddRequest();
request.setChannelsSellerNo( "jingdong" );
request.setPoNo( "jingdong" );
request.setWarehouseNo( "jingdong" );
request.setExpectDate( "jingdong" );
request.setSupplierName( "jingdong" );
request.setSupplierNo( "jingdong" );
request.setApprover( "jingdong" );
request.setGoodsNo( "jingdong,yanfa,pop" );
request.setExpectedQty( "123,234,345" );
request.setGoodsStatus( "jingdong,yanfa,pop" );
LogisticsPoAddResponse response=client.execute(request);

9. 订单取消

接口名称

jingdong.logistics.order.delete

功能说明

订单取消

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

应用级输入参数

名称	类型	是否必须	示例值	描述
receipt_no	String	是		JOSL单号

返回结果

名称	类型	示例值	描述
process_code	Number		处理结果code 1:为成功,其他均为错误
process_status	String		处理状态含义
error_message	String		处理错误信息

返回示例

JSON数据格式

{
  "jingdong_logistics_order_delete_response":{
  "processResult":{
  "error_message":"",
"process_code":"",
"process_status":""
  }
  }
  }

SDK调用示例（java）

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsOrderDeleteRequest request=new LogisticsOrderDeleteRequest();
request.setReceiptNo( "jingdong" );
LogisticsOrderDeleteResponse response=client.execute(request);

10. 获取订单信息

接口名称

jingdong.logistics.order.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

应用级输入参数

名称	类型	是否必须	示例值	描述
receipt_no	String	是		JOSL唯一单号

返回结果

名称	类型	示例值	描述
receipt_no	String		JOSL唯一采购出库单号
order_status_details	OrderStatusDetail[]
order_package_details	OrderPackageDetail[]

OrderStatusDetail属性

名称	类型	是否必须	示例值	描述
status	Number	否		状态
status_name	String	否		状态名称
complete_time	String	否		完成时间

OrderPackageDetail属性

名称	类型	是否必须	示例值	描述
weight	String	否		包裹重量
delivery_no	String	否		快递单号
carriers_id	String	否		承运商编号ID
carriers_name	String	否		承运商名称

返回示例

JSON数据格式

{
  "jingdong_logistics_order_get_response":{
  "order":{
  "order_package_details":{
  "delivery_no":"",
"weight":"",
"carriers_id":"",
"carriers_name":""
  },
"receipt_no":"",
"order_status_details":{
  "status_name":"",
"status":"",
"complete_time":""
  }
  }
  }
  }

SDK调用示例（java）

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsOrderGetRequest request=new LogisticsOrderGetRequest();
request.setReceiptNo( "jingdong" );
LogisticsOrderGetResponse response=client.execute(request);

11. 获取多订单信息

接口名称

jingdong.logistics.order.search

功能说明

获取多订单信息

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

应用级输入参数

名称	类型	是否必须	示例值	描述
receipt_nos	String	是		JOSL唯一单号(多订单请用英文','分割,最大支持200单)
status	String	否		状态值集(,)

返回结果

名称	类型	示例值	描述
orders	java.util.HashMap

java.util.HashMap 属性

名称	类型	是否必须	示例值	描述
order_list	ResponseOrderStatus[]	否

ResponseOrderStatus属性

名称	类型	是否必须	示例值	描述
receipt_no	String	否		JOSL唯一采购出库单号
order_status_details	OrderStatusDetail[]	否
order_package_details	OrderPackageDetail[]	否

OrderStatusDetail属性

名称	类型	是否必须	示例值	描述
status	Number	否		状态
status_name	String	否		状态名称
complete_time	String	否		完成时间

OrderPackageDetail属性

名称	类型	是否必须	示例值	描述
weight	String	否		包裹重量
delivery_no	String	否		快递单号
carriers_id	String	否		承运商编号ID
carriers_name	String	否		承运商名称

返回示例

JSON数据格式

{
  "jingdong_logistics_order_search_response":{
  "orders":{
  "order_list":{
  "order_package_details":{
  "delivery_no":"",
"weight":"",
"carriers_id":"",
"carriers_name":""
  },
"receipt_no":"",
"order_status_details":{
  "status_name":"",
"status":"",
"complete_time":""
  }
  }
  }
  }
  }

SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsOrderSearchRequest request=new LogisticsOrderSearchRequest();
request.setReceiptNos( "jingdong" );
request.setStatus( "jingdong" );
request.setPin( "jingdong" );
LogisticsOrderSearchResponse response=client.execute(request);

12. 退货入库单查询

接口名称

jingdong.logistics.returnorder.query

功能说明

退货入库单查询

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

应用级输入参数

名称	类型	是否必须	示例值	描述
receipt_no	String	是	JRI000001	要查询的josl退货入库单号

返回结果

名称	类型	示例值	描述
response_return_order	ResponseReturnOrder

ResponseReturnOrder属性

名称	类型	是否必须	示例值	描述
process_code	Number	否	1	查询成功代码 1:成功其他：失败
process_status	String	否	SUCCESS	查询是否成功名称
error_message	String	否	无权限查看	错误信息
josl_inbound_no	String	否	JRI000001	josl退货入库单号
return_order_no	String	否	EDBao1001	isv退货单号
josl_outbound_no	String	否	JOSL0001023	josl出库单号
status	Number	否	-1:初始化，0：完成	入库状态代码
complete_time	String	否	2013-05-11 12:23:11	状态更新时间

返回示例

JSON数据格式

{
  "jingdong_logistics_returnorder_query_response":{
  "response_return_order":{
  "return_order_no":"EDBao1001",
"josl_inbound_no":"JRI000001",
"status":"-1:初始化，0：完成",
"error_message":"无权限查看",
"process_code":"1",
"process_status":"SUCCESS",
"complete_time":"2013-05-11 12:23:11",
"josl_outbound_no":"JOSL0001023"
  }
  }
  }

SDK调用示例（java）

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsReturnorderQueryRequest request=newLogisticsReturnorderQueryRequest();
request.setReceiptNo( "jingdong" );
LogisticsReturnorderQueryResponse response=client.execute(request);

13. 退货入库单申请

接口名称

jingdong.logistics.returnorder.add

功能说明

退货入库单申请

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

应用级输入参数

名称	类型	是否必须	示例值	描述
seller_no	String	否	EDB0001	ISV商家编号
warehouse_no	String	是	BJ000000001	JOSL库房编号
inbound_no	String	是	EDBI001111	ISV入库单号
josl_outbound_no	String	是	JOSL1000012	JOSL出库单号
expected_date	Date	是	2013-06-18 11:00:59	JOSL预计送达日期
isv_source	String	否	http://www.centaur.cn/	ISV来源
approver	String	是	张三	审批人
goods_no	String[]	是	JGNO1000000052	JOSL商品编码
expected_qty	Number[]	是	10	入库数量
stock_mark	String[]	是	1良品，2残品，3样品，4新品	库存等级标识代码

返回结果

名称	类型	示例值	描述
process_result	ProcessResult []	申请结果

ProcessResult 属性

名称	类型	是否必须	示例值	描述
process_code	Number	否	1	申请结果代码
process_status	String	否	SUCCESS	申请状态
error_message	String	否	该退货单不能重复申请	错误信息
result_no	String	否	JRI000001	成功申请的退货单号

返回示例

JSON数据格式

{
  "jingdong_logistics_returnorder_add_response":{
  "process_result":{
  "error_message":"该退货单不能重复申请",
"process_code":"1",
"process_status":"SUCCESS",
"result_no":"JRI000001"
  }
  }
  }

SDK调用示例（java）

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsReturnorderAddRequest request=new LogisticsReturnorderAddRequest();
request.setSellerNo( "jingdong" );
request.setWarehouseNo( "jingdong" );
request.setInboundNo( "jingdong" );
request.setJoslOutboundNo( "jingdong" );
request.setExpectedDate( "2012-12-12 12:12:12" );
request.setIsvSource( "jingdong" );
request.setApprover( "jingdong" );
request.setGoodsNo( "jingdong,yanfa,pop" );
request.setExpectedQty( "123,234,345" );
request.setStockMark( "jingdong,yanfa,pop" );
LogisticsReturnorderAddResponse response=client.execute(request);

14. 退货入库单取消

接口名称

jingdong.logistics.returnorder.cancel

功能说明

退货入库单取消

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

应用级输入参数

名称	类型	是否必须	示例值	描述
receipt_no	String	是	JRI000001	要取消的退货入库单号
isv_source	String	否	http://www.centaur.cn/	ISV来源

返回结果

名称	类型	示例值	描述
process_result	ProcessResult []		取消结果信息

ProcessResult属性

名称	类型	是否必须	示例值	描述
process_code	Number	否	1	取消结果代码 1:成功其他：失败
process_status	String	否	SUCCESS	取消结果名称
error_message	String	否	无权限取消	错误信息
result_no	String	否

返回示例

JSON数据格式

{
  "jingdong_logistics_returnorder_cancel_response":{
  "process_result":{
  "error_message":"无权限取消",
"process_code":"1",
"process_status":"SUCCESS",
"result_no":""
  }
  }
  }

SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsReturnorderCancelRequest request=newLogisticsReturnorderCancelRequest();
request.setReceiptNo( "jingdong" );
request.setIsvSource( "jingdong" );
LogisticsReturnorderCancelResponse response=client.execute(request);

15. 新增客户订单

接口名称

jingdong.logistics.order.add

功能说明

客户订单

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

应用级输入参数

名称	类型	是否必须	示例值	描述
channels_seller_no	String	是		商家编号
channels_outbound_no	String	是		出库单号
warehouse_no	String	是		生产库房编号
carriers_id	String	是		承运商编号ID
expect_date	String	是		期望发货日期(yyyy-mm-dd hh:mm:ss)
order_no	String	否		平台销售单号
shop_no	String	否		平台店铺编号
consignee_name	String	是		收货人姓名
address_province	String	是		收货人省
address_city	String	是		收货人市
address_county	String	是		收货人县
address_town	String	是		收货人镇
address	String	是		收货人地址，需要全地址信息，如：XX省XX市XX县（镇）XX街XX路XX小区
zip_code	String	否		收货人邮编
phone	String	是		收货人电话
mobile	String	是		收货人手机
receivable	Number	是		应收金额
email	String	否		email
buyer_remark	String	否		买家留言
verify_remark	String	否		审核备注
return_consignee_address	String	否		退货收货人地址
return_consignee_name	String	否		退货收货人姓名
return_consignee_phone	String	否		退货收货人电话
station_no	String	否		站点编号
station_name	String	否		站点名称
order_mark	String	是		订单标记位:50位的数字串，第1位为1代表货到付款
shop_order_source	String	是		销售平台来源类型： 0010001 京东， 0010002 天猫， 0010003 苏宁， 0010004 亚马逊中国， 0020001 ChinaSkin， 0030001 其他小型销售平台如果选择京东平台，则order_no字段必须填写京东平台的订单号
shop_order_create_time	Date	否		销售平台的下单时间:yyyy-mm-dd hh:mm:ss
picker	String	否		取件人
picker_call	String	否		取件人电话
piker_id	String	否		取件人身份证
pack_type	String	否		包装类型
goods_no	String[]	是		JOSL商品编号
sku_id	String[]	否		ISV商品编号
shopGoodsNo	String[]	否		淘宝的商品编号
qty	Number[]	是		申请出库数量
goods_status	String[]	是		商品状态（1：良品；2：残品；3：样品；4：新品）

返回结果

名称	类型	示例值	描述
process_code	Number		处理结果code 1:为成功,其他均为错误
process_status	String		处理状态含义
error_message	String		处理错误信息
result_no	String		JOSL唯一出库单号.

返回示例

JSON数据格式

{
  "jingdong_logistics_order_add_response":{
  "process_result":{
  "error_message":"",
"process_code":"",
"process_status":"",
"result_no":""
  }
  }
  }

SDK调用示例（java）

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsOrderAddRequest request=new LogisticsOrderAddRequest();
request.setChannelsSellerNo( "jingdong" );
request.setChannelsOutboundNo( "jingdong" );
request.setWarehouseNo( "jingdong" );
request.setCarriersId( "jingdong" );
request.setExpectDate( "jingdong" );
request.setOrderNo( "jingdong" );
request.setShopNo( "jingdong" );
request.setConsigneeName( "jingdong" );
request.setAddressProvince( "jingdong" );
request.setAddressCity( "jingdong" );
request.setAddressCounty( "jingdong" );
request.setAddressTown( "jingdong" );
request.setAddress( "jingdong" );
request.setZipCode( "jingdong" );
request.setPhone( "jingdong" );
request.setMobile( "jingdong" );
request.setReceivable( 123 );
request.setEmail( "jingdong" );
request.setBuyerRemark( "jingdong" );
request.setVerifyRemark( "jingdong" );
request.setReturnConsigneeAddress( "jingdong" );
request.setReturnConsigneeName( "jingdong" );
request.setReturnConsigneePhone( "jingdong" );
request.setStationNo( "jingdong" );
request.setStationName( "jingdong" );
request.setOrderMark( "jingdong" );
request.setShopOrderSource( "jingdong" );
request.setShopOrderCreateTime( "2012-12-12 12:12:12" );
request.setOutboundFlag( "jingdong" );
request.setCustomFlag( "jingdong" );
request.setTransportWay( "jingdong" );
request.setPicker( "jingdong" );
request.setPickerCall( "jingdong" );
request.setPikerId( "jingdong" );
request.setPackType( "jingdong" );
request.setGoodsNo( "jingdong,yanfa,pop" );
request.setSkuId( "jingdong,yanfa,pop" );
request.setShopGoodsNo( "jingdong,yanfa,pop" );
request.setQty( "123,234,345" );
request.setGoodsStatus( "jingdong,yanfa,pop" );
LogisticsOrderAddResponse response=client.execute(request);

16. 其它入库单申请

接口名称

jingdong.logistics.otherInstore.add

功能说明

其它入库单申请

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

应用级输入参数

名称	类型	是否必须	示例值	描述
instore_type	String	是		入库单类型
po_no	String	是		入库单号
expected_date	String	否		预计送达日期
approver	String	否		审批人
warehouse_no	String	是		仓库编号
goods_no	String[]	是		JOSL商品编号
isv_goods_no	String[]	是		ISV的商品编号
expected_qty	Number[]	是		申请入库数量
goods_status	String[]	是		商品状态

返回结果

名称	类型	示例值	描述
process_code	Number		处理结果Code
process_status	String		处理状态含义
error_message	String		错误信息
result_no	String		返回操作单号

返回示例

JSON数据格式

{
  "jingdong_logistics_otherInstore_add_response":{
  "process_result":{
  "error_message":"",
"process_code":"",
"process_status":"",
"result_no":""
  }
  }
  }

SDK调用示例（java）

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsOtherInstoreAddRequest request=new LogisticsOtherInstoreAddRequest();
request.setInstoreType( "jingdong" );
request.setPoNo( "jingdong" );
request.setExpectedDate( "jingdong" );
request.setApprover( "jingdong" );
request.setWarehouseNo( "jingdong" );
request.setGoodsNo( "jingdong,yanfa,pop" );
request.setIsvGoodsNo( "jingdong,yanfa,pop" );
request.setExpectedQty( "123,234,345" );
request.setGoodsStatus( "jingdong,yanfa,pop" );
LogisticsOtherInstoreAddResponse response=client.execute(request);

17. 其它入库单查询

接口名称

jingdong.logistics.otherInstore.query

功能说明

其它入库单查询

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

应用级输入参数

名称	类型	是否必须	示例值	描述
in_bound_no	String	是	JBI0000000033	其它入库入库单号

返回结果

名称	类型	示例值	描述
process_code	Number		查询成功代码 1:成功其他：失败
process_status	String		查询是否成功名称
error_message	String		错误信息
inbound_no	String		josl入库单号
po_no	String		入库单号
inbound_status	String		入库状态
status_update_time	Date		更新时间
task_details	OtherInstoreOrderDetail[]		明细

OtherInstoreOrderDetail属性

名称	类型	是否必须	示例值	描述
goods_no	String	否		jos商品编码
difference_remark	String	否		差异描述
goods_status	String	否		商品状态

返回示例

JSON数据格式

{
  "jingdong_logistics_otherInstore_query_response":{
  "response_other_instore_status":{
  "inbound_no":"",
"task_details":[{
  "goods_status":"",
"goods_no":"",
"difference_remark":"",
"qty":""
  }],
"inbound_status":"",
"po_no":"",
"error_message":"",
"process_code":"",
"process_status":"",
"status_update_time":""
  }
  }
  }

SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsOtherInstoreQueryRequest request=newLogisticsOtherInstoreQueryRequest();
request.setInBoundNo( "jingdong" );
LogisticsOtherInstoreQueryResponse response=client.execute(request);

18. 其他出库订单下传

接口名称

jingdong.logistics.otherOutstore.add

功能说明

其他出库订单下传

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

应用级输入参数

;

名称	类型	是否必须	示例值	描述
outbound_no	String	是	123456	出库单号
josl_ware_no	String	是	BJ000000001	JOSL库房编号
josl_carriers_no	String	是	CYS0000002	JOSL承运商编号
expect_date	Date	否	yyyy-MM-dd HH:mm:ss	期望出库日期
supplier_name	String	否	xxxxxxx	供应商名称
supplier_no	String	否	1001	供应商编号
approver	String	否	张三	审批人
outbound_type	String	是	除销售出库以外的所有出库类型	出库类型
remark	String	否	xxxxxxxxxxxx	备注
consignee_name	String	是	李四	收货人姓名
address	String	是	xxxxxxxxxxxxxxxx	收货地址
station_no	String	否	xxxxxxxxxxxxxxxx	站点编号
station_name	String	否	xxxxxxxxxxxxxxxx	站点名称
receivable	Number	否	100.0	应收金额
zip_code	String	否	100001	邮编
phone	String	是	158xxxxxxxx	电话
mobile	String	是	136xxxxxxxx	手机号
email	String	否	xxx@jd.com	电子邮件
buyer_remark	String	否	xxxxxx	买家留言
verify_remark	String	否	xxxxxxx	审核备注
return_consignee_name	String	否	张三	退货收货人姓名
return_consignee_address	String	否	xxxxx	退货收货地址
return_consignee_mobile	String	否	136xxxxxxxx	退货收货人电话
address_province	String	是	北京	省
address_city	String	是	北京	市
address_county	String	是	昌平	县
address_town	String	是	昌平	镇
picker	String	否	李四	取件人
picker_cell	String	否	150xxxxxxxx	取件人电话
piker_id	String	否	130225xxxxxxxxxxxxxxxx	取件人身份证
transport_way	String	否	顺风快递	运输方式
order_mark	String	是	010101010101010	订单标记位
josl_good_no	String[]	是	JGNO0658257920	JOSL商品编号
isv_good_no	String[]	否	1253036049	ISV商品编号
out_qty	Number[]	是	100	申请出库数量
good_status	String[]	是	0	商品状态（1：良品；2：残品；3：样品；4：新品）

返回结果

名称	类型	示例值	描述
process_code	Number		处理结果Code
process_status	String		处理状态含义
error_message	String		错误信息
result_no	String		返回操作单号

返回示例

JSON数据格式

{
  "jingdong_logistics_otherOutstore_add_response":{
  "process_result":{
  "error_message":"",
"process_code":"",
"process_status":"",
"result_no":""
  }
  }
  }

SDK调用示例（java）

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsOtherOutstoreAddRequest request=newLogisticsOtherOutstoreAddRequest();
request.setOutboundNo( "jingdong" );
request.setJoslWareNo( "jingdong" );
request.setJoslCarriersNo( "jingdong" );
request.setExpectDate( "2012-12-12 12:12:12" );
request.setSupplierName( "jingdong" );
request.setSupplierNo( "jingdong" );
request.setApprover( "jingdong" );
request.setOutboundType( "jingdong" );
request.setRemark( "jingdong" );
request.setConsigneeName( "jingdong" );
request.setAddress( "jingdong" );
request.setStationNo( "jingdong" );
request.setStationName( "jingdong" );
request.setReceivable( 123 );
request.setZipCode( "jingdong" );
request.setPhone( "jingdong" );
request.setMobile( "jingdong" );
request.setEmail( "jingdong" );
request.setBuyerRemark( "jingdong" );
request.setVerifyRemark( "jingdong" );
request.setReturnConsigneeName( "jingdong" );
request.setReturnConsigneeAddress( "jingdong" );
request.setReturnConsigneeMobile( "jingdong" );
request.setAddressProvince( "jingdong" );
request.setAddressCity( "jingdong" );
request.setAddressCounty( "jingdong" );
request.setAddressTown( "jingdong" );
request.setPicker( "jingdong" );
request.setPickerCell( "jingdong" );
request.setPikerId( "jingdong" );
request.setTransportWay( "jingdong" );
request.setOrderMark( "jingdong" );
request.setJoslGoodNo( "jingdong,yanfa,pop" );
request.setIsvGoodNo( "jingdong,yanfa,pop" );
request.setOutQty( "123,234,345" );
request.setGoodStatus( "jingdong,yanfa,pop" );
LogisticsOtherOutstoreAddResponse response=client.execute(request);

19. 其它出库单查询

接口名称

jingdong.logistics.otherOutstore.query

功能说明

其它出库单查询

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

应用级输入参数

名称	类型	是否必须	示例值	描述
josl_outbound_no	String	是		josl出库单号

返回结果

名称	类型	示例值	描述
process_code	Number		查询成功代码 1:成功其他：失败
process_status	String		查询是否成功名称
error_message	String		错误信息
josl_outbound_no	String		josl出库单号
isv_outbound_no	String		ISV出库单号
josl_status	String		JOSL出库状态
complete_time	Date		状态更新时间
order_details	ResponseOrderOtherDetail[]		其它出库单明细
carriers_id	String		JOSL承运商编号
carriers_name	String		JOSL承运商名称
delivery_no_list	List		运单号列表

ResponseOrderOtherDetail属性

名称	类型	是否必须	示例值	描述
josl_good_no	String	否		jos商品编码
isv_good_no	String	否		isv商品编号
qty	Number	否		实际出库数量
goods_status	String	否		商品状态
difference_remark	String	否		差异备注

返回示例

JSON数据格式

{
  "jingdong_logistics_otherOutstore_query_response":{
  "response_order_other_status":{
  "delivery_no_list":[{

  }],
"carriers_id":"",
"error_message":"",
"process_code":"",
"process_status":"",
"order_details":[{
  "goods_status":"",
"difference_remark":"",
"qty":"",
"josl_good_no":"",
"isv_good_no":""
  }],
"complete_time":"",
"carriers_name":"",
"josl_status":"",
"isv_outbound_no":"",
"josl_outbound_no":""
  }
  }
  }

SDK调用示例（java）

public JdClient client=newDefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
LogisticsOtherOutstoreQueryRequest request=newLogisticsOtherOutstoreQueryRequest();
request.setJoslOutboundNo( "jingdong" );
LogisticsOtherOutstoreQueryResponse response=client.execute(request);

20. 获取京东物流运单号接口

接口名称

jingdong.etms.waybillcode.get

功能说明

获取京东物流预分配的运单号 相关文档下载：ERP对接方案【11月4日更新】

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

应用级输入参数

名称

类型

是否必须

示例值

描述

preNum

String

是

获取运单号数量（最大100）

customerCode

String

是

商家编码（区分英文大小写）

此商家编码需由商家向京东快递运营人员（与商家签订京东快递合同的人）索取。

返回结果

名称	类型	示例值	描述
resultInfo	ResultInfoDTO		处理结果

ResultInfoDTO属性

名称	类型	是否必须	示例值	描述
code	String	否	100	结果编码
message	String	否	成功	结果描述
deliveryIdList	String	否	000989987688	京东运单号

返回示例

JSON数据格式

{
  "jingdong_etms_waybillcode_get_responce":{
  "resultInfo":{
  "message":"成功",
"deliveryIdList":"000989987688",
"code":"100",
  }
  }
  }

SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
EtmsWaybillcodeGetRequest request=new EtmsWaybillcodeGetRequest();
request.setPreNum( "jingdong" );
request.setCustomerCode( "jingdong" );
EtmsWaybillcodeGetResponse response=client.execute(request);

21. 京东物流接单接口

接口名称

jingdong.etms.waybill.send

功能说明

向京东物流系统提交运单信息 相关文档下载：ERP对接方案【11月4日更新】 京东快递可配送区域

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

应用级输入参数

序号	字段描述	名称	类型	是否必须	示例值	描述
1	运单号	deliveryId	String	是		运单号（通过jingdong.etms.waybillcode.get获取到的运单号）
2	销售平台编码	salePlat	String	是		京东快递物流系统为各平台维护了数据字典，如为京东平台，则传入0010001。如没有以下平台，可传入0030001（即其他），数据字典如下： 0010001 京东 0010002 天猫 0010003 苏宁 0010004 亚马逊中国 0020001 ChinaSkin 0030001 其他小型销售平台务必保证该字段的正确
3	商家店铺编码	customerCode	String	是		商家编码商家跟京东快递签订合同后京东快递给商家根据店铺创建的编号，需要唯一。此商家编码需由商家向京东快递运营人员（与商家签订京东快递合同的人）索取。
4	商家订单号	orderId	String	是		商家发货商品的唯一标识，可能为ERP软件生成的新订单号，即商家订单号未必等于平台订单号（最多支持20个字符）
5	京东订单号	thrOrderId	String	否	如果销售平台编码为0010001（京东），则此字段不能为空。	如果订单为京东平台订单，此字段必填。如果该订单为京东平台之外的订单，请为空。货到付款订单，不支持合并发货；在线支付订单，此处可以回传多个订单号，用英文逗号分隔。
6	是否客户打印运单	selfPrintWayBill	Number	否	1	是否客户打印运单(是：1，否：0。不填或者超出范围，默认是1)
7	取件方式	pickMethod	String	否	1	取件方式(上门收货：1，自送：2。不填或者超出范围，默认是1)
8	包装要求	packageRequired	String	否	1	包装要求(不需包装：1，简单包装：2，特殊包装：3。不填或者超出范围，默认是1)
9	寄件人姓名	senderName	String	是		寄件人姓名（最大支持25个汉字）
10	寄件人地址	senderAddress	String	是		寄件人地址（最大支持128个汉字）
11	寄件人电话	senderTel	String	否		寄件人电话
12	寄件人手机	senderMobile	String	否		寄件人手机(寄件人电话、手机至少有一个不为空)
13	寄件人邮编	senderPostcode	String	否		寄件人邮编
14	收件人姓名	receiveName	String	是		收件人姓名（最大支持25个汉字）
15	收件人地址	receiveAddress	String	是		收件人地址（最大支持128个汉字）
16	收件人省	province	String	否		收件人省
17	收件人市	city	String	否		收件人市
18	收件人县	county	String	否		收件人县
19	收件人镇	town	String	否		收件人镇
20	收件人电话	receiveTel	String	否		收件人电话
21	收件人手机	receiveMobile	String	否		收件人手机号(收件人电话、手机至少有一个不为空)
22	收件人邮编	postcode	String	否		收件人邮编
23	包裹数量	packageCount	Number	是		该订单下的包裹数(大于0，小于1000)，几个包裹就需要打印几个快递单
24	重量	weight	Number	是		重量(单位：kg，保留小数点后两位，默认为0 )
25	包裹长度	vloumLong	Number	否		包裹长(单位：cm,保留小数点后两位)
26	包裹宽度	vloumWidth	Number	否		包裹宽(单位：cm，保留小数点后两位)
27	包裹高	vloumHeight	Number	否		包裹高(单位：cm，保留小数点后两位)
28	包裹体积	vloumn	Number	是	10000	体积(单位：CM3，保留小数点后两位，默认可传为0 )
29	商品描述	description	String	否		商品描述
30	是否代收货款	collectionValue	Number	是	1	1为代收货款，0为非代收货款
31	代收货款金额	collectionMoney	Number	否	98.00	【是否代收货款】为1，则必填：保留小数点后两位，后台会校验如果【是否代收货款】为0，则为空。京东平台订单，此字段务必通过360buy.order.print.data.get接口should_pay字段获取。
32	是否保价	guaranteeValue	Number	否	1	是否保价(是：1，否：0。不填或者超出范围，默认是0)
33	保价金额	guaranteeValueAmount	Number	否	100.00	如果有保价，则保价金额(保留小数点后两位) 为必填，后台有校验。
34	是否签单返还	signReturn	Number	否	1	签单返还(是：1，否：0。不填或者超出范围，默认是0)
35	运单时效	aging	Number	否	1	时效(普通：1，工作日：2，非工作日：3，晚间：4。不填或者超出范围，默认是1)
36	运输业务类型	transType	Number	否	1	运输类型(陆运：1，航空：2。不填或者超出范围，默认是1)

返回结果

名称	类型	示例值	描述
resultInfo	ResultInfoDTO		处理结果

ResultInfoDTO 属性

名称	类型	示例值	描述
code	String	100	结果编码
message	String	成功	结果描述
orderId	String	658898	商家订单号
deliveryId	String	000989987688	京东运单号.

返回示例

JSON数据格式

{
  "jingdong_etms_waybill_send_responce":{
  "resultInfo":{
  "message":"成功",
"deliveryId":"000989987688",
"code":"100",
"orderId":"658898"
  }
  }
  }

SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
EtmsWaybillSendRequest request=new EtmsWaybillSendRequest();
request.setDeliveryId( "jingdong" );
request.setSalePlat( "jingdong" );
request.setCustomerCode( "jingdong" );
request.setOrderId( "jingdong" );
request.thrOrderId( "jingdong" );
request.setSelfPrintWayBill( 123 );
request.setPickMethod( "jingdong" );
request.setPackageRequired( "jingdong" );
request.setSenderName( "jingdong" );
request.setSenderAddress( "jingdong" );
request.setSenderTel( "jingdong" );
request.setSenderMobile( "jingdong" );
request.setSenderPostcode( "jingdong" );
request.setReceiveName( "jingdong" );
request.setReceiveAddress( "jingdong" );
request.setProvince( "jingdong" );
request.setCity( "jingdong" );
request.setCounty( "jingdong" );
request.setTown( "jingdong" );
request.setReceiveTel( "jingdong" );
request.setReceiveMobile( "jingdong" );
request.setPostcode( "jingdong" );
request.setPackageCount( 123 );
request.setWeight( 123 );
request.setVloumLong( 123 );
request.setVloumWidth( 123 );
request.setVloumHeight( 123 );
request.setVloumn( 123 );
request.setDescription( "jingdong" );
request.setCollectionValue( 123 );
request.setCollectionMoney( 123 );
request.setGuaranteeValue( 123 );
request.setGuaranteeValueAmount( 123 );
request.setSignReturn( 123 );
request.setAging( 123 );
request.setTransType( 123 );
EtmsWaybillSendResponse response=client.execute(request);

22. 京东物流全程跟踪查询接口

接口名称

jingdong.etms.trace.get

功能说明

京东物流全程跟踪查询接口 相关文档下载：ERP对接方案【11月4日更新】 京东快递可配送区域

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

应用级输入参数

名称	类型	是否必须	示例值	描述
waybillCode	String	是	000123456789	运单号

返回结果

名称	类型	示例值	描述
trace_api_dtos	TraceApiDto[]	请参考返回示例中的JSON数据格式	全程跟踪数据结果集

trace_api_dtos 属性

名称	类型	是否必须	示例值	描述
ope_title	String	否	站点验货	操作标题
ope_remark	String	否	您的订单已分配	操作详情
ope_name	String	否	张三	操作人姓名
ope_time	String	否	2013/06/25 09:16:09	操作时间

返回示例

JSON数据格式

{
  "jingdong_etms_trace_get_responce":{
  "trace_api_dtos":[{
  "ope_remark":"您的订单已分配",
"ope_time":"2013/06/25 09:16:09",
"ope_title":"站点验货",
"ope_name":"张三"
  }]
  }
  }

SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
EtmsTraceGetRequest request=new EtmsTraceGetRequest();
request.setWaybillCode( "jingdong" );
EtmsTraceGetResponse response=client.execute(request);

服务目录

公告栏

接入流程

开发指南

常用工具

业务流程

常见问题

面向买家服务

面向商家服务

京麦服务市场

供应商服务

京东云服务

接口名称

功能说明

API用户授权类型

系统级别输入参数

应用级输入参数

返回结果

CarriersDetail属性

返回示例

JSON数据格式

SDK调用示例（java）

接口名称

功能说明

API用户授权类型

系统级别输入参数

应用级输入参数

返回结果

WarehouseDetail属性

返回示例

JSON数据格式

接口名称

功能说明

API用户授权类型

系统级别输入参数

应用级输入参数

返回结果

返回示例

JSON数据格式

接口名称

功能说明

API用户授权类型

系统级别输入参数

应用级输入参数

返回结果

返回示例

JSON数据格式

接口名称

功能说明

API用户授权类型

系统级别输入参数

应用级输入参数

返回结果

返回示例

JSON数据格式

SDK调用示例（java）

接口名称

功能说明

API用户授权类型

系统级别输入参数

应用级输入参数

返回结果

result_no json结构

返回示例

JSON数据格式

SDK调用示例（java）

接口名称

功能说明

API用户授权类型

系统级别输入参数

应用级输入参数

返回结果

ReceivingTask属性

返回示例

JSON数据格式

SDK调用示例（java）

接口名称

功能说明

API用户授权类型

系统级别输入参数