全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
商家取消获取的电子面单号
接口地址： http://api.vv-tool.com/tool/erps/cainiao-waybill-cancel
接口介绍： 商家取消获取的电子面单号 点击查看详情
必须用户授权 : 需要用户的授权，才能拿到被授权的数据
请求方式： POST
返回格式： JSON
接口收费： 联系运营
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| cp_code | String | 是 | 快递公司 code |
| waybill_code | String | 是 | 电子面单号 |
| shop_id | String | 是 | 店铺 id |
| vvtype | int | 否 | 普通版 1，不传默认 1，增强版 2，增强版的需要传参 2，标准版 3,需要标准版的传 3 |
请求示例
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| cancel_result | Boolean | true | 调用取消是否成功 |
| withholding_money | int | 1 | 该接口扣费金额（点券） |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1460,
"time": 1617273033,
"data": {}
}
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 202 | 系统错误，请稍后再试 | 稍后重试，或者联系对接群 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API 调用次数不足，请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |
| 401 | 身份凭证无效 | 在请求头中添加 access_token，重新更新 token |
| 404 | 请求路径或请求方式错误 | 请更换请求方式或者检查路径是否正确 |
| 614 | 取消面单时，没有对应的订单明细 | 确定入参面单号合法 |
| 614 | 面单已经被揽收，签收或回收 | 检查入参 |
| 614 | 取消次数已经超过预设所允许的次数(超过申请面单的 20%) | 放弃取消 |
| 614 | 取消面单号失败 | 稍后重试 |
| 614 | 当前传入的快递公司编号代表的快递公司取消服务暂不开放 | 检查 cpCode 是否错误，或开通服务 |
| 614 | 面单明细状态异常，可能正在被其他人修改 | 稍等后查询或者再次执行取消操作 |