V兔API开放平台

参数	类型	必选	描述
shop_id	string	是	店铺 id
send_goods	message:alibaba.logistics.OpSendGood[]	是	发货对象列表
--source_id	string	是	发货对象 id,一般是订单 id
--send_good_entries	message:alibaba.logistics.OpSendGoodEntry[]	是	发货对象明细列表
----source_entry_id	string	是	发货对象明细 id，对应子订单 Id
----amount	int	是	发货对象实发数量
----weight	int	是	发货对象实发重量，重量单位默认为千克
remarks	string	否	备注
gmt_send	string	否	发货时间
ext_body	string	是	JSON 字符串，extBodyJson 中的 noLogisticsCondition 必填，取值字符串 1 到 5：“1”：其他第三方物流、小型物充商、车队等（noLogisticsName、noLogisticsTel 必填）；“2”：补运费、差价（noLogisticsBillNo 必填）；“3”：卖家配送（noLogisticsName、noLogisticsTel 必填）；“4”：买家自提；“5”：其他原因（remarks 必填）。其他字段根据 noLogisticsCondition 的值不同，必填要求不同。字段说明：无需物流原因：noLogisticsCondition;无需物流名称：noLogisticsName;无需物流电话：noLogisticsTel;无需物流单号，不同的无需物流原因，该字段解释不同：noLogisticsBillNo。
ext_param	string	否	{}
receiver_info	message:alibaba.logistics.OpReceiveContacter	否	收货地址
--province_code	string	是	省编码
--city_code	string	是	市编码
--area_code	string	是	地区编码
--town_code	string	是	镇或街道编码
--province	string	是	省名称，如果传了 code，则可以不传
--city	string	是	市名称，如果传了 code，则可以不传
--area	string	是	区名称，如果传了 code，则可以不传
--town	string	是	镇或街道名称
--address	string	是	详细地址
--full_name	string	是	姓名
--corp_name	string	是	公司名称
--post	string	是	邮编
--phone	string	是	固定电话
--mobile	string	是	移动电话
--warehouse	string	是	仓库
--code_type	string	是	地址编码类型，默认菜鸟标准编码

请求示例

{
    'send_goods': [
        {
            'source_id':'11354545',
            'send_good_entries':[
                {
                    'source_entry_id':'11354545',
                    'amount':1,
                    'weight':1,
                }
            ]
        }
    ],
    'ext_body': '{'noLogisticsBillNo':'111111111111111111','noLogisticsCondition':'3','noLogisticsName':'张三','noLogisticsTel':'13999999999'}'
}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/tool/erps/1688send-order' --header 'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf' --data-raw '{
    'order_id': '201089727630969811',
    'delayed_days': 7
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/1688send-order',
  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 =>'{
    'order_id': '201089727630969811',
    'delayed_days': 7
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse('text/plain');
RequestBody body = RequestBody.create(mediaType, '{
    'order_id': '201089727630969811',
    'delayed_days': 7
}');
Request request = new Request.Builder()
  .url('http://api.vv-tool.com/tool/erps/1688send-order')
  .method('POST', body)
  .addHeader('Authorization', 'Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf')
  .build();
Response response = client.newCall(request).execute();

响应参数

名称	类型	描述
code	int	返回状态码
msg	string	返回码描述
msec	int	接口执行时间
time	int	接口返回时间
data	object	数据信息
--logistics_id	string	物流编号
--send_goods	array	发货明细
----source_id	int	发货对象 id,一般是订单 id
----send_good_entries	array	发货对象明细列表
------source_entry_id	int	发货对象明细 id，对应子订单 Id
------amount	int	发货对象实发数量
------weight	int	发货对象实发重量，重量单位默认为千克
--withholding_money	int	该接口扣费金额（点券）

返回数据


{
    'code': 0,
    'msg': '操作成功',
    'msec': 1469,
    'time': 1617270403,
    'data': {
        'logistics_id':'zx113988430670174',
        'send_goods':[
            {
                'source_id':206026099675498520,
                'send_good_entries':[
                    {
                        'source_entry_id':206026099675498520,
                        'amount':80,
                        'weight':10
                    }
                ]
            }
        ]
    }
}

响应代码

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