全部
电子面单
物流轨迹
物流发货
在线测试
店铺后台发货
接口地址: http://api.vv-tool.com/tool/accounts/dcfso
接口介绍: 对订单做发货处理,主要是自己的联系快递公司(线下物流)发货 点击查看详情
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 扣账户余额
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
sub_tid | string | false | 1,2,3 | 需要拆单发货的子订单集合,针对的是一笔交易下有多个子订单需要分开发货的场景;1 次可传人多个子订单号,子订单间用逗号隔开;为空表示不做拆单发货。 |
shop_id | String | true | 123456789 | 店铺 ID |
tid | Number | true | 123 | 淘宝交易 ID |
is_split | Number | false | 0 | 表明是否是拆单,默认值 0,1 表示拆单 |
out_sid | String | true | 123456789 | 运单号。具体一个物流公司的真实运单号码。淘宝官方物流会校验,请谨慎传入; |
company_code | String | true | POST | 物流公司代码。如"POST"就代表中国邮政,"ZJS"就代表宅急送。 快递简称快递简写列表 |
sender_id | Number | false | 123456 | 卖家联系人地址库 ID,可以通过 taobao.logistics.address.search 接口查询到地址库 ID。如果为空,取的卖家的默认取货地址 |
cancel_id | Number | false | 123456 | 卖家联系人地址库 ID,可以通过 taobao.logistics.address.search 接口查询到地址库 ID。 如果为空,取的卖家的默认退货地址 |
feature | String | false | identCode=tid:aaa,bbb | feature 参数格式 范例: identCode=tid1:识别码 1,识别码 2|tid2:识别码 3;machineCode=tid3:3C 机器号 A,3C 机器号 B identCode 为识别码的 KEY,machineCode 为 3C 的 KEY,多个 key 之间用”;”分隔 "tid1:识别码 1,识别码 2|tid2:识别码 3”为 identCode 对应的 value。 "|"不同商品间的分隔符。 例 1 商品和 2 商品,之间就用"|"分开。 TID 就是商品代表的子订单号,对应 taobao.trade.fullinfo.get 接口获得的 oid 字段。(通过 OID 可以唯一定位到当前商品上) ":"TID 和具体传入参数间的分隔符。冒号前表示 TID,之后代表该商品的参数属性。 "," 属性间分隔符。(对应商品数量,当存在一个商品的数量超过 1 个时,用逗号分开)。 具体:当订单中 A 商品的数量为 2 个,其中手机串号分别为"12345","67890"。 参数格式:identCode=TIDA:12345,67890。 TIDA 对应了 A 宝贝,冒号后用逗号分隔的"12345","67890".说明本订单 A 宝贝的数量为 2,值分别为"12345","67890"。 当存在"|"时,就说明订单中存在多个商品,商品间用"|"分隔了开来。|"之后的内容含义同上。retailStoreId=12345,发货门店 ID 或仓信息。retailStoreType=STORE: 发货门店类别,STORE 表示门店,WAREHOUSE 表示电商仓。对于全渠道订单回传的商家,retailStoreId 和 retailStoreType 字段为必填字段。 |
vvtype | int | false | 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2,标准版 3,需要标准版的传 3 |
请求示例
tid:123
out_sid:123456789
company_code:POST
shop_id:1234567
请求代码示例
cURL请求代码示例
curl --location --request POST "http://api.vv-tool.com/tool/accounts/dcfso" \
--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 "tid="123"" \
--form "out_sid="123456789"" \
--form "company_code="POST"" \
--form "shop_id="1234567""
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "http://api.vv-tool.com/tool/accounts/dcfso",
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("tid" => "123","out_sid" => "123456789","company_code" => "POST","shop_id" => "1234567"),
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("tid","123")
.addFormDataPart("out_sid","123456789")
.addFormDataPart("company_code","POST")
.addFormDataPart("shop_id","1234567")
.build();
Request request = new Request.Builder()
.url("http://api.vv-tool.com/tool/accounts/dcfso")
.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();
响应参数
参数 | 类型 | 描述 |
---|---|---|
url | string | url |
code | int | 错误码 0 为成功 |
msg | string | 返回码描述 |
msec | int | 接口执行时间 |
time | int | 接口返回时间 |
success | Boolean | 返回发货是否成功。 |
withholding_money | int | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "成功",
"msec": 1193,
"time": 1612416107,
"data": [
{
"withholding_money": 1,
"success": true
}
]
}
错误码 点击查看详情:查看