# 自由出单
接口地址: http://www.damaijia168.com/vv/external/dygetWayBillPlatSd
请求方式: POST
传参方式: JSON
返回格式: JSON
# 请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | 1798c6aadec33d1bc2f5b707f1049aefexxxx |
# 请求参数
| 参数 | 类型 | 必选 | 描述 |
|---|---|---|---|
| shop_id | string | 是 | 店铺id |
| platform | string | 是 | 授权渠道1 拼多多站外电子面单 2 淘宝菜鸟电子面单 3 菜鸟物流云电子面单 |
| 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}] |
| owner_id | string | 否 | 可选,不传,默认使用,对应手机号账号下的第一个授权出单账号,拼多多出单店铺的 owner_id,具体获取可查看拼多多文档 选填,不填就默认使用第一个授权的电子面单店铺,如果是多个出单店铺,请传递过来 |
| edition | string | 否 | 版本 默认:1(不传默认为1) 1:1.0,2:2.0 |
# 请求示例
{
"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
}
}
}
# 请求代码示例
cURL请求代码示例
curl --location --request POST 'http://www.damaijia168.com/vv/external/dygetWayBillPlatSd' \
--header 'Authorization: 43e61cb3a8d1367de949ecXXXXXXXXXXXXX' \
--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://www.damaijia168.com/vv/external/dygetWayBillPlatSd',
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: 43e61cb3a8d1367de949ecXXXXXXXXXXXXX'
),
));
$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://www.damaijia168.com/vv/external/dygetWayBillPlatSd")
.method("POST", body)
.addHeader("Authorization", "43e61cb3a8d1367de949ecXXXXXXXXXXXXX")
.build();
Response response = client.newCall(request).execute();
Pyton请求代码示例
# 响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| result | int | 1 | 返回码 |
| data | object | {} | 买家服务关系信息 |
| --order_id | string | 订单号 | |
| --waybill_code | string | 面单号! | |
| --parent_waybill_code | string | 父级面单号! | |
| --print_data | string | 打印信息! | |
| --code | string | 状态:0 失败;1 成功! | |
| --err_msg | string | 信息提示 | |
| deduct_money | int | 消耗点券 | |
| status | int | 状态码,0为成功 |
# 返回数据
{
"data": {
"result": 1,
"data": {
"0":{
"order_id": "47509**0A",
"waybill_code": "777***5778",
"parent_waybill_code": "",
"print_data": "{\"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": ""
},
"message": "SUCCESS",
"deduct_money":4
},
"status": 0
}
# 响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常:API调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |