全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

批量查询物流订单,返回详细信息


接口地址: http://api.vv-tool.com/tool/erps/detail


接口介绍: 批量查询物流订单,返回详细信息 点击查看详情


必须用户授权 : 需要用户的授权,才能拿到被授权的数据


请求方式: POST


返回格式: JSON


接口收费: 扣账户余额


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

名称 类型 必须 示例值 描述
shop_id string 1234 店铺 ID
fields String true tid,order_code,seller_nick,buyer_nick,item_title,
receiver_location,status,type,company_name,created,
modified,is_quick_cod_order,sub_tids,is_split,receiver_location,
receiver_name,receiver_phone,receiver_mobile
需返回的字段列表。可选值:Shipping 物流数据结构中所有字段。fileds 中可以指定返回以上任意一个或者多个字段,以","分隔。
tid Number false 255222 交易 ID.如果加入 tid 参数的话,不用传其他的参数,但是仅会返回一条物流订单信息。
buyer_nick String false zhangsan 买家昵称
status String false CREATED 物流状态。可查看数据结构 Shipping 中的 status 字段。
seller_confirm String false yes 卖家是否发货。可选值:yes(是),no(否).如:yes.
receiver_name String false name 收货人姓名
start_created Date false 2000-01-01 00:00:00 创建时间开始。格式:yyyy-MM-dd HH:mm:ss
end_created Date false 2000-01-01 00:00:00 创建时间结束。格式:yyyy-MM-dd HH:mm:ss
freight_payer String false buyer 谁承担运费。可选值:buyer(买家),seller(卖家).如:buyer
type String false post 物流方式。可选值:post(平邮),express(快递),ems(EMS).如:post
page_no Number false 1 页码。该字段没传 或 值 <1 ,则默认 page_no 为 1
page_size Number false 40 每页条数。该字段没传 或 值 <1 ,则默认 page_size 为 40
vvtype int false 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2

请求示例

fields:tid,order_code,seller_nick,buyer_nick,item_title,receiver_location,status,type,company_name,created,modified,is_quick_cod_order,sub_tids,is_split,receiver_location,receiver_name,receiver_phone,receiver_mobile
shop_id:123

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/tool/erps/detail' \
--header 'Authorization: Bearer 73a1e6f00198e0c43215505dcf6e31a61be8daad' \
--header 'Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D' \
--form 'fields="tid,order_code,seller_nick,buyer_nick,item_title,receiver_location,status,type,company_name,created,modified,is_quick_cod_order,sub_tids,is_split,receiver_location,receiver_name,receiver_phone,receiver_mobile"' \
--form 'shop_id="123"'
PHP请求代码示例
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/detail',
  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('fields' => 'tid,order_code,seller_nick,buyer_nick,item_title,receiver_location,status,type,company_name,created,modified,is_quick_cod_order,sub_tids,is_split,receiver_location,receiver_name,receiver_phone,receiver_mobile','shop_id' => '123'),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 73a1e6f00198e0c43215505dcf6e31a61be8daad',
    'Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%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("fields","tid,order_code,seller_nick,buyer_nick,item_title,receiver_location,status,type,company_name,created,modified,is_quick_cod_order,sub_tids,is_split,receiver_location,receiver_name,receiver_phone,receiver_mobile")
  .addFormDataPart("shop_id","123")
  .build();
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/detail")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 73a1e6f00198e0c43215505dcf6e31a61be8daad")
  .addHeader("Cookie", "__yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

名称 类型 示例值 描述
shippings Shipping [] 获取的物流订单详情列表。返回的 Shipping 包含的具体信息为入参 fields 请求的字段信息。
tid Number 125555221 交易 ID
order_code String LP12345678 物流订单编号
status String CREATED 物流订单状态,可选值:CREATED(订单已创建) RECREATED(订单重新创建) CANCELLED(订单已取消) CLOSED(订单关闭) SENDING(等候发送给物流公司) ACCEPTING(已发送给物流公司,等待接单) ACCEPTED(物流公司已接单) REJECTED(物流公司不接单) PICK_UP(物流公司揽收成功) PICK_UP_FAILED(物流公司揽收失败) LOST(物流公司丢单) REJECTED_BY_RECEIVER(对方拒签) ACCEPTED_BY_RECEIVER(发货方式在线下单:对方已签收;自己联系:卖家已发货)
is_quick_cod_order Boolean true 标示为是否快捷 COD 订单
seller_nick String huzh 卖家昵称
buyer_nick String ddd 买家昵称
delivery_start Date 2000-01-01 00:00:00 预约取货开始时间
delivery_end Date 2000-01-01 00:00:00 预约取货结束时间
out_sid String 1455858255 运单号。具体一个物流公司的运单号码。
item_title String 连衣花裙 货物名称
receiver_name String 周锦 收件人姓名
receiver_phone String 057188155188 收件人电话
receiver_mobile String 1384567842 收件人手机号码
location Location 收件人地址信息(在传输请求参数 Fields 字段时,必须使用“receiver_location”才能返回此字段)
zip String 310000 邮政编码
address String 华星路 99 号创业大厦 详细地址,最大 256 个字节(128 个中文)
city String 杭州 所在城市(中文名称)
state String 浙江 所在省份(中文名称)
country String 中国 国家名称
district String 西湖区 区/县(只适用于物流 API)
type String free 物流方式。可选值:free(卖家包邮),post(平邮),express(快递),ems(EMS).
freight_payer String buyer 谁承担运费。可选值:buyer(买家承担),seller(卖家承担运费).
seller_confirm String yes 卖家是否确认发货。可选值:yes(是),no(否).
company_name String sto 物流公司名称
created Date 2000-01-01 00:00:00 运单创建时间
modified Date 2000-01-01 00:00:00 运单修改时间
sub_tids Number[] 1,2,3 拆单子订单列表,对应的数据是:该物流订单下的全部子订单
is_split Number 0 表明是否是拆单,默认值 0,1 表示拆单
total_results Number 1 搜索到的物流订单列表总数
withholding_money int 11 该接口扣费金额(点券)

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1460,
    "time": 1617273033,
    "data": [
        {
				    "withholding_money": 1,
            "buyer_nick": "~yOlO+NauHofT1xEACTmZhA==~Pz1vgPL7Ej0u~1~~",
            "created": "2021-04-01 16:40:47",
            "is_quick_cod_order": false,
            "is_split": 0,
            "item_title": "婴幼儿童宝贝随身便携小包迷你清洁宝宝消毒湿巾生活多场景使用包",
            "location": {
                "address": "****",
                "city": "杭州市",
                "district": "西湖区",
                "state": "浙江省",
                "zip": "000000"
            },
            "modified": "2021-04-01 18:04:10",
            "order_code": "LP00439661727640",
            "receiver_mobile": "$un9BDyLXrNjZ8ki4CNcpNw==$ZFUq+8Ll97SRmROJ7sKQoA==$1$$",
            "receiver_name": "~c7taW1ODc8ukQPFVN66n5w==~W+3x~1~~",
            "seller_nick": "tb5930250350",
            "status": "CLOSED",
            "sub_tids": {
                "number": [
                    "1692089714634374451"
                ]
            },
            "tid": "1692089714634374451",
            "type": "express"
        },
        {
            "buyer_nick": "~yOlO+NauHofT1xEACTmZhA==~Pz1vgPL7Ej0u~1~~",
            "created": "2021-04-01 15:02:07",
            "is_quick_cod_order": false,
            "is_split": 0,
            "item_title": "婴幼儿童宝贝随身便携小包迷你清洁宝宝消毒湿巾生活多场景使用包",
            "location": {
                "address": "****",
                "city": "杭州市",
                "district": "西湖区",
                "state": "浙江省",
                "zip": "000000"
            },
            "modified": "2021-04-01 15:09:22",
            "order_code": "LP00439810486544",
            "receiver_mobile": "$un9BDyLXrNjZ8ki4CNcpNw==$ZFUq+8Ll97SRmROJ7sKQoA==$1$$",
            "receiver_name": "~c7taW1ODc8ukQPFVN66n5w==~W+3x~1~~",
            "seller_nick": "tb5930250350",
            "status": "CLOSED",
            "sub_tids": {
                "number": [
                    "1691874146122374451"
                ]
            },
            "tid": "1691874146122374451",
            "type": "express"
        },
        {
            "buyer_nick": "~S4Nv03/F2UCHVa3jWPfNJQ==~3QKd3lOgglfGJ5A8dC7z~1~~",
            "created": "2021-03-29 18:14:50",
            "is_quick_cod_order": false,
            "is_split": 0,
            "item_title": "婴幼儿童宝贝随身便携小包迷你清洁宝宝消毒湿巾生活多场景使用包",
            "location": {
                "address": "****",
                "city": "杭州市",
                "district": "西湖区",
                "state": "浙江省",
                "zip": "000000"
            },
            "modified": "2021-04-01 13:08:18",
            "order_code": "LP00439161488657",
            "receiver_mobile": "$1Sag+WmXBD+VgP9xnwRjAg==$jl1bvPq/dCd543U5hyyC+A==$1$$",
            "receiver_name": "~FMKydKvmoXhBMT5fIoILCQ==~fxrb~1~~",
            "seller_nick": "tb5930250350",
            "status": "CLOSED",
            "sub_tids": {
                "number": [
                    "1683977365576810386"
                ]
            },
            "tid": "1683977365576810386",
            "type": "express"
        },
        {
            "buyer_nick": "~drmTrQb4NVIcMyQRYYOopw==~GdB9zv+JglfG5a5g~1~~",
            "created": "2021-03-27 19:19:57",
            "is_quick_cod_order": false,
            "is_split": 0,
            "item_title": "婴幼儿童宝贝随身便携小包迷你清洁宝宝消毒湿巾生活多场景使用包",
            "location": {
                "address": "****",
                "city": "杭州市",
                "district": "西湖区",
                "state": "浙江省",
                "zip": "310000"
            },
            "modified": "2021-03-28 19:30:03",
            "order_code": "LP00438624576049",
            "receiver_mobile": "$CA7eWwstH+79xhR++I3+kA==$/6Bxb4MfF/JwjDvx6Kwndw==$1$$",
            "receiver_name": "~jHys31jNVnMLT2GWmMibdQ==~5z5WFbXe~1~~",
            "seller_nick": "tb5930250350",
            "status": "CLOSED",
            "sub_tids": {
                "number": [
                    "1267251421824702891"
                ]
            },
            "tid": "1267251421824702891",
            "type": "express"
        },
        {
            "buyer_nick": "~yOlO+NauHofT1xEACTmZhA==~Pz1vgPL7Ej0u~1~~",
            "created": "2021-03-23 16:10:02",
            "is_quick_cod_order": false,
            "is_split": 0,
            "item_title": "婴幼儿童宝贝随身便携小包迷你清洁宝宝消毒湿巾生活多场景使用包",
            "location": {
                "address": "****",
                "city": "杭州市",
                "district": "西湖区",
                "state": "浙江省",
                "zip": "000000"
            },
            "modified": "2021-03-23 16:15:40",
            "order_code": "LP00437901241037",
            "receiver_mobile": "$un9BDyLXrNjZ8ki4CNcpNw==$ZFUq+8Ll97SRmROJ7sKQoA==$1$$",
            "receiver_name": "~c7taW1ODc8ukQPFVN66n5w==~W+3x~1~~",
            "seller_nick": "tb5930250350",
            "status": "CLOSED",
            "sub_tids": {
                "number": [
                    "1665594000750374451"
                ]
            },
            "tid": "1665594000750374451",
            "type": "express"
        }
    ]
}

响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
202 系统错误,请稍后再试 稍后重试,或者联系对接群
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权
401 身份凭证无效 在请求头中添加 access_token,重新更新 token
404 请求路径或请求方式错误 请更换请求方式或者检查路径是否正确
614 参数:trade_id:P07 无效,格式不对、非法值、越界等 1. 在调用订单获取数据的时候,需要提前判断交易是否已经发货,对于没有发货的订单不要去取物流信息。2. 通过增量 API 接口同步订单的时候,不要同步 3 个月以外的订单,以防止取不到交易的情况。
614 参数:trade_id:P07 无效,格式不对、非法值、越界等 1. 在调用订单获取数据的时候,需要提前判断交易是否已经发货,对于没有发货的订单不要去取物流信息。2. 通过增量 API 接口同步订单的时候,不要同步 3 个月以外的订单,以防止取不到交易的情况。