最新更新时间：2021.07.22 版本说明
微信支付按天提供分账账单文件，商户可以通过该接口获取账单文件的下载地址。
• 微信侧未成功的分账单不会出现在对账单中。
• 对账单中涉及金额的字段单位为“元”。
• 对账单接口只能下载三个月以内的账单。
文件格式说明：
• 账单文件包括明细数据和汇总数据两部分，每一部分都包含一行表头和若干行具体数据。
• 明细数据每一行对应一笔分账或一笔回退，同时每一个数据前加入了字符`，以避免数据被Excel按科学计数法处理。如需汇总金额等数据，可以批量替换掉该字符。
适用对象： 直连商户
请求URL：https://api.mch.weixin.qq.com/v3/profitsharing/bills
请求方式：GET
path指该参数为路径参数
query指该参数需在请求URL传参
body指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 账单日期 | bill_date | string[1,10] | 是 | query 格式yyyy-MM-DD 仅支持三个月内的账单下载申请。 示例值：2019-06-11 |
| 压缩类型 | tar_type | string[1,32] | 否 | query 不填则默认是数据流 枚举值： GZIP：返回格式为.gzip的压缩包账单 示例值：GZIP |
https://api.mch.weixin.qq.com/v3/profitsharing/bills?bill_date=2020-12-31
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 哈希类型 | hash_type | string[1,32] | 是 | 原始账单（gzip需要解压缩）的摘要值，用于校验文件的完整性。 示例值：SHA1 |
| 哈希值 | hash_value | string[1,1024] | 是 | 原始账单（gzip需要解压缩）的摘要值，用于校验文件的完整性。 示例值：79bb0f45fc4c42234a918000b2668d689e2bde04 |
| 账单下载地址 | download_url | string[1,2048] | 是 | 供下一步请求账单文件的下载地址，该地址30s内有效。 示例值：https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx |
{
"download_url": "https://api.mch.weixin.qq.com/v3/billdownload/file?token=6XIv5TUPto7pByrTQKhd6kwvyKLG2uY2wMMR8cNXqaA_Cv_isgaUtBzp4QtiozLO",
"hash_type": "SHA1",
"hash_value": "8823044c286bea726f149bfcfce0b0318122d755"
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系统错误 | 系统异常，请使用相同参数稍后重新调用 |
| 400 | PARAM_ERROR | 日期格式不正确 | 请使用正确的参数重新调用 |
| 429 | RATELIMIT_EXCEEDED | 商户发起获取账单的频率过高 | 请降低频率后重试 |
| 400 | INVALID_REQUEST | 服务商和分账方无受理关系 | 请检查子商户号是否正确 |
| 400 | INVALID_REQUEST | 请求的账单日期已过期 | 请调整账单日期 |
| 400 | INVALID_REQUEST | 请求的账单正在生成中 | 请确认账单时间是否正确，当日的账单会在次日上午10点以后可供下载 |
| 400 | NO_STATEMENT_EXIST | 账单文件不存在 | 请确认账单时间是否正确，当日的账单会在次日上午10点以后可供下载 |