全部
电子面单
物流轨迹
物流发货
在线测试

店铺后台发货


接口地址: 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
    }
  ]
}

错误码 点击查看详情:查看