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

菜鸟通过面单号查看面单信息


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