全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

获取单号接口(无界电子面单)


接口地址: http://api.vv-tool.com/tool/erps/jdwaybillreceive


接口介绍: SV、POP 后台推送运单接口,接口不支持 sdk 方式调用,需用 https 方式,具体可参考https://jos.jd.com/commondoc?listId=33 请求成功后如果需要打印电子面单需要调用大头笔接口(不打印可以不用调用大头笔信息)


必须用户授权 : 需要用户的授权,才能拿到被授权的数据


请求方式: POST


返回格式: JSON


接口收费: 请求次数收费,联系运营


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

名称 类型 必须 示例值 描述
owner_id String 店铺 ownerId
content String 参考接口文档 报文内容
vvtype int 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2

相关字段补充说明

字段名称 字段类型 字段描述 必须 示例值
waybillType Integer 运单类型:1 普通运单 1、 普通运单
waybillCount Integer 所需运单的数量,顺丰只能传 1,非顺丰快递公司最多只能传 99 1
providerId Integer 承运商 id (providerId 与 providerCode 两者必填一个) 条件 1234
providerCode String(32) 承运商编码(providerID 与 providerCode 两者必填一个) 条件
branchCode String(32) 承运商发货网点编码,加盟型快递公司必传 条件
settlementCode String(32) 财务结算编码,直营型快递公司必传 条件
salePlatform String(7) 销售平台 0010001 代表京东平台下的订单 0010002 天猫、淘宝订单 0030001 其他平台订单
platformOrderNo String(200) 平台订单号,即 pop 订单号,如果多订单合并发货,每个订单号之间用“,”逗号分隔,每个订单号最多 32 位 20000000100 非京东平台填所对应平台的订单号
vendorCode String(16) 商家编码,是用 POP 商家 ID 10001
vendorName String(64) 商家名称 XXX 旗舰店
vendorOrderCode String(32) 商家自有订单号 ELS9292003
fromAddress WaybillAddress 京标发货四级地址 参考下述 waybilladdress
toAddress WaybillAddress 京标收货四级地址 **参考下述 waybilladdress **
weight BigDecimal 重量,单位为千克 两位小数 10.23,没有传 0
volume BigDecimal 体积,单位为统一为立方厘米 两位小数 9000.00,没有传 0
goodsName String(100) 商品名称 乐视电视
promiseTimeType Integer 承诺时效类型 无时效默认传 0
promiseCompleteTime Date 承诺完成时间,若未承诺时效,则不考虑此字段 2016-08-01 12:00:00
promiseOutStockTime Date 计划出库时间
payType Integer 付款方式 0-在线支付目前暂时不支持货到付款业务 0
goodsMoney BigDecimal 商品金额 两位小数 1000.01
shouldPayMoney BigDecimal 代收金额 两位小数付款方式为在线支付时,代收金额必须为 0 0.00
needGuarantee Boolean 是否要保价(系统暂不开放报价业务) True
guaranteeMoney BigDecimal 保价金额 两位小数 needGuarantee 为 false 时,保价金额必须为 0 非保价默认传 0.0
receiveTimeType Integer 收货时间类型,0 任何时间,1 工作日 2 节假日 0
warehouseCode String(20) 发货仓编码 0001
secondSectionCode String(50) 二段码 京配路区
thirdSectionCode String(50) 三段码 京配站点 ID
remark String(100) 备注 速递
expressPayMethod String(32) 快递费付款方式(顺丰必填) 1:寄方付 2:收方付 3:第三方付
expressType String(32) 快件产品类别(顺丰必填) 1. 顺丰次日 2. 顺丰隔日

waybillAddress 类型说明

字段名称 字段类型 字段描述 必填 示例值
provinceId Integer 省/直辖市 id 10
provinceName String(20) 省/直辖市名称 北京
cityId Integer 市 id 101
cityName String(20) 市名称 北京市
countryId Integer 区/县 id 10120
countryName String(20) 区/县名称 朝阳区
countrysideId Integer 乡镇/街道 id 10120002
countrysideName String(20) 县镇/街道名称 和平里北街
address String(100) 发货详细地址 广东省深圳市宝安区沙井镇上星路 1001 号
contact String(30) 发货联系人 李四
phone String(16) 发货人电话 18810909090
mobile String(16) 发货人手机 010-99929991
物流公司名称 物流公司编码 物流公司编号(发货时用)
EMS EMS 465
申通 STO 470
圆通 YTO 463
韵达 YUNDA 1327
宅急送 ZJS 1409
联邦快递 FEDEX 2096
德邦物流 DBL 2130
中通 ZTO 1499
百世 HTKY 1748
天天 TTKDEX 2009
顺丰 SF 467
中铁物流 ZTKY 5419
黑猫宅急便 YCT 1549
新邦物流 XB 2461
快捷快递 FAST 2094
优速快递 UC 1747
增益速递 QRT 3044
全峰快递 QFKD 2016
龙邦速递 LB 471
佳吉快递 CNEX 2460
天地华宇 HOAU 2462
邮政快递包裹 POSTB 2170
全一快递 UAPEX 2100
国通快递 GTO 2465
安能快递 596494
安能物流 ANE 4832
速尔 SURE 2105
德邦快递 DBKD 3046
跨越速运 599866
众邮快递 ZYKD 881232

请求示例

{
 content 请求示例:
    "wayBillType": 1,								//运单类型  1:普通运单  2:生鲜 3:航空   默认填 1
    "wayBillCount": 1,							//所需运单的数量 默认填 1 
    "providerId": 881232,						//物流公司编号 详见:京东物流公司编码 
    "providerCode": "",					//物流公司编码  详见:京东物流公司编码  可不传如果providerId传值的话
    "branchCode": "JJW000020",     //非直营物流必填签约成功返回的网点编码  
    "settlementCode": "JJW000020",        //直营物流必填签约成功返回网点编码
    "salePlatform": "0010001",     //平台编号 JD=0010001 TB=0010002 其它平台=0030001
    "platformOrderNo": "127889307770", //订单号
    "vendorCode": "804786",				 //店铺VendorCode
    "vendorName": "t*****1",				// 店铺账号或店铺名称
    "vendorOrderCode": "1",					// 默认填1
    "fromAddress": {								//发货地址
      "provinceId": 110000,   			//京东订单地址编号(详见京东地址库文档并下载附件)
      "provinceName": "北京",				//省份
      "cityId": 110100,							//....
      "cityName": "北京",
      "countryId": 110115,
      "countryName": "大兴区",
      "countrysideId": 0,
      "countrysideName": "",
      "address": "亦庄经济开发区京东总部",
      "contact": "孙先生",
      "phone": "13911198757",
      "mobile": "13911198757"
    },
    "toAddress": { 							//收货地址
      "provinceId": 1,					//对应的京东订单地址编号 京东订单自带该编号
      "provinceName": "北京",
      "cityId": 2810,
      "cityName": "北京市",
      "countryId": 51081,
      "countryName": "大兴区",
      "countrysideId": 0,
      "countrysideName": "",
      "address": "京东测试",
      "contact": "GJXtest",
      "phone": "13000000000",  //注:如果订单返回的desen_telephone不为空请将desen_telephone对应的值传入该字段
      "mobile": "13000000000" //注:如果订单返回的desen_mobile不为空请将desen_mobile对应的值传入该字段
    },
    "weight": 0.0,
    "volume": 0.0,
    "goodsName": null,
    "promiseTimeType": 0,          //承诺时效 默认填 0 
    "promiseComplateTime": null,
    "promiseOutStockTime": null,
    "payType": 0,									//支付类型 默认填 0 
    "goodsMoney": 29.00,					//商品价格 
    "shouldPayMoney": 0.0,				//代收货款 默认填 0 
    "needGuarantee": false,
    "guaranteeMoney": 0.0,				//保价 默认填 0.0
    "receiveTimeType": 0,					//收货时间类型  0 任何时间 1 工作日 2 节假日 默认0填0
    "wareHouseCode": null,
    "secondSectionCode": null,
    "thirdSectionCode": null,
    "remark": null,
    "expressPayMethod": null,
    "expressType": null

}
{
 {
    "owner_id": 123456,
    "content":{
    "wayBillType": 1,		
    "wayBillCount": 1,				
    "providerId": 1499,
    "providerCode": "ZTO",				
    "branchCode": "02100",    
    "salePlatform": "0010001",     
    "platformOrderNo": "123454324123", 
    "vendorCode": "121345",		跟	owner_id一样
    "vendorName": "服务市场测试店铺",		
    "vendorOrderCode": "1",				
    "fromAddress": {							
      "provinceId": 110000,   			
      "provinceName": "天津市",			
      "cityId": 110100,						
      "cityName": "天津市",
      "countryId": 110115,
      "countryName": "和平区",
      "countrysideId": 0,
      "countrysideName": "小白楼街道",
      "address": "天津",
      "contact": "孙先生",
      "phone": "13911213312",
      "mobile": "13912132312"
    },
    "toAddress": { 							
      "provinceId": 19,					
      "provinceName": "北京",
      "cityId": 2810,
      "cityName": "北京市",
      "countryId": 51081,
      "countryName": "大兴区",
      "countrysideId": 0,
      "countrysideName": "",
      "address": "京东测试",
      "contact": "GJXtest",
      "phone": "3734317418d14d7829255c9fb30da97b115",  
      "mobile": "3734317418d14d7829255c9fb30d"
    },
    "weight": 0.0,
    "volume": 0.0,
    "goodsName": null,
    "promiseTimeType": 0,         
    "promiseComplateTime": null,
    "promiseOutStockTime": null,
    "payType": 0,							
    "goodsMoney": 29.00,				
    "shouldPayMoney": 0.0,				
    "needGuarantee": false,
    "guaranteeMoney": 0.0,			
    "receiveTimeType": 0,				
    "wareHouseCode": null,
    "secondSectionCode": null,
    "thirdSectionCode": null,
    "remark": null,
    "expressPayMethod": null,
    "expressType": null
    }
}

}

请求代码示例

cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例

响应参数

名称 类型 示例值 描述
resultInfo com.jd.ldop.alpha.waybill.api.dto.waybill.WaybillResponseDTO 处理结果
-statusCode Number 0 结果编码
-statusMessage String 调用成功 结果描述
data com.jd.ldop.alpha.waybill.api.dto.response.WaybillResultDTO 运单号信息
waybillCodeList java.util.List 运单号集合
---- String 11000
-platformOrderNo String 10000 平台订单号
withholding_money int 该接口扣费金额(点券)

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1469,
    "time": 1617270403,
    "data": {
     "withholding_money":4,
"jingdong_ldop_alpha_waybill_receive_response": {
"resultInfo": {
"data": {
"platformOrderNo": "10000",
"waybillCodeList": [
{
"---": "11000"
}
]
},
"statusMessage": "调用成功",
"statusCode": "0"
}
}
}


响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权