V兔API开放平台

参数	类型	必选	描述
shop_id	string	是	店铺 id
contact_name	string	是	发货人姓名(既可以明文也可以密文)
contact_phone	string	是	发货人手机(既可以明文也可以密文)
waybill_type	string	是	面单类型：1 一联单电子面单类型 1 一联单 2 二联单！
logistics_code	string	是	快递公司编码
order_id_list	string	是	订单号需要出单的订单号，最好带上 A，不带也可以，多个订单用中引文逗号隔开，推荐英文
branch_code	string	是	网店查询接口中网点 code！
platform	string	是	授权渠道 0 抖音，1 拼多多站外电子面单 2 淘宝菜鸟电子面单 3 菜鸟物流云电子面单！从 2021 年 8 月开始，抖店已不支持第三方电子面单
invite_code	string	是	打单软件后台绑定手机号后会自动生成(vvtype 为 1 时 invite_code 必传为 2 请忽略 invite_code)该值可以从取号店铺在打单软件的后台设置 =》账号设置 =》店铺邀请码获取（需绑定手机号方可生成邀请码）
vvtype	int	否	普通版 1，增强版 2，专业版 3，无效数据或则不传默认为 3

请求示例

{
    "access_token1":"dawd***fegf",
    "contact_name":"发货人姓名",
    "contact_phone":"发货人手机",
    "waybill_type":"1",
    "logistics_code":"快递公司编码",
    "order_id_list":"订单号",
    "branch_code":"dda*****geaa",
    "platform":"1"
}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/tool/erps/get-way-bill-plat-sd' \
--header 'Authorization: Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--header 'Cookie: PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=8553bce0fb442de06dee6025f9ea6cdb6731eca27a561ea545213d025e2fa832a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22_oSawXs4iNblqv-G-5mzO3bKquamluJ5%22%3B%7D' \
--data-raw '{
    "access_token1":"dawd***fegf",
    "contact_name":"发货人姓名",
    "contact_phone":"发货人手机",
    "waybill_type":"1",
    "logistics_code":"快递公司编码",
    "order_id_list":"订单号",
    "branch_code":"dda*****geaa",
    "platform":"1"
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/get-way-bill-plat-sd',
  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 =>'{
    "access_token1":"dawd***fegf",
    "contact_name":"发货人姓名",
    "contact_phone":"发货人手机",
    "waybill_type":"1",
    "logistics_code":"快递公司编码",
    "order_id_list":"订单号",
    "branch_code":"dda*****geaa",
    "platform":"1"
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX',
    'Content-Type: application/json',
    'Cookie: PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=8553bce0fb442de06dee6025f9ea6cdb6731eca27a561ea545213d025e2fa832a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22_oSawXs4iNblqv-G-5mzO3bKquamluJ5%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    \"access_token1\":\"dawd***fegf\",\r\n    \"contact_name\":\"发货人姓名\",\r\n    \"contact_phone\":\"发货人手机\",\r\n    \"waybill_type\":\"1\",\r\n    \"logistics_code\":\"快递公司编码\",\r\n    \"order_id_list\":\"订单号\",\r\n    \"branch_code\":\"dda*****geaa\",\r\n    \"platform\":\"1\"\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/get-way-bill-plat-sd")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX")
  .addHeader("Content-Type", "application/json")
  .addHeader("Cookie", "PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=8553bce0fb442de06dee6025f9ea6cdb6731eca27a561ea545213d025e2fa832a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22_oSawXs4iNblqv-G-5mzO3bKquamluJ5%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

Pyton请求代码示例

import requests

url = "http://api.vv-tool.com/tool/erps/get-way-bill-plat-sd"

payload="{\r\n    \"access_token1\":\"dawd***fegf\",\r\n    \"contact_name\":\"发货人姓名\",\r\n    \"contact_phone\":\"发货人手机\",\r\n    \"waybill_type\":\"1\",\r\n    \"logistics_code\":\"快递公司编码\",\r\n    \"order_id_list\":\"订单号\",\r\n    \"branch_code\":\"dda*****geaa\",\r\n    \"platform\":\"1\"\r\n}"
headers = {
  'Authorization': 'Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX',
  'Content-Type': 'application/json',
  'Cookie': 'PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=8553bce0fb442de06dee6025f9ea6cdb6731eca27a561ea545213d025e2fa832a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22_oSawXs4iNblqv-G-5mzO3bKquamluJ5%22%3B%7D'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

响应参数

名称	类型	描述
order_id	string	订单号
waybillCode	string	面单号！
parentWaybillCode	string	父级面单号！
printData	string	打印信息！
code	string	状态：0 失败；1 成功！
err_msg	string	信息提示
withholding_money	int	该接口扣费金额（点券）

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1469,
    "time": 1617270403,
    "data": {
      "0":{
          "order_id": "47509**0A",
          "waybillCode": "777***5778",
          "parentWaybillCode": "",
          "printData": "{\"encryptedData\":\"a67d4819d0cd215********************d425ff963ff617195aab3729f75283d6204f621d882********def1ea9c11e7*****f5e2b7d1953e84dad92f8588d4ea1e7809ab9f2151ee808bc83d5ec*****2be58a542607a68a5a7a31e64e434141**************************a9da9630e2efe12b9\",\"templateUrl\":\"https:\\/\\/file-link.pinduoduo.com\\/sto_one\",\"signature\":\"WnZnc6LeteTsE+XP********************************fBR2s1+xasaKHEmaatHwLgAWQ5ZT5obRcGMWedF\\/coJue6************Xfa6+5bZtQvCE=\",\"ver\":\"3\"}",
          "code": 1,
          "err_msg": ""
      },
    "withholding_money":4
  },
}

响应代码

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