全部
淘宝
拼多多
抖音
京东
快手
当当
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 | 未授权店铺 | 根据返回链接进行扫码授权 |