全部
电子面单
物流轨迹
物流发货
在线测试

获取面单(非智能)


接口地址: http://api.vv-tool.com/tool/accounts/gcwb


接口介绍: 淘宝获取面单(非智能)


请求方式: POST


返回格式: JSON


接口收费: 扣账户余额


频率限制: 10 次/秒


请求头参数

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

请求参数

参数 类型 必选 描述
sellerNick string 掌柜号
shopCode string 菜鸟 token
senderAddress string 发货详细地址
orderNo string 订单号
goodsInfoList array 礼品信息
goodsCount string 礼品数量
goodsId string 礼品 id
goodsName string 礼品名称
goodsWeight string 礼品重量
receiverName string 收件人姓名
senderDistrict string 发货区县
receiverProvince string 收件省
senderProvince string 发货省
receiverCity string 收件市
senderCity string 发货市
templateUrl string 模板地址
receiverAddress string 收件详细地址
senderPhone string 发货人号码
senderName string 发货人姓名
receiverPhone string 收件人号码
receiverDistrict string 收件区
wpCode string YTO 快递编号

请求示例

{
    "sellerNick": "华为",
    "orderNo": "11112233223453",
    "receiverProvince": "浙江省",
    "receiverCity": "温州市",
    "receiverDistrict": "AAA区",
    "receiverAddress": "BBBBB公司",
    "receiverName": "X先生",
    "receiverPhone": "15088256666",
    "senderProvince": "湖北省",
    "senderCity": "孝感市",
    "senderDistrict": "NN市",
    "senderAddress": "MMMMM区",
    "senderName": "礼栈",
    "senderPhone": "18902446666",
    "templateUrl": "http://cloudprint.cainiao.com/template/standard/290659/40",(可以直接使用)
    "shopCode": "SaXR0ell54ekxkNxDTlpraw==",
    "wpCode": "YUNDA",
    "goodsInfoList": [{
    "goodsCount": 1,
    "goodsId": 14,
    "goodsImg": "",
    "goodsWeight": "0.02",
    "goodsName": "2020年新绿茶手工捏尖100g礼盒装浓香型送礼高端",
    "goodsPrice": 0.0,
    "goodsSpec": "200g礼盒装"
    }]
}

请求代码示例

cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/accounts/gcwb' \
--header 'Authorization: Bearer 777a2d62d6938f7d56a93423632c62850d513d77' \
--header 'Content-Type: application/json' \
--header 'Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=gptvic53o6k9mtu41vtv01jhpk; _csrf=9d99b24e587ae327d41222b64715c62cbf7f26e4dbb1e8b72f5168767948f528a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22w9tj4aF2NGE7agKb2x9d5Q36aRFgNtDJ%22%3B%7D' \
--data-raw '{
        
        "orderNo": "11112233223453",
        "receiverProvince": "浙江省",
        "receiverCity": "温州市",
        "receiverDistrict": "AAA区",
        "receiverAddress": "BBBBB公司",
        "receiverName": "X先生",
        "receiverPhone": "15088256666",
        "senderProvince": "湖北省",
        "senderCity": "孝感市",
        "senderDistrict": "NN市",
        "senderAddress": "MMMMM区",
        "senderName": "礼栈",
        "senderPhone": "18902446666",
        "templateUrl": "http://cloudprint.cainiao.com/template/standard/290659/40",(可以直接使用)
        "shopCode": "SaXR0ell54ekxkNxDTlpraw==",
        "wpCode": "YUNDA",
        "goodsInfoList": [{
        "goodsCount": 1,
        "goodsId": 14,
        "goodsImg": "",
        "goodsWeight": "0.02",
        "goodsName": "2020年新绿茶手工捏尖100g礼盒装浓香型送礼高端",
        "goodsPrice": 0.0,
        "goodsSpec": "200g礼盒装"
        }]
    }'

PHP请求代码示例
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/accounts/gcwb',
  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 =>'{
        
        "orderNo": "11112233223453",
        "receiverProvince": "浙江省",
        "receiverCity": "温州市",
        "receiverDistrict": "AAA区",
        "receiverAddress": "BBBBB公司",
        "receiverName": "X先生",
        "receiverPhone": "15088256666",
        "senderProvince": "湖北省",
        "senderCity": "孝感市",
        "senderDistrict": "NN市",
        "senderAddress": "MMMMM区",
        "senderName": "礼栈",
        "senderPhone": "18902446666",
        "templateUrl": "http://cloudprint.cainiao.com/template/standard/290659/40",(可以直接使用)
        "shopCode": "SaXR0ell54ekxkNxDTlpraw==",
        "wpCode": "YUNDA",
        "goodsInfoList": [{
        "goodsCount": 1,
        "goodsId": 14,
        "goodsImg": "",
        "goodsWeight": "0.02",
        "goodsName": "2020年新绿茶手工捏尖100g礼盒装浓香型送礼高端",
        "goodsPrice": 0.0,
        "goodsSpec": "200g礼盒装"
        }]
    }',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 777a2d62d6938f7d56a93423632c62850d513d77',
    'Content-Type: application/json',
    'Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=gptvic53o6k9mtu41vtv01jhpk; _csrf=9d99b24e587ae327d41222b64715c62cbf7f26e4dbb1e8b72f5168767948f528a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22w9tj4aF2NGE7agKb2x9d5Q36aRFgNtDJ%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        \r\n        \"orderNo\": \"11112233223453\",\r\n        \"receiverProvince\": \"浙江省\",\r\n        \"receiverCity\": \"温州市\",\r\n        \"receiverDistrict\": \"AAA区\",\r\n        \"receiverAddress\": \"BBBBB公司\",\r\n        \"receiverName\": \"X先生\",\r\n        \"receiverPhone\": \"15088256666\",\r\n        \"senderProvince\": \"湖北省\",\r\n        \"senderCity\": \"孝感市\",\r\n        \"senderDistrict\": \"NN市\",\r\n        \"senderAddress\": \"MMMMM区\",\r\n        \"senderName\": \"礼栈\",\r\n        \"senderPhone\": \"18902446666\",\r\n        \"templateUrl\": \"http://cloudprint.cainiao.com/template/standard/290659/40\",(可以直接使用)\r\n        \"shopCode\": \"SaXR0ell54ekxkNxDTlpraw==\",\r\n        \"wpCode\": \"YUNDA\",\r\n        \"goodsInfoList\": [{\r\n        \"goodsCount\": 1,\r\n        \"goodsId\": 14,\r\n        \"goodsImg\": \"\",\r\n        \"goodsWeight\": \"0.02\",\r\n        \"goodsName\": \"2020年新绿茶手工捏尖100g礼盒装浓香型送礼高端\",\r\n        \"goodsPrice\": 0.0,\r\n        \"goodsSpec\": \"200g礼盒装\"\r\n        }]\r\n    }");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/accounts/gcwb")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 777a2d62d6938f7d56a93423632c62850d513d77")
  .addHeader("Content-Type", "application/json")
  .addHeader("Cookie", "__yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=gptvic53o6k9mtu41vtv01jhpk; _csrf=9d99b24e587ae327d41222b64715c62cbf7f26e4dbb1e8b72f5168767948f528a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22w9tj4aF2NGE7agKb2x9d5Q36aRFgNtDJ%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

参数 类型 描述
url string url
code int 错误码 0 为成功
msg string 返回码描述
msec int 接口执行时间
time int 接口返回时间
orderNo string 订单号
printData string 打印数据
waybillNo string 面单号
withholding_money int 该接口扣费金额(点券)

返回数据

{
    "code": 0,
    "msg": "成功",
    "msec": 1193,
    "time": 1612416107,
    "data": {
				"withholding_money": 2,
        "orderNo": "11112233223453",
        "printData": "打印成功",
        "waybillNo":"49309976880"
    }
}

响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
202 系统错误,请稍后再试 稍后重试,或者联系对接群
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
401 身份凭证无效 在请求头中添加 access_token,重新更新 token
404 请求路径或请求方式错误 请更换请求方式或者检查路径是否正确