全部
淘宝
拼多多
抖音
京东
快手
当当
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 未授权店铺 根据返回链接进行扫码授权