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

平台出单


接口地址: http://api.vv-tool.com/tool/erps/ks-platform-the-single


接口介绍: 平台出单


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


请求方式: POST


返回格式: JSON


接口收费: 联系运营


频率限制: 10 次/秒


请求头参数

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

请求参数

参数 类型 必选 描述
owner_id string 店铺 ownerId
shop_id string 快手小店 id
sender_name string 发货人姓名
sender_mobile string 发货人手机
province string 发货省
city string 发货市
district string
detail string 发货地详细地址
wp_code string 快递简写快递简写列表,
waybill_type string 面单类型 1:一联单,2:二 联单,3:其他
shop_code string 订购软件里的店铺关联码(账号设置-店铺关联码)
template_url string 标准模版地址
order_sn_list[] string 订单号 索引数组["201117-68182136402308", "201117-431312312902308"],数组里每有一个订单,便请求一次打单,扣费是按订单数量来算
platform string 授权渠道
1 拼多多站外电子面单
2 淘宝菜鸟电子面单
3 菜鸟物流云电子面单(目前只能选 1)
vvtype int 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2
template_url string 标准模版地址

请求示例

{
    "shop_id": "2394900222",
    "owner_id": "228897222",
    "sender_name": "张三",
    "sender_mobile": "18937057052",
    "province": "河南省",
    "city": "郑州市",
    "district": "中牟县",
    "detail": "幸福园",
    "wp_code": "YUNDA",
    "waybill_type":"1",
    "template_url":"https://file-link.pinduoduo.com/yunda_std",
    "type": 1,
    "order_sn_list": [
        "2125600010394222",
        "2125600010394222"
    ]
}

请求代码示例

cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/ks-platform-the-single' \
--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": "发件人手机号",
    "province": "发件人所在省",
    "city": "发件人所在市",
    "town": "发件人所在县/区",
    "detail": "发件人具体地址(不拼接省市区)",
    "wp_code": "快递公司编码",
    "waybill_type": "1",
    "shop_code": "ffs",
    "order_sn_list": [
        "201117-68182136402308",
        "201117-431312312902308"
    ]
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/ks-platform-the-single',
  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": "发件人手机号",
    "province": "发件人所在省",
    "city": "发件人所在市",
    "town": "发件人所在县/区",
    "detail": "发件人具体地址(不拼接省市区)",
    "wp_code": "快递公司编码",
    "waybill_type": "1",
    "shop_code": "ffs",
    "order_sn_list": [
        "201117-68182136402308",
        "201117-431312312902308"
    ]
}',
  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    \"province\": \"发件人所在省\",\r\n    \"city\": \"发件人所在市\",\r\n    \"town\": \"发件人所在县/区\",\r\n    \"detail\": \"发件人具体地址(不拼接省市区)\",\r\n    \"wp_code\": \"快递公司编码\",\r\n    \"waybill_type\": \"1\",\r\n    \"shop_code\": \"ffs\",\r\n    \"order_sn_list\": [\r\n        \"201117-68182136402308\",\r\n        \"201117-431312312902308\"\r\n    ]\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/ks_platform_the_single")
  .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": 1939,
    "time": 1631527351,
    "data": {
        "result": [
            {
                "orderSn": "2125600010394222",
                "objectId": "1",
                "printData": "{\"encryptedData\":\"5ccb36c77db2ad2cd339c8e5b79ee95500a9637c4039d46904c3db976e03afe2d7c806c80ab6620eb99225c0a42bf3c05fea1dc56fa53cf8ab895655a41a40904a6291fd5c91138517e8c39a0db347b0c7868c1fa684db920ea14dd2d73bbd61045ab1f14306ab6c59eb5fb99d559d51353a0d87b9790cec4f5f22664b750c4a1a6e759c0e1b3af6cdc05dbe2001dd3713a46a41b5\",\"signature\":\"nDVx2/tvgOIWJLFpro1mFF2AyYogqbfv4xw8O7qbnYq5LKLfiJS0+8s8d9EWo8BSFCQ+Vgs6GUcCAPrWxDbUdh+FoSu9G3aEIn40/BEK00=\",\"templateUrl\":\"https://file-link.pinduoduo.com/yunda_std\",\"ver\":\"1\"}",
                "waybillCode": "4610105502222",
                "code": 0,
                "errorMsg": null
            }
        ],
        "withholding_money": 1
    }
}


响应代码

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