# 寫在前面
本文將介紹交易賬單文件的格式，閱讀本文前可先瀏覽：
# 數(shù)據(jù)組成說明
微信支付的資金賬單的出賬周期是“每日”，日切時(shí)間是每日的00:00:00。資金賬單的數(shù)據(jù)包括不同的業(yè)務(wù)類型，可通過賬單中的業(yè)務(wù)名稱、業(yè)務(wù)類型字段區(qū)分。
# 文件格式說明
每一份賬單文件在結(jié)構(gòu)上都包含以下四個(gè)部分：
- 明細(xì)數(shù)據(jù)表頭
- 明細(xì)數(shù)據(jù)
- 匯總數(shù)據(jù)表頭
- 匯總數(shù)據(jù)
其中，文件內(nèi)每個(gè)字段都使用英文逗號(hào)“,” 間隔。明細(xì)數(shù)據(jù)和匯總數(shù)據(jù)每個(gè)字段前會(huì)增加1個(gè)字符（用于避免獲取的內(nèi)容被excel展示為科學(xué)計(jì)數(shù)法的格式、丟失數(shù)據(jù)細(xì)節(jié)）。
具體格式可參考以下文件樣例：
注意
以上樣例為文件展示示例，實(shí)際API下載的是數(shù)據(jù)流。
下面針資金賬單文件，說明具體字段處理方式和字段含義：
# 賬單文件具體字段
明細(xì)數(shù)據(jù):
| 字段名 | 描述 | 示例值 |
|---|---|---|
| 記賬時(shí)間 | 指該筆資金流水實(shí)際在賬戶中發(fā)生增減的時(shí)間，格式為yyyy-MM-dd HH:MM:SS | 2019-07-18 04:11:47 |
| 微信支付業(yè)務(wù)單號(hào) | 微信支付為該筆資金流水對(duì)應(yīng)的業(yè)務(wù)分配的訂單號(hào)，最大長度128字符 | 4200000263201902167700134212 |
| 資金流水單號(hào) | 微信支付為該筆資金流水分配的單號(hào)，最大長度128字符 | 1900009301190219001019884779094940 |
| 業(yè)務(wù)名稱 | 該筆資金流水對(duì)應(yīng)的業(yè)務(wù)分類，業(yè)務(wù)名稱會(huì)由于業(yè)務(wù)發(fā)展做調(diào)整：交易、退款、充值/提現(xiàn)、企業(yè)付款、代金券/立減/折扣、分賬等 | 交易 |
| 業(yè)務(wù)類型 | 該筆資金流水對(duì)應(yīng)的細(xì)化業(yè)務(wù)分類，業(yè)務(wù)類型會(huì)由于業(yè)務(wù)發(fā)展做調(diào)整：交易、扣除交易手續(xù)費(fèi)、退款、退款關(guān)閉、退還交易手續(xù)費(fèi)等 | 交易 |
| 收支類型 | 該筆資金流水的收支標(biāo)識(shí)： 收入： 該筆流水為入賬流水 支出：該筆流水為出賬流水 | 收入 |
| 收支金額(元) | 指該筆流水的發(fā)生額，收支類型是收入時(shí)表示余額的增加金額，收支類型是收入時(shí)表示余額的減少金額，單位元，保留到小數(shù)點(diǎn)后2位 | 0.03 |
| 賬戶結(jié)余(元) | 指該筆流水發(fā)生后，商戶賬戶的余額，單位元，保留到小數(shù)點(diǎn)后2位 | 51.39 |
| 資金變更提交申請(qǐng)人 | 例如員工賬號(hào)@商戶號(hào)、商戶號(hào)API、system | system |
| 備注 | 商戶或業(yè)務(wù)的自定義備注，不同的業(yè)務(wù)有所區(qū)別，最大長度2048個(gè)字符 | 小店入款 |
| 業(yè)務(wù)憑證號(hào) | 一般為商戶訂單號(hào)，不同的業(yè)務(wù)有所區(qū)別 | 20190219015157_13391 |
匯總數(shù)據(jù):
| 字段名 | 描述 | 示例值 |
|---|---|---|
| 資金流水總筆數(shù) | 該份賬單內(nèi)明細(xì)數(shù)據(jù)的筆數(shù) | 72.0 |
| 收入筆數(shù) | 賬單內(nèi)所有收支類型為收入的數(shù)據(jù)的筆數(shù) | 42.0 |
| 收入金額 | 賬單內(nèi)所有收支類型為收入的字段之和，單位元 | 6.65 |
| 支出筆數(shù) | 賬單內(nèi)所有收支類型為支出的數(shù)據(jù)的筆數(shù) | 30.0 |
| 支出金額 | 賬單內(nèi)所有收支類型為支出的字段之和，單位元 | 6.22 |
# 特殊字符轉(zhuǎn)義
會(huì)對(duì)字段取值中含有的\1字符、\r字符、\n字符做替換處理，其中\(zhòng)1會(huì)替換為空格，\r字符和\n字符會(huì)分別替換為\\r字符,\\n字符
針對(duì)明細(xì)數(shù)據(jù)中的備注、業(yè)務(wù)憑證號(hào)這兩個(gè)商戶自定義字段，賬單在處理過程中對(duì)其進(jìn)行了特殊字符的轉(zhuǎn)義，具體規(guī)則包括：
| 原始特殊字符 Unicode | 含義 | 轉(zhuǎn)義后 Unicode | 含義 |
|---|---|---|---|
\u000a | 換行符(LF) | \u005c\u006e | \n |
\u000d | 回車符(CR) | \u005c\u0072 | \r |
\u0001 | 控制字符SOH(\001) | \u0020 | 空格 |
