淘宝批量查询物流订单,返回详细信息、淘宝erp,订单明细接口- v兔电商工具

淘宝批量查询物流订单,返回详细信息,需要租或者购买淘宝,拼多多,京东,抖音,1688,唯品会等平台的进销存或打单软件的欢迎前来咨询v:vtupaofu8888。v兔祝各位商家大卖!v兔电商工具出品 更多干货: http://ask.vv-tool.com/

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

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

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

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

请求方式: POST

返回格式: JSON

接口收费: 详询: v:vtupaofu8888,扣账户余额

频率限制: 10 次/秒

请求头参数

Authorizationstring授权 access_tokenBearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

shop_idstring1234店铺 ID
fieldsStringtruetid,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 中可以指定返回以上任意一个或者多个字段,以","分隔。
tidNumberfalse255222交易 ID.如果加入 tid 参数的话,不用传其他的参数,但是仅会返回一条物流订单信息。
buyer_nickStringfalsezhangsan买家昵称
statusStringfalseCREATED物流状态。可查看数据结构 Shipping 中的 status 字段。
seller_confirmStringfalseyes卖家是否发货。可选值:yes(是),no(否).如:yes.
receiver_nameStringfalsename收货人姓名
start_createdDatefalse2000-01-01 00:00:00创建时间开始。格式:yyyy-MM-dd HH:mm:ss
end_createdDatefalse2000-01-01 00:00:00创建时间结束。格式:yyyy-MM-dd HH:mm:ss
freight_payerStringfalsebuyer谁承担运费。可选值:buyer(买家),seller(卖家).如:buyer
typeStringfalsepost物流方式。可选值:post(平邮),express(快递),ems(EMS).如:post
page_noNumberfalse1页码。该字段没传 或 值 <1 ,则默认 page_no 为 1
page_sizeNumberfalse40每页条数。该字段没传 或 值 <1 ,则默认 page_size 为 40
vvtypeintfalse普通版 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();

响应参数

shippingsShipping []获取的物流订单详情列表。返回的 Shipping 包含的具体信息为入参 fields 请求的字段信息。
tidNumber125555221交易 ID
order_codeStringLP12345678物流订单编号
statusStringCREATED物流订单状态,可选值:CREATED(订单已创建) RECREATED(订单重新创建) CANCELLED(订单已取消) CLOSED(订单关闭) SENDING(等候发送给物流公司) ACCEPTING(已发送给物流公司,等待接单) ACCEPTED(物流公司已接单) REJECTED(物流公司不接单) PICK_UP(物流公司揽收成功) PICK_UP_FAILED(物流公司揽收失败) LOST(物流公司丢单) REJECTED_BY_RECEIVER(对方拒签) ACCEPTED_BY_RECEIVER(发货方式在线下单:对方已签收;自己联系:卖家已发货)
is_quick_cod_orderBooleantrue标示为是否快捷 COD 订单
seller_nickStringhuzh卖家昵称
buyer_nickStringddd买家昵称
delivery_startDate2000-01-01 00:00:00预约取货开始时间
delivery_endDate2000-01-01 00:00:00预约取货结束时间
out_sidString1455858255运单号。具体一个物流公司的运单号码。
item_titleString连衣花裙货物名称
receiver_nameString周锦收件人姓名
receiver_phoneString057188155188收件人电话
receiver_mobileString1384567842收件人手机号码
locationLocation收件人地址信息(在传输请求参数 Fields 字段时,必须使用“receiver_location”才能返回此字段)
zipString310000邮政编码
addressString华星路 99 号创业大厦详细地址,最大 256 个字节(128 个中文)
cityString杭州所在城市(中文名称)
stateString浙江所在省份(中文名称)
countryString中国国家名称
districtString西湖区区/县(只适用于物流 API)
typeStringfree物流方式。可选值:free(卖家包邮),post(平邮),express(快递),ems(EMS).
freight_payerStringbuyer谁承担运费。可选值:buyer(买家承担),seller(卖家承担运费).
seller_confirmStringyes卖家是否确认发货。可选值:yes(是),no(否).
company_nameStringsto物流公司名称
createdDate2000-01-01 00:00:00运单创建时间
modifiedDate2000-01-01 00:00:00运单修改时间
sub_tidsNumber[]1,2,3拆单子订单列表,对应的数据是:该物流订单下的全部子订单
is_splitNumber0表明是否是拆单,默认值 0,1 表示拆单
total_resultsNumber1搜索到的物流订单列表总数
withholding_moneyint11该接口扣费金额(点券)

返回数据

{
    "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 个月以外的订单,以防止取不到交易的情况。

作者:v兔 链接:http://ask.vv-tool.com 来源:v兔电商知识库 著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

  • 发表于 11/05/2021 10:09:26
  • 阅读 ( 1499 )
  • 分类:API接口

你可能感兴趣的文章

相关问题

0 条评论

请先 登录 后评论
泡芙
泡芙

2128 篇文章

我来创作