全部
电子面单
物流轨迹
物流发货
在线测试

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


接口地址: http://api.vv-tool.com/tool/accounts/mdjdwaybillreceive


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


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


请求方式: POST


返回格式: JSON


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


频率限制: 10 次/秒


请求头参数

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

请求参数

名称 类型 必须 示例值 描述
account_id string 面单 id
content String 参考接口文档 报文内容

相关字段补充说明

字段名称 字段类型 字段描述 必须 示例值
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

请求示例

{
 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

}

请求代码示例

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 未授权店铺 根据返回链接进行扫码授权