全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
获取交易订单的物流跟踪信息(卖家视角)
接口地址: http://api.vv-tool.com/tool/erps/1688seller-get-logistics-trace-info
接口介绍: 获取交易订单的物流跟踪信息(卖家视角)
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf |
请求参数
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
shop_id | string | 是 | 店铺 id |
logistics_id | string | 否 | 该订单下的物流编号 AL8234243 |
order_id | int | 是 | 订单号 13342343 |
web_site | string | 是 | 是 1688 业务还是 icbu 业务 1688 或者 alibaba |
请求示例
{
'logistics_id': 'AL8234243',
'order_id': 13342343,
'web_site': '1688'
}
请求代码示例
cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/1688seller-get-logistics-trace-info' --header 'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf' --data-raw '{
'logistics_id': 'AL8234243',
'order_id': 13342343,
'web_site': '1688'
}'
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/1688seller-get-logistics-trace-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 =>'{
'logistics_id': 'AL8234243',
'order_id': 13342343,
'web_site': '1688'
}',
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, '{
'logistics_id': 'AL8234243',
'order_id': 13342343,
'web_site': '1688'
}');
Request request = new Request.Builder()
.url('http://api.vv-tool.com/tool/erps/1688seller-get-logistics-trace-info')
.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_trace | array | 跟踪单详情 |
----logistics_id | string | 物流编号,如 BX110096003841234 |
----order_id | int | 订单编号 |
----logistics_bill_no | string | 物流单编号,如 480330616596 |
----logistics_steps | array | 物流跟踪步骤 |
------accept_time | string | 物流跟踪单该步骤的时间 |
------remark | string | 备注,如:“在浙江浦江县公司进行下级地点扫描,即将发往:广东深圳公司” |
--withholding_money | int | 该接口扣费金额(点券) |
返回数据
{
'code': 0,
'msg': '操作成功',
'msec': 1469,
'time': 1617270403,
'data': {
'logistics_trace':[
{
'logistics_id':'lp00103504142933',
'logistics_bill_no':'9953930013',
'order_id':173697443965297730,
'logistics_steps':[
{
'accept_time':'2018-07-26 16:36:40',
'remark':'您的订单已被收件员揽收,【汕头澄海区东里镇营业部】库存中'
},
{
'accept_time':'2018-07-26 19:20:13',
'remark':'运输中,离开【汕头澄海区东里镇营业部】,下一站【潮汕转运中心】'
},
{
'accept_time':'2018-07-26 21:01:44',
'remark':'货物已到达潮汕转运中心'
},
{
'accept_time':'2018-07-27 00:56:59',
'remark':'运输中,离开【潮汕转运中心】,下一站【深圳盐田转运场】'
},
{
'accept_time':'2018-07-27 05:28:57',
'remark':'货物已到达深圳盐田转运场'
},
{
'accept_time':'2018-07-27 08:04:24',
'remark':'运输中,离开【深圳盐田转运场】,下一站【深圳宝安区福永凤凰油站营业部】'
},
{
'accept_time':'2018-07-27 09:38:15',
'remark':'货物已到达深圳宝安区福永凤凰油站营业部'
},
{
'accept_time':'2018-07-27 10:15:55',
'remark':'预派送'
},
{
'accept_time':'2018-07-27 10:29:43',
'remark':'预派送'
},
{
'accept_time':'2018-07-27 10:29:57',
'remark':'14因休息日或假期客户不便收件,待工作日派送'
},
{
'accept_time':'2018-07-27 13:44:32',
'remark':'派送中'
},
{
'accept_time':'2018-07-27 15:48:25',
'remark':'正常签收,签收人类型:同事'
}
]
}
]
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或者联系对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |