V兔API开放平台

参数	类型	必选	描述
shop_id	string	是	店铺 id
order_id	int	是	订单 id
carriage	int	是	订单修改之后的运费，单位为分
entry_discounts	string	是	改价明细，discount 值的单位为分，正数为涨价，负数为减价

请求示例

{
    "shop_id":"daa-16165961198",
    "order_id": 2198111437768747370,
    "carriage": 200,
    "entry_discounts": [
        {
            "id": 2198111437768747370,
            "discount": 20
        }
    ]
}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/tool/erps/1688modify-order-price' --header 'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf' --header 'Content-Type: application/json' --data-raw '{
    'order_id': 1111204496116440,
    'carriage': 200,
    'entry_discounts': [
        {
            'id': 1111204496116440,
            'discount': 20
        }
    ]
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/1688modify-order-price',
  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': 1111204496116440,
    'carriage': 200,
    'entry_discounts': [
        {
            'id': 1111204496116440,
            'discount': 20
        }
    ]
}',
  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('application/json');
RequestBody body = RequestBody.create(mediaType, '{
    'order_id': 1111204496116440,
    'carriage': 200,
    'entry_discounts': [
        {
            'id': 1111204496116440,
            'discount': 20
        }
    ]
}');
Request request = new Request.Builder()
  .url('http://api.vv-tool.com/tool/erps/1688modify-order-price')
  .method('POST', body)
  .addHeader('Authorization', 'Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf')
  .addHeader('Content-Type', 'application/json')
  .build();
Response response = client.newCall(request).execute();

响应参数

名称	类型	描述
code	int	返回状态码
msg	string	返回码描述
msec	int	接口执行时间
time	int	接口返回时间
data	object	数据信息
--success	bool	是否处理成功：true 为成功，false 为失败，失败原因见 error
--result_code	string	错误码 FAIL_BIZ_TRADING_INVALID_PARAM:参数错误解决方案:参考参数说明 FAIL_BIZ_TRADING_ORDER_NOT_EXIST:订单不存在解决方案:检查订单号有效性 FAIL_BIZ_TRADING_ORDER_STATUS_ERROR:订单状态不正确（就是该状态不能修改价格）解决方案:检查下订单状态，只有等待买家付款状态的订单才能修改订单价格 FAIL_BIZ_TRADING_MODIFY_PRICE_ERROR:修改价格失败（例如不能涨价，只能降价）解决方案:确定订单改价限制，只能修改订单类型为 6、8、9、10 的订单，既 tradeTypeStr=6、8、9、10 FAIL_BIZ_TRADING_SYSTEM_ERROR:系统错误（系统繁忙）解决方案:稍后重试或联系开放平台管理人 FAIL_BIZ_TRADING_ORDER_ENTRY_STATUS_ERROR:子订单状态已改变，请返回重试解决方案:entry_discounts 中传递了已经删除的子订单信息，只需要传递未关闭的子订单即可
--result_msg	string	错误信息
--withholding_money	int	该接口扣费金额（点券）

返回数据


{
    'code': 0,
    'msg': '操作成功',
    'msec': 1469,
    'time': 1617270403,
    'data': {
        'success': true
    }
}

响应代码

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