京东协议长期供货协议方案

面向买家服务
面向商家服务
京东服务市场
供应商服务
京东云服务
【物流服务】接口导航
&以上为京东仓储系统对应接口,如商家需调取获取物流公司请参考京东快递配送对接请参考&相关文档下载:&
1. 获取承运商信息列表
接口名称jingdong.logistics.carriers.list功能说明获取承运商信息列表API用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否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
JOSL商品编码
ISV商品编码
goodShortName
goodCategoryId
商品类别ID
goodCategoryName
商品类别名称
goodStandard
grossWeight
sizeDefinition
supplierNo
供应商编码
supplierName
供应商名称
produceAddress
制造商地址
goodLength
goodHeight
是否保质期管理
条码 返回示例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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否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用户授权类型不需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString否采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否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& 否
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&:& 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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否API协议版本,可选值:2.0应用级输入参数名称类型是否必须示例值描述seller_no&String&
否EDB0001&ISV商家编号& warehouse_no&String&
是BJ&JOSL库房编号& inbound_no&String&
是EDBI001111&ISV入库单号& josl_outbound_no&String&
是JOSL1000012&JOSL出库单号& expected_date&Date&
是 11:00:59&JOSL预计送达日期& isv_source&String&
否/&ISV来源& approver&String&
是张三&审批人& goods_no&String[]&
是JGNO&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( & 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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否API协议版本,可选值:2.0应用级输入参数名称类型是否必须示例值描述receipt_no&String&
是JRI000001&要取消的退货入库单号& isv_source&String&
否/&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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否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( & 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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否API协议版本,可选值:2.0应用级输入参数名称类型是否必须示例值描述in_bound_no&String&
是JBI&其它入库入库单号& 返回结果名称类型示例值描述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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否API协议版本,可选值:2.0应用级输入参数; 名称类型是否必须示例值描述outbound_no&String&
是123456&出库单号& josl_ware_no&String&
是BJ&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&
否&电子邮件& 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&
是010&订单标记位& josl_good_no&String[]&
是JGNO&JOSL商品编号& isv_good_no&String[]&
否&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( & 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用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否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 功能说明获取京东物流预分配的运单号 & &相关文档下载: API用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否API协议版本,可选值:2.0应用级输入参数名称类型是否必须示例值描述
获取运单号数量(最大100)
customerCodeString 是&
商家编码(区分英文大小写)此商家编码需由商家向京东快递运营人员(与商家签订京东快递合同的人)索取。返回结果名称类型示例值描述resultInfo&ResultInfoDTO&&
处理结果ResultInfoDTO属性名称类型是否必须示例值描述code&String&
& message&&String&
结果描述deliveryIdList&String&&
京东运单号
返回示例JSON数据格式{&&&jingdong_etms_waybillcode_get_responce&:{&&&resultInfo&:{&&&message&:&成功&,&deliveryIdList&:&&,&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功能说明向京东物流系统提交运单信息 &&相关文档下载:& &API用户授权类型需要系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:
13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString否API协议版本,可选值:2.0应用级输入参数
deliveryId&
运单号(通过jingdong.etms.waybillcode.get获取到的运单号)
销售平台编码
京东快递物流系统为各平台维护了数据字典,如为京东平台,则传入0010001。如没有以下平台,可传入0030001(即其他),数据字典如下:
0010001 京东
0010002 天猫
0010003 苏宁
0010004 亚马逊中国
0020001 ChinaSkin
0030001 其他小型销售平台
务必保证该字段的正确
商家店铺编码
customerCode
商家编码商家跟京东快递签订合同后京东快递给商家根据店铺创建的编号,需要唯一。 此商家编码需由商家向京东快递运营人员(与商家签订京东快递合同的人)索取。
商家订单号
商家发货商品的唯一标识,可能为ERP软件生成的新订单号,即商家订单号未必等于平台订单号(最多支持20个字符)
京东订单号
thrOrderId
如果销售平台编码为0010001(京东),则此字段不能为空。
如果订单为京东平台订单,此字段必填。
如果该订单为京东平台之外的订单,请为空。货到付款订单,不支持合并发货;在线支付订单,此处可以回传多个订单号,用英文逗号分隔。
是否客户打印运单
selfPrintWayBill
是否客户打印运单(是:1,否:0。不填或者超出范围,默认是1)
pickMethod
取件方式(上门收货:1,自送:2。不填或者超出范围,默认是1)
packageRequired&
包装要求(不需包装:1,简单包装:2,特殊包装:3。不填或者超出范围,默认是1)&
寄件人姓名
senderName&
寄件人姓名(最大支持25个汉字)
寄件人地址
senderAddress&
寄件人地址 (最大支持128个汉字)
寄件人电话
senderTel&
寄件人电话
寄件人手机
senderMobile&
寄件人手机(寄件人电话、手机至少有一个不为空)&
寄件人邮编
senderPostcode&
寄件人邮编
收件人姓名
receiveName&
收件人姓名 (最大支持25个汉字)
收件人地址
receiveAddress&
收件人地址&(最大支持128个汉字)
收件人电话
receiveTel&
收件人电话
收件人手机
receiveMobile&
收件人手机号(收件人电话、手机至少有一个不为空)
收件人邮编
收件人邮编
packageCount&
该订单下的包裹数(大于0,小于1000),几个包裹就需要打印几个快递单
重量(单位:kg,保留小数点后两位,默认为0 )&
vloumLong&
包裹长(单位:cm,保留小数点后两位)
vloumWidth&
包裹宽(单位:cm,保留小数点后两位)&
vloumHeight&&
包裹高(单位:cm,保留小数点后两位)
体积(单位:CM3,保留小数点后两位,默认可传为0 )
description&&
是否代收货款
collectionValue&
1为代收货款,0为非代收货款
代收货款金额
collectionMoney&
【是否代收货款】为1,则必填:保留小数点后两位,后台会校验
如果【是否代收货款】为0,则为空。 京东平台订单,此字段务必通过360buy.order.print.data.get接口should_pay字段获取。
guaranteeValue&
是否保价(是:1,否:0。不填或者超出范围,默认是0)&
guaranteeValueAmount&&
如果有保价,则保价金额(保留小数点后两位)&为必填,后台有校验。
是否签单返还
signReturn&
签单返还(是:1,否:0。不填或者超出范围,默认是0)&
时效(普通:1,工作日:2,非工作日:3,晚间:4。不填或者超出范围,默认是1)&
运输业务类型
transType&
运输类型(陆运:1,航空:2。不填或者超出范围,默认是1)&
&返回结果名称类型示例值描述resultInfo&ResultInfoDTO&&
处理结果ResultInfoDTO&属性
商家订单号&
deliveryId&
京东运单号.&
&返回示例 JSON数据格式{
&&&jingdong_etms_waybill_send_responce&:{
&&&resultInfo&:{
&&&message&:&成功&,
&deliveryId&:&&,
&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(
);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(
);request.setWeight(
);request.setVloumLong(
);request.setVloumWidth(
);request.setVloumHeight(
);request.setVloumn(
);request.setDescription(
&jingdong&
);request.setCollectionValue(
);request.setCollectionMoney(
);request.setGuaranteeValue(
);request.setGuaranteeValueAmount(
);request.setSignReturn(
);request.setAging(
);request.setTransType(
);EtmsWaybillSendResponse response=client.execute(request);
22. 京东物流全程跟踪查询接口
&&接口名称jingdong.etms.trace.get&功能说明京东物流全程跟踪查询接口 &&相关文档下载:& &API用户授权类型需要系统级别输入参数
API接口名称
access_token
采用OAuth授权方式为必填参数
应用的app_key
时间戳,格式为yyyy-MM-dd HH:mm:ss,例如: 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
暂时只支持json
API协议版本,可选值:2.0
应用级输入参数
waybillCode&
trace_api_dtos&
TraceApiDto[]&
请参考返回示例中的JSON数据格式&
全程跟踪数据结果集&
trace_api_dtos&&属性
ope_title&
ope_remark&
您的订单已分配&
操作人姓名&
&返回示例JSON数据格式{
&&&jingdong_etms_trace_get_responce&:{
&&&trace_api_dtos&:[{
&&&ope_remark&:&您的订单已分配&,
&ope_time&:& 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);

我要回帖

更多关于 协议供货组织实施方案 的文章

 

随机推荐