V兔API开放平台

参数	类型	必选	描述
owner_id	string	是	店铺 ownerId
order_sn	string	是	自定义订单号，自行定义规则生成，8 以上即可
sender_name	string	是	发货人姓名
sender_mobile	string	是	发货人手机
sender_province	string	是	发货省
sender_city	string	是	发货市
sender_town	string	是	区
sender_detail	string	是	发货地详细地址
wp_code	string	是	快递简写快递简写列表,
waybill_type	string	是	面单类型 1：一联单，2：二联单，3：其他！
shopCode	string	是	订购软件里的店铺关联码(账号设置-店铺关联码) 增强版可不传
receiver_province	string	是	收件省
receiver_city	string	是	收件市
receiver_town	string	是	收件县区
receiver_address	string	是	收件地址
receiver_phone	string	是	收件电话
receiver_name	string	是	收件人
vvtype	INT	false	增强版 1，不传默认 1，普通版 2

请求示例

"owner_id": "123123",
"sender_name": "发件人姓名",
"order_sn": "自定义订单号",
"sender_phone": "发件人手机号",
"sender_province": "发件人所在省",
"sender_city": "发件人所在市",
"sender_town": "发件人所在县/区",
"sender_detail": "发件人具体地址（不拼接省市区）",
"receiver_name": "收件人姓名",
"receiver_phone": "收件人手机号",
"receiver_province": "收件人所在省",
"receiver_city": "收件人所在市",
"receiver_town": "收件人所在县/区",
"receiver_address": "收件人具体地址（不拼接省市区）",
"wp_code": "快递公司编码",
"waybill_type": "1",
"shopCode": "ffs"

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/tool/erps/getwaybillfreewn' \
--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 '{
    "owner_id": "123123",
    "sender_name": "发件人姓名",
    "sender_phone": "发件人手机号",
    "order_sn": "自定义订单号",
    "sender_province": "发件人所在省",
    "sender_city": "发件人所在市",
    "sender_town": "发件人所在县/区",
    "sender_detail": "发件人具体地址（不拼接省市区）",
    "receiver_name": "收件人姓名",
    "receiver_phone": "收件人手机号",
    "receiver_province": "收件人所在省",
    "receiver_city": "收件人所在市",
    "receiver_town": "收件人所在县/区",
    "receiver_address": "收件人具体地址（不拼接省市区）",
    "wp_code": "快递公司编码",
    "waybill_type": "1",
    "shopCode": "ffs"
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/getwaybillfreewn',
  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 =>'{
    "owner_id": "123123",
    "sender_name": "发件人姓名",
    "sender_phone": "发件人手机号",
    "order_sn": "自定义订单号",
    "sender_province": "发件人所在省",
    "sender_city": "发件人所在市",
    "sender_town": "发件人所在县/区",
    "sender_detail": "发件人具体地址（不拼接省市区）",
    "receiver_name": "收件人姓名",
    "receiver_phone": "收件人手机号",
    "receiver_province": "收件人所在省",
    "receiver_city": "收件人所在市",
    "receiver_town": "收件人所在县/区",
    "receiver_address": "收件人具体地址（不拼接省市区）",
    "wp_code": "快递公司编码",
    "waybill_type": "1",
    "shopCode": "ffs"
}',
  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    \"owner_id\": \"123123\",\r\n    \"sender_name\": \"发件人姓名\",\r\n    \"sender_phone\": \"发件人手机号\",\r\n    \"sender_province\": \"发件人所在省\",\r\n    \"sender_city\": \"发件人所在市\",\r\n    \"sender_town\": \"发件人所在县/区\",\r\n    \"sender_detail\": \"发件人具体地址（不拼接省市区）\",\r\n    \"receiver_name\": \"收件人姓名\",\r\n    \"receiver_phone\": \"收件人手机号\",\r\n    \"receiver_province\": \"收件人所在省\",\r\n    \"receiver_city\": \"收件人所在市\",\r\n    \"receiver_town\": \"收件人所在县/区\",\r\n    \"receiver_address\": \"收件人具体地址（不拼接省市区）\",\r\n    \"wp_code\": \"快递公司编码\",\r\n    \"waybill_type\": \"1\",\r\n    \"shopCode\": \"ffs\"\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/getwaybillfreewn")
  .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();

响应参数

名称	类型	描述
orderSn	string	订单号
objectId	string	任务 id
printData	string	打印信息
waybillCode	string	面单号
parentWaybillCode	string	父订单面单号
code	string	状态： 1 成功； 0 失败
errorMsg	string	错误信息
withholding_money	int	该接口扣费金额（点券）

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1469,
    "time": 1617270403,
    "data": {
      "withholding_money":1,
      "orderSn": null,
          "objectId": "123131320437457920",
          "printData": "", 
          "waybillCode": "2121312131", 
          "parentWaybillCode": null,
          "code": 1, 
          "errorMsg": null
  }
}

响应代码

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