V兔API开放平台

参数	类型	必选	描述
owner_id	string	是	店铺 ownerId
sender_name	string	是	发货人姓名
sender_mobile	string	是	发货人手机
province	string	是	发货省
city	string	是	发货市
district	string	是	区
detail	string	是	发货地详细地址
wp_code	string	是	快递简写快递简写列表,
waybill_type	string	是	面单类型 1：一联单，2：二联单，3：其他
shop_code	string	是	订购软件里的店铺关联码(账号设置-店铺关联码) 增强版可不传
order_sn_list[]	string	是	订单号索引数组["201117-68182136402308", "201117-431312312902308"],数组里每有一个订单，便请求一次打单，扣费是按订单数量来算
vvtype	INT	false	增强版 1，不传默认 1，普通版 2

请求示例

{
"owner_id": "228812133",
"sender_name": "啊啊",
"sender_mobile": "123144213",
"province": "河南省",
"city": "郑州市",
"district": "中牟县",
"detail": "河南省郑州市中牟县九 XXXXXXXXXX",
"wp_code": "YUNDA",
"waybill_type": "1",
"shop_code": "34234234",
"order_sn_list": [
"211129-3214123214123"
]
}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/tool/erps/platform-the-single' \
--header 'Authorization: Bearer 09bfa1fde79fb89cXXXXXXXXXXXXXXXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--header 'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=7ac3afd6f2a8ac810e49dfff5adc0f69; _csrf=2faeb80016ecf13f8f130c21d06d63b2a43ef6f93d6669f7cf79a58a1e98cc1ba%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22WkTXj27oaOeUulFY8lO7yxnzg0BUV_aG%22%3B%7D' \
--data-raw '{
    "owner_id": "1233213123",
    "sender_name": "啊啊",
    "sender_mobile": "321312321312",
    "province": "河南省",
    "city": "郑州市",
    "district": "中牟县",
    "detail": "河南省郑州市中牟县九xxxxxxxxxxxxxxxxxxx",
    "wp_code": "YUNDA",
    "waybill_type": "1",
    "shop_code": "34234234",
    "order_sn_list": [
        "211129-3214123214123"
    ]
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/platform-the-single',
  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": "312312312",
    "sender_name": "啊啊",
    "sender_mobile": "1231312423213",
    "province": "河南省",
    "city": "郑州市",
    "district": "中牟县",
    "detail": "河南省郑州市中牟县九XXXXXXXXXXXXXX",
    "wp_code": "YUNDA",
    "waybill_type": "1",
    "shop_code": "34234234",
    "order_sn_list": [
        "211129-312423123213"
    ]
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 09bfa1fde79fxxxxxxxxxxxxxxxxxxx',
    'Content-Type: application/json',
    'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=7ac3afd6f2a8ac810e49dfff5adc0f69; _csrf=2faeb80016ecf13f8f130c21d06d63b2a43ef6f93d6669f7cf79a58a1e98cc1ba%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22WkTXj27oaOeUulFY8lO7yxnzg0BUV_aG%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\": \"228897764\",\r\n    \"sender_name\": \"嗷嗷嗷\",\r\n    \"sender_mobile\": \"312321321\",\r\n    \"province\": \"河南省\",\r\n    \"city\": \"郑州市\",\r\n    \"district\": \"中牟县\",\r\n    \"detail\": \"河南省郑州市XXXXXXXXXXXXXXXXX\",\r\n    \"wp_code\": \"YUNDA\",\r\n    \"waybill_type\": \"1\",\r\n    \"shop_code\": \"34234234\",\r\n    \"order_sn_list\": [\r\n        \"211129-312321321321\"\r\n    ]\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/platform-the-single")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 09bfa1fde79fb89xxxxxxxxxxxxxxxxxxxxxxxxx")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

响应参数

参数	类型	描述
data	object	返回数据
--order_sn	string	订单号
--object_id	string	任务 id
--print_data	string	打印信息
--waybill_code	string	面单号
--parent_waybill_code	string	父订单面单号
--code	string	状态：0 失败； 1 成功
--error_msg	string	错误信息
--withholding_money	int

返回数据

{
  "data":  {
          "orderSn": "订单号",
          "objectId": null,
          "printData": "打印信息",
          "waybillCode": "面单号",
          "parentWaybillCode": null,
          "code": 1,
          "errorMsg": null,
        "withholding_money":4
      
      }
}

响应代码

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