最新更新時間：2021.07.22 版本說明
微信支付按天提供分賬賬單文件，商戶可以通過該接口獲取賬單文件的下載地址。
? 微信側(cè)未成功的分賬單不會出現(xiàn)在對賬單中。
? 對賬單中涉及金額的字段單位為“元”。
? 對賬單接口只能下載三個月以內(nèi)的賬單。
文件格式說明：
? 賬單文件包括明細數(shù)據(jù)和匯總數(shù)據(jù)兩部分，每一部分都包含一行表頭和若干行具體數(shù)據(jù)。
? 明細數(shù)據(jù)每一行對應(yīng)一筆分賬或一筆回退，同時每一個數(shù)據(jù)前加入了字符`，以避免數(shù)據(jù)被Excel按科學(xué)計數(shù)法處理。如需匯總金額等數(shù)據(jù)，可以批量替換掉該字符。
適用對象： 直連商戶
請求URL：https://api.mch.weixin.qq.com/v3/profitsharing/bills
請求方式：GET
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請求URL傳參
body指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 賬單日期 | bill_date | string[1,10] | 是 | query 格式y(tǒng)yyy-MM-DD 僅支持三個月內(nèi)的賬單下載申請。 示例值：2019-06-11 |
| 壓縮類型 | tar_type | string[1,32] | 否 | query 不填則默認(rèn)是數(shù)據(jù)流 枚舉值： GZIP：返回格式為.gzip的壓縮包賬單 示例值：GZIP |
https://api.mch.weixin.qq.com/v3/profitsharing/bills?bill_date=2020-12-31
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 哈希類型 | hash_type | string[1,32] | 是 | 原始賬單（gzip需要解壓縮）的摘要值，用于校驗文件的完整性。 示例值：SHA1 |
| 哈希值 | hash_value | string[1,1024] | 是 | 原始賬單（gzip需要解壓縮）的摘要值，用于校驗文件的完整性。 示例值：79bb0f45fc4c42234a918000b2668d689e2bde04 |
| 賬單下載地址 | download_url | string[1,2048] | 是 | 供下一步請求賬單文件的下載地址，該地址30s內(nèi)有效。 示例值：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"
}
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常，請使用相同參數(shù)稍后重新調(diào)用 |
| 400 | PARAM_ERROR | 日期格式不正確 | 請使用正確的參數(shù)重新調(diào)用 |
| 429 | RATELIMIT_EXCEEDED | 商戶發(fā)起獲取賬單的頻率過高 | 請降低頻率后重試 |
| 400 | INVALID_REQUEST | 服務(wù)商和分賬方無受理關(guān)系 | 請檢查子商戶號是否正確 |
| 400 | INVALID_REQUEST | 請求的賬單日期已過期 | 請調(diào)整賬單日期 |
| 400 | INVALID_REQUEST | 請求的賬單正在生成中 | 請確認(rèn)賬單時間是否正確，當(dāng)日的賬單會在次日上午10點以后可供下載 |
| 400 | NO_STATEMENT_EXIST | 賬單文件不存在 | 請確認(rèn)賬單時間是否正確，當(dāng)日的賬單會在次日上午10點以后可供下載 |