接口名稱：查詢對賬單下載下傳位址接口
英文名稱：alipay.data.dataservice.bill.downloadurl.query
用于查詢訂單是否存在以及訂單的詳細資訊；
一、文檔位址
官方文檔位址：[url]https://docs.open.alipay.com/api_1/alipay.trade.query/[/url]
二、開發前準備工作
調用步驟：[url]https://openclub.alipay.com/read.php?tid=12194&fid=69[/url]
注意事項：1、支援沙箱測試；2、需簽約并添加功能；3、支援第三方調用。
如何簽約以及簽約無法成功等相關簽約問題：[url]https://openclub.alipay.com/read.php?tid=276&fid=72[/url]
注：該接口為輔助接口，隻要簽約當面付、手機網站支付、電腦網站支付和APP支付，四個支付接口中其中一個就可以調用。
三、接口內建代碼示例
1、參數說明
（1）bill_type：賬單類型，可設定參數類型：trade、signcustomer；
trade指商戶基于支付寶交易收單的業務賬單；
signcustomer是指基于商戶支付寶餘額收入及支出等資金變動的帳務賬單；
（2）bill_date：賬單時間：日賬單格式為yyyy-MM-dd，月賬單格式為yyyy-MM；
2、JAVA版請求示例
public static void main(String[] args) throws AlipayApiException {
AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.gatewayUrl, AlipayConfig.app_id, AlipayConfig.merchant_private_key, AlipayConfig.format, AlipayConfig.charset, AlipayConfig.alipay_public_key, AlipayConfig.sign_type);
AlipayDataDataserviceBillDownloadurlQueryRequest request = new AlipayDataDataserviceBillDownloadurlQueryRequest();
AlipayDataDataserviceBillDownloadurlQueryModel model = new AlipayDataDataserviceBillDownloadurlQueryModel();
//賬單時間：日賬單格式為yyyy-MM-dd，月賬單格式為yyyy-MM。
model.setBillDate("2018-01");
//賬單類型，trade指商戶基于支付寶交易收單的業務賬單；signcustomer是指基于商戶支付寶餘額收入及支出等資金變動的帳務賬單；
// trade用于當面付，signcustomer用于其他支付接口
// 隻簽約當面付的情況下，trade資料是隻能查詢簽約之後的資料，但是signcustomer是之前也可以查詢
model.setBillType("signcustomer");
request.setBizModel(model);
AlipayDataDataserviceBillDownloadurlQueryResponse response = alipayClient.execute(request);
System.out.println(response.getBody());
} 傳回的響應參數示例：
{"alipay_data_dataservice_bill_downloadurl_query_response":{"code":"10000","msg":"Success","bill_download_url":"http://dwbillcenter.alipay.com/downloadBillFile.resource?bizType=fnd&userId=20885016245603350156&fileType=csv.zip&bizDates=201801&downloadFileName=20885016245603350156_201801.csv.zip&fileId=%2Ffnd%2F20885016245603350156%2F201801.csv.zip×tamp=1517903886&token=2c2bb5ad14b313d9b0959cd2006d6251"},"sign":"Fmz5F1hg9oqjB5qKAK9g9VOcL0hTQ4UIfdnEJ5HRaUtYWKWH01q9ngMpQ4EpGQ2Lg7gh/YKynKe4Pyxs/OeFZtgbOZgKlXcxZGAk2oRjidytv2fbaxEvUZ7OyjVPeltGTiaTtTXhOdtH7zm37IJ2FqMkDGZTOzibb/nsWbr03WIjt6tRSX4M2ohJi/GcmsTL0YIaPJn4sjnaZCn17hr9lBSRaM1P8mE/v7SxungalibODmX/raxittip9BqcUESH5hUIuDBdIO15/CqVG/r3wLuiTZGit52txGfl777dPa5AEjmjHxzgcd1T4PI84ZgmpM+5raKV9a4a2X8R5xuEaw=="} 3、PHP版請求示例
<?php
require_once 'AopSdk.php';
$aop = new AopClient ();
$aop->appId = '填寫您的appid';
$aop->rsaPrivateKey = '填寫您的私鑰';
$aop->alipayrsaPublicKey='填寫您的支付寶公鑰';
$aop->gatewayUrl = 'https://openapi.alipay.com/gateway.do';
$aop->apiVersion = '1.0';
$aop->signType = 'RSA2';
$aop->postCharset='utf-8';
$aop->format='json';
$date=date("YmdHis");
$arr=range(1000,9999);
shuffle($arr);
$request = new AlipayDataDataserviceBillDownloadurlQueryRequest ();
$request->setBizContent("{" .
""bill_type":"signcustomer"," .
""bill_date":"2018-01"" .
" }");
$result = $aop->execute($request);
//第三方調用
//$result = $aop->execute($request,"","app_auth_token");
echo json_encode($result); 傳回的響應參數示例
{"alipay_data_dataservice_bill_downloadurl_query_response":{"code":"10000","msg":"Success","bill_download_url":"http://dwbillcenter.alipaydev.com/downloadBillFile.resource?bizType=signcustomer&userId=20881021801985850156&fileType=csv.zip&bizDates=201801&downloadFileName=20881021801985850156_201801.csv.zip&fileId=%2Fsigncustomer%2F20881021801985850156%2F201801.csv.zip×tamp=1553248966&token=82bf804e4576d0a5ce566b26b5b54d14"},"sign":"hpStCjmmKUmiyuJGHJ7d+YUBetnqpNcn2x8z4GDNETyV5LYnFSj1FHakmJ/wkETinXJD0cS0HQHbE3/rCj4UOTBJvrHOwlBIIE79jz0WcX3aw50xCwGt9aJF2fbBKv21cYRoX94/j3YN2gZbe25hr9yToNN+kaIpU1AZRkqtXNn/bU08e7g8pF1Sfn12E72JkDwQ1PYr9XS9dBZdKWcMKSTAG4C8oCWP0ani1JrEHEZxOWnrDyz0Pawo6IY5yajgmjkbpp4Y1Nu5Uw3510GuOFMNwNaCnW82h3osOBF7luDhwLSi+F8AnJxZoyFOUhEP0KzdFlI3MmMPLNcz7A6ROA=="} 4、.NET版請求示例
IAopClient client = new DefaultAopClient(config.gatewayUrl, config.app_id, config.private_key, "json", "1.0", "RSA2", config.alipay_public_key, config.charset, false);
AlipayDataDataserviceBillDownloadurlQueryRequest request = new AlipayDataDataserviceBillDownloadurlQueryRequest();
request.BizContent="{" +
""bill_type":"trade"," +
""bill_date":"2018-06"" +
"}";
AlipayDataDataserviceBillDownloadurlQueryResponse response = client.Execute(request);
{"alipay_data_dataservice_bill_downloadurl_query_response":{"code":"10000","msg":"Success","bill_download_url":"http://dwbillcenter.alipaydev.com/downloadBillFile.resource?bizType=trade&userId=20881021701192600156&fileType=csv.zip&bizDates=201806&downloadFileName=20881021701192600156_201806.csv.zip&fileId=%2Ftrade%2F20881021701192600156%2F201806.csv.zip×tamp=1553589447&token=14bffc878e152701b10b98b0127cc332"},"sign":"Q91rvMbo4agL95YPZVp0UgEPlzLdPXGN5dJBibEWNF41RSTJGajTSHjDeNp9m3vHlwaYQy8f7pyeGfdoIRSZL0/xP+qcEAwBlqzzN36xCcQyRqOLaeTvCRtZMMV6W3pnGqxR/hwoKDgjU6F472IS2CPNWlmqgDM3UZNQfKAwU6oCmZoUvIJ7TcZhCeiVcpslc80wGzaAHl1IwLI/ZejV/YbUgmWdi0eu2PmV3+iTla2dtesQusHorDcNJAdUxmOc5wfhy2hK5hawIvAP7DQIa39Ban8DS32Tt4q+FbYlbp0fbO+fpqmCumke6zj6WJWowjDhawA008nRaA64Upw4hw=="} 三、注意事項
1、 如何下載下傳對賬單
直接将響應參數生成的bill_download_url進行浏覽器通路下載下傳。
2、對賬單bill_type類型解析
trade：商戶基于支付寶交易收單的業務賬單，即調用支付寶交易接口産生的交易資訊，不包含非接口交易的賬單資訊
signcustomer：基于商戶支付寶餘額收入及支出等資金變動的帳務賬單，即所有支付寶餘額産生的變動的交易資訊，包含調用接口産生的交易賬單以及非接口交易的賬單資訊
3、bill_download_ur有效期
bill_download_ur參數自接口調用生成，有效期為30s。
4、對賬下載下傳日期
賬單下載下傳日期支援下載下傳日賬單，月賬單，不支援年度賬單。
日賬單：日賬單不支援下載下傳當日賬單，隻能下載下傳前一日24點前的賬單（T+1），日期格式如：2018-01-05
注：建議在第二日10:00以後下載下傳
月賬單：月賬單不支援下載下傳當月賬單，隻能下載下傳上一月的賬單資訊，日期格式如：2018-01。
注：月賬單一般會在次月 4 日或之前生成，建議次月4号或後面日期下載下傳。
曆史賬單最久可以下載下傳30個月之前的賬單，具體的下載下傳時間以實際可下載下傳時間為準。
5、賬單表格資料詳解
具體賬單表格資料建議咨詢商戶客服：線上咨詢請點選以下連結：[url]https://cschannel.alipay.com/newPortal.htm?scene=kfpt&token=&pointId=&enterurl=https%3A%2F%2Fopen.alipay.com%2Fplatform%2Fhome.htm[/url]。商戶服務電話：0571-88158090
四、常見接口報錯
賬單資料亂碼、下載下傳逾時等接口報錯和對賬單位址參數解析詳解：[url]https://openclub.alipay.com/read.php?tid=4637&fid=72[/url]
如果還是報錯，請按如下方式進行提問：
正确提問方式：使用環境（沙箱還是正式環境）+接口名稱（中文+英文）+ 請求參數 + 報錯資訊詳情
![在SAP Business Application Studio裡建立Fiori應用的操作流程[圖]](data:image/gif;base64,R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs=)