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

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_id int 仓库 id
warehouse_name string 仓库名称
api_price int 快递价格 (单位是点券,1 点券 =1 分)
is_encryption string 是否支持密文 1 否 2 支持
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 其他
is_encryption string 是否支持密文 1 否 2 支持
support_encryption string 支持密文的平台(taobao:淘宝 tmall:天猫 jd:京东 pdd:拼多多 dyxd:抖店 返回参数为空不支持密文)

返回数据


{
    "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:拼多多 albb:阿里巴巴 ks:快手小店 dyxd:抖音小店 other(表明通用电子面单):其他
signing_method string 签收方式 1 买家签收 2 站点签收 3 快递员签收 4 其他
is_encryption string 是否支持密文 1 否 2 支持
support_encryption string 支持密文的平台(taobao:淘宝 tmall:天猫 jd:京东 pdd:拼多多 dyxd:抖店 返回参数为空不支持密文)

返回数据


{
    "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-encrypt


接口介绍:

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


请求方式: POST


传参方式: JSON


返回格式: JSON


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


频率限制: 10 次/秒


请求头参数

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

请求参数

参数 类型 必选 描述
shop_id int 店铺 ID
product_id int 礼品 ID
params array 包裹信息
-platform_order_sn string 第三方平台订单号:淘、猫、京、拼等平台订单编号通过 erp 订单接口获取
-source string 来源 taobao:淘宝 tmall:天猫 jd:京东 pdd:拼多多 albb:阿里巴巴 ks:快手小店 dyxd:抖音小店 other:其他
-consignee_remark string 包裹备注。(每个包裹对应一个收货人信息)
is_deliver string 自动发货//1 自动发货 0 不自动发货 默认类型 1(出单后自动将运单号推送电商发货接口),不传或则无效数据系统默认 1,类型 0(出单成功后,不再推送电商发货接口)
is_payment number 填 1 创建订单并完成支付,如果余额不足订单会创建(待支付状态),如果余额充足无需支付直接调用第六步获取单号

请求示例

{
"shop_id":121212121,
"product_id":643,
"is_deliver":"0",
"params":[
    {
"platform_order_sn":220104-2121212112,
"source":"pdd",
 }
  ],
}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/shop/apis/order-create-encrypt' \
--header 'Authorization: Bearer aee08acbe3543ac25e85ffxxxxxxxxxxxxxxxxxxxx' \
--header 'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=9a2c4b3a08cb17fec2a30a71d533abf0; _csrf=a42f582a9f774bf6a015e7e3f33f748ccc0cd3a76e9f2c53783cda674da38321a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22Oz0S-h_U7DAmQfGqB4YBxBrcSmo_qg85%22%3B%7D' \
--form 'shop_id="21212"' \
--form 'product_id="643"' \
--form 'platform_order_sn="220104-1212121212121"' \
--form 'source="pdd"' \
--form 'is_deliver="0"'
PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/shop/apis/order-create-encrypt',
  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('shop_id' => '212121','product_id' => '643','platform_order_sn' => '220104-21212121','source' => 'pdd','is_deliver' => '0'),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer aee08acbe3543ac25e85ffxxxxxxxxxxxxxxxxxxxx',
    'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=9a2c4b3a08cb17fec2a30a71d533abf0; _csrf=a42f582a9f774bf6a015e7e3f33f748ccc0cd3a76e9f2c53783cda674da38321a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22Oz0S-h_U7DAmQfGqB4YBxBrcSmo_qg85%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("shop_id","2121211")
  .addFormDataPart("product_id","643")
  .addFormDataPart("platform_order_sn","220104-21212121")
  .addFormDataPart("source","pdd")
  .addFormDataPart("is_deliver","0")
  .build();
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/shop/apis/order-create-encrypt")
  .method("POST", body)
  .addHeader("Authorization", "Bearer aee08acbe3543ac25e85ffxxxxxxxxxxxxxxxxxxxx")
  .addHeader("Cookie", "__yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=9a2c4b3a08cb17fec2a30a71d533abf0; _csrf=a42f582a9f774bf6a015e7e3f33f748ccc0cd3a76e9f2c53783cda674da38321a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22Oz0S-h_U7DAmQfGqB4YBxBrcSmo_qg85%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 订单备注(1 个订单里面可以多个包裹的),你自己平台的标记编号
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 物流公司
consignee_remark 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": "快递丢失",
                "status": "2",
                "order_sn": "202011051811030069452",
                "sale_price": "60",
                "express_no": null,
								"consignee_remark": "你好",
                "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": "快递丢失",
                "status": "4",
                "order_sn": "202011051711280065645",
                "sale_price": "60",
                "express_no": null,
								"consignee_remark": "你好",
                "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 取消原因
├ ─ consignee_remark string 包裹备注。(每个包裹对应一个收货人信息)

返回示例代码

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

商家返回



{
    "code": 0
   
}
           

响应状态码

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