全部
电子面单
物流轨迹
物流发货
在线测试

v 兔商城接口包含:

第一步:获取仓库信息

第二步:获取商品列表

第三步:获取商品信息

第四步:创建订单

第五步:提交支付

第六步:提交支付获取包裹列表(获取快递单号)

订单信息查询订单取消发货查询账户余额包裹状态信息回调(包裹状态发生变动)


token介绍: 如何获取 token接口文档 点击查看详情

获取仓库列表

接口介绍:

第一步:获取仓库详细信息 点击查看详情


接口地址: http://api.vv-tool.com/shop/apis/list-warehouse


请求方式: POST


返回格式: JSON


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

无请求参数

响应参数

参数 类型 描述
code int 状态(0 为成功)
msg string 返回数据
msec int 运行时间
time string 创建时间
data array 返回数据
warehouse_idid int 仓库 id
warehouse_name string 仓库名称
api_price int 快递价格 (单位是点券,1 点券 =1 分)
address string 发货地
--forbidSend string 仓库禁发地信息,仓库不支持的收件地区
---–district string 禁发城市
---–startTime string 禁发开始时间
---–endTime string 禁发结束时间

返回数据


{
    "code": 0,
    "msg": "成功",
    "msec": 559,
    "time": 1614339301,
    "data": [
        {
            "warehouse_id": "23",
            "warehouse_name": "广东仓",
            "api_price": "170",
            "address": "广州市",
            "forbidSend": [{
                    "district": [
                        "北京市"
                    ],
                    "startTime": "2021-08-01 00:00:00",
                    "endTime": "2021-09-14 00:00:00"
                },
                {
                    "district": [
                        "黑龙江省/伊春市"
                    ],
                    "startTime": "2021-08-01 00:00:00",
                    "endTime": "2021-09-14 00:00:00"
                }
								]
        },
        {
            "warehouse_id": "29",
            "warehouse_name": "圆通泉州自提仓",
            "api_price": "90",
            "address": "泉州",
            "forbidSend": [
                {
                    "district": [
                        "北京市"
                    ],
                    "startTime": "2021-08-01 00:00:00",
                    "endTime": "2021-09-06 00:00:00"
                }
            ]
        }
        }

获取商品列表


接口地址: http://api.vv-tool.com/shop/apis/get-product-list


接口介绍:

第二步:获取所有商品信息包含商品图片、标题、价格 点击查看详情


请求方式: POST


传参方式: JSON


返回格式: JSON


接口收费: 商品价格 + 快递价格,以接口获取的快递价格和商品价格为准


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

参数 类型 必选 描述
range array 页码(前面是第几页,后面是一页有多少条 不传默认返回全部)

请求示例


{
  "range":[2,10]
}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/shop/apis/get-product-list' \
--header 'Authorization: Bearer a5a85097d0b201acca91945b0baccxxxxxxx' \
--header 'Content-Type: application/json' \
--header 'Cookie: PHPSESSID=4gpm5pvc59v3ccf9peco4emot8; _csrf=801a9fb79f2527be47f5285745160486a9f4bfa995f54619358e0feca8c177f3a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22BhHvtTfJYjUXYv5whtwTgXVonKhYq8cV%22%3B%7D' \
--data-raw '{
    "range":[2,10]
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/shop/apis/get-product-list',
  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 =>'{
    "range":[2,10]
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer a5a85097d0b201acca91945b0bacc2xxxxxxxx',
    'Content-Type: application/json',
    'Cookie: PHPSESSID=4gpm5pvc59v3ccf9peco4emot8; _csrf=801a9fb79f2527be47f5285745160486a9f4bfa995f54619358e0feca8c177f3a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22BhHvtTfJYjUXYv5whtwTgXVonKhYq8cV%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    \"range\":[2,10]\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/shop/apis/get-product-list")
  .method("POST", body)
  .addHeader("Authorization", "Bearer a5a85097d0b201acca91945b0bacc2cxxxxxxxx")
  .addHeader("Content-Type", "application/json")
  .addHeader("Cookie", "PHPSESSID=4gpm5pvc59v3ccf9peco4emot8; _csrf=801a9fb79f2527be47f5285745160486a9f4bfa995f54619358e0feca8c177f3a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22BhHvtTfJYjUXYv5whtwTgXVonKhYq8cV%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

参数 类型 描述
code int 返回状态码
msg string 状态码描述
msec int 执行时间
time int 结果返回时间
data object 返回结果数据
list object 结果集合
status string 商品状态
sale_price int 商品售价(元)
warehouse_name string 仓库名称
shipping_fee int 运费
id string 商品 id
othumb string 商品缩略图
product_name string 商品名字
warehouse_id int 仓库 id
weight int 重量
stock int 库存
sales int 销量
total int 平台商品数据总数
signing_method string 签收方式 1 买家签收 2 站点签收 3 快递员签收 4 其他

返回数据


{
    "code": 0,
    "msg": "成功",
    "msec": 1407,
    "time": 1626921534,
    "data": {
        "list": [
            {
                "status": 1,
                "sale_price": 0.78,
                "id": 50077,
                "weight": 150,
                "othumb": "http://image2.vv-tool.com/2021/03/02/04/03/11/43100.jpg",
                "product_name": "",
                "stock": 2476,
                "sales": 8538,
                "province_code": 440000,
                "signing_method": 1,
                "shipping_fee": 192,
                "warehouse_id": 13,
                "warehouse_name": "申通广东仓"
            },
            {
                "status": 1,
                "sale_price": 0.33,
                "id": 50076,
                "weight": 100,
                "othumb": "http://image2.vv-tool.com/2021/02/22/05/02/51/59204.jpeg",
                "product_name": "",
                "stock": 10330,
                "sales": 8879,
                "province_code": 440000,
                "signing_method": 1,
                "shipping_fee": 192,
                "warehouse_id": 13,
                "warehouse_name": "申通广东仓"
            },
            {
                "status": 1,
                "sale_price": 0.33,
                "id": 50075,
                "weight": 50,
                "othumb": "http://image2.vv-tool.com/2021/02/22/05/02/10/97540.jpeg",
                "product_name": "",
                "stock": 11553,
                "sales": 1470,
                "province_code": 440000,
                "signing_method": 1,
                "shipping_fee": 192,
                "warehouse_id": 13,
                "warehouse_name": "申通广东仓"
            }
              ],
                "total": 52
    }
}

获取商品信息


接口地址: http://api.vv-tool.com/shop/apis/get-shop-info


接口介绍:

第三步:获取所有商品信息包含商品图片、标题、价格 点击查看详情


请求方式: POST


传参方式: JSON


返回格式: JSON


接口收费: 商品价格 + 快递价格,以接口获取的快递价格和商品价格为准


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

参数 类型 必选 描述
id int 商品 id

请求示例


{
  "id":49066
}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/shop/apis/get-shop-info' \
--header 'Authorization: Bearer 3a49bae7ea6178d0c157c900f088889xxxxxxx' \
--header 'Cookie: PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=7a5a79f08a467ec5abdf7eb94cce47fadeaa6b326179cf4da83e373ae32b93aea%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22TNIzBvdq42pEZWf4eZlR7TUqFtf43LTq%22%3B%7D' \
--form 'id=49066'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "http://api.vv-tool.com/shop/apis/get-shop-info",
  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 => array('id' => '49066'),
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer 3a49bae7ea6178d0c157c900f0888890c4xxxxxxx",
    "Cookie: PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=7a5a79f08a467ec5abdf7eb94cce47fadeaa6b326179cf4da83e373ae32b93aea%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22TNIzBvdq42pEZWf4eZlR7TUqFtf43LTq%22%3B%7D"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;


JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("id", "49066")
  .build();
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/shop/apis/get-shop-info")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 3a49bae7ea6178d0c157c900f08888xxxxxxx")
  .addHeader("Cookie", "PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=7a5a79f08a467ec5abdf7eb94cce47fadeaa6b326179cf4da83e373ae32b93aea%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22TNIzBvdq42pEZWf4eZlR7TUqFtf43LTq%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

参数 类型 描述
code int 返回状态码
msg string 状态码描述
msec int 执行时间
time int 结果返回时间
data object 返回结果数据
id string 商品 id
name string 商品名称
sale_price int 售价(元)
stock int 库存
weight string 重量
sales string 销量
othumb string 商品缩略图
create_time string 创建时间
status string 状态
ext_warehouse_id string 仓库 id
alias_name string 仓库别名
shipping_fee string 运费
user_source string 来源 taobao:淘宝 tmall:天猫 jd:京东 pdd:拼多多 other:其他
signing_method string 签收方式 1 买家签收 2 站点签收 3 快递员签收 4 其他

返回数据


{
    "code": 0,
    "msg": "成功",
    "msec": 265,
    "time": 1605096998,
    "data": {
        "id": "28",
        "name": "丝滑纸巾",
        "sale_price": 0.6,
        "weight": "5",
        "sales": "967",
        "othumb": "http://image.damaijia168.com/2020/10/30/12/10/32/98644.jpg",
        "create_time": "2020-10-30 10:46:13",
        "status": "1",
        "stock": "88888",
        "ext_warehouse_id": "2",
        "alias_name": "申通广州仓",
				"shipping_fee": "185",
        "user_source": "taobao“,
				"signing_method": "1"
    }
}

创建订单


接口地址: http://api.vv-tool.com/shop/apis/order-create


接口介绍:

第四步:选择礼品、发货仓库、发货快递、收货人等信息创建礼品订单 点击查看详情


请求方式: POST


传参方式: JSON


返回格式: JSON


接口收费: 商品价格 + 快递价格,以接口获取的快递价格和商品价格为准


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

参数 类型 必选 描述
product_id number 礼品 ID
warehouse_id number 仓库 ID
product_number number 下单数量不传默认是 1
remark string 备注,你自己平台的订单号
consignees array[] 收货人信息
consignee string 收货人
mobile string 手机号
province string 省份
city string
district string
address string 具体地址
platform_order_sn string 第三方平台订单号 vvtype 为 2 一定要传正确的,错误导致出单失败
source string 来源 taobao:淘宝 tmall:天猫 jd:京东 pdd:拼多多 albb(阿里巴巴),ks(快手小店)dyxd(抖音小店) other:其他
shop_id string 店铺 ID,店铺已经给授权 erp 软件
vvtype int 收货人明文版 1,不传默认 1,收货人脱敏数据(密文)版 2,收货人脱敏数据的需要传参 2

请求示例

{
  "product_id":11,
  "warehouse_id":23,
  "product_number":2,
  "remark": "测试",
  "consignees": [
    {
      "consignee": "马云",
      "mobile": "15568822288",
      "province": "浙江",
      "city": "杭州",
      "district": "余杭区",
      "address": "梦想小镇",
      "platform_order_sn": "8980809890809809"
    }
  ],
  "source": "tmall"
}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/shop/apis/order-create' \
--header 'Authorization: Bearer 3a49bae7ea6178d0c157c900f0888890xxxxxxxx' \
--header 'Content-Type: application/json' \
--header 'Cookie: PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=4bf8598859da8bb0a881f1a1b1acc097bd60baca033eba3d1aa5b75b9c0354aca%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22bDQ8vnNR19WjkKFYqLm6Xz1-vIt-0GfQ%22%3B%7D' \
--data-raw '  {
  "product_id":49066,
  "warehouse_id":23,
  "product_number":2,
  "remark": "测试",
  "consignees": [
    {
      "consignee": "马云",
      "mobile": "15568822288",
      "province": "浙江",
      "city": "杭州",
      "district": "余杭区",
      "address": "梦想小镇",
      "platform_order_sn": "8980809890809809"
    }
  ],
  "source":"tmall"
  }'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "http://api.vv-tool.com/shop/apis/order-create",
  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 =>"  {\r\n  \"product_id\":49066,\r\n  \"warehouse_id\":23,\r\n  \"product_number\":2,\r\n  \"remark\": \"测试\",\r\n  \"consignees\": [\r\n    {\r\n      \"consignee\": \"马云\",\r\n      \"mobile\": \"15568822288\",\r\n      \"province\": \"浙江\",\r\n      \"city\": \"杭州\",\r\n      \"district\": \"余杭区\",\r\n      \"address\": \"梦想小镇\",\r\n      \"platform_order_sn\": \"8980809890809809\"\r\n    }\r\n  ],\r\n  \"source\":\"tmall\"\r\n  }",
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer 3a49bae7ea6178d0c157c900f08888xxxxxxxx",
    "Content-Type: application/json",
    "Cookie: PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=4bf8598859da8bb0a881f1a1b1acc097bd60baca033eba3d1aa5b75b9c0354aca%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22bDQ8vnNR19WjkKFYqLm6Xz1-vIt-0GfQ%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  \"product_id\":49066,\r\n  \"warehouse_id\":23,\r\n  \"product_number\":2,\r\n  \"remark\": \"测试\",\r\n  \"consignees\": [\r\n    {\r\n      \"consignee\": \"马云\",\r\n      \"mobile\": \"15568822288\",\r\n      \"province\": \"浙江\",\r\n      \"city\": \"杭州\",\r\n      \"district\": \"余杭区\",\r\n      \"address\": \"梦想小镇\",\r\n      \"platform_order_sn\": \"8980809890809809\"\r\n    }\r\n  ],\r\n  \"source\":\"tmall\"\r\n  }");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/shop/apis/order-create")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 3a49bae7ea6178d0c157c900f088889xxxxxxxx")
  .addHeader("Content-Type", "application/json")
  .addHeader("Cookie", "PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=4bf8598859da8bb0a881f1a1b1acc097bd60baca033eba3d1aa5b75b9c0354aca%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22bDQ8vnNR19WjkKFYqLm6Xz1-vIt-0GfQ%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

参数 类型 描述
code int 返回状态码
msg string 状态码描述
msec int 执行时间
time int 结果返回时间
data object 结果返回信息
product object 商品信息
product_name string 商品名称
product_number int 商品数量
product_price string 商品价格
product_weight int 商品重量
total_price int 每个包裹商品总价
order object 订单信息
order_id int 订单 id
order_sn int 订单编号
total_count int 总数量
total_freight_number int 总件数
total_freight_price int 总包裹费用(点券)
total_product_price int 总商品费用(点券)
total_price int 总计费用(点券)

返回数据


{
    "code": 0,
    "msg": "成功",
    "msec": 697,
    "time": 1604036515,
    "data": {
        "product": {
            "product_name": "双齿梳",
            "product_number": 11,
            "product_price": "10",
            "product_weight": 10,
            "total_price": 110
        },
        "order": {
            "order_id": 375,
						"order_sn": "202104101104381809778",
            "total_count": 22,
            "total_freight_number": 2,
            "total_freight_price": 200,
            "total_product_price": 220,
            "total_price": 420
        }
    }
}

提交支付


接口地址: http://api.vv-tool.com/shop/apis/submit-payment


接口介绍:

第五步:创建订单提交支付 点击查看详情


请求方式: POST


传参方式: JSON


返回格式: JSON


接口收费: 商品价格 + 快递价格,以接口获取的快递价格和商品价格为准


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

参数 类型 必选 描述
order_id int 订单 id

请求示例

order_id:262

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/shop/apis/submit-payment' \
--header 'Authorization: Bearer 3cbde68532493d72fa2bc3c715e37d7xxxxxxxx' \
--header 'Content-Type: application/json' \
--header 'Cookie: PHPSESSID=jr3bo6bqn5l3408daruih71889; _csrf=0ec6b3747a02a68b820e885ec9ad3132958030765c3e4a5d9f9e14467f7d9c44a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22p-Gi402KnkFy_yglJIxcpKffprVJUVpK%22%3B%7D' \
--data-raw '{
    "order_id":262
}'


PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "http://api.vv-tool.com/shop/apis/submit-payment",
  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 =>"{\r\n    \"order_id\":262\r\n}",
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer 3cbde68532493d72fa2bc3c715e37dxxxxxxxx",
    "Content-Type: application/json",
    "Cookie: PHPSESSID=jr3bo6bqn5l3408daruih71889; _csrf=0ec6b3747a02a68b820e885ec9ad3132958030765c3e4a5d9f9e14467f7d9c44a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22p-Gi402KnkFy_yglJIxcpKffprVJUVpK%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   \"order_id\":262\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/shop/apis/submit-payment")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 3cbde68532493d72fa2bc3c715e37d7xxxxxxxx")
  .addHeader("Content-Type", "application/json")
  .addHeader("Cookie", "PHPSESSID=jr3bo6bqn5l3408daruih71889; _csrf=0ec6b3747a02a68b820e885ec9ad3132958030765c3e4a5d9f9e14467f7d9c44a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22p-Gi402KnkFy_yglJIxcpKffprVJUVpK%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

参数 类型 描述
code int 返回状态码(0 为成功,302 余额不足)
msg string 状态码描述
msec int 执行时间
time int 结果返回时间
data object 返回结果信息

返回数据

{
    "code": 0,
    "msg": "支付成功",
    "msec": 924,
    "time": 1603709388,
    "data": []
}
{
{
    "code": 302,
    "msg": "点券余额不足",
    "msec": 333,
    "time": 1614390512,
    "data": []
}}

订单列表查询


接口地址: http://api.vv-tool.com/shop/apis/get-order-list


接口介绍: 查询礼品订单信息 点击查看详情


请求方式: POST


传参方式: JSON


返回格式: JSON


接口收费: 商品价格 + 快递价格,以接口获取的快递价格和商品价格为准


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

参数 类型 必选 描述
range int 页码(前面是第几页,后面是一页有多少条 不传默认返回全部)
filter object 筛选条件
source string 来源 taobao:淘宝 tmall:天猫 dj:京东 pdd:拼多多 other:其他 通过来源条件查询
order_sn string 订单编号 通过编号条件查询
条件筛选任意选择 上面页码 来源 订单编号

请求示例

{
  "filter": {
      "order_sn":"202010231510481946975",
      "source":"pdd"
  },
  "range":[2,10]
}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/shop/apis/get-order-list' \
--header 'Authorization: Bearer 3a49bae7ea6178d0c157c900f0888890xxxxxxx' \
--header 'Content-Type: application/json' \
--header 'Cookie: PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=9d3c6a5331c548a3cba3122060588e603705ca7fd1da5ddc450ccf5c1cf5c58aa%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22P08bqLPu5-LHxGPjsGLDGem02jhywBUx%22%3B%7D' \
--data-raw '{
  "filter": {
      "order_sn":"202010231510481946975"
  },
  "range":[2,10]
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "http://api.vv-tool.com/shop/apis/get-order-list",
  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 =>"{\r\n  \"filter\": {\r\n      \"order_sn\":\"202010231510481946975\"\r\n  },\r\n  \"range\": [2,10]\r\n}",
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer 3a49bae7ea6178d0c157c900f08888xxxxxxxx",
    "Content-Type: application/json",
    "Cookie: PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=9d3c6a5331c548a3cba3122060588e603705ca7fd1da5ddc450ccf5c1cf5c58aa%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22P08bqLPu5-LHxGPjsGLDGem02jhywBUx%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  \"filter\": {\r\n      \"order_sn\":\"202010231510481946975\"\r\n  },\r\n  \"range\": [2,10]\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/shop/apis/get-order-list")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 3a49bae7ea6178d0c157c900f088889xxxxxxxx")
  .addHeader("Content-Type", "application/json")
  .addHeader("Cookie", "PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=9d3c6a5331c548a3cba3122060588e603705ca7fd1da5ddc450ccf5c1cf5c58aa%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22P08bqLPu5-LHxGPjsGLDGem02jhywBUx%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

参数 类型 描述
code int 返回状态码
msg string 状态码描述
msec int 执行时间
time int 结果返回时间
data object 结果数据
alias_name string 仓库别名
id int 包裹 id
order_sn string 订单编号
page_number int 包裹数
source string 来源 taobao:淘宝 tmall:天猫 jd:京东 pdd:拼多多 other:其他
remark string 备注
create_time string 创建时间
name string 商品名称
total_price string 总价
status string 状态 1:待付款 2:待发货 3:已发货 4:取消发货
total string 订单总数量

返回数据


{
    "code": 0,
    "msg": "成功",
    "msec": 106,
    "time": 1604473515,
    "data": {
        "list": [
            {
                "alias_name": "邮政黄山仓",
                "id": "466",
                "order_sn": "202011041511461997011",
                "page_number": "1",
                "source": "taobao",
                "remark": "222",
                "create_time": "2020-11-04 15:04:46",
                "name": "钢丝球",
                "total_price": "216",
                "status": "1"
            }
        ],
        "total": "1"
    }
}

获取包裹列表


接口地址: http://api.vv-tool.com/shop/apis/get-package-list


接口介绍: 获取订单对应的多个收货人包裹及快递等信息 点击查看详情


请求方式: POST


传参方式: JSON


返回格式: JSON


接口收费: 商品价格 + 快递价格,以接口获取的快递价格和商品价格为准


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

参数 类型 必选 描述
filter object 筛选条件
mobile int 收货人手机号码
order_sn string 订单编号
status string 状态 1:待付款 2:待发货 3:已发货 4:取消发货
range int 页码(前面是第几页,后面是一页有多少条 不传默认返回全部)
条件筛选任意选择 上面页码 状态 收货人手机号码 订单编号

请求示例


{
  
  "filter": {
   
  },
  "range":[2,10]
}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/shop/apis/get-package-list' \
--header 'Authorization: Bearer 3a49bae7ea6178d0c157c900f0888890xxxxxxxx' \
--header 'Content-Type: application/json' \
--header 'Cookie: PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=0f2e67738b52af7f4633b5ca4b009a305d60d2751c81d3c119b56ddb0b30203fa%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%228X_So9yASOmSp1BJ5tSG5IDVL-VmT7fM%22%3B%7D' \
--data-raw '{
  
  "filter": {
   
  },
  "range":[2,10]
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "http://api.vv-tool.com/shop/apis/get-package-list",
  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 =>"{\r\n  \r\n  \"filter\": {\r\n   \r\n  },\r\n  \"range\":[2,10]\r\n}",
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer 3a49bae7ea6178d0c157c900f0888890xxxxxx",
    "Content-Type: application/json",
    "Cookie: PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=0f2e67738b52af7f4633b5ca4b009a305d60d2751c81d3c119b56ddb0b30203fa%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%228X_So9yASOmSp1BJ5tSG5IDVL-VmT7fM%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  \r\n  \"filter\": {\r\n   \r\n  },\r\n  \"range\":[2,10]\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/shop/apis/get-package-list")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 3a49bae7ea6178d0c157c900f088889xxxxxxxx")
  .addHeader("Content-Type", "application/json")
  .addHeader("Cookie", "PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=0f2e67738b52af7f4633b5ca4b009a305d60d2751c81d3c119b56ddb0b30203fa%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%228X_So9yASOmSp1BJ5tSG5IDVL-VmT7fM%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

参数 类型 描述
code int 返回状态码
msg string 状态码描述
msec int 执行时间
time int 结果返回时间
data object 结果返回数据
list object 结果集合
id int 包裹 id
product_name string 商品名称
product_weight int 商品重量
order_id string 订单 id
package_total_price string 包裹总价格
create_time string 创建时间
update_time string 更新时间
shipping_fee int 运费
product_number string 商品数量
consignee string 收货人
mobile string 手机号
province string 省份
city string
district string
address string 具体地址
ext_platform_order_sn stirng 第三方订单编号
additional string 额外信息
status string 包裹状态:1:待付款 2:待发货 3:已发货 4:取消发货
order_sn string 订单编号
sale_price string 售价(点券)
express_no string 快递单号
express_company_name string 物流公司
total int 包裹数据总数

返回数据


{
    "code": 0,
    "msg": "成功",
    "msec": 287,
    "time": 1604571036,
    "data": {
        "list": [
            {
                "id": "10",
                "product_weight": "5",
                "product_name": "丝滑纸巾",
                "order_id": "8",
                "package_total_price": "195",
                "create_time": "2020-11-05 18:10:03",
                "update_time": null,
                "shipping_fee": "135",
                "product_number": "1",
                "consignee": "张三1",
                "mobile": "15568821111",
                "province": "浙江",
                "city": "杭州",
                "district": "余杭",
                "address": "余杭街道",
                "ext_platform_order_sn": "111111",
                "additional": null,
                "status": "2",
                "order_sn": "202011051811030069452",
                "sale_price": "60",
                "express_no": null,
                "express_company_name": null
            },
            {
                "id": "9",
                "product_weight": "5",
                "product_name": "丝滑纸巾",
                "order_id": "7",
                "package_total_price": "255",
                "create_time": "2020-11-05 17:46:28",
                "update_time": null,
                "shipping_fee": "135",
                "product_number": "2",
                "consignee": "张三1",
                "mobile": "15568821111",
                "province": "浙江",
                "city": "杭州",
                "district": "余杭",
                "address": "余杭街道",
                "ext_platform_order_sn": "111111",
                "additional": null,
                "status": "4",
                "order_sn": "202011051711280065645",
                "sale_price": "60",
                "express_no": null,
                "express_company_name": null
            }
        ],
        "total": "10"
    }
}

取消发货


接口地址: http://api.vv-tool.com/shop/apis/get-package-cancel


接口介绍: 根据包裹进行取消发货 点击查看详情


请求方式: POST


传参方式: JSON


返回格式: JSON


接口收费: 商品价格 + 快递价格,以接口获取的快递价格和商品价格为准


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

参数 类型 必选 描述
package_id int 包裹 id

请求示例


{
    "package_id":243
}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/shop/apis/get-package-cancel' \
--header 'Authorization: Bearer 3a49bae7ea6178d0c157c900f08888xxxxxxxxx' \
--header 'Cookie: PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=f9c04e12c0149218971bb3c7125efe66414bd6558029fa001143c8e513a91978a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22HXws4X9IFZxqeD6i-fJjAb5lueYHPBgr%22%3B%7D' \
--form 'package_id=227'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "http://api.vv-tool.com/shop/apis/get-package-cancel",
  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 => array('package_id' => '227'),
  CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer 3a49bae7ea6178d0c157c900f08888xxxxxxxx",
    "Cookie: PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=f9c04e12c0149218971bb3c7125efe66414bd6558029fa001143c8e513a91978a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22HXws4X9IFZxqeD6i-fJjAb5lueYHPBgr%22%3B%7D"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;


JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("package_id", "227")
  .build();
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/shop/apis/get-package-cancel")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 3a49bae7ea6178d0c157c900f08888xxxxxx")
  .addHeader("Cookie", "PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=f9c04e12c0149218971bb3c7125efe66414bd6558029fa001143c8e513a91978a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22HXws4X9IFZxqeD6i-fJjAb5lueYHPBgr%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

参数 类型 描述
code int 返回状态码
msg string 状态码描述
msec int 执行时间
time int 结果返回时间
data object 任务执行结果

返回数据


{
    "code": 0,
    "msg": "成功",
    "msec": 694,
    "time": 1604567398,
    "data": []
}
{
    "code": 10412,
    "msg": "当前包裹不能取消!",
    "msec": 802,
    "time": 1614336877,
    "data": []
}

获取用户余额


接口地址: http://api.vv-tool.com/shop/apis/get-user-balance


接口介绍: 获取您帐户的可用余额信息 点击查看详情


请求方式: POST


传参方式: JSON


返回格式: JSON


接口收费: 商品价格 + 快递价格,以接口获取的快递价格和商品价格为准


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

无请求参数

请求示例

无请求示例

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/shop/apis/get-user-balance' \
--header 'Authorization: Bearer 746568ff5b511bfda94c52d4edf35d9xxxxxxxx' \
--header 'Cookie: PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=160da8e3d8465d1be44d7c9ee164d6f86a24ee254471ec4a39e2de8c61399de4a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22-MQVg_dvu0WhWfOUB40klqPMMSnsU69h%22%3B%7D'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "http://api.vv-tool.com/shop/apis/get-user-balance",
  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_HTTPHEADER => array(
    "Authorization: Bearer 746568ff5b511bfda94c52d4edf35d9xxxxxxxxx",
    "Cookie: PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=160da8e3d8465d1be44d7c9ee164d6f86a24ee254471ec4a39e2de8c61399de4a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22-MQVg_dvu0WhWfOUB40klqPMMSnsU69h%22%3B%7D"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;


JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
MediaType JSON = MediaType.parse("application/json; charset=utf-8");
RequestBody body = RequestBody.create(JSON, "{}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/shop/apis/get-user-balance")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 746568ff5b511bfda94c52d4edf35d9xxxxxxxx")
  .addHeader("Cookie", "PHPSESSID=ab02gpb1aqeeab6bamd4j0a61b; _csrf=160da8e3d8465d1be44d7c9ee164d6f86a24ee254471ec4a39e2de8c61399de4a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22-MQVg_dvu0WhWfOUB40klqPMMSnsU69h%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

参数 类型 描述
code int 返回状态码
msg string 状态码描述
msec int 执行时间
time int 结果返回时间
data object 返回结果信息
balance int 余额

返回数据


{
    "code": 0,
    "msg": "成功",
    "msec": 1732,
    "time": 1603415692,
    "data": {
        "balance": 99420
    }
}

包裹详情回调

接口介绍: 包裹详情回调(一次最多传入 100 组包裹) 点击查看详情

应用场景

包裹详情回调

接口链接

商家需要返回 code=0 否则一共请求三次则不会在继续请求

该链接是通过向客服提交回调接口,如果链接无法访问,商户将无法接收到通知。

通知 url 必须为直接可访问的 url,不能携带参数。

返回数据

参数名 返回值类型 备注 其他信息
order_id string v 兔商城订单 id
order_sn string 订单编号
consignee object[] v 兔商城包裹 数组
├ ─ platform_order_sn stirng 第三方订单编号(创建订单时,用户传的参数)
├ ─ consignee_id string v 兔商城包裹 id
├ ─ express_no string 快递单号
├ ─ status string 包裹状态:1:已发货,且出单(出单号了) 2:取消发货 3:已发货,未出单
├ ─ cancel_reason string 取消原因

返回示例代码

json格式返回代码示例
{
    "order_id":"1117",
    "order_sn":"202105151305552563411",
    "consignees":[
        {
            "consignee_id":"1671",
            "platform_order_sn":"800000000000",
            "express_no":"123213211",
            "status":"1",
            "cancel_reason":null
        },
        {
            "consignee_id":"1671",
            "platform_order_sn":"800000000000",
            "express_no":"123213211",
            "status":"1",
            "cancel_reason":null
        },
        {
            "consignee_id":"1671",
            "platform_order_sn":"800000000000",
            "express_no":"123213211",
            "status":"1",
            "cancel_reason":null
        },
        {
            "consignee_id":"1671",
            "platform_order_sn":"800000000000",
            "express_no":"123213211",
            "status":"1",
            "cancel_reason":null
        }
    ]
}

商家返回

{
"code": 0

}

</details>


> ### 响应状态码

| 返回代码 | 返回码描述 | 解决办法 |
| -------- | -------- | -------- |
| 0 | 成功 |  |
| 100 | 请求参数错误 | 检查您的参数是否为空或者格式是否正确 |
| 101 | 请求超时,请重试 | 检查您的网络状况是否良好 |
| 102 | 调用接口不成功 | 检查您的接口代码或者联系客服解决 |
| 200 | 系统错误,请联系客服 | 联系客服解决 |
| 204 | 请求异常 | 检查接口url或者参数 |
| 204  | 免费次数或点券余额不足,请充值 | 充值点券后再来 |
| <font color=red>302</font> | <font color=red>未授权店铺或则授权过期</font> | <font color=red>msg:未授权,data返回专属的授权链接,请让店铺重新授权</font> |
| <font color=red>303</font> | <font color=red>店铺未订购该软件</font> | <font color=red>店铺订购到期或则未订购请前往订购,接口返回的提示msg,店铺订购到期或则未订购请前往订购</font> |
| 205 | 缺少必要参数 | 检查您的请求参数是否填写 |
| 208 | 参数类型错误 | 检查您的参数类型是否填写正确 |
| 401 | 身份凭证无效 | 重新获取token | 
| 10402 | 当前产品不存在 | 检查您的商品id是否正常 | 
| 10403 | 当前仓库不存在 | 检查您的仓库id是否正确 |
| 10406 | 当前订单不存在 | 检查您的订单号是否正确 |
| 10407 | 当前订单状态不是待付款状态 | 检查您的订单编号是否正确 |
| 10408 | 当前订单下没有包裹待付款包裹 | 检查您所需要支付的订单id是否正确 |
| 10409 | 订单创建失败 | 检查您的接口内容是否正确 |
| 10410 | 订单付款失败 | 检查您的参数填写是否正确或者联系客服解决 |
| 10411 | 当前包裹不存在 | 检查您的包裹id填写是否正确 |
| 10412 | 当前包裹不能取消 | 检查您的包裹id填写是否正确 |
| 10413 | 当前包裹取消失败 | 检查您的包裹id填写是否正确 |
| 10416 | 支付超时 | 请重新下单 |