1package com.java.downloadbilldemo;
2import com.java.demo.GetTradeBill; // 使用合作伙伴平台申请所有/单个特约商户交易账单接口 https://pay.weixin.qq.com/doc/v3/partner/4013080595
3import static com.java.demo.GetTradeBill.*; // 使用合作伙伴平台申请所有/单个特约商户交易账单接口 https://pay.weixin.qq.com/doc/v3/partner/4013080595
4import com.java.demo.DownloadBill; // 使用合作伙伴平台下载账单接口 https://pay.weixin.qq.com/doc/v3/partner/4013080597
5import static com.java.demo.DownloadBill.*; // 使用合作伙伴平台下载账单接口 https://pay.weixin.qq.com/doc/v3/partner/4013080597
6import com.java.utils.WXPayUtility; // 引用微信支付工具库，参考：https://pay.weixin.qq.com/doc/v3/partner/4014985777
7
8public class DownloadBillDemo {
9    public static void main(String[] args) {
10        GetTradeBill getTradeBill = new GetTradeBill(
11            "19xxxxxxxx",                    // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
12            "1DDE55AD98Exxxxxxxxxx",         // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
13            "/path/to/apiclient_key.pem",    // 商户API证书私钥文件路径，本地文件路径
14            "PUB_KEY_ID_xxxxxxxxxxxxx",      // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
15            "/path/to/wxp_pub.pem"           // 微信支付公钥文件路径，本地文件路径
16        );
17
18        DownloadBill downloadBill = new DownloadBill(
19            "19xxxxxxxx",                    // 商户号，是由微信支付系统生成并分配给每个商户的唯一标识符，商户号获取方式参考 https://pay.weixin.qq.com/doc/v3/partner/4013080340
20            "1DDE55AD98Exxxxxxxxxx",         // 商户API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013058924
21            "/path/to/apiclient_key.pem",    // 商户API证书私钥文件路径，本地文件路径
22            "PUB_KEY_ID_xxxxxxxxxxxxx",      // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/v3/partner/4013038589
23            "/path/to/wxp_pub.pem"           // 微信支付公钥文件路径，本地文件路径
24        );
25        try {
26            GetTradeBillRequest getTradeBillRequest = new GetTradeBillRequest();
27            getTradeBillRequest.subMchid = "19xxxxxxxx";  // 特约商户号，服务商可通过该参数指定获取某个子商户的账单，不填则返回服务商下所有子商户的全量账单。
28            getTradeBillRequest.billDate = "2025-08-11";  // 期望申请下载的账单日期
29            getTradeBillRequest.billType = BillType.ALL;  // 期望申请下载的账单类型
30            getTradeBillRequest.tarType = GetTradeBill.TarType.GZIP;  // 期望申请下载的账单类型
31
32            QueryBillEntity response = getTradeBill.run(getTradeBillRequest);
33
34            System.out.println("Download URL: " + response.downloadUrl);
35
36            DownloadBillRequest downloadBillRequest = new DownloadBillRequest();
37            downloadBillRequest.downloadUrl = response.downloadUrl;
38            downloadBillRequest.localFilePath = "test.csv";  // 期望下载的账单文件路径
39            downloadBillRequest.tarType = DownloadBill.TarType.valueOf(getTradeBillRequest.tarType.name());
40            downloadBillRequest.expectedHashType = DownloadBill.HashType.valueOf(response.hashType.name());
41            downloadBillRequest.expectedHashValue = response.hashValue;
42
43            downloadBill.run(downloadBillRequest);
44
45            System.out.println("File downloaded successfully! Local file path: " + downloadBillRequest.localFilePath);
46            // TODO: 请求成功，继续业务逻辑
47        } catch (WXPayUtility.ApiException e) {
48            // TODO: 请求失败，根据状态码执行不同的逻辑
49            if (e.getErrorCode().equals("NO_STATEMENT_EXIST")) {
50                // 错误：账单不存在
51                // 解决方式：请检查当前商户号在指定日期内是否有成功的交易或退款
52                // 描述：说明指定日期无账单文件生成。若无交易，则无需重试
53            } else if (e.getErrorCode().equals("STATEMENT_CREATING")) {
54                // 错误：账单正在生成中
55                // 解决方式：请检查当前商户号在指定日期内是否有成功的交易或退款
56                // 描述：说明指定日期账单正在生成中。若无交易，则无需重试；若有交易，则在T+1日上午10点后再重新下载
57            } else if (e.getErrorCode().equals("SYSTEM_ERROR")) {
58                // 错误：系统错误
59                // 解决方式：稍后重试
60                // 描述：微信支付系统失败，系统失败直接立即重试大概率还会是系统失败，建议等1分钟后再重试
61            } else if (e.getErrorCode().equals("FREQUENCY_LIMITED")) {
62                // 错误：限频报错
63                // 解决方式：稍后重试
64                // 描述： 接口频率限制，直接立即重试大概率还会是系统失败，建议等1分钟后再重试
65            } else if (e.getErrorCode().equals("SIGN_ERROR")) {
66                // 错误：签名错误
67                // 解决方式：检查平台商户证书序列号，证书私钥文件，公钥ID，公钥文件，同时确认下签名过程是不是按照微信支付的签名方式
68                // 描述：签名报错，需要确认签名材料和签名流程是否正确
69            } else if (e.getErrorCode().equals("PARAM_ERROR")) {
70                // 错误：参数错误
71                // 解决方式：按照报错返回的message，重新输入请求参数
72                // 描述：参数的类型，长度，或者必填选项没有填写等
73            } else if (e.getErrorCode().equals("INVALID_REQUEST")) {
74                // 错误：请求非法，请求参数正确，但是不符合下载账单业务规则
75                // 解决方式：根据具体message查看具体哪里不符合业务规则，如果可以修改参数达到符合业务规则的修改请求符合业务规则之后再重试
76                // 描述：不符合业务规则的场景如：
77                // - 账单时间超过180天，不允许申请下载账单
78            } else {
79                // 其他类型错误：稍等一会后重试
80            }
81        }
82    }
83}
84