文档
测试

1.下单

POST
https://api.jd.com/routerjson

接口描述

开发者可调用此接口下纯配揽收单

快运流程及状态变换图

![快运交互图 3.png](https://cos.easydoc.net/48578360/files/kpxt0ywt.png)

数据格式及编码

``` Content_type:application/json Accept:application/json Charset:utf-8 ```

params参数

参数名
类型
描述
必填
method
string
接口方法名:jingdong.eclp.co.createWbOrder
必填
app_key
string
开发者应用app_key
必填
access_token
string
授权访问令牌码
必填
timestamp
string
请求时间, 京东网关允许误差为10分钟。 示例:2020-09-23 12:23:45
必填
format
string
数据格式。固定值"json"
必填
v
string
接口版本号,固定值“2.0”
必填
sign
string
签名值。签名算法请参考https://easydoc.xyz/doc/85914950/QULSrw7u/EnnJTVOz
必填

request Body参数

参数名
类型
描述
必填
360buy_param_json
object
业务参数
必填
orderNo
string(50)
isv/商家订单号(自定义,唯一属性)
可选
deptNo
string(50)
eclp--事业部编码
必填
orderType
int
eclp--订单类型(0-B商家订单,默认项,1-营业厅订单,3-到仓/退供订单)
可选
deliveryType
int
eclp--产品类型(1-零担,2-整车直达,3-京东快递-特惠送, 4-京东快递-特快送 ,5-特惠零担, 6-特快零担, 10-特惠整车,11-特惠拼车,12同城直配,13-冷链卡班, 14-冷链专车,15-冷链城配, 17-医药零担,18-医药整车,24-专线包仓, 25-特快重货,26-大票直达,28-航空重货)
可选
vehicleTypeNo
string(50)
【整车必填】车辆类型编码;
可选
vehicleTypeName
string(50)
【整车必填】车辆类型名称
可选
vehicleQty
string(50)
【整车必填】用车数量
可选
vehicleOrderNo
string
【整车必填】整车单号
可选
spId
int
订单来源销售平台(1:京东,0:其他)
可选
saleOrderNo
string(50)
销售平台订单号
可选
wayBillCode
string(50)
预制运单号
可选
senderNickName
string(50)
寄件信息--寄件人简称
可选
senderName
string(50)
寄件信息--寄件人姓名;
可选
senderMobile
string(50)
寄件信息--寄件人手机;
可选
senderCompany
string(100)
寄件信息--寄件人公司
可选
senderPhone
string(50)
寄件信息--寄件人座机;
可选
senderProvinceName
string(100)
寄件信息--寄件地址所属省;
可选
senderProvince
string(100)
寄件信息--寄件地址所属省code;
可选
senderCityName
string(100)
寄件信息--寄件地址所属市
可选
senderCity
string(100)
寄件信息--寄件地址所属市code
可选
senderCountyName
string(100)
寄件信息--寄件地址所属区/县
可选
senderCounty
string(100)
寄件信息--寄件地址所属区/县code
可选
senderTownName
string(100)
寄件信息--寄件地址所属乡(镇);
可选
senderTown
string(100)
寄件信息--寄件地址所属乡(镇)code
可选
senderAddress
string(200)
寄件信息--详细地址;
可选
warehouseCode
string(50)
寄件信息--发货仓编码
可选
receiverNickName
string(50)
收件信息--收件人简称;
可选
receiverName
string(50)
收件人信息--收货人姓名;
可选
receiverCompany
string(100)
收件人信息--收件人公司
可选
receiverMobile
string(50)
收件人信息--收货人手机;
可选
receiverPhone
string(50)
收件人信息--收货人座机
可选
receiverProvinceName
string(100)
收件人信息--收货人省
可选
receiverProvince
string(100)
收件人信息--收货人省code
可选
receiverCityName
string(100)
收件人信息--收货人市
可选
receiverCity
string(100)
收件人信息--收货人市code
可选
receiverCountyName
string(100)
收件人信息--收货人区/县
可选
receiverCounty
string(100)
收件人信息--收货人区/县code
可选
receiverTownName
string(100)
收件人信息--收货人城镇
可选
receiverTown
string(100)
收件人信息--收货人城镇code
可选
receiverAddress
string(200)
收件人信息--收件人详细地址(简称不存在,必填)
可选
checkPreSort
int
下单是否校验超区 (0:否,1:是)
可选
remark
string(200)
订单备注
可选
expressItemName
string(50)
托寄物信息--货物名称
可选
grossWeight
number
托寄物信息--总重量(kg)
可选
grossVolume
number
托寄物信息--总体积(立方米)
可选
expressItemQty
number
托寄物信息--总包裹数/总箱数
可选
packageNo
string[]
托寄物信息--商家箱号
可选
deliveryIntoWarehouse
int
增值服务--是否送货入仓; 0:否 1:是
可选
inStorageTime
date
增值服务--进仓时间( YYYY-MM-DD HH:MM:SS)
可选
inStorageNo
string(200)
增值服务--进仓预约号(多个预约号用逗号,隔开)
可选
inStorageRemark
string(100)
增值服务--进仓备注;
可选
isCod
int
增值服务--是否代收货款
可选
receivable
number
增值服务--代收货款金额
可选
guaranteeValue
number
增值服务--保价金额(元)
可选
fcFlag
int
增值服务--运费结算方式(0:月结 1:到付 2:现付)
可选
loadFlag
int
增值服务--是否装货(0:否 ;1:是)
可选
unloadFlag
int
增值服务--是否卸货 0:否 ;1:是;2:TC卸货(到仓专用)
可选
receiptFlag
int
增值服务--签单返还(0无签单,1纸质签单,3电子签单,4纸质签单和电子签单)
可选
heavyUpstair
int
增值服务--是否重货上楼 (0:否;1:是 ,如需开通请联系业务支持,默认不支持此功能)
可选
packageServiceOn
int
增值服务--是否支持包装服务 0:否;1:是;
可选
temporaryStorage
int
增值服务--暂存服务(0-否;1-是)
可选
predictReceiptDate
date
预计收货时间,参考(YYYY-MM-DD)
可选
deliveryMthd
int
配送信息--配送方式(0:京配 1:京配转三方)
可选
providerCode
int
配送信息--承运商编号
可选
messageSign
int
配送信息--特殊签收方式( 0:默认,1:短信签收,8:签收前激活电信卡)
可选
pickupBeginTime
date
上门提货开始时间(格式:yyyy-MM-dd HH:mm:ss)
可选
pickupEndTime
date
上门提货结束时间(格式:yyyy-MM-dd HH:mm:ss)
可选
tracker
int
是否使用鸡毛信 0:不使用,1:使用鸡毛信器
可选
warehouseServiceType
int
【到仓/退供服务】仓服务业务场景(1、到仓;2、退供)
可选
homeDeliveryOn
int
【到仓/退供服务】上门提货(是1/否0) or 退供至门(是1/否0)
可选
siteCode
string
【到仓/退供服务】站点编码(送货点编码/提货点编码)
可选
referCancelDate
date
【到仓/退供服务】参考取消日( YYYY-MM-DD HH:mm:ss)
可选
rebackConfluenceOn
int
【到仓/退供服务】退货合流(是1/否0),(到仓/退供专用)
可选
expressDeliveryOn
int
【到仓/退供服务】快递(是1/否0),(到仓/退供专用)
可选
expectPickupDate
date
【到仓/退供服务】仓服务-预计提货时间-到仓,参考(YYYY-MM-DD HH:mm:ss)
可选
expectDeliveryDate
date
【到仓/退供服务】仓服务-预计送货时间-到仓 ,参考(YYYY-MM-DD HH:mm:ss)
可选
warehousePlatformName
string
【到仓/退供服务】送货仓/提货仓所属平台名称
可选
extendFieldStr
string
商家随单扩展信息字段json串,合法的key有:miniBox(微小箱数量),extraSmallBox(特小箱数量),smallBox(小箱数量),middleSmallBox(中小箱数量),middleBox(中箱数量),bigMiddleBox(中大箱数量),bigBox(大箱数量),courierBag(快递袋数量),specialGoods(特殊货品数量),senderArea(寄件公司所属区域),receiverArea(收件公司所属区域),sellerTransportType(商家运输方式),importType(是否进口 1-是,0-否),netbagType(是否网兜 1-是,0-否),heatInsulationType(是否保温 1-是,0-否)
可选

response参数

参数名
类型
描述
必填
jingdong_eclp_co_createWbOrder_responce
object
数据字典
必填
code
string
网关状态码(0-接收成功)
必填
CoCreateLwbResult_result
object
数据字典
必填
resultCode
int
业务系统状态码(1-成功,其他失败)
必填
resultMsg
string
业务系统状态描述
必填
lwbNo
string
青龙系统单号,示例:JDVC06139468595
必填
wbNo
string
京东单号,示例:ECO83583029876503
必填
deliveryMthd
int
配送方式 0:京配 1:京配转三方
必填
providerName
string
京配转三方-承运商编码
可选
thrOrderId
string
京配转三方-三方运单号
可选

请求示例

##### json版本 ```json { "360buy_param_json":{ "orderNo":"test202002200001", //商家订单号 "deptNo":"EBU4418046582013", //事业部编码 "orderType":0, //订单类型(0-B商家订单,默认项,1-营业厅订单,3-到仓/退供订单) "deliveryType":6, //产品类型(1-零担,2-整车直达,3-京东快递-特惠送, 4-京东快递-特快送 ,5-特惠零担, 6-特快零担, 10-特惠整车,11-特惠拼车,12同城直配,13-冷链卡班, 14-冷链专车,15-冷链城配, 17-医药零担,18-医药整车,24-专线包仓, 25-特快重货,26-大票直达,28-航空重货) "spId":0, //订单来源销售平台(1:京东,0:其他) "saleOrderNo":"12345678", //订单在销售平台销售单号 "senderName":"测试", //寄件人 "senderMobile":"13800000000", //寄件人手机 "senderAddress":"广东省广州市黄埔区南岗镇京东华南电子商务基地", //寄件地址 "receiverName":"测试", //收件人 "receiverMobile":"13800000000", //收件人手机 "receiverAddress":"广东省广州市黄埔区南岗镇京东华南电子商务基地", //收件人地址 "remark":"测试下单备注", //下单备注 "grossWeight":"12", //下单重量 "grossVolume":"10", //下单体积 "expressItemName":"测试托寄物名称",//托寄物名称 "expressItemQty":1, //包裹数量 "fcFlag":0, //增值服务--运费结算方式(0:月结 1:到付 2:现付) "loadFlag":0, //增值服务--是否装货(0:否 ;1:是) "unloadFlag":0, //增值服务--是否卸货 0:否 ;1:是;2:TC卸货(到仓专用) "deliveryIntoWarehouse":0, //增值服务--是否送货入仓 "receiptFlag":0, //增值服务--签单返还(0无签单,1纸质签单,3电子签单,4纸质签单和电子签单) "heavyUpstair":0, //增值服务--是否重货上楼 (0:否;1:是 ,如需开通请联系业务支持,默认不支持此功能) "packageServiceOn":0, //增值服务--是否支持包装服务 0:否;1:是; "temporaryStorage":0, //增值服务--是否支持包装服务 0:否;1:是; "pickupBeginTime":"2021-06-18 12:00:00", //上门提货开始时间(格式:yyyy-MM-dd HH:mm:ss) "pickupEndTime":"2021-06-18 13:00:00" //上门提货结束时间(格式:yyyy-MM-dd HH:mm:ss) } } ``` ==SDK-java版本== ```java public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret); EclpCoTransportLasWayBillRequest request=new EclpCoTransportLasWayBillRequest(); request.setDeptNo("EBU0000000000571"); request.setOrderNo("201901241657"); request.setSenderName("李四"); request.setSenderMobile("18712898776"); request.setSenderPhone("010-98785434"); request.setSenderAddress("北京市大兴区瀛海镇南海家园四里"); request.setReceiverName("张三"); request.setReceiverMobile("18712987009"); request.setReceiverPhone("010-87984543"); request.setReceiverAddress("上海市黄浦区陆家浜路918号"); request.setRemark("请及时送达"); request.setIsFragile("2"); request.setSenderTc("北京转运中心"); request.setPredictDate("2019/01/25"); request.setIsJDOrder("1"); request.setIsCod("1"); request.setReceiveable("299.23"); request.setOnDoorPickUp("1"); request.setPickUpDate("2019/01/25"); request.setIsGuarantee("1"); request.setGuaranteeValue("1000.5"); request.setReceiptFlag("1"); request.setPaperFrom("1"); request.setRtnReceiverName("张三"); request.setRtnReceiverMobile("18712898776"); request.setRtnReceiverAddress("上海市黄浦区陆家浜路918号"); request.setRtnReceiverPhone("1861290887"); request.setProductType("1"); request.setPickUpForNew("2"); request.setPickUpAbnormalNumber("18622987887"); request.setPickUpReceiverName("张三"); request.setPickUpReceiverMobile("18622987887"); request.setPickUpReceiverPhone("010-8209765"); request.setPickUpReceiverCode("100016"); request.setPickUpReceiverAddress("北京市朝阳区三环以内"); request.setIsSignPrint(1); request.setSameCityDelivery("0"); request.setWeight("100.5"); request.setLength("20000"); request.setWidth("20000"); request.setHeight("20000"); request.setInstallFlag("1"); request.setThirdCategoryNo("9200"); request.setBrandNo("101"); request.setProductSku("234123"); request.setPackageName("洗衣机"); request.setReverseLwb("2"); request.setGetOldService("0"); request.setOpenBoxService("0"); request.setDeliveryInstallService("0"); request.setPackageIdentityCode("abc"); request.setPrice("0"); request.setLasInstall("0"); EclpCoTransportLasWayBillResponse response=client.execute(request); ``` ==SDK-php版本== ```php $c = new JdClient(); $c->appKey = appKey; $c->appSecret = appSecret; $c->accessToken = accessToken; $c->serverUrl = SERVER_URL; $req = new EclpCoTransportLasWayBillRequest(); $req->setDeptNo( "abc" ); $req->setOrderNo( "abc" ); $req->setSenderName( "abc" ); $req->setSenderMobile( "abc" ); $req->setSenderPhone( "abc" ); $req->setSenderAddress( "abc" ); $req->setReceiverName( "abc" ); $req->setReceiverMobile( "abc" ); $req->setReceiverPhone( "abc" ); $req->setReceiverAddress( "abc" ); $req->setRemark( "abc" ); $req->setIsFragile( "abc" ); $req->setSenderTc( "abc" ); $req->setPredictDate( "abc" ); $req->setIsJDOrder( "abc" ); $req->setIsCod( "abc" ); $req->setReceiveable( "abc" ); $req->setOnDoorPickUp( "abc" ); $req->setPickUpDate( "abc" ); $req->setIsGuarantee( "abc" ); $req->setGuaranteeValue( "abc" ); $req->setReceiptFlag( "abc" ); $req->setPaperFrom( "abc" ); $req->setRtnReceiverName( "abc" ); $req->setRtnReceiverMobile( "abc" ); $req->setRtnReceiverAddress( "abc" ); $req->setRtnReceiverPhone( "abc" ); $req->setProductType( "abc" ); $req->setPickUpForNew( "abc" ); $req->setPickUpAbnormalNumber( "abc" ); $req->setPickUpReceiverName( "abc" ); $req->setPickUpReceiverMobile( "abc" ); $req->setPickUpReceiverPhone( "abc" ); $req->setPickUpReceiverCode( "abc" ); $req->setPickUpReceiverAddress( "abc" ); $req->setIsSignPrint( ); $req->setSameCityDelivery( "abc" ); $req->setWeight( "abc,def,hgj" ); $req->setLength( "abc,def,hgj" ); $req->setWidth( "abc,def,hgj" ); $req->setHeight( "abc,def,hgj" ); $req->setInstallFlag( "abc,def,hgj" ); $req->setThirdCategoryNo( "abc,def,hgj" ); $req->setBrandNo( "abc,def,hgj" ); $req->setProductSku( "abc,def,hgj" ); $req->setPackageName( "abc,def,hgj" ); $req->setReverseLwb( "abc,def,hgj" ); $req->setGetOldService( "abc,def,hgj" ); $req->setOpenBoxService( "abc,def,hgj" ); $req->setDeliveryInstallService( "abc,def,hgj" ); $req->setPackageIdentityCode( "abc,def,hgj" ); $req->setPrice( "abc,def,hgj" ); $req->setLasInstall( "abc,def,hgj" ); $resp = $c->execute($req, $c->accessToken); ``` ==SDK-.net版本== ```.net IJdClient client = new DefaultJdClient(url, appkey, appsecret); EclpCoTransportLasWayBillRequest req = new EclpCoTransportLasWayBillRequest(); req.deptNo = "abc" ; req.orderNo = "abc" ; req.senderName = "abc" ; req.senderMobile = "abc" ; req.senderPhone = "abc" ; req.senderAddress = "abc" ; req.receiverName = "abc" ; req.receiverMobile = "abc" ; req.receiverPhone = "abc" ; req.receiverAddress = "abc" ; req.remark = "abc" ; req.isFragile = "abc" ; req.senderTc = "abc" ; req.predictDate = "abc" ; req.isJDOrder = "abc" ; req.isCod = "abc" ; req.receiveable = "abc" ; req.onDoorPickUp = "abc" ; req.pickUpDate = "abc" ; req.isGuarantee = "abc" ; req.guaranteeValue = "abc" ; req.receiptFlag = "abc" ; req.paperFrom = "abc" ; req.rtnReceiverName = "abc" ; req.rtnReceiverMobile = "abc" ; req.rtnReceiverAddress = "abc" ; req.rtnReceiverPhone = "abc" ; req.productType = "abc" ; req.pickUpForNew = "abc" ; req.pickUpAbnormalNumber = "abc" ; req.pickUpReceiverName = "abc" ; req.pickUpReceiverMobile = "abc" ; req.pickUpReceiverPhone = "abc" ; req.pickUpReceiverCode = "abc" ; req.pickUpReceiverAddress = "abc" ; req.isSignPrint = ; req.sameCityDelivery = "abc" ; req.weight = "abc,def,hgj" ; req.length = "abc,def,hgj" ; req.width = "abc,def,hgj" ; req.height = "abc,def,hgj" ; req.installFlag = "abc,def,hgj" ; req.thirdCategoryNo = "abc,def,hgj" ; req.brandNo = "abc,def,hgj" ; req.productSku = "abc,def,hgj" ; req.packageName = "abc,def,hgj" ; req.reverseLwb = "abc,def,hgj" ; req.getOldService = "abc,def,hgj" ; req.openBoxService = "abc,def,hgj" ; req.deliveryInstallService = "abc,def,hgj" ; req.packageIdentityCode = "abc,def,hgj" ; req.price = "abc,def,hgj" ; req.lasInstall = "abc,def,hgj" ; EclpCoTransportLasWayBillResponse response = client.Execute (req, token, DateTime.Now.ToLocalTime()); ``` ==SDK-python版本== ```python import jd.api import json from jd.api.rest.EclpCoTransportLasWayBillRequest import EclpCoTransportLasWayBillRequest jd.setDefaultAppInfo(appkey, secret) a = EclpCoTransportLasWayBillRequest(url,port) a.deptNo = "abc" a.orderNo = "abc" a.senderName = "abc" a.senderMobile = "abc" a.senderPhone = "abc" a.senderAddress = "abc" a.receiverName = "abc" a.receiverMobile = "abc" a.receiverPhone = "abc" a.receiverAddress = "abc" a.remark = "abc" a.isFragile = "abc" a.senderTc = "abc" a.predictDate = "abc" a.isJDOrder = "abc" a.isCod = "abc" a.receiveable = "abc" a.onDoorPickUp = "abc" a.pickUpDate = "abc" a.isGuarantee = "abc" a.guaranteeValue = "abc" a.receiptFlag = "abc" a.paperFrom = "abc" a.rtnReceiverName = "abc" a.rtnReceiverMobile = "abc" a.rtnReceiverAddress = "abc" a.rtnReceiverPhone = "abc" a.productType = "abc" a.pickUpForNew = "abc" a.pickUpAbnormalNumber = "abc" a.pickUpReceiverName = "abc" a.pickUpReceiverMobile = "abc" a.pickUpReceiverPhone = "abc" a.pickUpReceiverCode = "abc" a.pickUpReceiverAddress = "abc" a.isSignPrint = a.sameCityDelivery = "abc" a.weight = "abc,def,hgj" a.length = "abc,def,hgj" a.width = "abc,def,hgj" a.height = "abc,def,hgj" a.installFlag = "abc,def,hgj" a.thirdCategoryNo = "abc,def,hgj" a.brandNo = "abc,def,hgj" a.productSku = "abc,def,hgj" a.packageName = "abc,def,hgj" a.reverseLwb = "abc,def,hgj" a.getOldService = "abc,def,hgj" a.openBoxService = "abc,def,hgj" a.deliveryInstallService = "abc,def,hgj" a.packageIdentityCode = "abc,def,hgj" a.price = "abc,def,hgj" a.lasInstall = "abc,def,hgj" try: f= a.getResponse(sessionkey) print(json.dumps(f, ensure_ascii=False)) except Exception,e: print(e) ```

响应示例

```json {     "jingdong_eclp_co_createWbOrder_responce": {         "code": "0",         "CoCreateLwbResult_result": {             "deliveryMthd": 0,             "resultMsg": "操作成功!",             "resultCode": 1,             "lwbNo": "JDVC06139468595",             "wbNo": "ECO83583029876503"         }     } } ```

接口状态码说明(resultCode)

|resultCode状态码|描述|建议处理方式| |-|-|-| |0|下单失败|| |1|下单成功||