全部
淘宝
拼多多
抖音
京东
快手
当当
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 | 否 | 普通版 1，增强版 2，专业版 3，无效数据或则不传默认为 3 |
请求示例
{
}
请求代码示例
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 | 未授权店铺 | 根据返回链接进行扫码授权 |