全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
通过订单号查询电子面单通接口
接口地址： http://api.vv-tool.com/tool/erps/tbddhcxmd
接口介绍： 通过订单号查询电子面单通接口 点击查看详情
必须用户授权 : 需要用户的授权，才能拿到被授权的数据
请求方式： POST
返回格式： JSON
接口收费： 扣账户余额
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
| 参数 | 类型 | 必选 | 示例 | 描述 |
|---|---|---|---|---|
| shop_id | string | 是 | 123 | 店铺 ID |
| param_list | WaybillDetailQueryByWaybillCodeRequest[] | 是 | 订单号列表(最多传 20 个) | |
| -biz_sub_code | String | 是 | 1111,2222 | 订单号 |
| -object_id | String | 是 | 1 | 请求 id |
| vvtype | int | 是 | 3 | 普通版 1，标准版 3 |
请求示例
{
"param_list": [
{
"biz_sub_code": "432151324512354123412",
"object_id": "123"
}
],
"vvtype": "3",
"shop_id": "123"
}
请求代码示例
cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/tbddhcxmd' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--header 'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=opvplhvshaldeu0t7qprgiclvf; _csrf=d2f486baf1b13ce48fdf2306f77381842ac6e81e5b4fd8a3d2d78b52bcb88d65a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%223tpHi936he9EP0uI_lql0YH4StENa9BI%22%3B%7D' \
--data-raw '{
"param_list": [
{
"biz_sub_code": "432151324512354123412",
"object_id": "123"
}
],
"vvtype": "3",
"shop_id": "123"
}'
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/tbddhcxmd',
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 =>'{
"param_list": [
{
"biz_sub_code": "432151324512354123412",
"object_id": "123"
}
],
"vvtype": "3",
"shop_id": "123"
}',
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer XXXXXXXXXXXXXXXX',
'Content-Type: application/json',
'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=opvplhvshaldeu0t7qprgiclvf; _csrf=d2f486baf1b13ce48fdf2306f77381842ac6e81e5b4fd8a3d2d78b52bcb88d65a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%223tpHi936he9EP0uI_lql0YH4StENa9BI%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 \"param_list\": [\r\n {\r\n \"biz_sub_code\": \"432151324512354123412\",\r\n \"object_id\": \"123\" }\r\n \r\n ],\r\n \"vvtype\": \"3\",\r\n \"shop_id\": \"123\"\r\n\t\t\r\n\t\t\r\n}");
Request request = new Request.Builder()
.url("http://api.vv-tool.com/tool/erps/tbddhcxmd")
.method("POST", body)
.addHeader("Authorization", "Bearer XXXXXXXXXXXXXXXX")
.addHeader("Content-Type", "application/json")
.addHeader("Cookie", "__yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=opvplhvshaldeu0t7qprgiclvf; _csrf=d2f486baf1b13ce48fdf2306f77381842ac6e81e5b4fd8a3d2d78b52bcb88d65a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%223tpHi936he9EP0uI_lql0YH4StENa9BI%22%3B%7D")
.build();
Response response = client.newCall(request).execute();
响应参数
| 参数 | 类型 | 示例 | 描述 |
|---|---|---|---|
| modules | WaybillCloudPrintWithResultDescResponse [] | x | 查询返回值 |
| error_code | String | xx | 单查询错误 code |
| error_message | String | x | 单查询错误 message |
| object_id | String | x | 请求 id |
| success | Boolean | x | 是否查询 |
| waybill_cloud_print_response | WaybillCloudPrintResponse | x | 面单信息 |
| print_data | String | x | 面单信息 |
| waybill_code | String | x | 面单号 |
| withholding_money | int | 1 | 该接口扣费金额（点券） |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1065,
"time": 1670987028,
"data": {
"modules": {
"waybill_cloud_print_with_result_desc_response": [
{
"object_id": "123",
"success": true,
"waybill_cloud_print_response": {
"print_data": "{\"encryptedData\":\"AES:rU904rj6UH2oqfSUb43+Z5CuoOkTVqESmlQ0tcJbrUBxXXIXMgzLoucuG7LXMGSfZY4FQV0sweilwFN6s1cLyoY70m4F4tr7S0ctYT0hgHkWN1OdVKVxYTK5moi1Ia6muDqSlVn8N+H1+gZXAKajQlY3ZdWQF/rEf3dU+nLfREkUkjtNmY3q4UPoaYnoIjUPFjdTnVSlcWEyuZqItSGuprg6kpVZ/Dfh9foGVwCmo0JoecQCBHsYuKW/VtVcV1RHaOjdYfjyGWsISFG2YQvTFeEWoUFmRYqv3Ywjb3iuwX0CYRN5xNOjwQ+CmpDP0k0h8IPEXUC7yuoAZpTngndmKg/+ApRmg4/0wSbft1eCJc8xcvuciQ9ri7xzvLjzu1qwjYgnPieb8zHW64vvGpPNqSBk0/Pi9+xkwwnJU1+/g8d7gisBuOLcITLTriDx3J+CGBi6uM7YN4+8g9M/BM9tvev8zsp2sAZZUCX5+oJai+nxVRMeG2rg8J4xKRZMswOOFjElXn1CkrczXkhqdL3A2vA5INmmOPyPN15TdJ9FcHtqpvaOEpNgyUMz+W6xkNHxZw5wtg1lksMFbyc01c9WBa7FeUwvKghA5qxB3cyS0NbbgoF2E/5QZBHyTIstZpg58BP6nD4df22A0YEXfq82Ofhpedalt6mRvGFs17i3cbGV56NmssJ47xHvSiDOIBt/AQt9Bo1tKenxtlo5407xupQlBPLXdIZWH9eh5tcqPCKpDJIGw/t2OZsCbB2w==\",\"signature\":\"MD:v1ucAeHvrultvmaEqKr/QA==\",\"templateURL\":\"http://cloudprint.cainiao.com/template/standard/290659\",\"ver\":\"waybill_print_secret_version_1\"}",
"waybill_code": "YT6867966788292"
}
},
{
"object_id": "1",
"success": true,
"waybill_cloud_print_response": {
"print_data": "{\"encryptedData\":\"AES:rU904rj6UH2oqfSUb43+Z5CuoOkTVqESmlQ0tcJbrUBxXXIXMgzLoucuG7LXMGSfZY4FQV0sweilwFN6s1cLyoY70m4F4tr7S0ctYT0hgHkWN1OdVKVxYTK5moi1Ia6muDqSlVn8N+H1+gZXAKajQlY3ZdWQF/rEf3dU+nLfREkUkjtNmY3q4UPoaYnoIjUPFjdTnVSlcWEyuZqItSGuprg6kpVZ/Dfh9foGVwCmo0JoecQCBHsYuKW/VtVcV1RHaOjdYfjyGWsISFG2YQvTFeEWoUFmRYqv3Ywjb3iuwX0CYRN5xNOjwQ+CmpDP0k0h8IPEXUC7yuoAZpTngndmKg/+ApRmg4/0wSbft1eCJc8xcvuciQ9ri7xzvLjzu1qwbu05z5NAzUMesECGl7shgwwyQPPbc4k+vQ06dZ8ZGWkZYkzDxnk8JglSLlv3o4LqP72mloE4P6uMr1YW4ZqrX3U1MteYZN+cETASfBQ+8VqsL3CWQ+h88X5CsHcNhVPx8edwsb/tw6noRagipDe+7g/VZNcFF8G7eV6vE/LR/3qsOkz62ncLaxn7gr8CiWufDgklqQOVvQqE4wHnrZcv+G0GwyWK0WgvuLQIjTKAHprFGl8XJs27Nz4W6UN/Q1BGZBGNyST+w+ZUI+Ky8R5AsLXy7+4lSx+2h+ZYOQTVH60OVUROsMIjNl9hYmUmbwhHefKosiOPfnF1e8zPSnmbI9Mqqp473sa5pS/wEfobHnFM3GKjrIpgsuxyZV3k4s6mhpKmh8d/QB2/aZq5KK/q90MbeUydyL0SqawwUNHfRYDB4Mic7Vkk98P3heYdXghTtrLGj286DRDYmBqe8Sqx/PleyhJg5WoNeFzmuBfs0GvJkuBCiiwii0P5/jzl0J0R4HKSw==\",\"signature\":\"MD:/cW5RdjGMnS8m82lrTAfSQ==\",\"templateURL\":\"http://cloudprint.cainiao.com/template/standard/290659\",\"ver\":\"waybill_print_secret_version_1\"}",
"waybill_code": "YT6858410625590"
}
},
{
"object_id": "123",
"success": true,
"waybill_cloud_print_response": {
"print_data": "{\"encryptedData\":\"AES:rU904rj6UH2oqfSUb43+Z5CuoOkTVqESmlQ0tcJbrUBxXXIXMgzLoucuG7LXMGSfZY4FQV0sweilwFN6s1cLyoY70m4F4tr7S0ctYT0hgHkWN1OdVKVxYTK5moi1Ia6muDqSlVn8N+H1+gZXAKajQlY3ZdWQF/rEf3dU+nLfREkUkjtNmY3q4UPoaYnoIjUPFjdTnVSlcWEyuZqItSGuprg6kpVZ/Dfh9foGVwCmo0JoecQCBHsYuKW/VtVcV1RHaOjdYfjyGWsISFG2YQvTFeEWoUFmRYqv3Ywjb3iuwX0CYRN5xNOjwQ+CmpDP0k0h8IPEXUC7yuoAZpTngndmKg/+ApRmg4/0wSbft1eCJc8xcvuciQ9ri7xzvLjzu1qwjYgnPieb8zHW64vvGpPNqfrSMvVBxCgEdEvQJkD1OB9eIhyCUfroeKQiBrjlksMFbyc01c9WBa7FeUwvKghA5qxB3cyS0NbbgoF2E/5QZBHyTIstZpg58BP6nD4df22A0YEXfq82Ofhpedalt6mRvGFs17i3cbGV56NmssJ47xHvSiDOIBt/AQt9Bo1tKenxtlo57vvh4P9NWfxh0SEeyivnUUcqPCKpDJIGw/t2OZsCbB2w==\",\"signature\":\"MD:ScPWszFUFPdvl7ORWAiGNQ==\",\"templateURL\":\"http://cloudprint.cainiao.com/template/standard/290659\",\"ver\":\"waybill_print_secret_version_1\"}",
"waybill_code": "YT6858410626051"
}
}
]
},
"request_id": "16kfhowt9q2vy",
"withholding_money": 2
}
}
错误码 点击查看详情：查看