全部
电子面单
物流轨迹
物流发货
在线测试
菜鸟通过面单号查看面单信息
接口地址: http://api.vv-tool.com/tool/erps/cnGETwaybillcodeby
接口介绍: 通过面单号查询云打印报文,方便二次打单。
请求方式: POST
返回格式: JSON
接口收费: 联系客服
频率限制: 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请使用新的生成 token 接口 点击查看详情
请求参数
| 参数 | 类型 | 必选 | 描述 |
|---|---|---|---|
| account_id | string | 是 | 面单 id |
| data | object | 是 | 数据 |
| --sellerId | long | true | 取号商家 sellerId |
| --waybillDetailQueryByWaybillCodeRequests | List | true | 面单查询参数列表(上限 10 个) |
| ----waybillDetailQueryByWaybillCodeRequest | object | true | 参数请求实体 |
| ------objectId | string | true | 请求 id,该次请求里多个 objectId 不能重复 |
| ------cpCode | string | true | 快递公司编码 |
| ------waybillCode | string | true | 电子面单单号 |
请求示例
{
"account_id": "123456",
"data": {
"sellerId": "12345678",
"waybillDetailQueryByWaybillCodeRequests": [
{
"cpCode": "ZTO",
"waybillCode": "SL12345667001",
"objectId": "12345678910"
}
]
}
}
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| code | int | 返回状态码 | |
| msg | string | 返回码描述 | |
| msec | int | 接口执行时间 | |
| time | int | 接口返回时间 | |
| data | object | 数据信息 | |
| --success | boolean | true | 是否成功,false 表示失败,true 表示成功 |
| --errorCode | string | true | 错误编码 |
| --errorMessage | string | true | 错误信息描述 |
| --waybillCloudPrintResponse | WaybillCloudPrintResponse | true | 面单信息 |
| ----objectId | string | true | 对应入参中的 objectId |
| ----waybillCode | string | true | 电子面单单号 |
| ----parentWaybillCode | string | true | 快运子母件中的母单号 |
| ----printData | string | true | 面单打印报文 |
| ----extraInfo | string | true | 拓展字段,特殊场景下使用,正常情况不用关注 |
| --withholding_money | int | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1617270403,
"data": [
{
"success":"false",
"errorMessage":"面单号不存在",
"errorCode":"WAYBILL_NOT_FOUNT",
"waybillCloudPrintResponse":{
"parentWaybillCode":"SL12345667",
"waybillCode":"SL12345667001",
"printData":"{
\"data\":{
\"_dataFrom\":\"waybill\"
}
}",
"objectId":"12345678910",
"extraInfo":"{
\"aa\":\"bb\"
}"
}
}
]
}
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |
