# 获取单号接口(无界电子面单)
接口地址： http://www.damaijia168.com/vv/external/jdwaybillreceive
请求方式： POST
传参方式： JSON
返回格式： JSON
# 请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | 1798c6aadec33d1bc2f5b707f1049aefexxxx |
# 请求参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| owner_id | String | 是 | 店铺 ownerId | |
| content | String | 是 | 参考接口文档 | 报文内容 |
| edition | string | 否 | 版本 默认:1(不传默认为1) 1:1.0,2:2.0 |
# 相关字段补充说明
| 字段名称 | 字段类型 | 字段描述 | 必须 | 示例值 |
|---|---|---|---|---|
| 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请求代码示例
# 响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| data | object | 数据信息 | |
| 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 | 平台订单号 |
| deduct_money | int | 1 | 消耗点券 |
| status | int | 0 | 状态码，0为成功 |
# 返回数据
{
"data": {
"deduct_money":1,
"jingdong_ldop_alpha_waybill_receive_response": {
"resultInfo": {
"data": {
"platformOrderNo": "10000",
"waybillCodeList": [
{
"---": "11000"
}
]
},
"statusMessage": "调用成功",
"statusCode": "0"
}
},
"status": 0
}
}
# 响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |