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

自由出单


接口地址: http://api.vv-tool.com/tool/erps/dyget-way-bill-plat-sd


接口介绍: 通过平台同步的脱敏订单的情况


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


请求方式: POST


返回格式: JSON


接口收费: 联系运营,联系运营


频率限制: 10 次/秒


请求头参数

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

请求参数

参数 类型 必选 描述
shop_id string 店铺 id
platform string 调用平台电子面单(例:调抖音接口 0 代表抖音) 1 拼多多站外电子面单 2 淘宝菜鸟电子面单 3 菜鸟物流云电子面单 注: 从 2021 年 8 月开始, 抖店已不支持第三方电子面单
params object 请求参数 数组形式传递
params[sender_name] string 发件人姓名
params[sender_phone] string 发件人手机号
params[sender_province] string 发件人所在省
params[sender_city] string 发件人所在市
params[sender_town] string 发件人所在县/区
params[sender_detail] string 发件人具体地址(不拼接省市区)
params[receiver_name] string 收件人姓名
params[receiver_phone] string 收件人手机号
params[receiver_province] string 收件人所在省
params[receiver_city] string 收件人所在市
params[receiver_town] string 收件人所在县/区
params[receiver_address] string 收件人具体地址(不拼接省市区)
params[wp_code] string 快递公司编码
params[waybill_type] string 电子面单类型 1 一联单 2 二联单
params[goods_info] string 商品详情,自定义,本身是个 JSON, 传数组过来也行,JSON 的话会验证 JSON 的结构,一定要是规范的 JSON 格式,例如,[{"index":"0","value":"","title":"商品标题","code":"商品编码","norm":"商品规格","num":1,"price":10,"weight":1,"volume":1}]
vvtype int

请求示例

{
    
}

请求代码示例

cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/dyget-way-bill-plat-sd' \
--header 'Authorization: Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--header 'Cookie: PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=8553bce0fb442de06dee6025f9ea6cdb6731eca27a561ea545213d025e2fa832a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22_oSawXs4iNblqv-G-5mzO3bKquamluJ5%22%3B%7D' \
--data-raw '{
    "shop_id": "dwadaw***7dawd",
    "platform": "授权渠道",
    "params": {
        "sender_name": "发件人姓名",
        "sender_phone": "发件人手机号",
        "sender_province": "发件人所在省",
        "sender_city": "发件人所在市",
        "sender_town": "发件人所在县/区",
        "sender_detail": "发件人具体地址(不拼接省市区)",
        "receiver_name": "收件人姓名",
        "receiver_phone": "收件人手机号",
        "receiver_province": "收件人所在省",
        "receiver_city": "收件人所在市",
        "receiver_town": "收件人所在县/区",
        "receiver_address": "收件人具体地址(不拼接省市区)",
        "wp_code": "快递公司编码",
        "waybill_type": "1",
        "goods_info": {
            "index": "0",
            "value": "",
            "title": "商品标题",
            "code": "商品编码",
            "norm": "商品规格",
            "num": 1,
            "price": 10,
            "weight": 1,
            "volume": 1
        }
    }
}'
PHP请求代码示例
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/dyget-way-bill-plat-sd',
  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 =>'{
    "shop_id": "dwadaw***7dawd",
    "platform": "授权渠道",
    "params": {
        "sender_name": "发件人姓名",
        "sender_phone": "发件人手机号",
        "sender_province": "发件人所在省",
        "sender_city": "发件人所在市",
        "sender_town": "发件人所在县/区",
        "sender_detail": "发件人具体地址(不拼接省市区)",
        "receiver_name": "收件人姓名",
        "receiver_phone": "收件人手机号",
        "receiver_province": "收件人所在省",
        "receiver_city": "收件人所在市",
        "receiver_town": "收件人所在县/区",
        "receiver_address": "收件人具体地址(不拼接省市区)",
        "wp_code": "快递公司编码",
        "waybill_type": "1",
        "goods_info": {
            "index": "0",
            "value": "",
            "title": "商品标题",
            "code": "商品编码",
            "norm": "商品规格",
            "num": 1,
            "price": 10,
            "weight": 1,
            "volume": 1
        }
    }
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX',
    'Content-Type: application/json',
    'Cookie: PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=8553bce0fb442de06dee6025f9ea6cdb6731eca27a561ea545213d025e2fa832a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22_oSawXs4iNblqv-G-5mzO3bKquamluJ5%22%3B%7D'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n    \"shop_id\": \"dwadaw***7dawd\",\r\n    \"platform\": \"授权渠道\",\r\n    \"params\": {\r\n        \"sender_name\": \"发件人姓名\",\r\n        \"sender_phone\": \"发件人手机号\",\r\n        \"sender_province\": \"发件人所在省\",\r\n        \"sender_city\": \"发件人所在市\",\r\n        \"sender_town\": \"发件人所在县/区\",\r\n        \"sender_detail\": \"发件人具体地址(不拼接省市区)\",\r\n        \"receiver_name\": \"收件人姓名\",\r\n        \"receiver_phone\": \"收件人手机号\",\r\n        \"receiver_province\": \"收件人所在省\",\r\n        \"receiver_city\": \"收件人所在市\",\r\n        \"receiver_town\": \"收件人所在县/区\",\r\n        \"receiver_address\": \"收件人具体地址(不拼接省市区)\",\r\n        \"wp_code\": \"快递公司编码\",\r\n        \"waybill_type\": \"1\",\r\n        \"goods_info\": {\r\n            \"index\": \"0\",\r\n            \"value\": \"\",\r\n            \"title\": \"商品标题\",\r\n            \"code\": \"商品编码\",\r\n            \"norm\": \"商品规格\",\r\n            \"num\": 1,\r\n            \"price\": 10,\r\n            \"weight\": 1,\r\n            \"volume\": 1\r\n        }\r\n    }\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/dyget-way-bill-plat-sd")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX")
  .addHeader("Content-Type", "application/json")
  .addHeader("Cookie", "PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=8553bce0fb442de06dee6025f9ea6cdb6731eca27a561ea545213d025e2fa832a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22_oSawXs4iNblqv-G-5mzO3bKquamluJ5%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();
Pyton请求代码示例
import requests

url = "http://api.vv-tool.com/tool/erps/dyget-way-bill-plat-sd"

payload="{\r\n    \"shop_id\": \"dwadaw***7dawd\",\r\n    \"platform\": \"授权渠道\",\r\n    \"params\": {\r\n        \"sender_name\": \"发件人姓名\",\r\n        \"sender_phone\": \"发件人手机号\",\r\n        \"sender_province\": \"发件人所在省\",\r\n        \"sender_city\": \"发件人所在市\",\r\n        \"sender_town\": \"发件人所在县/区\",\r\n        \"sender_detail\": \"发件人具体地址(不拼接省市区)\",\r\n        \"receiver_name\": \"收件人姓名\",\r\n        \"receiver_phone\": \"收件人手机号\",\r\n        \"receiver_province\": \"收件人所在省\",\r\n        \"receiver_city\": \"收件人所在市\",\r\n        \"receiver_town\": \"收件人所在县/区\",\r\n        \"receiver_address\": \"收件人具体地址(不拼接省市区)\",\r\n        \"wp_code\": \"快递公司编码\",\r\n        \"waybill_type\": \"1\",\r\n        \"goods_info\": {\r\n            \"index\": \"0\",\r\n            \"value\": \"\",\r\n            \"title\": \"商品标题\",\r\n            \"code\": \"商品编码\",\r\n            \"norm\": \"商品规格\",\r\n            \"num\": 1,\r\n            \"price\": 10,\r\n            \"weight\": 1,\r\n            \"volume\": 1\r\n        }\r\n    }\r\n}"
headers = {
  'Authorization': 'Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX',
  'Content-Type': 'application/json',
  'Cookie': 'PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=8553bce0fb442de06dee6025f9ea6cdb6731eca27a561ea545213d025e2fa832a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22_oSawXs4iNblqv-G-5mzO3bKquamluJ5%22%3B%7D'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

响应参数

名称 类型 示例值 描述
order_id string 订单号
waybillCode string 面单号!
parentWaybillCode string 父级面单号!
printData string 打印信息!
code string 状态:0 失败;1 成功!
err_msg string 信息提示
withholding_money int 该接口扣费金额(点券)

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1469,
    "time": 1617270403,
    "data": {
      "0":{
          "order_id": "47509**0A",
          "waybillCode": "777***5778",
          "parentWaybillCode": "",
          "printData": "{\"encryptedData\":\"a67d4819d0cd215********************d425ff963ff617195aab3729f75283d6204f621d882********def1ea9c11e7*****f5e2b7d1953e84dad92f8588d4ea1e7809ab9f2151ee808bc83d5ec*****2be58a542607a68a5a7a31e64e434141**************************a9da9630e2efe12b9\",\"templateUrl\":\"https:\\/\\/file-link.pinduoduo.com\\/sto_one\",\"signature\":\"WnZnc6LeteTsE+XP********************************fBR2s1+xasaKHEmaatHwLgAWQ5ZT5obRcGMWedF\\/coJue6************Xfa6+5bZtQvCE=\",\"ver\":\"3\"}",
          "code": 1,
          "err_msg": ""
      },
    "withholding_money":4
  }
}


响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
202 系统错误,请稍后再试 稍后重试,或者联系对接群
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权