全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
通过订单号获取订单信息
接口地址: http://api.vv-tool.com/tool/erps/mpaging-orders
接口介绍: 通过订单号同步订单信息点击查看详情
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
owner_id | string | 是 | 店铺 ownerId |
orderSns[] | string | 是 | 订单号 (索引数组 ["201117-681808213123308", "201117-431331084902308"]) |
vvtype | INT | false | 增强版 1,不传默认 1,普通版 2 |
请求示例
owner_id:123123
orderSns[]:["201117-681132146402308", "201117-432413123308"]
请求代码示例
cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/paging-orders' \
--header 'Authorization: Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX' \
--header 'Cookie: PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=bbfd2eabf5b3920db30ec1841da280fc0dbbd20bb47606fb70dc59589bdb7028a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22e2Mj-LP98Vt2gauxRmXNjUi7wgUvNCzU%22%3B%7D' \
--form 'owner_id="123123"' \
--form 'orderSns="[\"201117-681132146402308\", \"201117-432413123308\"]"'
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/paging-orders',
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('{"owner_id": "1234567","orderSns": ["211129-5229772422424","210910-3418624242429"
]
}',),
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX',
'Cookie: PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=bbfd2eabf5b3920db30ec1841da280fc0dbbd20bb47606fb70dc59589bdb7028a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22e2Mj-LP98Vt2gauxRmXNjUi7wgUvNCzU%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("owner_id","123123")
.addFormDataPart("orderSns","[\"201117-681132146402308\", \"201117-432413123308\"]")
.build();
Request request = new Request.Builder()
.url("http://api.vv-tool.com/tool/erps/paging-orders")
.method("POST", body)
.addHeader("Authorization", "Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX")
.addHeader("Cookie", "PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=bbfd2eabf5b3920db30ec1841da280fc0dbbd20bb47606fb70dc59589bdb7028a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22e2Mj-LP98Vt2gauxRmXNjUi7wgUvNCzU%22%3B%7D")
.build();
Response response = client.newCall(request).execute();
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
receiver_name | string | 收货人姓名(加密) | |
receiver_phone | string | 收货人手机号(加密) | |
province | string | 省 | |
city | string | 市 | |
town | string | 区 | |
address | string | 详细收货地址 | |
order_sn | string | 订单号 | |
goods_name | string | 商品名 | |
goods_img | string | 商品图片 | |
goods_spec | string | 商品规格,使用(规格值 1,规格值 2)组合作为 sku 的表示,中间以英文逗号隔开 | |
is_pre_sale | string | 是否为预售商品 true 是,false 否 | |
last_ship_time | string | 截止发货时间 | |
confirm_time | string | 订单成交时间 ! | |
remark | string | 备注 | |
goods_count | string | 商品数量 | |
pay_amount | string | 金额(元) | |
order_status | string | 订单状态 | |
remark_tag | string | 评论 | |
remark_tag_name | string | 评论名字 | |
item_list | object[] | 订单中商品 sku 列表 | |
├ ─ goods_name | string | 商品名称 | |
├ ─ outer_goods_id | string | 商家外部商品编码 | |
├ ─ goods_price | string | 商品销售价格 | |
├ ─ goods_id | string | 商品编号 | |
├ ─ sku_id | string | 商品规格编码 | |
├ ─ goods_count | string | 商品数量 | |
├ ─ goods_spec | string | 商品规格,使用(规格值 1,规格值 2)组合作为 sku 的表示,中间以英文逗号隔开 | |
├ ─ outer_id | string | 商家外部 sku 编码 | |
├ ─ goods_img | string | 商品图片 | |
withholding_money | int | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1617270403,
"data": {
"withholding_money": 1,
"content": [
{
"receiver_name": "****",
"receiver_phone": "150*******15",
"province": "大象省",
"city": "猴子市",
"town": "鸡蛋区",
"receiver_address": "详细收货地址",
"order_sn": "订单号",
"goods_name": "商品名",
"goods_img": "商品图片",
"goods_spec": "商品描述",
"is_pre_sale": false,
"last_ship_time": 1605768641000,
"confirm_time": 1605595841000,
"remark": "啊啊",
"goods_count": 1,
"goods_spec": "str",
"pay_amount": 9.9,
"order_status": 1,
"remark_tag": null,
"remark_tag_name": null
"item_list": [
{
"goods_count": 1,
"goods_id": 1,
"goods_img": "1",
"goods_name": "1",
"goods_price": 1.0,
"goods_spec": "1",
"outer_goods_id": "1",
"outer_id": "1",
"sku_id": 1
}
]
}
]
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或者联系对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |