导出财务凭证
财务接口的第四道、也是最后一道工序：把准备财务凭证生成的通用凭证，按金蝶表格或用友 TXT 两种格式取出来。本页全程只读——不校验借贷是否平衡、不校验科目是否合法，也不会把凭证标记成「已导出」，同一期数据可以反复下载。上一步没生成通用凭证，这里三个页签都是空的；上一步的科目映射缺了行，这里少了分录也不会有任何提示。
功能路径：财务管理 → 财务接口 → 导出财务凭证
一、功能概述
1. 核心用途
- 对着数据：用「通用凭证预览」核对当期到底生成了多少行分录；
- 出金蝶文件：在「金蝶格式」页签把 21 列表格导成文件；
- 出用友文件：在「用友格式」页签预览 23 列文本并下载 GBK 编码的 TXT；
- 重复取数：需要重出文件时刷新即可，不锁批次、不留导出痕迹。
2. 与其他功能的关系
| 功能 | 关系 |
|---|---|
| 准备财务凭证 | 唯一数据源；那一步没生成分录，本页无内容可导 |
| 设置科目对应关系 | 金蝶的科目代码、核算代码与用友的科目编码、部门、业务员、客户等列都来自它 |
| 导出数据设置 | 间接决定这里能看到多少凭证——第一道没勾的类型根本进不到接口 |
| 财务报表／帐簿查询 | 用于交叉核对导出的金额是否与账面一致 |
| 余额检查 | 导出文件前的借贷平衡、科目合法性要在这里靠账簿自查，本页不做 |
二、界面布局说明
1. 会计期导航
与其他页一样是「上个月／下个月／本月」加一个月份输入框。本页记住的月份只属于本页，与准备财务凭证各存一份、互不同步：在那一页做了 9 月的凭证，这一页仍可能停在 10 月，切月份这一步不能省。输入非法时回落到系统「现在会计期」，再取不到就用系统当前月。
2. 三个页签
| 页签 | 内容 |
|---|---|
| 通用凭证预览 | 与「准备财务凭证」的通用凭证页签同一套列，看的是接口分录原样 |
| 金蝶格式 | 21 列表格，列标题含凭证号、凭证日期、摘要、科目代码、科目余额方向、借方金额、贷方金额、核算代码、核算名称、核算类别以及往来单位／部门／职员等核算维度 |
| 用友格式 | 纯文本面板，按用友导入模板排好的 23 列逗号分隔内容 |
工具栏没有业务动作按钮，只提供会计期切换。
3. 金蝶格式的两条取数规则
- 摘要：优先取分录上的导出摘要，为空时回退到分录备注；
- 核算代码：按往来单位代码 → 部门代码 → 员工代码的优先顺序取第一个有值的，核算类别相应写作「往来单位」「部门」「职员」；
- 行序：按凭证字、凭证号、分录行号排序，同一张凭证的分录保证连续排列。
4. 用友格式的列序与规则
23 列逗号分隔，列序固定为：制单日期、凭证类别字、业务凭证号、附单据数、摘要、科目编码、金额借方、金额贷方、数量、外币、汇率、结算方式、结算号、票据日期、票据号、客户、部门、业务员、制单人、出纳、审核人、记账人、项目。
| 规则 | 具体表现 |
|---|---|
| 编码与换行 | GBK 编码、CRLF 行尾、无 BOM |
| 默认文件名 | 用友凭证_当天日期.txt（yyyymmdd） |
| 固定值 | 数量、外币、汇率恒为 0；结算方式、结算号、票据日期、票据号、制单人、出纳、审核人、记账人留空 |
| 金额 | 两位小数，不带千分位 |
| 摘要清洗 | 导出摘要为空回退备注 → 逗号换成空格 → 去掉换行符 → 按 GBK 字节截断到 60 字节，且不切断汉字 |
5. 与桌面客户端的差别
| 项目 | 桌面客户端 | 网页版 |
|---|---|---|
| 金蝶导出 | 表格直接导出真正的 XLS 文件 | 【导出EXCEL文件】产出的是带 UTF-8 BOM 的 CSV |
| 导出前校验 | 文档所述科目合法性、借贷平衡等校验与异常清单 | 本页不做校验，也不出异常清单 |
| 导出留痕 | 记录导出时间、操作员、目标系统、凭证数量、文件路径 | 不标记「已导出」、不阻止重复导出 |
| 用友 TXT | GBK／CRLF／23 列／文件名 用友凭证_yyyymmdd.txt | 与客户端一致 |
| 会计期 | 两个窗口各自弹日期框选择 | 两页各记一份月份，互不同步 |
细节见客户端文档导出财务凭证。
三、业务操作步骤
步骤 1：切到与生成时相同的会计期并核对行数
用导航条或月份输入框选中做过生成的那个月，点【刷新预览】。看到「当前没有可保存的内容，请先生成 TXT 数据。」说明这一个月还没有通用凭证，回到准备财务凭证执行导入与生成。行数要和账簿、与「准备财务凭证」的凭证记录条数对一遍——行数偏少通常是科目映射缺行，而不是这一页出了问题。
步骤 2：需要金蝶文件时切「金蝶格式」
表格下方状态栏（「共 X 条」同一行）有【导出EXCEL文件】按钮，只在金蝶页签显示。点它得到的是带 UTF-8 BOM 的 CSV 文件，用 Excel 打开就是表格，金蝶导入也按文本读取；如果按钮无响应或提示「导出组件未就绪，请刷新页面重试」，刷新页面再试一次。
步骤 3：需要用友文件时切「用友格式」
面板显示「会计期 X 共 N 行 × 23 列 默认文件名 …（GBK 编码 / CRLF 行尾 / 无 BOM）」，下方列出列序。同一会计期的预览只做一次，反复看不会重取。核对无误后点【下载 TXT（GBK）】保存，文件名按当天日期命名，导入前可以改成对方系统要求的名字。对方系统报科目不存在、金额不对时，改的都是前面三道工序：回设置科目对应关系补映射，删本月通用凭证重新生成，再回这里重新导出。
四、字段详细说明
| 项 | 含义 |
|---|---|
| 共 X 条 | 金蝶页签当前的分录行数，与预览页签应当一致 |
| 科目代码／科目编码 | 来自映射的目标科目编号；映射留空则输出空值 |
| 科目余额方向 | 按源科目的余额方向写成借／贷，决定金额落在借方列还是贷方列 |
| 核算代码／核算名称／核算类别 | 往来单位、部门、职员三选一，按优先级取有值的那个；附单据数取原始凭证的附件张数 |
| 摘要 | 经过清洗与 60 字节截断，可能比账面上的摘要短 |
五、典型使用场景
场景 1：用友账套按月接管
每月在 ERP 记账完毕后走到这一步，切「用友格式」→【刷新预览】→【下载 TXT（GBK）】，把文件直接交给用友凭证导入。GBK 与无 BOM 是用友旧版导入的要求，不要用 Excel 打开后再另存，编码会被改掉。
场景 2：金蝶只要表格数据
对方实施人员习惯拿表格整理导入模板时，切「金蝶格式」→【导出EXCEL文件】拿到 CSV，同一张凭证的分录连续排列，便于按凭证号分组。
六、权限控制与前置条件
- 需要财务接口相关菜单权限；租户库中财务接口的表与视图已建好，系统选项「现在会计期」必须已设置，缺失时页面报错；
- 前置：在本页所选的会计期上已完成「导入本月凭证」与「生成通用凭证」；
- 借贷平衡、科目合法性、辅助核算完整性都不在本页校验，导出前请自行用帐簿查询、余额检查复核。
七、常见问题
1. 三个页签都是空的
原因：所选会计期上没有生成的通用凭证，或者本页的月份与做「准备财务凭证」时的月份不是一回事——两页各记一份会计期，不联动。 处理：用导航条切到做过生成的那个月，点【刷新预览】；仍为空就回准备财务凭证执行导入与生成。
2. 点【下载 TXT（GBK）】提示「当前没有可保存的内容，请先生成 TXT 数据。」
原因：当前会计期没有分录数据。 处理：先按上一条核对会计期并完成生成，再回来刷新下载。
3. 「导出EXCEL文件」得到的是 CSV 不是 XLS
原因：网页版按 CSV（UTF-8 带 BOM）产出，按钮名沿用了习惯叫法。 处理：直接用 Excel 打开即可正常显示中文；若对方系统坚持要 XLS，在 Excel 里另存一次再导入。
4. 用友文件里的中文在对方系统里是乱码
原因：文件本身是 GBK 编码、无 BOM，被工具按 UTF-8 打开或另存过。 处理：重新下载原始 TXT，不做任何转存，直接交给用友导入。
5. 同一期反复导出会不会重复入账
原因：担心页面重复取数留下痕迹。 处理：本页只读，不标记「已导出」、也不阻止重复导出，是否重复导入完全由对方系统的批次控制决定；自己要在文件名或台账上做区分。
6. 导出文件里少了几张凭证的分录
原因：多为科目映射缺行导致生成时被丢弃，也可能摘要超长被截断造成行看起来不一样。 处理：对照准备财务凭证的分录行数，回设置科目对应关系补齐映射后重新生成再导出。