# 财务ERP系统需求规格说明书与开发方案 ## 版本历史
日期版本修改内容作者
2026-06-25v1.0初始版本架构组
--- ## 1. 项目概述 ### 1.1 项目背景 本公司目前财务管理分散在多个系统（金蝶、飞书多维表格、Wimoor ERP、海外仓、OMS等），缺乏统一的财务核算与报表体系。为满足合规要求、提高核算效率、实现业财一体化，决定自建财务ERP会计模块，作为现有业务系统的补充与整合。 ### 1.2 系统目标 - **统一会计核算**：建立标准化的会计科目、账套、凭证、报表体系。 - **多数据源自动记账**：对接飞书多维表格、亚马逊结算报告、采购模块、支付平台等，自动生成会计凭证。 - **全链路台账管理**：实现采购账户、供应商、发票、库存（进销存）的精细化管理，支持账期、对账、分摊等复杂业务场景。 - **合规留痕**：四票一致（合同、发票、物流、付款）与业务附件留存，满足税务稽查与审计要求。 - **灵活报表与合并**：支持单个账套报表及多账套合并，提供资产负债表、利润表、现金流量表等标准财务报表。 - **权限与隔离**：支持按账套、科目、操作权限精细化控制，满足多公司、多项目的数据隔离与授权需求。 ### 1.3 适用范围 本系统服务于公司财务部、采购部、物流部、运营部及管理层，覆盖跨境电商全业务流程（采购、物流、销售、支付、库存、税务）。 --- ## 2. 总体功能架构 系统分为**基础设置**、**凭证管理**、**自动记账**、**台账管理**、**报表中心**、**结账处理**六大模块。
--- ## 3. 功能需求详述 ### 3.1 基础设置 #### 3.1.1 会计科目 - **科目结构**：支持多级科目（如一级、二级、三级），编码使用数字分层（如10020101）。 - **科目属性**：需指定是否为“现金及现金等价物科目”、“非现金科目”；支持多币种（默认人民币，可设置外币）。 - **辅助核算**：支持按供应商、客户、部门、存货、项目等进行辅助核算，便于报表多维分析。 - **科目禁用/启用**：支持科目停用，历史数据保留。 - **科目复制**：支持从金蝶或现有模板快速导入。 #### 3.1.2 账套管理 - **账套定义**：代表一个独立的会计核算主体（如公司、店铺、项目）。 - **账套组合**：允许创建“合并账套”，其数据为多个子账套的汇总（如集团账套包含所有子公司）。 - **账套权限**：用户可被授予特定账套的查看/登记权限，各账套数据隔离。 - **账套参数**：每个账套可独立设置本位币、会计期间、小数位数等。 #### 3.1.3 用户与权限 - **功能权限**：控制用户对各菜单模块的访问（查看、新增、修改、删除、审核）。 - **数据权限**：按账套、科目范围限制数据可见性。 - **操作审计**：记录所有关键操作（凭证录入、审核、修改）的日志（时间、操作人、IP）。 #### 3.1.4 进销存配置 - **采购账户配置**：定义采购支付账户类型（现金/账期）、费用类型、对应会计科目、凭证生成规则（详见3.4.1）。 - **供应商配置**：维护供应商基本信息及多个收款账户（公司名称、银行账号），支持默认设置。 - **存货核算方法**：仅支持移动加权平均法，系统自动计算出库成本。 - **仓库设置**：区分本地仓库与FBA仓库，设定对应的科目映射。 ### 3.2 凭证管理 #### 3.2.1 手工录入凭证 - **凭证要素**：凭证字（收、付、转、记）、凭证号、日期、账套、制单人、摘要、会计科目（带辅助核算）、借贷方金额、币别/汇率、附件张数。 - **借贷平衡校验**：自动校验借贷合计是否相等，不相等禁止保存。 - **凭证模板**：支持保存常用分录模板，提高录入效率。 - **凭证审核**：需审核后方可生成报表；支持反审核。 #### 3.2.2 凭证查询与导出 - **多维筛选**：按凭证字号、日期范围、账套、科目、制单人、来源模块、摘要模糊搜索等。 - **显示原币**：支持显示外币凭证的原币金额及折算本位币金额。 - **导出格式**：支持导出为Excel、PDF，用于打印或外部审计。 #### 3.2.3 凭证附件 - 每张凭证可关联多个附件（图片、PDF、Excel等），附件存储于服务器并加密，保存期限不少于10年。 - 支持从飞书审批、多维表格自动关联附件。 ### 3.3 自动记账 #### 3.3.1 飞书多维表格连接 - **配置模板**：定义多维表格数据源（API Token、表格ID）、字段映射（账套、日期、金额、科目等）、筛选条件、凭证生成规则。 - **生成方式**：支持前端手动触发（勾选记录发送至ERP）或定时轮询自动生成。 - **异常处理**：记录未成功生成凭证的异常数据，提供异常列表供人工处理。 - **典型应用**：工资分摊、行政费用付款、报销审批等。 #### 3.3.2 亚马逊月度结算数据自动凭证 - **数据来源**：通过SP-API获取Settlement Report或Payment Report，按月度汇总。 - **凭证逻辑**： - 按回款日期确认收入，借：应收账款-亚马逊平台，贷：主营业务收入（按商品类别）、其他业务收入（运费等）。 - 平台费用（佣金、仓储费、广告费等）计入费用科目，借：销售费用/管理费用，贷：应收账款-亚马逊平台。 - 汇率使用当月中国外汇交易中心公布的中间价。 - **附件留存**：自动下载月度结算PDF作为凭证附件。 #### 3.3.3 采购模块自动记账（详见3.4.1） - 采购订单付款、入库、发票入账等操作实时生成会计凭证。 #### 3.3.4 支付平台出账 - **连连星球等支付平台**：提供模块展示各币种余额，出账时按账套分摊金额，生成凭证（借：内部往来/费用，贷：其他货币资金-连连）。 - **内部往来**：用于账套间资金调拨，合并报表时抵消为零。 ### 3.4 台账管理（核心模块） #### 3.4.1 采购账户台账 - **功能目标**：管理所有采购支付账户（现金类/账期类）的收支明细、余额、对账；支持账期结算与批量付款。 - **数据来源**：采购订单付款、台账付款（账期还款）、退款等操作。 - **筛选视图**：按采购账户、账套、时间、付款/库存/发票状态多维过滤。 - **台账付款（账期类）**： - 支持勾选多条未付记录，统一生成付款单，选择现金类账户进行实际支付。 - 支持Excel模板批量导入付款明细（用于跨境直采等批量场景）。 - 付款时自动生成凭证（借：应付账款-供应商，贷：其他货币资金/银行存款）。 - **退款处理**：支持部分或全额退款，自动生成红字凭证冲销原分录。 - **余额/对账**：提供账户余额统计、与银行流水对账功能（后续对接银行API）。 #### 3.4.2 供应商台账 - **功能目标**：管理供应商的应付、预付、发票、库存状态。 - **核心字段**：供应商、订单、SKU、收款账号、付款状态、库存状态、发票状态。 - **发票入账**：支持勾选未开票记录，关联数电发票（通过API获取）生成凭证（借：预付账款-在途发票，贷：预付账款-采购供应商）。 - **对账单导出**：可按供应商导出未开票明细，用于催开发票。 #### 3.4.3 发票台账 - **数据同步**：通过税局API（或金蝶接口）获取数电发票信息（发票号码、销方、金额、税额、状态）。 - **台账展示**：按账套、销方、时间筛选，显示发票状态（未入账/已入账/作废/红冲等）。 - **入账操作**：支持手工选择发票并生成凭证（借：费用/库存，贷：预付账款-供应商），可分摊到不同账套。 - **统计分析**：按账簿汇总发票金额、税额，比对账面预付账款余额。 #### 3.4.4 本地仓库台账（进销存） - **核算方式**：移动加权平均法，每笔入库重新计算单位成本。 - **汇总账**：按月展示SKU的期初、入库、出库、期末数量与金额，提供勾稽校验（与科目余额对比）。 - **明细账**：按时间、操作类型（采购入库、销售出库、盘点盈亏、调拨等）展示每次变动明细，点击可联查对应凭证。 - **成本计算**：自动计算每次出库成本（出库数量 × 当前移动平均单价），保留精度，避免尾差。 #### 3.4.5 FBA仓库台账 - **数据来源**：亚马逊库存报告（Inventory Health Report）及发货记录。 - **核算方式**：按月汇总核算，发货至FBA时按移动加权价结转成本。 - **勾稽校验**：与亚马逊平台报告核对，确保库存价值准确。 ### 3.5 报表中心 - **科目余额表**：展示所选期间各科目期初、发生额、期末余额，支持外币原币与本位币双列显示。 - **明细账/总账**：按科目查询所有凭证明细，支持导出。 - **资产负债表**：按标准格式（期末余额、年初余额）自动生成，项目名称与金蝶一致。 - **利润表**：支持月、季、年，展示本期金额与本年累计，可隐藏/显示成本占比。 - **现金流量表**：按直接法编制，提供试算平衡校验。 - **所有者权益变动表**：年报格式，暂简化处理。 ### 3.6 结账处理 - **期末调汇**：对外币科目按月末汇率调整汇兑损益。 - **结转销售成本**：根据出库记录自动计算并生成凭证（借：主营业务成本，贷：库存商品）。 - **结转损益**：将损益类科目余额结转至本年利润。 - **结账**：结账后禁止修改该期间凭证，支持反结账。 --- ## 4. 非功能需求 ### 4.1 性能要求 - 支持并发用户数≥50，凭证查询响应时间≤2秒。 - 月度结算数据生成凭证（约1万条记录）处理时间≤5分钟。 - 数据库读写分离，历史数据归档。 ### 4.2 安全性 - 数据传输HTTPS加密，敏感字段（金额）数据库加密存储。 - 操作日志保留不少于180天，审计日志保留不少于10年。 - 防SQL注入、XSS攻击，接口鉴权采用JWT Token。 ### 4.3 可靠性 - 系统可用性≥99.9%，每日自动备份数据库与附件。 - 异常数据自动记录并告警（邮件/飞书通知）。 ### 4.4 可维护性 - 模块化、微服务化设计（可拆分会计核心、台账、报表独立服务）。 - 配置化程度高（科目映射、凭证模板、连接器均支持界面配置）。 --- ## 5. 技术架构 ### 5.1 整体技术栈 - **后端**：Spring Boot 2.7+，Spring Security，MyBatis-Plus，MySQL 8.0，Redis（缓存），RabbitMQ（异步任务）。 - **前端**：Vue 3 + TypeScript，Element Plus，Vite，Axios。 - **部署**：Docker容器化，Nginx负载均衡，Jenkins CI/CD。 ### 5.2 模块划分（后端微服务）
服务名职责
`accounting-core`科目、账套、凭证、基础设置、手工录入、查询
`automation-service`自动记账引擎（多维表格、亚马逊、采购事件）
`ledger-service`台账管理（采购账户、供应商、发票、库存）
`report-service`报表生成（科目余额表、三表等）
`file-service`附件存储与管理
`auth-service`用户认证与权限
### 5.3 数据库设计概要（核心表） - `account_set`（账套表） - `account_subject`（科目表，含辅助核算字段） - `voucher`（凭证主表） - `voucher_detail`（凭证分录明细，含外币字段） - `auto_template`（自动凭证模板配置） - `purchase_account`（采购账户） - `purchase_order`（采购订单） - `purchase_payment`（采购付款记录） - `supplier`（供应商） - `invoice`（发票台账） - `inventory_transaction`（库存变动明细） - `warehouse_stock`（仓库库存余额） ### 5.4 关键接口设计（RESTful） - `/api/v1/accounting/...` 凭证相关 - `/api/v1/ledger/purchase-account/...` 采购台账 - `/api/v1/automation/feishu/...` 飞书连接 - `/api/v1/report/...` 报表数据 --- ## 6. 开发计划（分阶段实施）
阶段时间节点主要内容备注
第一阶段2026-10 ~ 2027-02基础设置（科目、账套、权限）、手工凭证、凭证查询、基础报表（科目余额表）核心基建
第二阶段2027-03 ~ 2027-05自动记账：飞书多维表格连接、亚马逊月度数据自动凭证、结账处理（调汇、结转）提高效率
第三阶段2027-06 ~ 2027-09进销存模块（采购账户台账、供应商台账、发票台账、仓库台账）及关联凭证生成业财融合
第四阶段2027-10 ~ 2027-12完善报表（三表）、权限深化、附件管理、多币种优化、性能调优精细化
后续2028+对接银行API、税务接口、更多平台（Wimoor、海外仓）生态扩展
--- ## 7. 关键业务规则说明 1. **损益类科目红字规则**：损益类科目不允许借方蓝字，必须记贷方红字（负数），以保证利润表取数正确。 2. **凭证日期**：必须等于业务实际发生日期（如付款日期、收入确认日期），不得随意提前或推后。 3. **内部往来抵消**：多账套合并报表时，内部往来科目（如其他应收款-账套间）必须清零。 4. **库存成本核算**：采用移动加权平均，每次出库成本 = 出库数量 × 当前移动平均单价；库存余额不通过单价×数量反算，而通过期初+入库-出库滚动计算。 5. **附件保存**：所有凭证和重要业务单据（合同、发票、物流单）均需上传附件，电子档案保存不少于10年。 --- ## 8. 开发注意事项 - **前端适配**：大量表格需支持动态列、排序、筛选、导出，建议封装通用表格组件。 - **性能优化**：台账页面数据量大，需后端分页、前端虚拟滚动。 - **安全性**：金额字段前端展示需千分位格式化，但传输时保持原始数值。 - **国际化**：预留多语言接口（目前仅中文）。 - **测试重点**：凭证借贷平衡、外币折算、移动加权平均计算、自动生成凭证的异常处理。 --- ## 9. 附录：参考文档与资源 - [金蝶会计科目体系参考](https://./%E5%8F%82%E8%80%83%E6%96%87%E4%BB%B6) - [亚马逊SP-API文档](https://developer-docs.amazon.com/sp-api/docs) - [飞书多维表格API](https://open.feishu.cn/document/server-docs/docs/bitable-v1/bitable-overview) - 公司内部《2025-财务及海关ERP设计方案》