V兔API开放平台

参数	类型	必选	描述
params	array	是	面单信息列表
--wp_code	string	是	快递简写快递简写列表
--waybill_code	string	是	面单号（快递单号）
--owner_id	string	是	店铺 ownerId
--platform	string	是	授权渠道 1 拼多多站外电子面单 2 淘宝菜鸟电子面单 3 菜鸟物流云电子面单(目前只能选 1)
vvtype	int	否

请求示例

{
    "params": [
        {
            "owner_id": "228897222",
            "wp_code": "YUNDA",
            "waybill_code": "4610105502238",
            "platform": 1
        },
        {
            "owner_id": "228892222",
            "wp_code": "YUNDA",
            "waybill_code": "4610105502238",
            "platform": 1
        }
    ]
}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/tool/erps/ks-cancel-waybill' \
--header 'Authorization: Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--header 'Cookie: PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=bbfd2eabf5b3920db30ec1841da280fc0dbbd20bb47606fb70dc59589bdb7028a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22e2Mj-LP98Vt2gauxRmXNjUi7wgUvNCzU%22%3B%7D' \
--data-raw '{
   "params": [
    {
        "wp_code": "STO",
        "waybill_code": "面单号",
        "owner_id": "店铺 ownerId"
    },
    {
        "wp_code": "YTO",
        "waybill_code": "面单号",
        "owner_id": "店铺 ownerId"
    }
]
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/ks-cancel-waybill',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
   "params": [
    {
        "wp_code": "STO",
        "waybill_code": "面单号",
        "owner_id": "店铺 ownerId"
    },
    {
        "wp_code": "YTO",
        "waybill_code": "面单号",
        "owner_id": "店铺 ownerId"
    }
]
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX',
    'Content-Type: application/json',
    'Cookie: PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=bbfd2eabf5b3920db30ec1841da280fc0dbbd20bb47606fb70dc59589bdb7028a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22e2Mj-LP98Vt2gauxRmXNjUi7wgUvNCzU%22%3B%7D'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n   \"params\": [\r\n    {\r\n        \"wp_code\": \"STO\",\r\n        \"waybill_code\": \"面单号\",\r\n        \"owner_id\": \"店铺 ownerId\"\r\n    },\r\n    {\r\n        \"wp_code\": \"YTO\",\r\n        \"waybill_code\": \"面单号\",\r\n        \"owner_id\": \"店铺 ownerId\"\r\n    }\r\n]\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/ks-cancel-waybill")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX")
  .addHeader("Content-Type", "application/json")
  .addHeader("Cookie", "PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=bbfd2eabf5b3920db30ec1841da280fc0dbbd20bb47606fb70dc59589bdb7028a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22e2Mj-LP98Vt2gauxRmXNjUi7wgUvNCzU%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

名称	类型	示例值	描述
code	string		状态：0 失败； 1 成功
error_msg	string		错误内容
wp_code	string	STO	快递编号
order_sn	string		订单信息
waybill_code	string		面单号（快递单号）
withholding_money	int		该接口扣费金额（点券）

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1550,
    "time": 1631529908,
    "data": {
        "result": [
            {
                "waybill_code": "4610105502238",
                "wp_code": "YUNDA",
                "code": 1,
                "error_msg": null
            },
            {
                "waybill_code": "4610105502238",
                "wp_code": "YUNDA",
                "code": 0,
                "error_msg": "面单已取消"
            }
        ],
        "withholding_money": 2
    }
}

响应代码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
103	旺旺账号不存在	检查您输入的旺旺号是否正确
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
202	系统错误，请稍后再试	稍后重试，或者联系对接群
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API 调用次数不足，请前往网站兑换次数。	前往官网充值该接口调用次数
302	未授权店铺	根据返回链接进行扫码授权