全部
电子面单
物流轨迹
物流发货
在线测试
菜鸟电子面单云打印更新接口
接口地址: http://api.vv-tool.com/tool/erps/cnUpdateElectronicSheet
接口介绍: 商家更新电子面单号对应的面单信息。
请求方式: POST
返回格式: JSON
接口收费: 联系客服
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请使用新的生成 token 接口 点击查看详情
请求参数
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
account_id | string | 是 | 面单 id |
data | object | 是 | 数据 |
--cpCode | string | 是 | 物流公司 CODE |
--waybillCode | string | 是 | 面单号 |
--objectId | string | 否 | 请求 ID(只限传入数字、字母和下划线) |
--logisticsServices | string | 否 | 物流服务值 |
--packageInfo | PackageInfoDto | 否 | 包裹信息 |
----items | List |
否 | 商品信息,数量限制为 100 |
------items | Item | 否 | 商品信息 |
--------count | int | 否 | 数量 |
--------name | string | 否 | 名称 |
----volume | long | 否 | 体积, 单位 ml |
----weight | long | 否 | 重量,单位 g |
--recipient | Recipient | 否 | 收件人信息 |
----address | AddressDto | 否 | 发货地址 |
--------city | string | 否 | 城市 |
--------detail | string | 否 | 详细地址 |
--------district | string | 否 | 区 |
--------province | string | 否 | 省 |
--------town | string | 否 | 街道 |
----mobile | string | 否 | 手机号码 |
----name | string | 否 | 姓名 |
----phone | string | 否 | 固定电话 |
--sender | Sender | 否 | 发件人信息 |
----mobile | string | 否 | 手机号码 |
----name | string | 否 | 姓名 |
----phone | string | 否 | 固定电话 |
--templateUrl | string | 否 | 云打印标准模板 URL |
请求示例
{
"account_id": "123456",
"data": {
"cpCode":"POSTB",
"logisticsServices":"json串",
"sender":{
"phone":"057123222",
"mobile":"1326443654",
"name":"Bar"
},
"recipient":{
"address":{
"province":"北京",
"town":"望京街道",
"city":"北京市",
"district":"朝阳区",
"detail":"花家地社区卫生服务站"
},
"phone":"057123222",
"mobile":"1326443654",
"name":"Bar"
},
"waybillCode":"9890000160004",
"packageInfo":{
"volume":"1",
"weight":"1",
"items":[
{
"count":"1",
"name":"衣服"
}
]
},
"objectId":"1",
"templateUrl":"http://cloudprint.cainiao.com/template/standard/101"
},
}
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | int | 返回状态码 | |
msg | string | 返回码描述 | |
msec | int | 接口执行时间 | |
time | int | 接口返回时间 | |
data | object | 数据信息 | |
--data | String | x | 云打印内容 |
--templateURL | String | x | 云打印标准模板 URL |
--withholding_money | int | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1617270403,
"data":{
"withholding_money":1,
"data":"",
"templateURL":"http://cloudprint.cainiao.com/template/standard/101"
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |