全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
非官方订单出单
接口地址: http://api.vv-tool.com/tool/erps/kswaybillfreewn
接口介绍: 非官方订单出单点击查看详情
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
owner_id | string | 是 | 店铺 ownerId |
order_sn | string | 是 | 自定义订单号,自行定义规则生成,8 以上即可 |
sender_name | string | 是 | 发货人姓名 |
sender_mobile | string | 是 | 发货人手机 |
sender_province | string | 是 | 发货省 |
sender_city | string | 是 | 发货市 |
sender_town | string | 是 | 区 |
sender_detail | string | 是 | 发货地详细地址 |
wp_code | string | 是 | 快递简写快递简写列表, |
waybill_type | string | 是 | 面单类型 1:一联单,2:二 联单,3:其他 ! |
shopCode | string | 是 | 订购软件里的店铺关联码(账号设置-店铺关联码) |
receiver_province | string | 是 | 收件省 |
receiver_city | string | 是 | 收件市 |
receiver_town | string | 是 | 收件县区 |
receiver_address | string | 是 | 收件地址 |
receiver_phone | string | 是 | 收件电话 |
receiver_name | string | 是 | 收件人 |
template_url | string | 是 | 标准模版地址 |
platform | string | 是 | 授权渠道 1 拼多多站外电子面单 2 淘宝菜鸟电子面单 3 菜鸟物流云电子面单(目前只能选 1) |
vvtype | int | 否 | |
template_url | string | 是 | 标准模版地址 |
请求示例
{
"owner_id": "22889722",
"sender_name": "张三",
"order_sn": "2125600010394222",
"sender_mobile": "18937052222",
"sender_province": "河南省",
"sender_city": "郑州市",
"sender_town": "中牟县",
"sender_detail": "幸福园",
"receiver_name": "张三",
"receiver_phone": "18937057052",
"receiver_province": "河南省",
"receiver_city": "郑州市",
"receiver_town": "中牟县",
"receiver_address": "幸福园",
"wp_code": "YUNDA",
"waybill_type": "2",
"shopCode": "22889722",
"template_url":"https://file-link.pinduoduo.com/yundaaaa"
}
请求代码示例
cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/getwaybillfreewn' \
--header 'Authorization: Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--header 'Cookie: PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=bbfd2eabf5b3920db30ec1841da280fc0dbbd20bb47606fb70dc59589bdb7028a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22e2Mj-LP98Vt2gauxRmXNjUi7wgUvNCzU%22%3B%7D' \
--data-raw '{
"owner_id": "123123",
"sender_name": "发件人姓名",
"sender_phone": "发件人手机号",
"order_sn": "自定义订单号",
"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",
"shopCode": "ffs"
}'
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/getwaybillfreewn',
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 =>'{
"owner_id": "123123",
"sender_name": "发件人姓名",
"sender_phone": "发件人手机号",
"order_sn": "自定义订单号",
"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",
"shopCode": "ffs"
}',
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX',
'Content-Type: application/json',
'Cookie: PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=bbfd2eabf5b3920db30ec1841da280fc0dbbd20bb47606fb70dc59589bdb7028a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22e2Mj-LP98Vt2gauxRmXNjUi7wgUvNCzU%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 \"owner_id\": \"123123\",\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 \"shopCode\": \"ffs\"\r\n}");
Request request = new Request.Builder()
.url("http://api.vv-tool.com/tool/erps/getwaybillfreewn")
.method("POST", body)
.addHeader("Authorization", "Bearer 43e61cb3a8d1367de949ecXXXXXXXXXXXXX")
.addHeader("Content-Type", "application/json")
.addHeader("Cookie", "PHPSESSID=ndkbjtm1hf9cilj25utcgopnnk; _csrf=bbfd2eabf5b3920db30ec1841da280fc0dbbd20bb47606fb70dc59589bdb7028a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22e2Mj-LP98Vt2gauxRmXNjUi7wgUvNCzU%22%3B%7D")
.build();
Response response = client.newCall(request).execute();
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
orderSn | string | 订单号 | |
objectId | string | 任务 id | |
printData | string | 打印信息 | |
waybillCode | string | 面单号 | |
parentWaybillCode | string | 父订单面单号 | |
code | string | 状态: 1 成功; 0 失败 | |
errorMsg | string | 错误信息 | |
withholding_money | int | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1306,
"time": 1631530654,
"data": {
"object_id": "1",
"print_data": "{\"encryptedData\":\"5ccb36c77db2ad2cd339c8e5b79ee955e9cfe477556608cb96e91202b65f874368e48784a94800a055092d83b67653683db94c5079d946fbd4dd04be3875863d70c4a33d4571c7df2eda7e1f9\",\"signature\":\"fhCAAO5rUeAoF7Jl2fFxcUQGwuBRXP9TWcpZA8vadi2SZhL3Ht7WTFDVclKy9EvRVm+6vFbJyVwig0BZXhCBusXQ0iR63H+TFXJm3vrJTNzuQkhDjZ7U2IexdyGQIad/1nALF6+3/SmkFU9yKc9Fei+PIAKkNQpcY/RMjbcNec4=\",\"templateUrl\":\"https://file-link.pinduoduo.com/yunda_std\",\"ver\":\"3\"}",
"waybill_code": "4610106702222",
"withholding_money": 1
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或者联系对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |