全部
淘宝
拼多多
抖音
京东
快手
当当
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,标准版 3,需要标准版的传 3 |
请求示例
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 个月以外的订单,以防止取不到交易的情况。 |