# 需求文档 # 财务模块-新需求整理与开发 # 财务ERP系统需求规格说明书与开发方案 ## 版本历史

日期	版本	修改内容	作者
2026-06-25	v1.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设计方案》 # 财务ERP - 进销存模块（采购与台账）详细开发文档 ## 版本历史

版本	日期	修改内容	作者
v1.0	2026-06-25	基于20260618需求梳理，定义采购模块与台账功能	架构组

--- ## 1. 模块定位与范围 ### 1.1 模块目标实现采购业务全流程的财务核算与台账管理，打通**采购订单 → 付款 → 入库 → 发票**的业务闭环，并提供多维度的台账查询与对账功能。本模块作为现有 `wimoor-finance` 微服务的扩展，复用已有凭证、科目、辅助核算等基础能力。 ### 1.2 涉及功能清单 - **进销存配置**：采购账户、供应商收款账户、库存核算方法、凭证科目映射 - **采购单（会计版）**：创建、付款、退款、入库、退货，状态追踪 - **采购账户台账**：多维度查询、台账付款（账期结算）、批量上传对账单、退款处理 - **供应商台账**：按供应商汇总应付/已付/待付、库存价值、发票状态，支持发票入账 - **发票台账**：数电发票同步、入账、查询、统计分析 - **本地仓库台账**：移动加权平均核算，汇总账与明细账，与总账勾稽 - **FBA仓库台账**：与亚马逊库存报告对接，按月汇总核算（后续迭代） ### 1.3 依赖关系 - 复用 `wimoor-finance` 现有表：`fin_accounting_subjects`、`fin_vouchers`、`fin_voucher_entries`、`fin_auxiliary_*`、`fin_currency` - 调用 `wimoor-erp` 模块：供应商基础信息、SKU信息、仓库信息 - 调用 `wimoor-amazon` 模块：FBA库存报告数据（后续） - 调用 `wimoor-admin` 模块：飞书多维表格连接配置（用于发票同步等） --- ## 2. 数据库设计（新增表） ### 2.1 采购账户表 `fin_purchase_account` 已在原文档中定义，此处补充字段说明：

字段	类型	说明
`id`	bigint unsigned	主键
`groupid`	bigint unsigned	租户ID（账套）
`account_name`	varchar(100)	账户名称，如“公户现金”“跨境直采”
`account_type`	tinyint	1-现金，2-账期
`related_subject_id`	bigint unsigned	对应会计科目ID（如“银行存款-浦发”）
`config_json`	json	完整配置：费用类型列表、归属标记、借贷科目映射、退款设置、支持的付款账户等
`is_enabled`	tinyint	是否启用
`created_time`	datetime
`updated_time`	datetime

**config\_json 结构示例：**

``` { "feeTypes": [ { "code": "GOODS", "name": "货款", "isSupplierRelated": true }, { "code": "FREIGHT", "name": "运费", "isSupplierRelated": true }, { "code": "SERVICE", "name": "跨境直采手续费", "isSupplierRelated": false } ], "paySubjectMapping": { "GOODS": { "debitSubjectId": 101, "creditSubjectId": 201 }, "FREIGHT": { "debitSubjectId": 102, "creditSubjectId": 201 }, "SERVICE": { "debitSubjectId": 501, "creditSubjectId": 201 } }, "refundMapping": { "GOODS": { "debitSubjectId": 201, "creditSubjectId": 101 }, "FREIGHT": { "debitSubjectId": 201, "creditSubjectId": 102 } }, "creditPayAccounts": [ // 仅账期类型有效，可选的现金账户列表 { "cashAccountId": 1, "subjectMapping": { "debit": 301, "credit": 201 } } ] } ```

### 2.2 采购订单表 `fin_purchase_order` 已在原文档中定义，补充以下索引和约束：

``` ALTER TABLE `fin_purchase_order` ADD INDEX `idx_status_pay` (`status_pay`), ADD INDEX `idx_status_inv` (`status_inv`), ADD INDEX `idx_status_stock` (`status_stock`); ```

### 2.3 采购付款明细表 `fin_purchase_payment` 已在原文档定义，确保与 `purchase_order_id` 和 `voucher_id` 关联。 ### 2.4 供应商收款账户表 `fin_supplier_bank` （新增）用于维护供应商的多个收款账户信息：

``` CREATE TABLE `fin_supplier_bank` ( `id` bigint unsigned NOT NULL AUTO_INCREMENT, `groupid` bigint unsigned NOT NULL, `supplier_id` bigint unsigned NOT NULL, `bank_name` varchar(100) COLLATE utf8mb4_bin DEFAULT NULL, `account_name` varchar(100) COLLATE utf8mb4_bin NOT NULL, `account_no` varchar(50) COLLATE utf8mb4_bin NOT NULL, `is_default` tinyint DEFAULT '0', `is_enabled` tinyint DEFAULT '1', `created_time` datetime DEFAULT NULL, PRIMARY KEY (`id`), KEY `idx_supplier` (`supplier_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='供应商收款账户'; ```

### 2.5 库存余额表 `fin_warehouse_stock` 已在原文档定义，新增 `warehouse_type` 字段区分本地/FBA：

``` ALTER TABLE `fin_warehouse_stock` ADD COLUMN `warehouse_type` tinyint DEFAULT '1' COMMENT '1-本地，2-FBA'; ```

### 2.6 库存变动明细表 `fin_inventory_transaction` 已在原文档定义。 ### 2.7 采购发票关联表（可选）为支持“一张发票对应多笔采购订单”，可新增中间表，但当前简化设计，发票直接关联凭证，通过凭证分录的辅助核算追踪订单，暂不建中间表。 --- ## 3. 核心业务逻辑 ### 3.1 采购付款凭证生成规则（完整版）根据需求，采购付款涉及三个环节：**付款**、**在途库存确认**、**发票入账**。系统按以下规则自动生成凭证。 #### 3.1.1 现金类账户付款（公户、跨境直采等） - **付款时（采购单点击“付款”）**： - 凭证1（付款）：

``` 借：预付账款-ERP采购供应商 (供应商辅助核算) 贷：银行存款-浦发银行(2384) / 其他货币资金-连连跨境直采 ```

- 凭证2（在途库存）：

``` 借：在途库存_XX本地仓库 (存货辅助核算) 贷：预付账款-ERP在途发票 ```

- **收到发票时（发票入账操作）**：

``` 借：预付账款-ERP在途发票贷：预付账款-ERP采购供应商 ```

- **入库时（采购单收货）**：

``` 借：库存商品_XX本地仓库 (存货辅助核算) 贷：在途库存_XX本地仓库 ```

#### 3.1.2 账期类账户付款（先采后付、公户请款等） - **采购单点击“付款”（即发起请款）**：

``` 借：预付账款-ERP采购供应商贷：应付账款_1688先采后付（或应付账款_公户请款即付等） ```

- **在途库存确认**（同3.1.1）：

``` 借：在途库存_XX本地仓库贷：预付账款-ERP在途发票 ```

- **台账付款（实际还款）**： - 借：应付账款\_1688先采后付 - 贷：银行存款-浦发 / 其他货币资金-连连跨境直采 - 若有跨境直采手续费，另加一笔：

``` 借：财务费用_跨境直采贷：其他货币资金-连连跨境直采 ```

#### 3.1.3 退款处理退款时，根据已付款、已入库、已开票的不同状态，系统自动生成红字冲销凭证（方向相反），并更新台账。具体规则已在需求中列出，此处不再赘述。 #### 3.1.4 辅助核算要求所有涉及供应商的科目必须启用“供应商”辅助核算；涉及存货的科目启用“存货”辅助核算（即SKU）。系统在生成凭证时自动填充 `fin_voucher_entries_auxiliary` 表。 --- ### 3.2 移动加权平均成本计算在每次采购入库、盘盈入库时，重新计算库存单价。出库时，出库成本 = 出库数量 × 当前移动单价。 **Java 核心实现：**

``` @Component public class MovingAverageCostCalculator { /** * 计算新移动平均单价 * @param currentQty 当前数量 * @param currentAmount 当前金额 * @param inQty 入库数量（正数） * @param inAmount 入库金额（正数） * @return 新单价，保留4位小数 */ public BigDecimal calculateNewUnitCost(BigDecimal currentQty, BigDecimal currentAmount, BigDecimal inQty, BigDecimal inAmount) { if (inQty.compareTo(BigDecimal.ZERO) == 0) { return BigDecimal.ZERO; } BigDecimal newQty = currentQty.add(inQty); if (newQty.compareTo(BigDecimal.ZERO) == 0) { return BigDecimal.ZERO; } BigDecimal newAmount = currentAmount.add(inAmount); return newAmount.divide(newQty, 4, RoundingMode.HALF_UP); } /** * 计算出库成本（金额） */ public BigDecimal calculateOutCost(BigDecimal qty, BigDecimal unitCost) { return qty.multiply(unitCost).setScale(2, RoundingMode.HALF_UP); } } ```

**库存余额更新（确保不反算）：**

``` @Transactional public void updateStockForTransaction(InventoryTransactionDTO dto) { // 1. 获取当前期间库存 WarehouseStock stock = stockMapper.selectBySkuPeriod(...); BigDecimal oldQty = stock.getCurrentQty(); BigDecimal oldAmount = stock.getCurrentAmount(); BigDecimal oldUnitCost = stock.getUnitCost(); if (dto.getTransType() == PURCHASE_IN) { // 入库：重新计算单价 BigDecimal newUnitCost = calculateNewUnitCost(oldQty, oldAmount, dto.getQty(), dto.getAmount()); stock.setUnitCost(newUnitCost); stock.setCurrentQty(oldQty.add(dto.getQty())); stock.setCurrentAmount(oldAmount.add(dto.getAmount())); } else if (dto.getTransType() == SALE_OUT) { // 出库：使用当前单价计算成本 BigDecimal cost = calculateOutCost(dto.getQty().abs(), oldUnitCost); dto.setAmountChange(cost.negate()); // 记录变动金额 stock.setCurrentQty(oldQty.subtract(dto.getQty().abs())); stock.setCurrentAmount(oldAmount.subtract(cost)); // 单价不变 } // 其他类型（调拨、盘点等）类似... stockMapper.updateById(stock); // 插入变动明细 inventoryTransactionMapper.insert(buildTransaction(dto, oldUnitCost)); } ```

--- ### 3.3 采购账户台账查询与批量付款 #### 3.3.1 台账列表查询支持多维度筛选（采购账户、账套、时间、状态），返回以下核心字段： - 账簿、采购账户、采购订单号、SKU、供应商、收款账号 - 付款状态、库存状态、发票状态 - 金额字段：订单金额、请款金额（归属供应商）、已付金额、待付金额 - 库存字段：库存价值、已入库价值、待入库价值 - 发票字段：应开票金额、已开票金额、待开票金额 **SQL 查询核心（MyBatis XML）：**

``` ```

#### 3.3.2 台账付款操作 - 前端勾选多条记录 → 调用 `/api/finance/ledger/purchase-account/ledger-pay` - 后端校验：所有记录必须属于同一个账期采购账户；必须选择现金类付款账户 - 生成凭证（借贷科目按配置）并插入 `fin_purchase_payment`，更新 `paid_amount` 和状态 - 支持分摊：若付款金额与应付总额不一致，按比例分摊到尾差处理 **批量上传对账单（Excel）流程：** 1. 下载模板（含列：采购订单号、SKU、应付金额、本次付款金额、费用类型） 2. 用户填写后上传 3. 后端解析，校验订单号有效、未超额付款 4. 预览确认，用户提交 5. 批量生成付款记录和凭证 --- ### 3.4 供应商台账与发票入账 #### 3.4.1 供应商台账查询与采购账户台账类似，但按**供应商**维度汇总，展示： - 供应商、账簿、采购订单明细 - 应付/已付/待付（归属供应商） - 库存价值、已入库、待入库 - 应开票、已开票、待开票 #### 3.4.2 发票入账操作 - 前端勾选多条未开票记录 → 选择数电发票（从发票台账中选） - 调用 `/api/finance/ledger/invoice/post` - 后端：生成凭证：

``` 借：预付账款-ERP在途发票贷：预付账款-ERP采购供应商 ```

- 同时更新采购订单的 `invoiced_amount` 和 `status_inv`，更新发票的 `posting_status=1`、`voucher_id` - 支持发票分摊到多条订单（按订单待开票金额比例） --- ### 3.5 发票台账同步与入账 #### 3.5.1 发票数据同步 - 定时任务调用税局电子发票API（或从金蝶拉取），将数电发票信息写入 `fin_invoice` - 同步时，根据发票销方税号匹配内部供应商（`supplier_id`），若无法匹配则记录为“待匹配” - 同步后，发票状态默认为“正常” #### 3.5.2 发票台账查询提供多维度筛选（账簿、销方、日期、入账状态、发票状态），展示发票号码、开票日期、价税合计、税额、入账状态等。 #### 3.5.3 手工入账（未匹配自动入账）用户可在发票台账页面勾选发票，选择“入账”，系统生成凭证（借：预付账款-ERP在途发票贷：预付账款-ERP采购供应商），并关联供应商（若之前未匹配）。 --- ### 3.6 本地仓库台账（移动加权平均核算） #### 3.6.1 汇总账按“期间 + 账簿 + SKU + 仓库”展示期初、入库、出库、期末的数量和金额。 - 期初 = 上一期间期末 - 入库 = 所有 `PURCHASE_IN` 类型变动汇总 - 出库 = 所有 `SALE_OUT` 类型变动汇总 - 期末 = 期初 + 入库 - 出库 **勾稽校验**：期末金额应与对应会计科目（库存商品）余额一致，若不一致，系统提示差异。 #### 3.6.2 明细账展示每笔库存变动明细：操作时间、类型、数量、单价、金额变动、关联单据号、凭证号。支持按SKU、仓库、时间筛选。 --- ## 4. API 接口详细设计 ### 4.1 采购账户管理

方法	路径	说明	请求参数
POST	`/api/finance/purchase/account/create`	创建采购账户	`PurchaseAccountSaveDTO`
PUT	`/api/finance/purchase/account/update`	更新配置	`PurchaseAccountUpdateDTO`
GET	`/api/finance/purchase/account/list`	查询可用账户	`groupid`
GET	`/api/finance/purchase/account/detail/{id}`	获取详情	`id`

### 4.2 采购订单（会计版）

方法	路径	说明	请求参数
POST	`/api/finance/purchase/order/create`	创建采购订单（从ERP业务单转换）	`PurchaseOrderSaveDTO`
POST	`/api/finance/purchase/order/pay`	付款（生成凭证）	`PurchasePayDTO`（含付款账户、费用明细）
POST	`/api/finance/purchase/order/refund`	退款	`RefundDTO`
POST	`/api/finance/purchase/order/receive`	入库	`ReceiveDTO`（收货数量/金额）
GET	`/api/finance/purchase/order/page`	订单列表	`PageQuery` + 筛选条件

### 4.3 采购账户台账

方法	路径	说明
GET	`/api/finance/ledger/purchase/page`	台账列表（分页）
POST	`/api/finance/ledger/purchase/ledger-pay`	台账付款（批量）
POST	`/api/finance/ledger/purchase/upload-pay`	上传对账单批量付款
GET	`/api/finance/ledger/purchase/statistics`	统计图表数据

### 4.4 供应商台账

方法	路径	说明
GET	`/api/finance/ledger/supplier/page`	供应商台账列表
POST	`/api/finance/ledger/supplier/invoice-post`	发票入账
GET	`/api/finance/ledger/supplier/export-uninvoiced`	导出未开票明细

### 4.5 发票台账

方法	路径	说明
GET	`/api/finance/ledger/invoice/page`	发票台账列表
POST	`/api/finance/ledger/invoice/sync`	手动触发同步（定时任务自动）
POST	`/api/finance/ledger/invoice/post`	发票入账（勾选后）
GET	`/api/finance/ledger/invoice/statistics`	发票统计

### 4.6 库存台账

方法	路径	说明
GET	`/api/finance/ledger/stock/summary`	汇总账（按期间）
GET	`/api/finance/ledger/stock/detail`	明细账（按SKU）
GET	`/api/finance/ledger/stock/check`	勾稽校验（与总账对比）

--- ## 5. 服务层实现要点 ### 5.1 采购付款服务（`PurchasePaymentService`） - 职责：处理采购单付款、退款、台账付款 - 主要方法： - `payOrder(PurchasePayDTO)`：校验账户余额（现金类）、生成凭证、更新订单状态、更新台账 - `ledgerPay(LedgerPayDTO)`：批量处理账期还款，支持分摊 - `refund(RefundDTO)`：退款，生成红字凭证，更新订单状态 ### 5.2 库存服务（`InventoryService`） - 职责：管理库存余额、变动明细、成本计算 - 主要方法： - `onPurchaseReceive(PurchaseOrder order, ReceiveDTO)`：入库，调用成本计算器更新库存 - `onSaleOut(SaleOutDTO)`：销售出库，计算成本并更新库存 - `getStockSummary(String period)`：汇总账查询 - `getStockDetail(String sku)`：明细账查询 ### 5.3 发票服务（`InvoiceService`） - 职责：同步税局发票、匹配供应商、入账 - 主要方法： - `syncFromTaxAPI()`：调用外部API拉取发票 - `matchSupplier()`：根据税号匹配供应商 - `postInvoice(InvoicePostingDTO)`：生成入账凭证，关联采购订单 ### 5.4 台账查询服务（`LedgerQueryService`） - 职责：提供采购账户、供应商、发票、库存的统一查询视图 - 使用 MyBatis-Plus 分页 + 复杂SQL关联查询 --- ## 6. 前端页面交互设计 ### 6.1 采购单（会计版）页面 - **列表页**：展示订单号、SKU、供应商、金额、付款/库存/发票状态；支持筛选、排序 - **详情/操作页**：显示完整信息，提供“付款”“退款”“收货”“退货”按钮，点击弹出对应表单 - **付款表单**：选择采购账户（带出对应费用类型）、填写金额、选择供应商收款账户 ### 6.2 采购账户台账页面 - **筛选区**：采购账户下拉、账套、时间、状态 - **表格**：展示上述金额字段，底部汇总行 - **操作区**：“台账付款”按钮（勾选后弹出付款对话框），“导出对账单”按钮 - **图表页签**：按日期展示付款趋势图 ### 6.3 供应商台账页面 - **筛选区**：供应商下拉、账套、时间 - **表格**：展示应付/已付/待付、库存价值、应开票/已开票/待开票 - **操作**：“发票入账”按钮（勾选后弹出选择发票对话框） ### 6.4 发票台账页面 - **筛选区**：账簿、销方、日期、入账状态 - **表格**：发票号码、金额、税额、状态 - **操作**：“同步”按钮（手动触发），“入账”按钮 ### 6.5 本地仓库台账 - **汇总账**：期间选择、SKU搜索，展示期初/入库/出库/期末数量和金额，提供校验标识 - **明细账**：点击SKU跳转明细，展示每笔变动，联查凭证 --- ## 7. 定时任务与消息队列 ### 7.1 定时任务（XXL-JOB）

任务名称	Cron	说明
`InvoiceSyncJob`	`0 0 2 * * ?`	同步税局发票数据
`StockCheckJob`	`0 0 3 1 * ?`	每月1号执行库存与总账勾稽校验
`AutoPostInvoiceJob`	`0 0/30 9-18 * * ?`	工作时间内自动匹配未入账发票（可选）

### 7.2 消息队列（RabbitMQ） - 采购订单状态变更时，发送事件（如 `ORDER_PAID`、`ORDER_RECEIVED`）到 exchange，库存服务、台账服务监听更新。 - 避免同步调用，提高响应速度。 --- ## 8. 异常处理与日志 ### 8.1 异常场景 - 付款金额超过订单未付金额 → 提示“超额付款” - 发票金额与订单待开票金额不一致 → 提示“金额不符，请确认分摊” - 供应商未维护收款账户 → 提示“请先维护供应商收款信息” - 科目配置缺失 → 提示“采购账户科目映射不完整，请联系管理员” ### 8.2 日志规范 - 关键操作（付款、退款、入库、发票入账）记录 INFO 日志，包含操作人、订单号、金额 - 异常堆栈记录 ERROR 日志，并发送飞书告警（通过 `wimoor-common` 的告警组件） --- ## 9. 测试策略 ### 9.1 单元测试（JUnit + Mockito） - 移动加权平均计算器 - 凭证生成逻辑（各场景） - 分摊算法 ### 9.2 集成测试（@SpringBootTest + Testcontainers） - 完整流程：创建订单 → 现金付款 → 入库 → 发票入账 → 查询台账 - 账期流程：创建订单 → 账期付款 → 台账付款 → 查询供应商待付 - 退款流程：部分退款、全额退款（不同状态组合） ### 9.3 前端测试（Vue Test Utils） - 页面渲染、表单交互、数据校验 --- ## 10. 部署与配置 ### 10.1 依赖环境 - MySQL 8.0（已有） - Redis（用于缓存科目、辅助核算项） - RabbitMQ（事件驱动） - XXL-JOB（调度中心） ### 10.2 配置示例（application.yml）

``` wimoor: finance: inventory: cost-method: moving_average # 仅支持移动加权 invoice: sync-api: https://api.tax.gov/invoice sync-cron: 0 0 2 * * ? ledger: batch-size: 1000 # 批量导入单次最大行数 ```

--- ## 11. 后续扩展规划 - **FBA仓库台账**：对接亚马逊库存报告，按月汇总，与本地仓库成本联动 - **关务台账**：报关单与FBA货件关联，统计出口数据 - **无票成本统计**：在利润表中增加无票成本明细 - **银行API对接**：自动获取对公账户流水，与采购账户对账 --- > **开发周期估计**： > > - 数据库设计与基础服务：3天 > - 核心业务逻辑（凭证生成、成本计算、台账查询）：5天 > - 接口开发与联调：4天 > - 前端页面开发：5天 > - 测试与修复：3天 > **总计约20人天** # 财务ERP - 进销存模块（采购与台账）详细开发流程文档 ## 文档说明本文档为20260618进销存模块梳理后的详细开发流程文档，面向开发团队，明确开发的**顺序、依赖、任务拆解、开发步骤及验收标准**。重点覆盖采购模块与财务模块的互通，以及台账管理的完整实现。 > **重要说明**：本文档仅包含业务需求、流程设计、接口契约和验收标准，不包含具体代码实现。请根据现有系统架构自行设计代码结构，避免与现有代码产生冲突。 ## 版本历史 | 版本 | 日期 | 修改内容 | 作者 | |------|------|---------|------| | v1.0 | 2026-06-25 | 初稿，基于20260618需求梳理 | 架构组 | ## 1. 模块依赖关系与开发顺序 ### 1.1 模块依赖图 ``` ┌─────────────────────────────────────────────────────────────────────────────┐ │ 开发依赖关系（自上而下） │ ├─────────────────────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────────────┐ │ │ │ 基础配置模块 │ ◄── 第1周：无依赖，可优先开发 │ │ │ - 采购账户配置 │ │ │ │ - 供应商收款账户 │ │ │ │ - 进销存全局配置 │ │ │ └──────────┬──────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────┐ │ │ │ 采购订单（会计版） │ ◄── 第2周：依赖基础配置 + ERP供应商/SKU数据 │ │ │ - 订单创建/查询 │ │ │ │ - 付款/退款/入库 │ │ │ └──────────┬──────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────┐ ◄── 第3周：依赖采购订单数据 │ │ │ 采购账户台账 │ │ │ │ - 台账列表查询 │ │ │ │ - 台账付款 │ │ │ │ - 批量对账单上传 │ │ │ └──────────┬──────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────┐ ◄── 第4周：依赖采购订单 + 税局API │ │ │ 发票台账 │ │ │ │ - 发票同步 │ │ │ │ - 发票入账 │ │ │ │ - 供应商台账查询 │ │ │ └──────────┬──────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────┐ ◄── 第5周：依赖库存变动数据 │ │ │ 库存台账 │ │ │ │ - 移动加权平均计算 │ │ │ │ - 汇总账/明细账 │ │ │ │ - 勾稽校验 │ │ │ └─────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────────────┘ ``` ### 1.2 开发顺序总览 | 阶段 | 周期 | 模块 | 产出物 | 依赖 | |------|------|------|--------|------| | **阶段一** | 第1周 | 基础配置模块 | 采购账户CRUD、供应商收款账户管理、配置校验逻辑 | 现有科目表、辅助核算表 | | **阶段二** | 第2-3周 | 采购订单（会计版） | 订单创建、付款、退款、入库、状态管理、凭证生成 | 阶段一 + ERP供应商/SKU数据 | | **阶段三** | 第3-4周 | 采购账户台账 | 台账列表、台账付款、批量上传对账单、图表统计 | 阶段二 | | **阶段四** | 第4-5周 | 发票台账与供应商台账 | 发票同步、发票入账、供应商汇总查询、未开票导出 | 阶段二 + 税局API | | **阶段五** | 第5-6周 | 库存台账（本地仓库） | 移动加权平均计算、汇总账、明细账、勾稽校验 | 阶段二 + 阶段四 | | **阶段六** | 第6周 | 联调与测试 | 端到端流程测试、性能测试、Bug修复 | 全部模块 | ## 2. 数据库设计（新增表） ### 2.1 新增表清单 | 表名 | 说明 | 关联模块 | |------|------|---------| | `fin_purchase_account` | 采购账户表 | 基础配置 | | `fin_supplier_bank` | 供应商收款账户表 | 基础配置 | | `fin_purchase_order` | 采购订单表（会计版） | 采购订单 | | `fin_purchase_payment` | 采购付款明细表 | 采购订单/台账 | | `fin_invoice` | 发票台账表 | 发票台账 | | `fin_warehouse_stock` | 库存余额表 | 库存台账 | | `fin_inventory_transaction` | 库存变动明细表 | 库存台账 | ### 2.2 表结构设计要点 #### 2.2.1 采购账户表 `fin_purchase_account` | 字段 | 类型 | 说明 | 校验规则 | |------|------|------|---------| | `id` | bigint unsigned | 主键 | 自增 | | `groupid` | bigint unsigned | 租户ID | 必填，索引 | | `account_name` | varchar(100) | 账户名称 | 必填，唯一（同租户下） | | `account_type` | tinyint | 1-现金，2-账期 | 必填，默认1 | | `related_subject_id` | bigint unsigned | 对应会计科目ID | 必填，关联fin_accounting_subjects | | `config_json` | json | 完整配置 | 见下方结构 | | `is_enabled` | tinyint | 是否启用 | 默认1 | | `created_time` | datetime | 创建时间 | 自动 | | `updated_time` | datetime | 更新时间 | 自动 | **config_json 结构：** ```json { "feeTypes": [ { "code": "GOODS", "name": "货款", "isSupplierRelated": true }, { "code": "FREIGHT", "name": "运费", "isSupplierRelated": true }, { "code": "SERVICE", "name": "跨境直采手续费", "isSupplierRelated": false } ], "paySubjectMapping": { "GOODS": { "debitSubjectId": 101, "creditSubjectId": 201 }, "FREIGHT": { "debitSubjectId": 102, "creditSubjectId": 201 } }, "refundMapping": { "GOODS": { "debitSubjectId": 201, "creditSubjectId": 101 } }, "creditPayAccounts": [ { "cashAccountId": 1, "subjectMapping": { "debit": 301, "credit": 201 } } ] } ``` #### 2.2.2 供应商收款账户表 `fin_supplier_bank` | 字段 | 类型 | 说明 | 校验规则 | |------|------|------|---------| | `id` | bigint unsigned | 主键 | 自增 | | `groupid` | bigint unsigned | 租户ID | 必填 | | `supplier_id` | bigint unsigned | 供应商ID | 必填，索引 | | `bank_name` | varchar(100) | 开户银行 | 可选 | | `account_name` | varchar(100) | 收款账户名称 | 必填 | | `account_no` | varchar(50) | 收款账号 | 必填 | | `is_default` | tinyint | 是否默认 | 默认0，同供应商仅一个默认 | | `is_enabled` | tinyint | 是否启用 | 默认1 | | `created_time` | datetime | 创建时间 | 自动 | #### 2.2.3 采购订单表 `fin_purchase_order` | 字段 | 类型 | 说明 | 校验规则 | |------|------|------|---------| | `id` | bigint unsigned | 主键 | 自增 | | `groupid` | bigint unsigned | 租户ID | 必填，索引 | | `supplier_id` | bigint unsigned | 供应商ID | 必填，关联t_erp_supplier | | `purchase_account_id` | bigint unsigned | 采购账户ID | 必填 | | `sku` | varchar(50) | SKU编码 | 必填 | | `warehouse_code` | varchar(50) | 入库仓库编码 | 必填 | | `order_qty` | decimal(12,2) | 订单数量 | >0 | | `unit_price` | decimal(18,4) | 采购单价 | ≥0 | | `total_amount` | decimal(18,2) | 订单金额 | = order_qty × unit_price | | `paid_amount` | decimal(18,2) | 累计已付 | ≥0，≤total_amount | | `inventory_value` | decimal(18,2) | 库存价值 | ≥0 | | `invoiced_amount` | decimal(18,2) | 已开票金额 | ≥0，≤total_amount | | `status_order` | tinyint | 1-草稿，2-已确认，3-已完成，4-已取消 | 默认1 | | `status_pay` | tinyint | 1-未付款，2-部分付款，3-已付款，4-退款中，5-已退款 | 默认1 | | `status_inv` | tinyint | 1-未开票，2-部分开票，3-已开票 | 默认1 | | `status_stock` | tinyint | 1-未收货，2-部分收货，3-已收货 | 默认1 | #### 2.2.4 采购付款明细表 `fin_purchase_payment` | 字段 | 类型 | 说明 | |------|------|------| | `id` | bigint unsigned | 主键 | | `purchase_order_id` | bigint unsigned | 关联采购订单 | | `purchase_account_id` | bigint unsigned | 使用的采购账户 | | `voucher_id` | bigint unsigned | 生成的凭证ID | | `fee_type` | varchar(50) | 费用类型（货款/运费/手续费） | | `is_supplier_related` | tinyint | 是否归属供应商款项 | | `amount` | decimal(18,2) | 支付金额 | | `payment_date` | date | 付款日期 | | `is_refund` | tinyint | 是否退款 | | `refund_original_id` | bigint unsigned | 退款对应的原付款明细ID | | `status` | tinyint | 0-正常，1-已退款 | #### 2.2.5 发票台账表 `fin_invoice` | 字段 | 类型 | 说明 | |------|------|------| | `id` | bigint unsigned | 主键 | | `invoice_no` | varchar(100) | 数电发票号码（唯一） | | `invoice_type` | varchar(20) | 数电专票/普票/传统 | | `groupid` | bigint unsigned | 入账账套ID | | `supplier_id` | bigint unsigned | 匹配的供应商ID | | `seller_name` | varchar(200) | 销方名称 | | `seller_tax_no` | varchar(50) | 销方税号 | | `invoice_date` | date | 开票日期 | | `amount_with_tax` | decimal(18,2) | 价税合计 | | `amount_without_tax` | decimal(18,2) | 不含税金额 | | `tax_amount` | decimal(18,2) | 税额 | | `status` | varchar(20) | NORMAL/CANCELLED/RED_ALL/RED_PART/ABNORMAL | | `posting_status` | tinyint | 0-未入账，1-已入账 | | `voucher_id` | bigint unsigned | 入账凭证ID | #### 2.2.6 库存余额表 `fin_warehouse_stock` | 字段 | 类型 | 说明 | |------|------|------| | `id` | bigint unsigned | 主键 | | `groupid` | bigint unsigned | 租户ID | | `sku` | varchar(50) | SKU编码 | | `warehouse_code` | varchar(50) | 仓库编码 | | `warehouse_type` | tinyint | 1-本地，2-FBA | | `current_qty` | decimal(12,2) | 当前数量 | | `current_amount` | decimal(18,2) | 当前金额 | | `unit_cost` | decimal(18,4) | 移动平均单价 | | `period` | varchar(6) | 会计期间（YYYYMM） | #### 2.2.7 库存变动明细表 `fin_inventory_transaction` | 字段 | 类型 | 说明 | |------|------|------| | `id` | bigint unsigned | 主键 | | `groupid` | bigint unsigned | 租户ID | | `sku` | varchar(50) | SKU编码 | | `warehouse_code` | varchar(50) | 仓库编码 | | `trans_date` | date | 变动日期 | | `trans_type` | varchar(50) | PURCHASE_IN/SALE_OUT/TRANSFER_IN/ADJUST | | `source_doc_id` | varchar(100) | 来源单据号 | | `qty_change` | decimal(12,2) | 正为入库，负为出库 | | `amount_change` | decimal(18,2) | 金额变动 | | `unit_cost` | decimal(18,4) | 发生时单价 | | `voucher_id` | bigint unsigned | 关联凭证ID | ## 3. 服务层开发任务（按顺序执行） ### 3.1 阶段一：基础配置模块（第1周） #### 3.1.1 任务清单 | 序号 | 任务 | 服务类 | 方法/职责 | 验收标准 | |------|------|--------|---------|---------| | 1 | 采购账户CRUD | `PurchaseAccountService` | 创建、更新、删除、查询列表 | 可正常增删改查，配置JSON正确序列化 | | 2 | 采购账户配置校验 | `PurchaseAccountValidator` | 校验费用类型、科目映射完整性 | 配置不完整时拒绝保存并提示 | | 3 | 供应商收款账户管理 | `SupplierBankService` | 保存、更新、设置默认、查询 | 支持多账户、默认账户唯一 | | 4 | 进销存全局配置 | `InventoryConfigService` | 获取配置、更新配置 | 支持配置成本方法（仅移动加权） | #### 3.1.2 开发步骤 1. **创建实体类**：映射新增表，使用MyBatis-Plus注解，JSON字段配置TypeHandler 2. **创建Mapper接口**：继承BaseMapper，定义必要的自定义查询方法 3. **实现Service层**： - 创建：校验参数完整性、唯一性，保存配置JSON - 更新：校验是否被引用，合并配置 - 删除：软删除或校验无引用后删除 - 列表：支持按账套、类型筛选 4. **实现Controller层**：定义REST接口，参数校验，统一响应格式 5. **单元测试**：覆盖CRUD各场景 #### 3.1.3 接口契约 **创建采购账户** - `POST /api/finance/purchase/account/create` - 请求体： ```json { "groupid": 1001, "accountName": "公户现金", "accountType": 1, "relatedSubjectId": 2384, "configJson": { ... } } ``` - 响应：`{ "code": 200, "data": { "id": 1 } }` **查询采购账户列表** - `GET /api/finance/purchase/account/list?groupid=1001&type=1` - 响应：账户列表JSON #### 3.1.4 测试用例 | 测试场景 | 预期结果 | |---------|---------| | 创建现金类账户，配置完整 | 保存成功 | | 创建账期类账户，未配置cashAccount列表 | 校验失败，提示配置不完整 | | 删除正在使用的账户 | 返回错误，提示账户已被引用 | | 设置默认收款账户 | 该账户is_default=1，其他同供应商账户=0 | ### 3.2 阶段二：采购订单（会计版）（第2-3周） #### 3.2.1 任务清单 | 序号 | 任务 | 服务类 | 方法/职责 | 验收标准 | |------|------|--------|---------|---------| | 1 | 采购订单创建 | `PurchaseOrderService` | 创建订单，初始状态为草稿 | 订单保存，状态正确 | | 2 | 采购订单确认 | `PurchaseOrderService` | 确认订单，状态变为已确认 | 仅草稿状态可确认 | | 3 | 采购订单付款 | `PurchasePaymentService` | 付款，生成凭证，更新状态 | 凭证生成正确，状态更新 | | 4 | 采购订单退款 | `PurchasePaymentService` | 退款，生成红字凭证，更新状态 | 凭证方向相反，状态更新 | | 5 | 采购入库 | `PurchaseOrderService` | 入库，更新库存，生成凭证 | 库存更新，凭证生成 | | 6 | 采购退货 | `PurchaseOrderService` | 退货，更新库存，生成凭证 | 库存回退，凭证生成 | | 7 | 订单列表查询 | `PurchaseOrderService` | 分页查询，多维度筛选 | 筛选条件生效，状态展示正确 | #### 3.2.2 订单状态机设计 **订单状态（status_order）流转：** - `1-草稿` → 确认 → `2-已确认` → 付款+入库完成 → `3-已完成` - `1-草稿` → `4-已取消`（仅草稿可取消） - `2-已确认` → 任何状态 → `3-已完成`（所有子状态均为完成） **付款状态（status_pay）流转：** - `1-未付款` → 付款金额>0且<总额 → `2-部分付款` - `1-未付款` 或 `2-部分付款` → 付款金额=总额 → `3-已付款` - `3-已付款` → 发起退款 → `4-退款中` → 退款完成 → `5-已退款` **库存状态（status_stock）流转：** - `1-未收货` → 入库数量>0且<订单数量 → `2-部分收货` - `1-未收货` 或 `2-部分收货` → 入库数量=订单数量 → `3-已收货` **发票状态（status_inv）流转：** - `1-未开票` → 开票金额>0且<总额 → `2-部分开票` - `1-未开票` 或 `2-部分开票` → 开票金额=总额 → `3-已开票` #### 3.2.3 凭证生成规则 **场景A：现金类账户付款** - 付款凭证： - 借：预付账款-ERP采购供应商（供应商辅助核算） - 贷：对应现金科目（如银行存款-浦发） - 在途库存凭证（同时生成）： - 借：在途库存_XX本地仓库（存货辅助核算） - 贷：预付账款-ERP在途发票 **场景B：账期类账户付款** - 付款凭证： - 借：预付账款-ERP采购供应商（供应商辅助核算） - 贷：应付账款_XXX（账期账户对应科目） - 在途库存凭证（同时生成）： - 借：在途库存_XX本地仓库（存货辅助核算） - 贷：预付账款-ERP在途发票 **场景C：入库** - 借：库存商品_XX本地仓库（存货辅助核算） - 贷：在途库存_XX本地仓库 **场景D：发票入账** - 借：预付账款-ERP在途发票 - 贷：预付账款-ERP采购供应商（供应商辅助核算） #### 3.2.4 接口契约 **采购订单付款** - `POST /api/finance/purchase/order/pay` - 请求体： ```json { "orderId": 1001, "accountId": 5, "feeType": "GOODS", "amount": 10000.00, "paymentDate": "2026-06-25" } ``` - 响应：`{ "code": 200, "data": { "voucherId": 123, "status": "PAID" } }` **采购入库** - `POST /api/finance/purchase/order/receive` - 请求体： ```json { "orderId": 1001, "qty": 100, "receiveDate": "2026-06-25" } ``` - 响应：`{ "code": 200, "data": { "voucherId": 124, "newUnitCost": 95.50 } }` #### 3.2.5 异常场景处理 | 异常场景 | 错误码 | 提示信息 | |---------|--------|---------| | 付款金额超过未付金额 | 4001 | "付款金额超过未付金额" | | 订单已付款完成 | 4002 | "订单已付款完成，不可重复付款" | | 订单状态不可付款 | 4003 | "当前订单状态不可付款" | | 入库数量超过订单数量 | 4004 | "入库数量超过订单未入库数量" | | 采购账户科目映射缺失 | 5001 | "采购账户科目映射不完整，请联系管理员" | #### 3.2.6 测试用例 | 测试场景 | 预期结果 | |---------|---------| | 创建订单，初始状态 | status_order=1（草稿），所有子状态均为1 | | 现金付款，全额 | 生成2张凭证（付款+在途），status_pay=3（已付款） | | 账期付款，全额 | 生成2张凭证（应付+在途），status_pay=3，现金未扣 | | 部分付款 | status_pay=2（部分付款），待付金额正确 | | 入库数量等于订单数量 | status_stock=3（已收货） | | 部分入库 | status_stock=2（部分收货） | | 全额退款 | 生成红字凭证，status_pay=5（已退款） | ### 3.3 阶段三：采购账户台账（第3-4周） #### 3.3.1 任务清单 | 序号 | 任务 | 服务类 | 方法/职责 | 验收标准 | |------|------|--------|---------|---------| | 1 | 台账列表查询 | `LedgerQueryService` | 分页查询，汇总行计算 | 数据准确，汇总正确 | | 2 | 台账付款（批量） | `LedgerPaymentService` | 勾选多条，生成凭证，更新状态 | 凭证生成，状态更新 | | 3 | 对账单上传 | `LedgerBatchService` | 解析Excel，预览确认，批量付款 | 解析成功，预览准确 | | 4 | 退款处理 | `LedgerPaymentService` | 生成红字凭证，更新台账 | 凭证正确，台账更新 | | 5 | 图表统计 | `LedgerStatisticsService` | 返回日期X轴+金额Y轴数据 | 图表数据正确 | #### 3.3.2 台账列表查询字段 | 字段组 | 包含字段 | 计算逻辑 | |--------|---------|---------| | 订单信息 | 账簿、采购账户、采购订单号、SKU、供应商、收款账号 | 直接从订单表关联查询 | | 付款状态 | 订单金额、请款金额、已付金额、待付金额 | 请款=归属供应商的费用类型金额合计；已付=累计付款；待付=请款-已付 | | 库存状态 | 库存价值、已入库价值、待入库价值 | 库存价值=采购订单的inventory_value；已入库=SUM(入库变动金额)；待入库=库存价值-已入库 | | 发票状态 | 应开票金额、已开票金额、待开票金额 | 应开票=归属供应商的请款金额；已开票=sum(invoiced_amount)；待开票=应开票-已开票 | **重要限制**： - 非供应商款项（如跨境直采手续费）不计入请款金额 - 退款金额按原方向反冲，减少请款金额 #### 3.3.3 台账付款核心约束 1. **同账户约束**：一次付款操作，所有选中的记录必须使用同一个账期采购账户 2. **账户类型约束**：仅账期类型账户支持台账付款 3. **现金账户约束**：选中的现金账户必须在账期账户的`creditPayAccounts`配置中 4. **金额约束**：付款金额不超过各订单待付金额之和 5. **尾差处理**：按比例分摊，差额归入最后一条记录 #### 3.3.4 Excel批量上传模板 | 列名 | 类型 | 说明 | 校验规则 | |------|------|------|---------| | 采购订单号 | 文本 | 订单唯一标识 | 必填，存在于系统 | | SKU | 文本 | SKU编码 | 必填，与订单匹配 | | 应付金额 | 数字 | 订单应付金额 | 必填，≥0 | | 本次付款金额 | 数字 | 本次实际支付 | 必填，>0，≤应付-已付 | | 费用类型 | 文本 | 货款/运费/其他 | 必填，在配置中 | **上传流程**： 1. 用户下载模板 2. 填写后上传 3. 系统解析并校验 4. 返回预览数据（含校验结果） 5. 用户确认后提交 6. 批量生成付款记录和凭证 #### 3.3.5 接口契约 **台账列表查询** - `GET /api/finance/ledger/purchase/page` - 参数：`groupid`, `accountId`, `startDate`, `endDate`, `payStatus`, `page`, `size` - 响应：分页数据 + 汇总行（订单金额、已付金额、待付金额汇总） **台账付款** - `POST /api/finance/ledger/purchase/ledger-pay` - 请求体： ```json { "orderIds": [1001, 1002, 1003], "cashAccountId": 5, "paymentDate": "2026-06-25" } ``` - 响应：`{ "code": 200, "data": { "voucherIds": [123, 124, 125], "totalAmount": 50000 } }` **上传对账单** - `POST /api/finance/ledger/purchase/upload-pay` - 请求：`multipart/form-data`，file字段 - 响应：预览数据 #### 3.3.6 测试用例 | 测试场景 | 预期结果 | |---------|---------| | 查询台账列表，带筛选条件 | 返回正确数据，汇总行金额正确 | | 勾选3条账期记录，台账付款 | 生成3张凭证，订单待付金额归零 | | 上传对账单Excel | 解析成功，预览显示待付款明细 | | 确认上传的对账单 | 批量生成凭证，更新订单状态 | | 部分退款 | 生成红字凭证，订单状态变为退款中/已退款 | ### 3.4 阶段四：发票台账与供应商台账（第4-5周） #### 3.4.1 任务清单 | 序号 | 任务 | 服务类 | 方法/职责 | 验收标准 | |------|------|--------|---------|---------| | 1 | 发票同步（税局API） | `InvoiceSyncService` | 拉取发票数据，写入fin_invoice | 去重，匹配供应商 | | 2 | 发票台账查询 | `InvoiceQueryService` | 多维度筛选，显示入账状态 | 筛选条件生效 | | 3 | 发票入账 | `InvoicePostingService` | 生成凭证，更新发票和订单状态 | 凭证生成，状态更新 | | 4 | 供应商台账查询 | `SupplierLedgerService` | 按供应商汇总各金额字段 | 汇总数据正确 | | 5 | 未开票明细导出 | `SupplierLedgerService` | 导出Excel | 格式正确，数据完整 | #### 3.4.2 发票同步流程 1. **触发方式**： - 定时任务：每日凌晨2点自动执行 - 手动触发：用户在页面点击"同步"按钮 2. **数据来源**：税局电子发票API（或金蝶接口） 3. **处理逻辑**： - 按日期范围拉取发票列表 - 按发票号码去重（已存在则跳过） - 按销方税号匹配内部供应商（`t_erp_supplier`） - 匹配成功则记录`supplier_id`，否则留空 - 写入`fin_invoice`，状态为"正常"，入账状态为"未入账" 4. **异常处理**：单条失败不影响整体，记录日志 #### 3.4.3 发票入账流程 1. **入口**：发票台账页面勾选未入账发票 → 点击"入账" 2. **或**：供应商台账页面勾选待开票记录 → 选择发票 → 提交入账 3. **处理逻辑**： - 校验发票未入账 - 校验供应商与订单供应商一致 - 获取该供应商下待开票订单列表 - 按订单待开票金额比例分摊发票金额 - 生成凭证（借：预付账款-ERP在途发票，贷：预付账款-ERP采购供应商） - 更新发票：`posting_status=1`，关联`voucher_id` - 更新订单：`invoiced_amount`增加，`status_inv`重新计算 #### 3.4.4 供应商台账查询字段 | 字段 | 计算逻辑 | |------|---------| | 供应商名称 | 从t_erp_supplier关联 | | 应付金额 | SUM(归属供应商的请款金额) | | 已付金额 | SUM(已付款金额，仅归属供应商部分) | | 待付金额 | 应付金额 - 已付金额 | | 库存价值 | SUM(inventory_value) | | 应开票金额 | SUM(归属供应商的请款金额) | | 已开票金额 | SUM(invoiced_amount) | | 待开票金额 | 应开票金额 - 已开票金额 | #### 3.4.5 接口契约 **发票同步** - `POST /api/finance/ledger/invoice/sync` - 请求体（可选）： ```json { "groupid": 1001, "startDate": "2026-06-01", "endDate": "2026-06-25" } ``` - 响应：`{ "code": 200, "data": { "success": 50, "failed": 2 } }` **发票入账** - `POST /api/finance/ledger/invoice/post` - 请求体： ```json { "invoiceIds": [101, 102], "orderIds": [1001, 1002, 1003], "voucherDate": "2026-06-25" } ``` - 响应：`{ "code": 200, "data": { "voucherId": 200 } }` **供应商台账查询** - `GET /api/finance/ledger/supplier/page` - 参数：`groupid`, `supplierIds`, `page`, `size` - 响应：分页数据 **导出未开票明细** - `GET /api/finance/ledger/supplier/export-uninvoiced` - 参数：`groupid`, `supplierId` - 响应：Excel文件流 #### 3.4.6 测试用例 | 测试场景 | 预期结果 | |---------|---------| | 手动触发发票同步 | 拉取到新发票，写入fin_invoice，匹配供应商 | | 发票入账（全额匹配） | 生成凭证，订单待开票金额归零 | | 发票入账（部分匹配） | 分摊到多条订单，待开票金额减少 | | 供应商台账查询 | 汇总数据正确，与订单明细一致 | | 导出未开票明细 | Excel包含未开票订单及金额 | ### 3.5 阶段五：库存台账（本地仓库）（第5-6周） #### 3.5.1 任务清单 | 序号 | 任务 | 服务类 | 方法/职责 | 验收标准 | |------|------|--------|---------|---------| | 1 | 移动加权平均计算 | `MovingAverageCostCalculator` | 计算新单价、出库成本 | 计算精确，保留4位小数 | | 2 | 采购入库更新库存 | `InventoryService` | 更新余额表、插入变动明细、生成凭证 | 余额正确，明细完整 | | 3 | 销售出库更新库存 | `InventoryService` | 更新余额表、插入变动明细、生成凭证 | 余额正确，明细完整 | | 4 | 库存汇总账查询 | `InventoryQueryService` | 按期间展示期初/入库/出库/期末 | 数据准确 | | 5 | 库存明细账查询 | `InventoryQueryService` | 逐笔变动明细，联查凭证 | 明细完整，可联查 | | 6 | 勾稽校验 | `InventoryCheckService` | 对比库存余额与科目余额 | 提示差异明细 | #### 3.5.2 移动加权平均核算规则 **核心公式：** ``` 新移动单价 = (当前结存金额 + 本次入库金额) / (当前结存数量 + 本次入库数量) 出库成本 = 出库数量 × 当前移动单价 ``` **重要规则：** 1. 只有采购入库（`PURCHASE_IN`）、盘盈入库（`ADJUST_IN`）会改变移动单价 2. 销售出库（`SALE_OUT`）、调拨出库（`TRANSFER_OUT`）不改变单价，仅减少数量 3. 库存余额不通过"单价×数量"反算，采用滚动加减法： - 新余额 = 旧余额 + 入库金额 - 出库成本 4. 单价保留4位小数，金额保留2位小数 5. 尾差处理：出库时先乘后减，避免单价反算误差 **期间核算：** - 按月汇总，每月初从上月期末结转 - 同一SKU在同一仓库同一期间仅有一条库存余额记录 #### 3.5.3 库存变动类型 | 类型编码 | 说明 | 数量方向 | 是否影响单价 | 来源 | |---------|------|---------|-------------|------| | `PURCHASE_IN` | 采购入库 | 正 | 是 | 采购订单收货 | | `SALE_OUT` | 销售出库 | 负 | 否 | 销售订单发货 | | `TRANSFER_IN` | 调拨入库 | 正 | 否（沿用原单价） | 仓库调拨 | | `TRANSFER_OUT` | 调拨出库 | 负 | 否 | 仓库调拨 | | `ADJUST_IN` | 盘盈入库 | 正 | 是 | 盘点调整 | | `ADJUST_OUT` | 盘亏出库 | 负 | 否 | 盘点调整 | #### 3.5.4 汇总账查询结构 | 列 | 说明 | |----|------| | 期间 | YYYYMM | | 账簿 | groupid对应账套名称 | | SKU | SKU编码 | | 仓库 | 仓库编码 | | 期初数量 | 上期期末数量 | | 期初金额 | 上期期末金额 | | 本期入库数量 | SUM(入库变动数量) | | 本期入库金额 | SUM(入库变动金额) | | 本期出库数量 | SUM(出库变动数量绝对值) | | 本期出库金额 | SUM(出库变动金额绝对值) | | 期末数量 | 期初数量 + 入库数量 - 出库数量 | | 期末金额 | 期初金额 + 入库金额 - 出库金额 | | 期末单价 | 期末金额 / 期末数量 | #### 3.5.5 明细账查询结构 | 列 | 说明 | |----|------| | 日期 | 变动日期 | | SKU | SKU编码 | | 仓库 | 仓库编码 | | 变动类型 | PURCHASE_IN/SALE_OUT等 | | 数量 | 正为入库，负为出库 | | 单价 | 发生时使用的单价 | | 金额 | 数量 × 单价 | | 来源单据号 | 采购订单号/销售订单号等 | | 凭证号 | 关联凭证编号 | #### 3.5.6 勾稽校验逻辑 **校验目标**：库存台账的期末金额与总账中"库存商品"科目余额一致 **校验步骤**： 1. 查询指定期间内所有SKU的期末库存金额合计 2. 查询总账中"库存商品"科目（及所有子科目）的期末余额 3. 对比两者差异 4. 若差异不为零，列出差异明细（按SKU或按仓库） **差异处理建议**： - 差异 < 100元：可接受，记录为"微小差异" - 差异 ≥ 100元：需要生成调整凭证 #### 3.5.7 接口契约 **库存汇总账查询** - `GET /api/finance/ledger/stock/summary` - 参数：`groupid`, `period`（YYYYMM）, `sku`（可选模糊搜索）, `warehouseCode`（可选） - 响应：分页数据 **库存明细账查询** - `GET /api/finance/ledger/stock/detail` - 参数：`groupid`, `sku`, `warehouseCode`, `startDate`, `endDate` - 响应：分页明细数据 **勾稽校验** - `GET /api/finance/ledger/stock/check` - 参数：`groupid`, `period` - 响应： ```json { "stockAmount": 1000000.00, "ledgerAmount": 1000050.00, "diff": -50.00, "status": "BALANCED", // 或 "DIFF" "details": [] // 差异明细 } ``` #### 3.5.8 测试用例 | 测试场景 | 预期结果 | |---------|---------| | 采购入库，库存为空 | 新增库存余额记录，单价=入库金额/数量 | | 采购入库，库存已有 | 更新余额，重新计算移动单价 | | 销售出库 | 按当前单价计算成本，减少库存 | | 盘点调整 | 调整后单价重新计算 | | 勾稽校验，无差异 | 返回BALANCED状态 | | 勾稽校验，有差异 | 返回DIFF状态，列出差异明细 | ## 4. 联调与测试（第6周） ### 4.1 端到端流程测试 | 测试场景 | 操作步骤 | 验证点 | |---------|---------|--------| | 完整采购流程（现金） | 创建订单→付款→入库→发票入账 | 凭证正确，台账更新，状态流转正确 | | 完整采购流程（账期） | 创建订单→账期付款→台账付款→入库→发票入账 | 凭证正确，台账更新，状态流转正确 | | 部分付款+部分入库 | 创建订单→部分付款→部分入库→余款付款→余货入库 | 状态正确，金额正确 | | 退款流程（已付款未入库） | 创建订单→全额付款→全额退款 | 红字凭证，状态变为已退款 | | 退款流程（已付款已入库） | 创建订单→付款→入库→退货→退款 | 退货凭证，退款凭证，库存回退 | | 批量对账单上传 | 上传Excel→预览→确认 | 批量生成凭证和付款明细 | | 月末结账 | 调汇→结转损益→结账 | 期间关闭，不可修改 | ### 4.2 性能测试 | 测试项 | 数据量 | 性能要求 | |--------|--------|---------| | 台账列表查询 | 10万条订单 | 响应时间 ≤ 3秒 | | 发票同步 | 单次1万条 | 处理时间 ≤ 5分钟 | | 库存汇总账 | 1万条SKU记录 | 响应时间 ≤ 5秒 | | 批量对账单上传 | 500条记录 | 处理时间 ≤ 30秒 | | 移动加权平均计算 | 单次1000条变动 | 计算时间 ≤ 5秒 | ### 4.3 数据一致性测试 | 测试项 | 验证方法 | |--------|---------| | 采购订单金额 = 付款明细合计 | 查询统计对比 | | 订单库存价值 = 入库明细合计 | 查询统计对比 | | 订单已开票金额 = 发票入账金额合计 | 查询统计对比 | | 库存余额 = 期初 + 入库 - 出库 | 滚动计算校验 | | 库存余额对应总账科目余额 | 勾稽校验接口 | ## 5. 数据迁移方案（第6周） ### 5.1 迁移范围 - 历史采购订单（从ERP采购单表） - 历史库存数据（从现有库存表） - 历史发票数据（从金蝶/税局） ### 5.2 迁移顺序 1. **采购账户**：手动创建历史使用的采购账户 2. **采购订单**：按时间分批迁移，每批1000条 3. **付款明细**：从ERP付款记录中提取 4. **库存余额**：从当前库存表初始化 5. **发票台账**：从税局API拉取历史发票 ### 5.3 迁移校验 - 迁移完成后，运行勾稽校验 - 对比迁移前后的总额数据，误差 < 100元为通过 ## 6. 风险与应对 | 风险 | 影响 | 应对措施 | |------|------|---------| | 税局API不稳定 | 发票同步失败 | 支持手动导入Excel，保留重试机制 | | 历史数据量过大 | 迁移耗时长 | 分批迁移，错峰执行 | | 科目配置复杂 | 凭证生成错误 | 提供配置校验工具，预置常用模板 | | 多账套数据隔离 | 权限混乱 | 所有查询强制带groupid，使用多租户拦截器 | | 移动加权计算精度 | 尾差累积 | 保留4位小数，定期勾稽校验 | ## 7. 里程碑与交付物 | 里程碑 | 时间 | 交付物 | |--------|------|--------| | M1：基础配置上线 | 第1周末 | 采购账户CRUD、供应商收款账户管理 | | M2：采购订单上线 | 第3周末 | 采购订单创建、付款、退款、入库、凭证生成 | | M3：台账模块上线 | 第4周末 | 采购账户台账、台账付款、批量对账单 | | M4：发票模块上线 | 第5周末 | 发票同步、发票入账、供应商台账 | | M5：库存模块上线 | 第6周中 | 库存汇总账、明细账、勾稽校验 | | M6：全量联调上线 | 第6周末 | 端到端测试通过，数据迁移完成 | ## 8. 附录：术语表 | 术语 | 说明 | |------|------| | 账期账户 | 采购时先挂账，后续通过台账付款实际支付的账户类型 | | 现金账户 | 采购时直接扣款的账户类型，如银行账户、连连账户 | | 台账付款 | 账期账户的还款操作，在台账页面批量处理 | | 归属供应商款项 | 计入供应商应付/已付的金额（如货款、运费），不含手续费等 | | 非供应商款项 | 不计入供应商应付的金额（如跨境直采手续费） | | 移动加权平均 | 每笔入库后重新计算库存单价的成本核算方法 | | 在途库存 | 已付款但尚未入库的存货，在途库存_XX本地仓库科目 | | 预付账款-ERP采购供应商 | 用于记录已付款但未取得发票的供应商款项 | | 预付账款-ERP在途发票 | 用于记录已取得发票但未入库的库存 | # 财务ERP - 进销存模块（采购与台账）开发纲要 ## 文档说明本文档为20260618进销存模块梳理后的开发纲要，简明列出业务目标、核心功能、数据库设计及开发优先级，便于开发团队快速把握全貌。 ## 版本历史 | 版本 | 日期 | 修改内容 | 作者 | |------|------|---------|------| | v1.0 | 2026-06-25 | 初稿 | 架构组 | ## 1. 业务目标打通采购业务与财务核算的闭环，实现： - 采购订单 → 付款 → 入库 → 发票全流程自动记账 - 多维度台账查询（采购账户、供应商、发票、库存） - 移动加权平均成本核算 - 账期采购的批量结算与对账 ## 2. 核心功能模块 ### 2.1 功能模块总览 | 序号 | 模块 | 核心功能 | 优先级 | |------|------|---------|--------| | 1 | 基础配置 | 采购账户配置、供应商收款账户、进销存全局配置 | P0 | | 2 | 采购订单（会计版） | 订单创建、付款、退款、入库、退货、状态管理 | P0 | | 3 | 采购账户台账 | 台账列表查询、台账付款、批量对账单上传、图表统计 | P0 | | 4 | 供应商台账 | 供应商汇总查询、未开票明细导出 | P0 | | 5 | 发票台账 | 发票同步（税局API）、发票入账、发票查询 | P0 | | 6 | 本地仓库台账 | 移动加权平均计算、汇总账、明细账、勾稽校验 | P1 | ### 2.2 业务流程图 **核心流程：采购 → 财务全链路** ``` ┌─────────────────────────────────────────────────────────────────────────────┐ │ 采购全流程业务图 │ ├─────────────────────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ 创建订单 │────▶│ 确认订单 │───▶│ 采购付款 │────▶│ 采购入库 │ │ │ └─────────┘ └─────────┘ └────┬────┘ └────┬────┘ │ │ │ │ │ │ ▼ ▼ │ │ ┌─────────────────────────────┐ │ │ │ 自动生成凭证 │ │ │ │ 付款凭证 / 在途库存凭证 │ │ │ └─────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────┐ ┌─────────┐ ┌─────────────────────────────┐ │ │ │ 发票入账 │◀────│ 发票同步 │◀────│ 发票台账 │ │ │ └────┬────┘ └─────────┘ └─────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────────┐ │ │ │ 台账管理 │ │ │ │ 采购账户台账 │ 供应商台账 │ 本地仓库台账 │ FBA仓库台账│ │ │ │ └─────────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────────────┘ ``` **账期付款流程：** ``` 采购订单(账期付款) ──▶ 生成凭证(应付账款) ──▶ 进入采购账户台账 │ ▼ 台账付款(批量勾选) │ ▼ 选择现金账户实际支付 ──▶ 生成凭证(还款) │ ▼ 更新订单付款状态 ``` **发票入账流程：** ``` 税局API ──▶ 发票同步 ──▶ 发票台账(未入账) │ ▼ 匹配采购订单(供应商) │ ▼ 发票入账(勾选确认) │ ▼ 生成凭证 ──▶ 更新订单开票状态 ``` ## 3. 状态机设计 ### 3.1 采购订单状态（四维状态） | 状态维度 | 编码 | 说明 | 流转条件 | |---------|------|------|---------| | **订单状态** | 1-草稿 | 初始状态 | 创建时 | | | 2-已确认 | 订单生效 | 用户确认 | | | 3-已完成 | 全部完成 | 付款+入库完成 | | | 4-已取消 | 订单取消 | 仅草稿可取消 | | **付款状态** | 1-未付款 | 初始 | 创建时 | | | 2-部分付款 | 已付>0且<总额 | 付款操作 | | | 3-已付款 | 已付=总额 | 付款完成 | | | 4-退款中 | 已发起退款 | 退款操作 | | | 5-已退款 | 退款完成 | 退款完成 | | **库存状态** | 1-未收货 | 初始 | 创建时 | | | 2-部分收货 | 已收>0且<数量 | 入库操作 | | | 3-已收货 | 已收=数量 | 入库完成 | | **发票状态** | 1-未开票 | 初始 | 创建时 | | | 2-部分开票 | 已开>0且<总额 | 发票入账 | | | 3-已开票 | 已开=总额 | 开票完成 | ### 3.2 付款状态流转图 ``` ┌──────────────────────────────────────┐ │ │ ▼ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ 未付款 │────▶│ 部分付款 │────▶│ 已付款 │ │ └─────────┘ └─────────┘ └────┬────┘ │ │ │ │ │ ▼ │ │ ┌──────────┐ │ │ │ 退款中 │ │ │ └────┬─────┘ │ │ │ │ │ ▼ │ │ ┌──────────┐ │ └────────────────────────▶│ 已退款 │─────────────┘ └──────────┘ ``` ## 4. 核心业务规则 ### 4.1 凭证生成规则 | 业务场景 | 借方科目 | 贷方科目 | 辅助核算 | |---------|---------|---------|---------| | 现金付款 | 预付账款-ERP采购供应商 | 银行存款/其他货币资金 | 供应商 | | 账期付款 | 预付账款-ERP采购供应商 | 应付账款-XXX（账期户） | 供应商 | | 在途库存确认 | 在途库存_XX仓库 | 预付账款-ERP在途发票 | 存货(SKU) | | 采购入库 | 库存商品_XX仓库 | 在途库存_XX仓库 | 存货(SKU) | | 发票入账 | 预付账款-ERP在途发票 | 预付账款-ERP采购供应商 | 供应商 | | 账期还款 | 应付账款-XXX（账期户） | 银行存款/其他货币资金 | 供应商 | | 退款（反向） | 对应贷方科目 | 对应借方科目 | 供应商/存货 | ### 4.2 成本核算规则 | 规则项 | 说明 | |--------|------| | 核算方法 | 移动加权平均法 | | 单价精度 | 保留4位小数 | | 金额精度 | 保留2位小数 | | 入库影响 | 每笔采购入库重新计算单价 | | 出库影响 | 使用当前单价计算成本，不改变单价 | | 余额计算 | 滚动加减，不反算 | | 尾差处理 | 出库时先乘后减，差额归入最后一条 | | 核算周期 | 按月汇总，逐笔明细 | ### 4.3 台账核算规则 | 规则项 | 说明 | |--------|------| | 请款金额 | 仅统计"归属供应商款项"的费用类型 | | 待付金额 | 请款金额 - 已付金额 | | 待入库金额 | 库存价值 - 已入库价值 | | 待开票金额 | 应开票金额 - 已开票金额 | | 应开票金额 | 归属供应商的请款金额（即待开票订单总额） | | 分摊方式 | 按比例分摊，尾差归最后一条 | | 退款处理 | 红字冲销，减少请款/已付/库存/开票金额 | ## 5. 数据库设计 ### 5.1 ER图（核心表关系） ``` ┌─────────────────────────┐ │ fin_purchase_account │ │ (采购账户) │ └───────────┬─────────────┘ │ 1 │ │ N ┌───────────▼─────────────┐ ┌─────────────────────────┐ │ fin_purchase_order │──────────│ t_erp_supplier │ │ (采购订单-会计版) │ N 1│ (供应商-ERP) │ └───────────┬─────────────┘ └─────────────────────────┘ │ 1 │ │ │ 1 │ N │ ┌───────────▼─────────────┐ ┌───────▼─────────────────┐ │ fin_purchase_payment │ │ fin_supplier_bank │ │ (采购付款明细) │ │ (供应商收款账户) │ └───────────┬─────────────┘ └─────────────────────────┘ │ │ N:1 ┌───────────▼─────────────┐ ┌─────────────────────────┐ │ fin_vouchers │ │ fin_invoice │ │ (凭证-现有表) │◀─────────│ (发票台账) │ └─────────────────────────┘ └─────────────────────────┘ │ ┌─────────────────────────┐ ┌───────────▼─────────────┐ │ fin_warehouse_stock │ │ fin_inventory_transaction│ │ (库存余额) │ │ (库存变动明细) │ └───────────┬─────────────┘ └───────────┬─────────────┘ │ │ └───────────────────┬────────────────┘ │ ┌───────────▼─────────────┐ │ fin_vouchers │ │ (凭证-关联) │ └─────────────────────────┘ ``` ### 5.2 新增表清单 | 序号 | 表名 | 说明 | 关联模块 | |------|------|------|---------| | 1 | `fin_purchase_account` | 采购账户配置表 | 基础配置 | | 2 | `fin_supplier_bank` | 供应商收款账户表 | 基础配置 | | 3 | `fin_purchase_order` | 采购订单表（会计版） | 采购订单 | | 4 | `fin_purchase_payment` | 采购付款明细表 | 采购订单/台账 | | 5 | `fin_invoice` | 发票台账表 | 发票台账 | | 6 | `fin_warehouse_stock` | 库存余额表 | 库存台账 | | 7 | `fin_inventory_transaction` | 库存变动明细表 | 库存台账 | ### 5.3 表结构详情 #### 5.3.1 采购账户表 `fin_purchase_account` | 字段 | 类型 | 必填 | 说明 | |------|------|------|------| | `id` | bigint unsigned | ✅ | 主键，自增 | | `groupid` | bigint unsigned | ✅ | 租户ID（账套），索引 | | `account_name` | varchar(100) | ✅ | 账户名称，同租户唯一 | | `account_type` | tinyint | ✅ | 1-现金，2-账期，默认1 | | `related_subject_id` | bigint unsigned | ✅ | 对应会计科目ID | | `config_json` | json | ✅ | 完整配置JSON | | `is_enabled` | tinyint | | 是否启用，默认1 | | `created_time` | datetime | | 创建时间，自动 | | `updated_time` | datetime | | 更新时间，自动 | **config_json 结构：** ```json { "feeTypes": [ { "code": "GOODS", "name": "货款", "isSupplierRelated": true }, { "code": "FREIGHT", "name": "运费", "isSupplierRelated": true }, { "code": "SERVICE", "name": "跨境直采手续费", "isSupplierRelated": false } ], "paySubjectMapping": { "GOODS": { "debitSubjectId": 101, "creditSubjectId": 201 } }, "refundMapping": { "GOODS": { "debitSubjectId": 201, "creditSubjectId": 101 } }, "creditPayAccounts": [ { "cashAccountId": 1, "subjectMapping": { "debit": 301, "credit": 201 } } ] } ``` #### 5.3.2 供应商收款账户表 `fin_supplier_bank` | 字段 | 类型 | 必填 | 说明 | |------|------|------|------| | `id` | bigint unsigned | ✅ | 主键，自增 | | `groupid` | bigint unsigned | ✅ | 租户ID | | `supplier_id` | bigint unsigned | ✅ | 供应商ID，索引 | | `bank_name` | varchar(100) | | 开户银行 | | `account_name` | varchar(100) | ✅ | 收款账户名称 | | `account_no` | varchar(50) | ✅ | 收款账号 | | `is_default` | tinyint | | 是否默认，默认0 | | `is_enabled` | tinyint | | 是否启用，默认1 | | `created_time` | datetime | | 创建时间，自动 | #### 5.3.3 采购订单表 `fin_purchase_order` | 字段 | 类型 | 必填 | 说明 | |------|------|------|------| | `id` | bigint unsigned | ✅ | 主键，自增 | | `groupid` | bigint unsigned | ✅ | 租户ID，索引 | | `supplier_id` | bigint unsigned | ✅ | 供应商ID | | `purchase_account_id` | bigint unsigned | ✅ | 采购账户ID | | `sku` | varchar(50) | ✅ | SKU编码 | | `warehouse_code` | varchar(50) | ✅ | 入库仓库编码 | | `order_qty` | decimal(12,2) | ✅ | 订单数量，>0 | | `unit_price` | decimal(18,4) | | 采购单价，≥0 | | `total_amount` | decimal(18,2) | ✅ | 订单金额 | | `paid_amount` | decimal(18,2) | | 累计已付，默认0 | | `inventory_value` | decimal(18,2) | | 库存价值，默认0 | | `invoiced_amount` | decimal(18,2) | | 已开票金额，默认0 | | `status_order` | tinyint | | 1-草稿，2-已确认，3-已完成，4-已取消 | | `status_pay` | tinyint | | 1-未付款，2-部分付款，3-已付款，4-退款中，5-已退款 | | `status_inv` | tinyint | | 1-未开票，2-部分开票，3-已开票 | | `status_stock` | tinyint | | 1-未收货，2-部分收货，3-已收货 | | `created_time` | datetime | | 创建时间，自动 | | `updated_time` | datetime | | 更新时间，自动 | **索引建议**：`(groupid, supplier_id)`, `(groupid, status_pay)`, `(groupid, status_inv)`, `(groupid, status_stock)` #### 5.3.4 采购付款明细表 `fin_purchase_payment` | 字段 | 类型 | 必填 | 说明 | |------|------|------|------| | `id` | bigint unsigned | ✅ | 主键，自增 | | `purchase_order_id` | bigint unsigned | ✅ | 采购订单ID，索引 | | `purchase_account_id` | bigint unsigned | ✅ | 采购账户ID | | `voucher_id` | bigint unsigned | | 关联凭证ID，索引 | | `fee_type` | varchar(50) | ✅ | 费用类型 | | `is_supplier_related` | tinyint | | 是否归属供应商，默认1 | | `amount` | decimal(18,2) | ✅ | 支付金额 | | `payment_date` | date | ✅ | 付款日期 | | `is_refund` | tinyint | | 是否退款，默认0 | | `refund_original_id` | bigint unsigned | | 退款对应的原付款明细ID | | `status` | tinyint | | 0-正常，1-已退款，默认0 | | `created_time` | datetime | | 创建时间，自动 | #### 5.3.5 发票台账表 `fin_invoice` | 字段 | 类型 | 必填 | 说明 | |------|------|------|------| | `id` | bigint unsigned | ✅ | 主键，自增 | | `invoice_no` | varchar(100) | ✅ | 数电发票号码，唯一 | | `invoice_type` | varchar(20) | ✅ | 数电专票/普票/传统 | | `groupid` | bigint unsigned | | 入账账套ID，索引 | | `supplier_id` | bigint unsigned | | 匹配的供应商ID | | `seller_name` | varchar(200) | ✅ | 销方名称 | | `seller_tax_no` | varchar(50) | | 销方税号 | | `invoice_date` | date | ✅ | 开票日期 | | `amount_with_tax` | decimal(18,2) | ✅ | 价税合计 | | `amount_without_tax` | decimal(18,2) | ✅ | 不含税金额 | | `tax_amount` | decimal(18,2) | ✅ | 税额 | | `status` | varchar(20) | | NORMAL/CANCELLED/RED_ALL/RED_PART/ABNORMAL | | `posting_status` | tinyint | | 0-未入账，1-已入账，默认0 | | `voucher_id` | bigint unsigned | | 入账凭证ID | | `sync_time` | datetime | | 同步时间 | | `created_time` | datetime | | 创建时间，自动 | #### 5.3.6 库存余额表 `fin_warehouse_stock` | 字段 | 类型 | 必填 | 说明 | |------|------|------|------| | `id` | bigint unsigned | ✅ | 主键，自增 | | `groupid` | bigint unsigned | ✅ | 租户ID | | `sku` | varchar(50) | ✅ | SKU编码 | | `warehouse_code` | varchar(50) | ✅ | 仓库编码 | | `warehouse_type` | tinyint | | 1-本地，2-FBA，默认1 | | `current_qty` | decimal(12,2) | | 当前数量，默认0 | | `current_amount` | decimal(18,2) | | 当前金额，默认0 | | `unit_cost` | decimal(18,4) | | 移动平均单价，默认0 | | `period` | varchar(6) | ✅ | 会计期间（YYYYMM） | | `updated_time` | datetime | | 更新时间，自动 | **唯一索引**：`(groupid, sku, warehouse_code, warehouse_type, period)` #### 5.3.7 库存变动明细表 `fin_inventory_transaction` | 字段 | 类型 | 必填 | 说明 | |------|------|------|------| | `id` | bigint unsigned | ✅ | 主键，自增 | | `groupid` | bigint unsigned | ✅ | 租户ID | | `sku` | varchar(50) | ✅ | SKU编码 | | `warehouse_code` | varchar(50) | ✅ | 仓库编码 | | `trans_date` | date | ✅ | 变动日期 | | `trans_type` | varchar(50) | ✅ | PURCHASE_IN/SALE_OUT/TRANSFER_IN/ADJUST | | `source_doc_id` | varchar(100) | | 来源单据号 | | `qty_change` | decimal(12,2) | ✅ | 正为入库，负为出库 | | `amount_change` | decimal(18,2) | ✅ | 金额变动 | | `unit_cost` | decimal(18,4) | | 发生时单价 | | `voucher_id` | bigint unsigned | | 关联凭证ID，索引 | | `created_time` | datetime | | 创建时间，自动 | ### 5.4 与现有表的关系 | 现有表 | 关联方式 | 说明 | |--------|---------|------| | `fin_accounting_subjects` | `subject_id` | 采购账户关联科目，凭证分录使用 | | `fin_vouchers` | `voucher_id` | 付款、入库、发票入账生成的凭证 | | `fin_voucher_entries` | `voucher_id` | 凭证分录明细 | | `fin_voucher_entries_auxiliary` | `entry_id` | 供应商/存货辅助核算 | | `t_erp_supplier` | `supplier_id` | 供应商主数据（跨模块） | | `t_erp_sku` | `sku` | SKU主数据（跨模块） | | `t_erp_warehouse` | `warehouse_code` | 仓库主数据（跨模块） | ### 5.5 索引清单 | 表 | 索引字段 | 类型 | 用途 | |----|---------|------|------| | `fin_purchase_account` | `groupid` | 普通 | 租户隔离 | | `fin_supplier_bank` | `supplier_id` | 普通 | 按供应商查询 | | `fin_supplier_bank` | `(groupid, supplier_id)` | 复合 | 租户+供应商查询 | | `fin_purchase_order` | `groupid` | 普通 | 租户隔离 | | `fin_purchase_order` | `(groupid, supplier_id)` | 复合 | 供应商台账查询 | | `fin_purchase_order` | `(groupid, status_pay)` | 复合 | 付款状态筛选 | | `fin_purchase_order` | `(groupid, status_inv)` | 复合 | 发票状态筛选 | | `fin_purchase_order` | `(groupid, status_stock)` | 复合 | 库存状态筛选 | | `fin_purchase_payment` | `purchase_order_id` | 普通 | 订单关联查询 | | `fin_purchase_payment` | `voucher_id` | 普通 | 凭证关联查询 | | `fin_invoice` | `invoice_no` | 唯一 | 发票去重 | | `fin_invoice` | `groupid` | 普通 | 租户隔离 | | `fin_invoice` | `(groupid, posting_status)` | 复合 | 入账状态筛选 | | `fin_warehouse_stock` | `(groupid, sku, warehouse_code, warehouse_type, period)` | 唯一 | 期间库存查询 | | `fin_inventory_transaction` | `(groupid, sku)` | 复合 | SKU明细查询 | | `fin_inventory_transaction` | `voucher_id` | 普通 | 凭证关联查询 | ## 6. 接口清单 ### 6.1 基础配置接口 | 方法 | 路径 | 说明 | |------|------|------| | POST | `/api/finance/purchase/account/create` | 创建采购账户 | | PUT | `/api/finance/purchase/account/update` | 更新采购账户 | | GET | `/api/finance/purchase/account/list` | 查询采购账户列表 | | GET | `/api/finance/purchase/account/detail/{id}` | 查询采购账户详情 | | POST | `/api/finance/supplier/bank/save` | 保存供应商收款账户 | | GET | `/api/finance/supplier/bank/list` | 查询供应商收款账户列表 | ### 6.2 采购订单接口 | 方法 | 路径 | 说明 | |------|------|------| | POST | `/api/finance/purchase/order/create` | 创建采购订单 | | POST | `/api/finance/purchase/order/confirm` | 确认订单 | | POST | `/api/finance/purchase/order/pay` | 采购付款 | | POST | `/api/finance/purchase/order/refund` | 采购退款 | | POST | `/api/finance/purchase/order/receive` | 采购入库 | | POST | `/api/finance/purchase/order/return` | 采购退货 | | GET | `/api/finance/purchase/order/page` | 订单列表查询 | | GET | `/api/finance/purchase/order/detail/{id}` | 订单详情查询 | ### 6.3 台账接口 | 方法 | 路径 | 说明 | |------|------|------| | GET | `/api/finance/ledger/purchase/page` | 采购账户台账列表 | | POST | `/api/finance/ledger/purchase/ledger-pay` | 台账付款 | | POST | `/api/finance/ledger/purchase/upload-pay` | 上传对账单批量付款 | | GET | `/api/finance/ledger/purchase/statistics` | 台账图表统计 | | GET | `/api/finance/ledger/supplier/page` | 供应商台账列表 | | GET | `/api/finance/ledger/supplier/export-uninvoiced` | 导出未开票明细 | ### 6.4 发票接口 | 方法 | 路径 | 说明 | |------|------|------| | POST | `/api/finance/ledger/invoice/sync` | 手动同步发票 | | GET | `/api/finance/ledger/invoice/page` | 发票台账列表 | | POST | `/api/finance/ledger/invoice/post` | 发票入账 | | GET | `/api/finance/ledger/invoice/statistics` | 发票统计 | ### 6.5 库存接口 | 方法 | 路径 | 说明 | |------|------|------| | GET | `/api/finance/ledger/stock/summary` | 库存汇总账 | | GET | `/api/finance/ledger/stock/detail` | 库存明细账 | | GET | `/api/finance/ledger/stock/check` | 勾稽校验 | ## 7. 开发优先级与排期 ### 7.1 优先级定义 | 等级 | 说明 | 必须完成时间 | |------|------|-------------| | **P0** | 核心功能，必须上线 | 第4周末 | | **P1** | 重要功能，上线后尽快完成 | 第6周末 | | **P2** | 增强功能，后续迭代 | 后续版本 | ### 7.2 排期总览 | 阶段 | 周期 | 模块 | 任务数 | 优先级 | |------|------|------|--------|--------| | 阶段一 | 第1周 | 基础配置 | 4 | P0 | | 阶段二 | 第2-3周 | 采购订单（会计版） | 7 | P0 | | 阶段三 | 第3-4周 | 采购账户台账 | 5 | P0 | | 阶段四 | 第4-5周 | 发票台账与供应商台账 | 5 | P0 | | 阶段五 | 第5-6周 | 库存台账 | 6 | P1 | | 阶段六 | 第6周 | 联调与测试 | - | P0/P1 | ### 7.3 里程碑 | 里程碑 | 时间 | 交付物 | 验收标准 | |--------|------|--------|---------| | M1 | 第1周末 | 基础配置上线 | 采购账户CRUD、供应商收款账户管理可用 | | M2 | 第3周末 | 采购订单上线 | 订单创建、付款、退款、入库、凭证生成可用 | | M3 | 第4周末 | 台账模块上线 | 采购账户台账、台账付款、批量对账单可用 | | M4 | 第5周末 | 发票模块上线 | 发票同步、发票入账、供应商台账可用 | | M5 | 第6周中 | 库存模块上线 | 汇总账、明细账、勾稽校验可用 | | M6 | 第6周末 | 全量联调上线 | 端到端流程测试通过，数据迁移完成 | ### 7.4 任务依赖关系 ``` 基础配置 (P0) │ ├── 采购订单 (P0) │ │ │ ├── 采购账户台账 (P0) │ │ │ │ │ └── 批量对账单上传 (P0) │ │ │ ├── 发票台账 (P0) │ │ │ │ │ └── 供应商台账 (P0) │ │ │ └── 库存台账 (P1) │ │ │ ├── 移动加权平均 (P1) │ │ │ └── 勾稽校验 (P1) │ └── 供应商收款账户 (P0) ──▶ 采购订单付款 ``` ## 8. 测试验收要点 ### 8.1 核心流程测试 | 测试场景 | 验证点 | |---------|--------| | 现金采购完整流程 | 订单创建→付款→入库→发票入账，凭证正确，状态流转正确 | | 账期采购完整流程 | 订单创建→账期付款→台账付款→入库→发票入账，凭证正确 | | 部分付款+部分入库 | 状态正确（部分付款/部分收货），金额正确 | | 退款（已付款未入库） | 红字凭证，状态变为已退款 | | 退款（已付款已入库） | 退货凭证，库存回退，状态正确 | | 批量对账单上传 | Excel解析→预览→确认→批量生成凭证 | ### 8.2 台账查询测试 | 测试场景 | 验证点 | |---------|--------| | 采购账户台账列表 | 各金额字段正确，汇总行准确 | | 供应商台账 | 按供应商汇总数据正确 | | 发票台账 | 同步数据完整，入账状态正确 | | 库存汇总账 | 期初/入库/出库/期末数据正确 | | 库存明细账 | 逐笔变动可追溯，联查凭证 | ### 8.3 数据一致性测试 | 测试项 | 验证方法 | |--------|---------| | 订单金额 = 付款明细合计 | 查询统计对比 | | 库存价值 = 入库明细合计 | 查询统计对比 | | 已开票金额 = 发票入账金额合计 | 查询统计对比 | | 库存余额 = 期初 + 入库 - 出库 | 滚动计算校验 | | 库存余额 = 总账科目余额 | 勾稽校验接口 | ## 9. 风险与应对 | 风险 | 影响 | 应对措施 | |------|------|---------| | 税局API不稳定 | 发票同步失败 | 支持手动导入Excel，保留重试机制 | | 历史数据量大 | 迁移耗时长 | 分批迁移，错峰执行 | | 科目配置复杂 | 凭证生成错误 | 提供配置校验工具，预置常用模板 | | 移动加权精度 | 尾差累积 | 保留4位小数，定期勾稽校验 | | 多账套权限 | 数据隔离混乱 | 所有查询强制带groupid，使用多租户拦截器 | | 与现有代码冲突 | 系统不稳定 | 新表独立，Service独立，不修改现有代码 | ## 10. 附录 ### 10.1 术语表 | 术语 | 说明 | |------|------| | 账期账户 | 采购时先挂账，后续通过台账付款实际支付的账户 | | 现金账户 | 采购时直接扣款的账户 | | 台账付款 | 账期账户的还款操作，在台账页面批量处理 | | 归属供应商款项 | 计入供应商应付/已付的金额（货款、运费） | | 非供应商款项 | 不计入供应商应付的金额（手续费） | | 移动加权平均 | 每笔入库后重新计算库存单价的核算方法 | | 在途库存 | 已付款但尚未入库的存货 | | P0/P1/P2 | 优先级：P0最高，P2最低 | ### 10.2 参考文档 - 20260618 进销存模块梳理（采购模块、台账）需求文档 - 财务ERP会计模块详细开发文档 - 财务ERP - 进销存模块详细开发流程文档 # 财务设计框架20251011-原始需求 # 财务设计框架20251011

所有支出参照正规的财务管理流程: 请款>审核>支付>凭证

字段齐全,包含财务报表所需要的相关对应字段(业务对应, 现金流表等)

设计好全公司的基础财务字段库, 以及可以兼容的更改方式

可以满足在这个框架下, 方便的显示公司,各个项目, 各个子公司的财务报表(业务,现金,资产等)

类似金蝶等的财务软件, 设计基础框架后,按照设计好的流程和操作, 后续所有报表都可以系统生成

跨越使用, 平台数据+多维表格+WIMOOR+海外仓+其它OMS,WMS

---

请款

类型有

多维表格:

房租 , 行政备用金, 项目备用金, 采购备用金, CFD请款总表

台账, 月结采购和承运商,快递

飞书审批: 个人报销 / 付款申请

Wimoor 应用

---

# 基本框架

会计科目基本字段配置

金蝶的账号密码

网址: [jdy.com](http://jdy.com) 账号：15773186733 密码：15773186733Aa@

![](https://x2ni3u3y40.feishu.cn/space/api/box/stream/download/asynccode/?code=YTIzY2I2MjNjMGJhYTViY2Y2YmQ0M2UzNGYwMmUzYmFfcXFJbHpjNzRRbjdpWVlRa3hqcEJqME1HOWZPMWw0WU5fVG9rZW46SzNZY2JQQVZsb2NtOVl4WDMwYWN3NlBpbkZoXzE3ODM2NDk5ODY6MTc4MzY1MzU4Nl9WNA&add_watermark=true&scene_type=CCM)

类似金蝶等主流企业

设置主流科目(要带编码),自定义的科目

科目的要否 : 现金及现金等价物科目 , 非现金科目

科目默认人民币, 可以设置其它币种. 统计余额/报表时需要转换币种

主科目, 子科目. 可能需要三级子科目. (银行存款 - 连连星球 - 连连星球美元 )

多级科目, 如果统计上一级科目时, 会把本级和子一级的所有子科目一起计算

跟三表还有明细账、总账中各个项目的关系. 便于系统自动统计报表

项目配置("账套" 配置 , 叫账套可能更贴合会计实操 )

自定义"账套" (相当于一个公司, 或者是项目), "账套" 可以是单独的, 也可以其数据 = 自身 + 其它多个公司数据相加

"账套" 作用是可以针对"账套"出报表, 该账套名下所有凭证的数据对应的三表

权限设定时, 一个账套也是按权限查看,

账套的相关凭证登记和查看, 是分开做权限

"账套" 比如是有 FD-KQ FD-APN等, 然后再新建"账套", FD , 数据来源于 FD 加 FD-KQ 加 FD-APN

理论上讲 , 账套可以使用所有科目. 但是有些自定义科目,实操/逻辑上只会用于某一账套才对.

用户权限设置

具体模块是否有查看 , 使用等的权限

用户查看和登记的权限

查看相应的"公司" 数据

登记凭证时, 登记相应的"账套", 和指定的一些科目

登记凭证

手动登记凭证

符合会计凭证登记原则的行业方案, 比如借贷相等, 相应科目

凭证还需要填写"账套", 同一账套下必须有相应的借贷科目

凭证登记人 + 凭证登记时间 + 业务时间 + 凭证登记来源

自动登记凭证配置

凭证登记人 + 凭证登记时间 + 业务时间 + 凭证登记来源

多维表格配置

新增自动化配置

绑定一个多维表格(按飞书多维表格API的要求), 字段和科目/公司/等等数据对应

相关设置

采购时, 个别无法通过平台确认账簿的SKU, 支持在采购订单, 手动指定/分别分摊对应账簿?

固定, 还是全部都能手动指定?

基于此, 导致台账的查看, 是否需要支持 "当前账簿" , "全部账簿" 的(就这两个选择就行, 肯定不能支持逐个账簿筛选), 以便于对比数据 !

不但是跨账簿的问题, 个别还有跨ERP的,比如跨境直采的数据(只支持在主ERP里显示全部?)

对于ERP自动生的凭证,设置专用的会计科目(区别于其它渠道录的凭证)并启用相关的辅助核算

应付账款-ERP采购供应商

预付账款-ERP采购供应商

其他货币资金-(相应采购账户)

在途库存-ERP采购

### 20260523

[财务ERP会计模块-进销存](https://x2ni3u3y40.feishu.cn/docx/TPMydRRAeoZ7K9xd6FHcn7UqnId)

## 20260422 发票台账

数电发票 - 数电发票号码管理

对应客户

凭证

合同

三方API ,中税创新,金蝶等 > 爬虫 > 乐企

暂时先用金蝶?

飞书审批

审批 > 付款 > 发票

付款 , 对应付款的会计凭证

借预付款 - XXX ; 贷现金类

预付款 - xxx : 建立台账页面,需要相应详情

收到发票

多维表格审批,填写发票号 <> 对应后台获取的发票号, 支持多张

借 XX费用 ; 贷预付款 - XXX

发票未获取, 发票台账, 显示待收发票? 需要进一步细化

发票获取, 对应付款 + 原凭证

设计 - 会计科目

在发票台账设置, 哪个会计科目的哪个辅助核算, 借贷方, 对应发票出具方 + 欠多少发票额 + 已给哪些发票等

比如: 设置预付账款_ERP采购供应商 (ERP物流供应商,等等), 在凭证中,这个科目放, 借方, 就是对应的供应商需要欠的发票 ; 在贷方, 就是对应供应商已给的发票

## 2026604 对公账户余额数据

https://open.spdb.com.cn/develop/

满足需求:

台账: 查询账明细流水

采购: 付款关联

发票: 进项发票关联付款单

## 202605 采购模块扩展改进

需要包含的内容

支付方式/支付账户/卡 :

现金类型, 还是贷记,赊账支付类型

对应会计科目绑定关系.

跨境直采问题

1688先采后付

使用跨境直采, 批量还款时,

跨境直采的服务费

分摊问题.

实际金额是多少的问题 (连连下载的明细是1688订单总的金额,不按SKU细分 ; ERP登记的是按SKU细分)

## 20260612 系统优化需求

查凭证

数值格式化,千分位2小数点

凭证字号,摘要, 支持模糊查询

支持凭证备注模糊查询

制单人, 选项查询

来源模块 (手工录入, 结账-模板类型 , ... )

支持, 显示原币: 币列,汇率,原币借方(贷方)金额

凭证可自主选择显示相应的科目

![](https://x2ni3u3y40.feishu.cn/space/api/box/stream/download/asynccode/?code=OTJjMjY5Nzk2NWRjOTMxZTQ3ZjQ1MGZkYzA2N2UwNzdfb3ZHSE52VW9WSzZ6bXRjQ09IOWphZ0IxVm1CSVhBQzRfVG9rZW46Um9iRWIxZ214bzc5Y0d4aWVhRGNQYzh6bkxmXzE3ODM2NDk5ODY6MTc4MzY1MzU4Nl9WNA&add_watermark=true&scene_type=CCM)

支持会计科目输入搜索, 模糊输入+返回选项+选择选项搜索.

会计科目,名称全局统一, 所有地方都要如此显示, 其它模块亦如此

编码一级名称_二级名称_三级名称, 示例: 10120201 其他货币资金_第三方平台-连连_加元户

凭证日期/凭证字号排序：两者都需要排序按钮

![](https://x2ni3u3y40.feishu.cn/space/api/box/stream/download/asynccode/?code=NjkxYzIzM2Q4M2UwYzJhMGE5MTgwNTMwYjQ0NTdlNjFfRG03a3BoTTh3ZlZJVVB2SUMxN1pnUHNVWlhwNmdibWFfVG9rZW46VU9tcmIwdVJTb3BlbkV4YXVaZ2N1Uk5UbkFlXzE3ODM2NDk5ODY6MTc4MzY1MzU4Nl9WNA&add_watermark=true&scene_type=CCM)

明细账:

数值格式化,千分位2小数点 ;

不需要: 凭证编号摘要的搜索 (业务逻辑不存在需要这个搜索)

支持会计科目输入搜索, 模糊输入+返回选项+选择选项搜索.

支持选择显示/不显示原币相关列 : 币列,汇率,原币借方(贷方)金额

凭证创建时间不需要, (此页面是报表的类型, 非报表相关的列,编辑/审核/操作流程相关的列此处没有参考意义)

科目余额表

科目编码+科目名称的搜索改为支持会计科目输入搜索

科目的折叠展开,hover,提高触发范围 (现在范围太小,鼠标很难点中)

不需要科目级别, 科目类别列

支持外币:

提供币位单选项,默认是本位币(XXX)

选择了其它非本位币,

二级表头借方, 贷方 , 各自改为借方(原币/本位币), 贷方(原币/本位币)

可以在原来本位币的单元格, 加高行高, 分开写两行. 上行原币金额, 下行本位币金额. 或者再做其它设计. 避免整个表格列太宽,不好阅读.

![](https://x2ni3u3y40.feishu.cn/space/api/box/stream/download/asynccode/?code=M2I1OWMyNGZjOWE2YTFkZjhjMmIxNDE4Yzg5ZWY3NDJfdWdRd3hSWjFKNTFsdVNHd0NCMVQzM0ttTlQ4UXF2YnBfVG9rZW46Q1ZTbGJuY1NXb1lhQ0R4ajVGeWN2YXd2bjQ1XzE3ODM2NDk5ODY6MTc4MzY1MzU4Nl9WNA&add_watermark=true&scene_type=CCM)

报表项目

这几个菜单/页面名称, 都需要按会计统一的名称, XXX表, 不是XX报告

平衡/不平衡提示：

![](https://x2ni3u3y40.feishu.cn/space/api/box/stream/download/asynccode/?code=NmJjMTgyOWFiZGU3ZjQ4NGE1ZDdmNzk3MDg1NWJkZTBfSHAyRThndURueUx3aVBMeW0zaXFNR1R2c1ZLanI2MzNfVG9rZW46TnFVRmJXaUZGb3VmWkl4QmtJQ2M4ZVZlblFjXzE3ODM2NDk5ODY6MTc4MzY1MzU4Nl9WNA&add_watermark=true&scene_type=CCM)![](https://x2ni3u3y40.feishu.cn/space/api/box/stream/download/asynccode/?code=ZGVkOThjNjMyMGMzODZkZjAyNDMzMTdhMTM1ZTcxNDFfMDZYZ0NhUmFaVGlaUFNQcjJYT0hFZ2xyV2Y5dmNwVHJfVG9rZW46WncydGJrazFVb3d2YXl4S3hqV2NkVzRmbnJkXzE3ODM2NDk5ODY6MTc4MzY1MzU4Nl9WNA&add_watermark=true&scene_type=CCM)

利润表

数据: 没有按报表模板设定的公式, 相应计算各项目金额. 成本全部都没有

设计: 支持月度,季度,年度

新增列: 本年累计金额

模板设置: 项目名称, 要与金蝶的项目名称完全一致.

资产负债表

数据问题

模板设置: 项目名称等问题

本期金额,不需要, 这是发生额,不符合报表要以核算余额为目标的逻辑.

新增列: 期末余额, 年初余额. 对比可以按期末余额为基准对比

标准现金流量表

数据问题

模板设置: 项目名称, 要与金蝶的项目名称完全一致.

设计: 支持月度,季度

本期金额, 这列后新增 , 本年累计金额

提供试算平衡结果. 平衡/不平衡的话,提供相关解释,具体数据

所有者权益变动报告

只需要支持年度

这个用处不大.可以以后深化.

结账

亚马逊月度模板

多维表格：

公户支付明细 / 第三方支付明细

需要改为支付时,按条输入. 将应付登记 / 付款登记分开.

会计科目-映射配置：加一个导入及导入模版

![](https://x2ni3u3y40.feishu.cn/space/api/box/stream/download/asynccode/?code=Y2Q3NjVkYmVmYTg4MTAxNGU3OTA5MDM4NmQ1ZjI4YTFfeHd1NVVKRWxLekp3YXNkRmw1SlhpWU1NUW9OMFJGOVhfVG9rZW46UUh5OGIzSGZTb1dMUFl4U3E4RGMzTmNMbmhjXzE3ODM2NDk5ODY6MTc4MzY1MzU4Nl9WNA&add_watermark=true&scene_type=CCM)

登记问题

所有凭证都没有按[财务 - 会计工作内容](https://x2ni3u3y40.feishu.cn/docx/LCdEdjjAkobRboxvC1ScgcGnn20#share-QWEQd4V15o829yxlxqIcl5LBntf)的设计科目来登记

[财务 - 会计工作内容](https://x2ni3u3y40.feishu.cn/docx/LCdEdjjAkobRboxvC1ScgcGnn20#share-DtDLdmcZJoscfNxBoCucyElZnNf)

公账回款等, 付的和回的,科目不对;

凭证日期, 对应业务日期;

摘要,简要明了.

凭证字号,对应主要业务统一规则

平台数据月度.主营收入支出

手工录入

飞书多维表格自动录入

三方平台代收代付,付款和划转, 对账单

进销存, 系统生成 (采购,月结对账单,入库,库存调整)

会计科目的命名问题

要符合[公司2025 - 财务及海关 ERP设计方案](https://x2ni3u3y40.feishu.cn/docx/XXgVdPs8pobAM1xDY9dcxxKknTh#share-VB5DdwKS7oOL9DxnEbtcZJsInze)这个系统显示的会计科目的逻辑, 不要用_下划线,会与系统的以_分隔不同级别的科目有冲突.

## 20260618 进销存模块梳理(采购模块,台账)

1. ### 前端页面: 账簿 > 配置 > 进销存配置

在账簿的模块下, 每个账簿独立单独配置

会计版本的进销存, 启用与禁用

启用后数据转为使用新版的采购单(会计版)

包括生成的采购单等等

暂不考虑增值税退税/抵扣的问题.基于出口不退税/无国内销售/无销项发票的情况

采购账户配置

维护可用的采购账户及其属性

用于在"采购单(会计版)", 付款时选择采购账户以及生成相应的凭证

相应地启用该采购账户对应的"采购账户台账"

采购账户配置:

采购账户名称

账户类型: 分为"现金", "账期"

现金: 指在采购单付款时, 就实际发生扣款的账户.(采购同步另行操作或者API对接实现同步扣款)

账期: 指在采购单付款时, 没有实际发生扣款,产生了应付, 相当于采购的付款操作等于发起采购的请款. 在相应的采购账户台账里处理这个请款的实际支付.

账户关联:

将本采购账户, 与其它账簿(跨ERP,跨账簿)的采购账户进行关联 (需要账户类型完全一致)

关联后, 数据可以在本ERP账号的采购台账下查看关联的采购账户的明细数据.

支付费用类型: 该种采购账户, 能支付的费用类型. 在"采购单"里付款时,选择该采购账户, 能支持选择的费用类型

费用类型, 比如"货款", "包装费用" 等等, 由用户自定义,

每个费用类型, 分为 "归属供应商款项" 和 "非供应商款项", 需要用户设置

只有"归属供应商款项" ,计入供应商相关的付款汇总.

采购单付款,各种费用类型,对应的借贷方科目:

指定采购单付款页面,相应生成的凭证的借贷方科目

每一笔付款明细, 对应一对借贷科目

需要支持,配置该采购账户支持的各种的"费用类型", 可以指定不同借贷方科目

采购账户台账付款借贷方科目:

只有"账期"类的账户类型,需要这个设置.

现金类(已完成实际支付)的不需要在"采购账户台账"有台账付款功能.

指定在"采购账户台账", 台账付款操作时, 相应生成的凭证的借贷方科目

支持配置该"账期"类采购账户, 用以给它最终实际付款的现金类"采购账户"(已经创建的现金类采购账户, 可以配置多个)

配置该账期采购账户的对应支持的各个现金类"采购账户", 相应指定不同借贷方科目

采购账户退款设置

退款设置, 对应的费用类型 + 对应的借贷科目

默认借贷科目为已经设置好的费用类型,正常付款时的借贷科目[公司2025 - 财务及海关 ERP设计方案](https://x2ni3u3y40.feishu.cn/docx/XXgVdPs8pobAM1xDY9dcxxKknTh#share-WPu9dqESTo3fQbxlSFocWVYOn6d), 相反方向

凭证字号规则

采购供应商台账配置

采购供应商台账发票, 指定会计科目

凭证字号规

库存配置

系统默认设定

单位存货成本核算方法设定: 仅支持移动加权平均

核心规则：每一笔入库就重新计算一次单价，出库用当前最新单价

$$\\text{新移动单价}=\\frac{\\text{当前结存金额}+\\text{本次入库金额}}{\\text{当前结存数量}+\\text{本次入库数量}$$

只有采购入库、盘盈入库、暂估入库才会改变移动加权单价；调拨、销售出库、领用出库不重新算单价

每次出库：出库成本 = 出库数量 × 当前移动平均单价库存货值实时自动更新+新的移动单价不影响既往的入库凭证库存商品会计科目的余额+后续出库等操作的凭证中按新的移动单价来计算库存金额

避免尾差. 库存余额不以 “单价 × 数量” 反算,始终加减滚动计算.(比如出库时: 先乘法算好出库成本, 再上一次的结余,减去出库成本)

亚马逊FBA仓库核算方法设定: 按月汇总核算

亚马逊FBA仓库单位存货成本:

使用"移动加权平均法", 但因为是按月汇总核算, 只使用本地仓库发货到FBA仓库入库的金额进行更新单位存货成本, 对于FBA仓库内的盘盈等操作不更新单位存货成本核算

本地仓库调转相关的操作配置

采购入库配置

采购入库,指定会计科目.

为在"采购单(会计版)"页面里, 执行入库操作时, 相应生成的凭证(旧版本叫"收货")

凭证字号规则

调拔

盘点

本地仓库发往FBA海外仓的发货配置

其它设置

支持采购账户排序.优先顺序,第一为系统级别默认. 实际在采购单中的采购账户付款默认以该供应商上一次的输入状态为基准

配置示例,以安普纳的账簿为例

采购账户
采购账户	账户类型	支付费用类型 ("归属供应商款项" 和 "非供应商款项") (退款 / 正常付款)	采购单付款借方科目	采购单付款贷方科目	台账付款借方科目	台账付款贷方科目
公户现金	现金	货款运费其它费用	货款运费/其它费用: 借预付账款-ERP采购供应商	贷银行存款-浦发银行（2384）
跨境直采	现金	货款运费其它费用跨境直采手续费 --- 退款退款手续费	货款运费/其它费用: 借预付账款_ERP采购供应商跨境直采手续费: 借财务费用_跨境直采 --- 退款/退款手续费: 借其他货币资金_连连国际等-跨境直采待结算_CNH	贷其他货币资金_连连国际等-跨境直采待结算_CNH --- 退款: 贷预付账款_ERP采购供应商退款手续费贷财务费用_跨境直采
先采后付	账期	货款运费其它费用 --- 退款	借预付账款-ERP采购供应商退款: 与正常流程相反设置(下同)	贷应付账款_1688先采后付退款: 与正常流程相反设置(下同)	借应付账款_1688先采后付 (跨境直采,还款时还需要有): 借财务费用_跨境直采	跨境直采,还款时: 贷其他货币资金_连连国际等-跨境直采待结算_CNH 公户现金,还款时: 贷银行存款-浦发银行（2384）
公户请款即付	账期	货款运费其它费用 --- 退款	借预付账款-ERP采购供应商 --- 退款:	贷应付账款_公户请款即付 --- 退款:	借应付账款_公户请款即付	公户现金,还款时: 贷银行存款-浦发银行（2384）
公户请款月结	账期	货款运费其它费用退款	借预付账款-ERP采购供应商退款:	贷应付账款_公户请款月结退款:	借应付账款_公户请款月结	公户现金,还款时: 贷银行存款-浦发银行（2384）
第三方支付请款	账期	货款运费其它费用退款	借预付账款-ERP采购供应商退款:	贷应付账款_第三方支付请款退款:	借应付账款_第三方支付请款	第三方支付: 贷其他货币资金_连连国际等-待结算_CNH


采购账户修改时限	XX 天	*在采购单付款/退款操作之后(并且在结账操作之前), 多少天之后,不可修改	(20260707) 这个设置目的是避免'结账'时间太靠后,导致采购单的容易被改动,导致数据汇总不一致.	要对明细支持改删,主要考虑即时的错误操作.便于使用.

采购供应商台账
		操作	借方科目	贷方科目
		发票入账	贷预付账款-ERP在途发票	预付账款-ERP采购供应商


采购入库配置
		操作	借方科目	贷方科目
		采购付款时	借在途库存_XX本地仓库	贷预付账款-ERP在途发票
		采购退款时	预付账款-ERP在途发票	在途库存_XX本地仓库
		入库	借库存商品_XX本地仓库	贷在途库存_XX本地仓库
		退货	在途库存_XX本地仓库	库存商品_XX本地仓库

海外仓发货配置		操作	借方科目	贷方科目
		发货处理_发货	在途库存_XX国FBA仓库	库存商品_XX本地仓库


FBA承运商台账		操作	借方科目	贷方科目		*默认ERP物流承运商的款项支付对应的只有一个科目(公账), 所以不需要额外单独类似采购账户等的设计
		请款	预付账款_ERP物流承运商	应付账款_ERP物流承运商
		付款	应付账款_ERP物流承运商	银行存款_浦发银行（2384）
		发票入账	销售费用_FBA承运商	应付账款_ERP物流承运商		*发票入账直接转为费用.不转入库存

本地仓库台账

FBA仓库台账

``` ```

账期采购账户的台账付款:即相当于采购请款单/采购付款单/账期结算还款的功能. 以上为暂时的以安普纳为基础的配置示例其它科目基本相似, 银行存款-浦发银行（2384）,公户的科目需要按公司实际设置将公户相关的设置成三个: 1. 公户现金,用于在台账付款时调用,以及现金台账生成. 实际它不在采购单里接入API使用 2. 公户请款即付,用于当前采购单需要立即使用公账支付,采购走飞书审批的.后续则不需要使用飞书审批, 出纳在这个采购账户的台账下, 进行逐项支付 3. 公户请款月结, 用于需要使用公账,在月底支付的.与请款即付区分开来,便于管理. 一个采购订单+SKU,对应一个账簿,一个供应商, 一份收款信息, 一种采购账户可对应多笔支付明细,多笔库存明细,多笔发票明细账期采购账户,退款时, 不论台账付款是否退,在采购付款,都同样操作.实际差额也在台账付款页面处理. "归属供应商款项" 和 "非供应商款项"的费用类型,用于给采购账户会产生手续费的情况. 同时也能在供应商台账,区分供应商的实际已付款,核对发票应开票金额 20260622补充: 关于退款原先计划, 采购账户的费用类型,用户自定义"退款"作为其中一种费用类型,指定其相应的借贷科目, 但是考虑到前端输入,退款的类型是输入正数还是负数? 会直接影响台账里的数据所以改为,采购账户都有内定的退款设定, 需要用户单独设置退款的设置. 更新发票入库操作配置更新入库配置如此,采购账户的设置就包括账户类型账户关联费用类型费用类型的款项归属费用类型的借贷科目台账付款时,可用的现金类"采购账户" 采购账户的退款设置:可用的费用类型以及借贷科目设置关于数据库数据模型采购单,业务表, 需要保留.不能因为有新的会计凭证表就不要采购单业务表采购模块生成的会计凭证, 需要用到的辅助核算,尽量辅助核算另行建表. 在此处配置的会计科目大部份需要采购单(采购单+数量+SKU) + 供应商辅助核算或者发票辅助核算操作日志与审计追踪需要设计 **当前的流程下: 各主要环节的凭证基础示例** (不抵扣/退税环境,不用设计待认证进项,不用进项转出等) **A:支付采购订单时:** 借预付账款-ERP采购供应商, 贷银行存款-浦发银行（2384）其他货币资金_连连国际等-跨境直采待结算_CNH 应付账款_1688先采后付应付账款_公户请款即付等 **B:同时** 借在途库存_XX本地仓库, 贷预付账款-ERP在途发票 **C:收到发票时:** 借预付账款-ERP在途发票, 贷预付账款-ERP采购供应商 **D:收到库存入库时:** 借库存商品_XX本地仓库, 贷在途库存_XX本地仓库 ------ **涉及退款,退货时** R1:已付款+未入发票+未入库 >> 全额退或者部分退,款在采购单页面,退款上述A+B反向即可 R2 已付款+已入票+未入库 >> 全额退或者部分退,款+票正常A+B反向供应商开具红字数电票相应做发票做账冲销, C反向 (或主动通过电子税局向供应商发起红字发票开具推送) R3 已付款+未入票+已入库 >> 全额退或者部分退,款+货反向 A+B , D R4 已付款+已入票+已入库 >> 全额退或者部分退,款+票+货反向 A+B ,C, D R5 已付款+已入票+已入库 >> 全额退或者部分退,款+票, 不退货反向 A+B ,C, D根据实际情况做.暂时系统不处理 (这种处理,会导致相应的采购订单+SKU,台账里是在途是负数,有挂账) (处理方式: 应该使用其它会计科目,来另做凭证比如: 借：在途库存_XX 本地仓库贷：其他收益 / 营业外收入 / 采购折让冲主营业务成本（三选一）) 强制要求: 款+票,只要已付已入,必须一并退 20260626 补充 FBA承运商台账的操作对应凭证生成规则

``` ``` 2. ### 前端页面: 采购 > 采购单(会计版)

基于当前的采购单,进行设计

采购单获取的账簿里的数据(比如配置的采购账户), 按采购单里的 SKU 对应账簿,进行匹配

采购单收货,退货等操作基本与之前版本一致.

采购付款页面

选择采购账户

账簿关系,按SKU的账簿进行匹配

需要在页面里显示, 该采购订单当前SKU的账簿. 如果是多个账簿, 支持手动切换

1个订单+SKU , 只能选择一个账簿, 以及该账簿下一个采购账户(先按此SKU上一次的提交状态默认, 如无则按默认的采购账户)

选择的如果是现金类采购账户, 会显示其当前的余额

选择供应商的收款信息 (1个订单只能一个收款信息, 先按此供应商上一次的提交状态默认, 如无则按默认的供应商的收款信息)

费用明细,可有多条. 选择

费用类型 (与采购账户设置对应,默认第1个) + 金额

退款时:

在付款页面,相应的退款区域,

新增退款明细

选择已支付的付款明细, 匹配对应的采购账户的设置, 生成相应的凭证

退款金额, 统一输入正数.

(20260707) 付款/退款,操作明细, 修改/删除时限,参考采购账户'修改时限'和'结账'时间.

采购单状态, 有以下四个维度显示

订单状态	付款状态	库存状态	发票状态
有效	未付款		未开票
撤销	付款中		开票中
	部分付款(未完成)	部分收货(未完成)	部分开票
	超额付款(未完成)	超额收货(未完成)	超额开票

	付款完成	收货完成	开票完成
	部分付款(已完成)	部分收货(已完成)
	超额付款(已完成)	超额收货(已完成)
	退款中	退货中	冲销未入账
			发票异常

	付款完成(有退款)	收货完成(有退货)	开票完成(有冲销)

	"非供应商款项"的费用类型不计入; 付款中,指的是使用账期采购账户支付,已到了台账中; 付款完成, 包括使用现金类或台账支付完成的,金额一致. 部分付款(已完成), 付款已完成但实付少; 部分付款(已完成), 付款已完成但实付多;	收货中	"非供应商款项"的费用类型不计入发票异常:发票已冲销但未做账待根据API来进一步设计状态

3. ### 前端页面: 其它旧的页面的相应调整

供应商管理:

增加支持维护供应商的收款账户, 包括公司名称,银行账号等. 用于在采购付款 / 发票核对等情况下调用

收款账户可多个,可设置默认.

收款账户的**启用/停用**状态管理（银行账户可能变更）,不删除(只停用, 可查询)

产品管理

增加产品对应的账簿 (也就是公司)

可以初始化,按店铺在售SKU等规则, 对所有SKU进行 SKU账簿初始化.

允许非完整SKU 对应多个账簿, 设置默认

4. ### 前端页面: 账簿 > 台账 > 采购账户台账

支持跨账簿, 不跨ERP, 只有关联的采购账户可以跨ERP(并且只有主动起关联的ERP账号(包括其主子账号)能返回跨ERP数据)

基于"采购单(会计版)", 采购付款的操作生成的数据和凭证, 每笔订单明细生成一张凭证, 以保证供应商应付+发票核算需求.

筛选查询:

采购账户(ERP下跨账簿,多选) , 账簿(默认全部), 时间范围, 采购订单(或 1688订单,多行搜索,精确匹配)

**付款状态(多选)**+库存状态(多选)+发票状态(多选)

账簿	采购订单	请款日期	收款账号	付款状态	库存状态	发票状态
账簿 (跨ERP时,显示对应的关联的ERP账号)	采购订单 + 同时显示, 1688订单(如果有)	以在采购订单第一次开始付款的日期为准. 不以采购订单生成日期.	供应商 + 该订单的收款账号(收款人+账号)	除了状态信息,同时显示: 订单金额,(订单的金额) 请款金额,(采购单里付款明细,包括减去退款, 包括归属供应商和不归属供应商的金额) 已付金额, (现金类采购账户的已付 + 台款付款里的已付, 包括归属供应商和不归属供应商的金额 ) 待付金额 , (请款 - 已付的差额)	除了状态信息,同时显示: 库存价值和数量,(采购单的价值和数量 , 采购单里付款明细,包括减去退款类型的, 只包括归属供应商的金额) 已入库金额和数量, (收货入库的金额, 按供应商应付/应入库数量计算单价) 待入库金额和数量 , (库存价值 - 已入库金额的差额)

				点击可以弹窗显示,该笔相应的明细: 采购付款的明细,台账付款的明细, 以及对应的凭证字号 (时间,类型,金额等等)	点击可以弹窗显示,该笔相应的明细

汇总行				汇总,四种金额的数值	不须汇总	不须汇总

适用于存在大量数据的分页功能

支持列表最下面, 显示查询的全部数据的汇总: 订单金额,已付金额,待付金额

支持, 单独勾选/多选/全选, 操作: 台账付款 + 支持导出EXCEL数据

勾选时, 前端动态显示,所勾选的数据的汇总金额, 三个金额

支持, 对于"现金"类的采购账户,做"入账登记"功能

登记一笔入账, 无采购订单,SKU,收款账号等等信息. 只有入账. 用于核算该采购账户的余额.

不用涉及凭证等会计业务.

(20260707)支持, '结账'功能

结账后, 该日期以前的采购订单, 不可对原有的付款退款等做操作(改删),只能新增操作,不能修改

支持上述的表格页签和图表页签和采购账户统计切换查询结果.

图表页签, 显示日期X轴 + 四种付款状态的金额的数据 + 显示数据点的数值标签

采购账户统计页签

按账簿划分出不同区域(查询返回的账簿), 显示账簿下的采购账户卡片, 卡片内显示账簿下的这个采购账户的四种金额

对于现金类采购账户, 增加"余额"显示.

采购账户台账付款,功能页面

只有"账期"类的采购账户,才能使用

选择相应的采购订单,然后进行付款.

台账付款的页面和逻辑也要支持退款 (费用类型是属于退款的, 相应的明细,相应的凭证科目等)

操作流程:

在台账列表里勾选后,操作,跳转到采购账户台账付款页面, 自动带入,包括账簿,采购账户,付款订单列表,金额等,点击付款提交, 对应相关配置生成凭证.

输入: 下拉框,选择这些采购账户(账期类), 配置好的对应的支持的现金类采购账户进行实际支付,选择的都是现金类采购账户, 需要显示其当前的余额

台账付款明细输入: 下拉框,根据配置的现金类采购账户, 选择与其对应的支付费用类型,带默认值,

支持按照支付费用类型,增减台账支付明细.

台账付款明细输入: 台账付款金额, 默认为带入的应付金额(订单金额-已付金额) ,支持更改

账簿,采购账户,订单/SKU,供应商及其收款账户,不可更改

excel模版上传:

导出台账数据, 编辑整理后,上传生成"台账付款"数据

在模板中指定每条记录的,台账付款采购账户(现金类) + 费用类型 + 台账付款金额

支持Excel上传后的**预览确认页面**，展示即将执行的付款明细+校验信息，用户确认后再提交

校验:

一次台账付款,必须所有记录都同一个采购账户(可以是跨账簿的,关联的,同一个采购账户)

台账付款金额("归属供应商款项"的费用类型),与对应的台账付款绑定的记录(采购订单+SKU) 的汇总的应付金额,不一致时, 需要提示处理方法.

按台账付款 : 应付金额比例分摊, 还是取消本次付款操作

关于分摊金额:

尾差处理规则：将差额摊到最后一条记录

单条记录金额上限校验：分摊后单条金额不应超过原应付金额

在提交后的预览, 提供分摊结果预览，让用户确认后再提交

``` ```

采购账户台账主要解决: 对账(余额和明细), 账期付款的问题. 因为我们公司的采购账户, 跨境直采,公账,都不是专用于采购,所以没法对余额.只能对采购模块花掉的金额先采后付,1688是有临时额度/基础额度不定期变动,而且先采后付本期待还款金额也是1688系统会根据交付时间有变动,也对不上余额,也对不上剩余额度,也对不上本期还款额公户月结,这一类没有余额对的需要.但是可以对应付,已付,待付. 还款有多种情况 1.一条台账记录同收款账号, 多笔付款 > 公账支付 2.同账簿同供应商同收款账号,多笔付款 > 公账支付,月结 3.跨账簿跨供应商不同收款账号,多笔付款 > 跨境直采还先采后付 (或者以前还有的法人支付宝还先采后付) 公账支付月结时需要采购,确认采购账户按采购账户,导出一笔支付需要的对应采购账户台账明细,然后确认好明细和金额,交付给出纳支付(交接流程待明确,文件交接,飞书审批?) 跨境直采支付先采后付时这是采购直接操作跨境直采付款. 需要下载单笔跨境直采对应的支付明细,与1688订单明细,与台账明细, 分析处理该笔还款对应的台账明细, 使用EXCEL模板上传功能, 做台账支付的操作. 含货款和手续费明细. 这样才能精确匹配每笔应付(请款)记录对应的已付款和手续费. 只能通过上传来处理. 无法通过全流程在前端界面处理.如果要前端界面也支持每条记录分别指定现金类采购账户(账户+费用类型+金额),结构会很复杂 20260622补充适配退款在采购账户中的单独设置, 将"请款金额"明确减去退款的类型将付款状态里的四种金额, 明确定义台账付款也要相应支持退款的操作新增图表和卡片显示查询结果更新入库操作更新库存状态 20260625 考虑到当前采购实际流程, 尤其是对于跨境直采,多个采购和出纳共用同一个资金池,需要在数据上控制资金分配和使用,需要给'跨境直采'一个限额, 所以需要设计给'现金'类的采购账户一个余额核算的功能,包括入账登记+余额

``` ```

5. ### 前端页面: 账簿 > 台账 > 采购供应商台账

支持跨账簿, 不跨ERP

基于"采购单(会计版)", 采购付款的操作生成的数据和凭证.

筛选查询:

供应商(本账簿内,多选) , 账簿(默认全部), 时间范围, 采购订单(或 1688订单,多行搜索,精确匹配)

付款状态(多选)+库存状态(多选)+**发票状态(多选)**

账簿	采购订单	请款日期	收款账号	付款状态	库存状态	发票状态
	采购订单 + 同时显示, 1688订单(如果有)	以在采购订单第一次开始付款的日期为准. 不以采购订单生成日期.	该订单的收款账号(收款人+账号)	除了状态信息,同时显: 订单金额,(订单的金额) 供应商应付额,(采购单里付款明细,包括减去退款类型的, 只包括归属供应商的金额) 已付金额, (现金类采购账户的已付 + 台款付款里的已付, 只包括归属供应的金额 ) 待付金额 , (供应商应付额 - 已付的差额)	除了状态信息,同时显示: 库存价值和数量,(采购单的价值和数量 , 采购单里付款明细,包括减去退款类型的, 只包括归属供应商的金额) 已入库金额和数量, (收货入库的金额, 按供应商应付/应入库数量计算单价) 待入库金额和数量 , (库存价值 - 已入库金额的差额)	除了状态信息,同时显示(不是"开票完成"的情况下): 应开票金额, 已开票金额, 待开票金额
				点击可以弹窗显示,该笔相应的明细: 采购付款的明细,台账付款的明细, 以及对应的凭证字号	点击可以弹窗显示,该笔相应的明细	点击可以弹窗显示,该笔相应的发票明细:

汇总行				汇总	汇总	汇总

适用于存在大量数据的分页功能

支持导出EXCEL数据

支持列表最下面, 显示查询的全部数据的汇总: 应开票金额,已开票金额,待开票金额

支持, 单独勾选/多选/全选, 操作: 供应商台账发票入账+导出供应商发票数据

勾选时, 前端动态显示,所勾选的数据的汇总金额, 三个开票金额

支持上述的表格页签和供应商统计切换查询结果.

供应商统计页签

表格显示, 按账簿汇总统计,关键的供应商的库存和发票金额, (汇总,无采购订单明细)

表头: 账簿供应商库存的三个金额和数量, 以及发票的三个金额

供应商台账发票入账,功能页面

选择相应的采购订单,然后进行付款.

操作流程:

在台账列表里勾选后,操作,跳转到台账发票入账页面, 自动带入,包括账簿,供应商,采购订单等,点击发票入账提交, 对应采购供应商台账发票指定的会计科目 (预付账款-ERP采购供应商)相关配置生成凭证.

输入: 下拉框,多选, 选择该账簿下所有的可用,未入账的发票,

模糊搜索, 发票号码和发票开票人

显示已选择的发票的信息列表和发票金额汇总

发票金额,不可填写.使用数据库的数据

账簿,采购账户,订单/SKU,供应商及其收款账户,不可更改

用户核对: 选择的发票 <> 选择的供应商台账明细, 提交做发票入账

excel模版上传:

导出台账数据, 编辑整理后,上传生成"台账付款"数据

在模板中指定每条记录的,数电发票号码 + 发票入账金额

校验:

一次台账发票入账,

其对应的台账明细, 必须所有记录都同一个供应商(不可以是跨账簿的)

所有发票对应的账簿必须统一是一个

填写的发票金额 = 发票上的金额 = 对应的台账明细的待开票金额. (EXCEL模版提交的需要汇总每条记录的发票入账金额)

对应多条台账明细时, 提示用户,需要将发票金额分摊到台账明细中. 直接按每条台账明细的待开票金额进行分摊.

``` ```

采购供应商台账主要用于管理采购过程中,供应商的发票,查询未开,入账,订单相应的发票情况.等等先按账簿+供应商, 或供应商,导出其未开发票, 数据处理, 分出,相应的收款账号-账簿-待开票金额, 发给供应商确认,让其开票收到供应商发票后,做发票入账, 使用之前下载的数据,处理后,上传,关联采购订单做发票入账. 少数情况,可能是单订单-单张发票的入账使用发票API数据获取账簿公司下所有的发票, 来保证账簿-发票对应关系根据情况后续可以:增加**开票提醒/催开票**功能前端按供应商生成未开票明细 > 对接飞书/企业微信 > 供应商+对应群 > 发送消息. 20260622 补充更新四种金额的定义更新库存状态提供按供应商汇总小计统计 20260626补充增加 '请款日期', 在表格中

``` ```

6. ### 前端页面: 账簿 > 台账 > FBA承运商台账

支持跨账簿, 不跨ERP

基于"货件处理", 发货处理_发货的操作生成的数据.

筛选查询:

承运商(本ERP内,多选) , 账簿(默认全部), 时间范围,

付款状态(多选)+库存状态(多选)+**发票状态(多选)**

账簿	发货日期	收款账号	付款状态	货件状态	发票状态
	以在发货处理点击发货的日期为准. 不以采货件的生成日期.	该订单的收款账号(收款人+账号)


汇总行			汇总	汇总	汇总

操作

支持导出EXCEL数据

请款

(20260707)支持, '结账'功能

结账后, 该日期以前的发货订单, 不可对原有的运费等做操作(改删),只能新增操作,不能修改

``` ```

20260626 FBA承运商台账主要用于管理在FBA货件发货后, 对物流承运商的货件,对账,付款,凭证, 发票等操作对账:暂拟流程从发货处理模块发货后,不产生凭证; 在台账处,确认哪些货件可以付款,请款操作,产生凭证(付款,在途等) 需要支持单个货件,多条明细,付款,退款,加付关税后续等的情况.

``` ```

7. ### 前端页面: 账簿 > 台账 > 发票台账

支持跨账簿, 不跨ERP

台账API配置 + 同步任务详情(同步时间,失败,状态,条数等)

同步的是按账簿其下的所有发票, 进和销项等

页面包括: **进项发票台账 + 全部发票查询**

**进项发票台账**: 筛选查询:

进项发票是指发票中的"购买方"与本账簿相同, 就归属于该账簿下的进项发票数据.

账簿(默认全部), 销方名称(模糊搜索查询,下拉结果选择) , 时间范围,

入账状态(多选)+发票状态(多选)

账簿	发票号码	销方名称	价税合计总额	入账状态	发票状态
	数电发票号码(非数电发票时, 显示传统发票的代码+号码) , + 发票票种标识 (自行设计, 数电普票/专票等标识)	开票人公司+税号	价税合计总额 + 不含税总金额 + 总税额	未入账已入账进项转出	正常 / 作废 / 红冲(全额)/红冲(部分) / 失控 / 异常
				点击可以弹窗显示,已入账发票,相应入账的凭证明细: 字号,凭证日期,等
				进项转出:预置.以后才需要.

汇总行			汇总三个金额

进项发票台账 : 支持上述的表格页签和图表页签和发票统计切换查询结果.

图表页签, 显示日期X轴 + 三种金额的数据 + 显示数据点的数值标签

发票统计页签

表格显示, 按账簿汇计统计,关键的发票信息

表头: 账簿发票数量发票三个金额等

进项发票台账 : 操作

勾选发票 > 手工录入凭证(发票入账), 等等

手工发票入账+冲销

自动匹配未入账发票 (后续,暂时不用)

**全部发票查询:**

按拉取的发票数据, 查询全部发票

支持将税务分类编码,对应查询前三层(前5位)的税务分类, 存储该税务分类数据(税务分类编码对应的税务分类, 映射关系, 可以做前端页面增改删+导入导出维护)

筛选: 账簿+数电发票号码+销售方+开票时间范围+税收分类+发票票种+发票状态+正数发票+风险等级 (实际根据发票数据既有的重要字段设计)

表格展示 + 图表展示

按查询结果, 分为进项+销项在各个税务分类, 的饼图, 比例+金额.及点击弹窗明细

价税合计金额的汇总

``` ```

进项发票台账发票一一对应, 状态, 凭证入账查询等问题 20260622 新增图表和发票统计显示查询结果鉴于近期商务局的信息,行业后续可能支持成本分摊,A的发票a1可能可以用于B里核算成本.即a1可以入账到B,以后可能需要相应调整这种逻辑. 20260625 按当前税局导出的发票进一步设计, 进项和销项管理. 需要后续进一步设计关于统计分析的.

``` ``` 8. ### 前端页面: 账簿 > 台账 > 本地仓库台账

支持跨账簿, 不跨ERP

分为汇总账 + 明细账

汇总账:

筛选查询:

账簿(多选), SKU(模糊匹配), 本地仓库(全部,多选),期间(按月汇总),

类似财务报表资产负债表一样, 提供勾稽校验的标识(校验期末库存与相应的会计科目余额, 可以点击标识 > 设置对应的会计科目, 对应其余额校验)

期间	本期最新单位存货成本	期初库存	期间变动	期末库存

		金额+数量		金额+数量
	点击可查看本期的日期/单位存货成本变动图		点击可查看明细
汇总行

明细账:

筛选查询: 账簿(多选), SKU(模糊匹配), 本地仓库(多选),操作时间(范围),库存操作(多选, 操作类型), 单据(输入,精确查询)

账簿	操作数量	库存价值变动	单位存货成本
			该操作对应使用的存货成本
	以相应的正,负数显示.	以相应的正,负数显示.	涉及采购/盘盈/暂估(其他)入库, 等会影响存货成本的操作时, 点击弹窗, 显示, 操作前, 操作后的单位存货成本
		点击列出相应的凭证明细列表
汇总行	汇总需要对应库存操作类型, 加,减计算

操作

盘点

盘点会相应生成凭证.需要按进销存配置

``` ```

20260623 (初稿, 需要进一步优化补充) 本地仓库台账主要用于本地仓库, 明细,SKU数量和采购加权平均单价,移动加权平均, 盘点.等等勾稽校验

``` ``` 9. ### 前端页面: 账簿 > 台账 > FBA仓库台账

支持跨账簿, 不跨ERP

分为汇总账 + 明细账

汇总账:

筛选查询:

账簿(与亚马逊店铺一一对应), SKU(模糊匹配), 仓库站点(全部,多选),期间(按月范围),

期间	账簿	SKU	仓库站点
					完全按Summary view的FBA报表来设计
					Disposition
					Starting Warehouse Balance
					In Transit Between Warehouses
					Receipts
					Customer Shipments
					Customer Returns
					Vendor Returns
					Warehouse Transfer In/Out
					Found
					Lost
					Damaged
					Disposed
					Other Events
					Ending Warehouse Balance
					Unknown Events
					Location
					Store

汇总行

明细账:

筛选查询: 账簿(多选), SKU(模糊匹配), 本地仓库(多选),操作时间(范围),库存操作(多选, 操作类型), 单据(输入,精确查询)

操作时间	账簿	SKU	仓库站点
				按Detailed view的FBA报表来设计
				Event Type
				Reference ID
				Quantity
				Fulfillment Center
				Disposition
				Reason
				Country
				Reconciled Quantity
				Unreconciled Quantity
				Date and Time
				Store
汇总行

操作

``` ```

20260623 FBA仓库台账主要用基于亚马逊的库存台账报表生成, 相应汇总核算盘点,入库,出库等等勾稽校验

``` ```

# 税务审查便利性功能

款项代收及划转服务

台账

外方账单 + 连连月单

无票成本和有票成本

利润表外加成本统计

统计无票成本 + 有票成本 , 明细.

发票台账

支持部分入账. 每张发票入到不同账簿

关务

出口台账

账簿下报关单角度和 FBA货件角度

FBA货件/海外仓货件 <> 报关单 (报关单拆分对应,金额,项目,数量)

# 海关申报

跨境电商报关模式

传统报关单模式: H2018,单一窗口标准版,货物申报,出口整合申报

订单 + 运单 + 报关单

清单模式: 跨境电商出口统一版, 单一窗口/客户端等,跨境电商,订单/清单

订单 + 运单 + 清单

ERP

单票, 出口报关申报 , 国外进口清关

HSCODE , api数据接口.

查询 , 返回提醒如何填写

告警 , hscode有进出口管控

[国家税务总局政策法规库](https://fgk.chinatax.gov.cn/zcfgk/c102424/c5238760/content.html)

[国家税务总局安徽省税务局通知公告关于发布出口退税率文库2025A版的通知](https://anhui.chinatax.gov.cn/art/2025/3/7/art_9422_1236824.html)

[税率查询-hscode,退税率,hs编码,进出口商品编码,进口关税,出口退税商品税率,海关编码,申报要素查询](https://cess.tax360.com.cn/)

## 20260707

拼单出口

同一目的国, 跨账簿/跨店铺, 多选FBA ID, 选定一个出口公司, 推9810订单

报关单台账, 支持, 将拼单的一张报关单, 里的明细/金额, 对应不同的店铺公司

支持代理出口协议数据

支持所得税,自营/代理出口等申报数据

考虑: 使用一家,或者轮换多家, 当天同目的地拼成一张报关单出口

后续代理出口协议/申报数据等做溯源

# 财务模块-凭证模版 # 凭证模版需求 ## 1、在录入凭证的界面就模版按钮，点击下拉出现“保存为凭证模版“ 和 “从模版生成凭证” ### 从模版生成凭证：打开模版对话框，选择对应模版将内容加载到创建凭证内容中以下图片展示的是从模版生成凭证，标题：选择模版，可以通过模版类型和模版名称搜索，模版类型为下拉选择框。有勾选框仅显示模版类别和名称，默认勾选，如果去掉这个将自动显示模版内部对应的分录信息，含辅助核算，金额等信息，具体实现请参考凭证查询页面 [![img_v3_0213i_26f03f74-381f-404b-8b6a-49b0464c34ag.jpg](https://wiki.wimoor.com/uploads/images/gallery/2026-07/scaled-1680-/img-v3-0213i-26f03f74-381f-404b-8b6a-49b0464c34ag.jpg)](https://wiki.wimoor.com/uploads/images/gallery/2026-07/img-v3-0213i-26f03f74-381f-404b-8b6a-49b0464c34ag.jpg) ### 保存为凭证模版：将当前客户编辑的内容保存为特定模版弹出新增模版对话框，输入表单模版名称，模版类别（下拉列表）保存一下信息：摘要（默认勾选）科目（默认勾选）金额（默认不勾选）辅助核算（默认不勾选）对话框footer部分提供保存与取消按钮，保存按钮点击后将会保存凭证页面维护的相应内容 [![img_v3_0213i_d9c06840-be0f-4270-af89-f45bf7de109g.jpg](https://wiki.wimoor.com/uploads/images/gallery/2026-07/scaled-1680-/img-v3-0213i-d9c06840-be0f-4270-af89-f45bf7de109g.jpg)](https://wiki.wimoor.com/uploads/images/gallery/2026-07/img-v3-0213i-d9c06840-be0f-4270-af89-f45bf7de109g.jpg) 模版类别提供编辑逻辑，可以在下拉框边上加入编辑图标，或者在下拉列表最下面加入新增按钮点击后弹出模版类别管理对话框 [![image.png](https://wiki.wimoor.com/uploads/images/gallery/2026-07/scaled-1680-/image.png)](https://wiki.wimoor.com/uploads/images/gallery/2026-07/image.png) 在模版类别管理对话可以新增，修改和删除模版类别。也可以选择某个模版类别，确定后下拉列表会自动选择对话框中选择的类别 [![image.png](https://wiki.wimoor.com/uploads/images/gallery/2026-07/scaled-1680-/u8Eimage.png)](https://wiki.wimoor.com/uploads/images/gallery/2026-07/u8Eimage.png) ## 数据库设计：

CREATE TABLE `fin_vouchers_template_type` (

`id` BIGINT(20) UNSIGNED NULL DEFAULT NULL COMMENT 'ID',

`groupid` BIGINT(20) UNSIGNED NULL DEFAULT NULL COMMENT '租户ID',

`name` VARCHAR(50) NULL DEFAULT NULL COMMENT '分类名称' COLLATE 'utf8mb4_bin',

`create_by` VARCHAR(50) NULL DEFAULT NULL COMMENT '创建人名称' COLLATE 'utf8mb4_bin',

`modify_by` VARCHAR(50) NULL DEFAULT NULL COMMENT '修改人名称' COLLATE 'utf8mb4_bin',

`created_time` DATETIME NULL DEFAULT NULL COMMENT '创建时间',

`updated_time` DATETIME NULL DEFAULT NULL COMMENT '修改时间'

)

COMMENT='凭证模版分类'

COLLATE='utf8mb4_bin'

ENGINE=InnoDB

;

后台controller应当在保存逻辑自动维护created\_time，updated\_time，modify\_by，create\_by 和修改时自动维护updated\_time，modify\_by 前端在保存时应当将当前的groupid维护上去，用户只需要维护对应的分类名称

CREATE TABLE `fin_vouchers_template` (

`id` BIGINT(20) UNSIGNED NULL DEFAULT NULL COMMENT 'ID',

`groupid` BIGINT(20) UNSIGNED NULL DEFAULT NULL COMMENT '租户ID',

`type_id` BIGINT(20) UNSIGNED NULL DEFAULT NULL COMMENT '类型ID',

`name` VARCHAR(50) NULL DEFAULT NULL COMMENT '模版名称' COLLATE 'utf8mb4_bin',

`create_by` VARCHAR(50) NULL DEFAULT NULL COMMENT '创建人名称' COLLATE 'utf8mb4_bin',

`modify_by` VARCHAR(50) NULL DEFAULT NULL COMMENT '修改人名称' COLLATE 'utf8mb4_bin',

`created_time` DATETIME NULL DEFAULT NULL COMMENT '创建时间',

`updated_time` DATETIME NULL DEFAULT NULL COMMENT '修改时间'

)

COMMENT='凭证模版'

COLLATE='utf8mb4_bin'

ENGINE=InnoDB

;

用于存储凭证模版，type\_id存储新增模版对话框中的模版类型对应的ID，name是客户在新增模版对话框中的form中维护的input 页面上客户填写的内容存储到fin\_vouchers\_template\_entries中

CREATE TABLE `fin_vouchers_template_entries` (

`entry_id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '分录主键ID',

`groupid` BIGINT(20) UNSIGNED NOT NULL COMMENT '租户ID',

`template_id` BIGINT(20) UNSIGNED NOT NULL COMMENT '关联的凭证模版ID',

`entry_no` INT(10) NOT NULL COMMENT '分录序号',

`subject_id` BIGINT(20) UNSIGNED NOT NULL COMMENT '会计科目ID',

`summary` VARCHAR(200) NULL DEFAULT NULL COMMENT '摘要说明' COLLATE 'utf8mb4_bin',

`debit_amount` DECIMAL(15,2) NULL DEFAULT '0.00' COMMENT '借方金额',

`credit_amount` DECIMAL(15,2) NULL DEFAULT '0.00' COMMENT '贷方金额',

`original_amount` DECIMAL(20,6) NULL DEFAULT NULL,

`currency` VARCHAR(5) NULL DEFAULT NULL COLLATE 'utf8mb4_bin',

`exchange_rate` DECIMAL(20,6) NULL DEFAULT NULL,

`quantity` INT(10) NULL DEFAULT NULL,

`unit_price` DECIMAL(20,2) NULL DEFAULT NULL,

`created_time` DATETIME NULL DEFAULT NULL COMMENT '创建时间',

PRIMARY KEY (`entry_id`) USING BTREE,

INDEX `idx_voucher_entries_tenant_subject` (`groupid`, `subject_id`) USING BTREE COMMENT '租户分录科目索引',

INDEX `tenant_id` (`groupid`, `template_id`) USING BTREE,

INDEX `template_id` (`template_id`) USING BTREE

)

COMMENT='凭证模版分录明细表，存储凭证模版的每一笔分录信息'

COLLATE='utf8mb4_bin'

ENGINE=InnoDB

AUTO_INCREMENT=12839

;

注意必须按照客户的维护的次序保存entry_no

其中如果客户维护了辅助核算类人且在保存时勾选了辅助核算，应当将辅助核算保存在fin_vouchers_template_entries_auxiliary中

CREATE TABLE `fin_vouchers_template_entries_auxiliary` (

`id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT COMMENT 'ID',

`entry_id` BIGINT(20) UNSIGNED NULL DEFAULT NULL COMMENT '关联分录',

`auxiliary_type_id` BIGINT(20) UNSIGNED NULL DEFAULT NULL COMMENT '核算类型：CUSTOMER, DEPARTMENT, PROJECT, SUPPLIER, EMPLOYEE',

`auxiliary_item_id` BIGINT(20) UNSIGNED NULL DEFAULT NULL COMMENT '具体核算项的ID（对应客户主表、部门主表的ID）',

`groupid` BIGINT(20) UNSIGNED NULL DEFAULT NULL COMMENT '租户ID',

PRIMARY KEY (`id`) USING BTREE,

UNIQUE INDEX `entry_id_assistant_type_code` (`entry_id`, `auxiliary_type_id`) USING BTREE

)

COLLATE='utf8mb4_bin'

ENGINE=InnoDB

AUTO_INCREMENT=5

;

## 文件位置以上内容后台在wimoor-finance\\src\\main\\java\\com\\wimoor\\finance\\voucher 前段在wimoor-ui\\src\\views\\finance\\vouchers\_template 请帮我完成以上需求 # 采购模块 # 采购模块-付款报告-店铺链接：https://app.wimoor.com/erp/purchase/paymentDetail?title=%E9%87%87%E8%B4%AD%E4%BB%98%E6%AC%BE%E6%98%8E%E7%BB%86&path=/erp/purchase/paymentDetail&closable=true&scrolltop=0 采购付款明细在字段中的SKU边上增加灰色的 (店铺）的形式。注意店铺是t\_erp\_purchase\_form的groupid,而且其内容表t\_amazon\_group不是ERP模块的，他是amazon模块。需要使用fegin调用。对于groupname的加入需要考虑页面和导出两个地方搜索条件中新增店铺，直接用店铺组件建议group\_select.vue ,且帮我将查询模块费用类型和支付方式减少宽度以便能够一行放下所有查询模块 # 供应商管理 1.

供应商管理:

数据库表：

CREATE TABLE `t_erp_customer` (

`id` BIGINT(20) UNSIGNED NOT NULL COMMENT 'ID(h)',

`name` CHAR(50) NULL DEFAULT NULL COMMENT '客户简称' COLLATE 'utf8mb4_bin',

`number` CHAR(50) NULL DEFAULT NULL COMMENT '客户编码' COLLATE 'utf8mb4_bin',

`fullname` VARCHAR(200) NULL DEFAULT NULL COMMENT '客户全称' COLLATE 'utf8mb4_bin',

`ftype` CHAR(10) NULL DEFAULT NULL COMMENT '客户分类(supplier 供应商，purchaser 采购商）' COLLATE 'utf8mb4_bin',

`goodtype` VARCHAR(50) NULL DEFAULT NULL COMMENT '货物类型（透明胶，服装，玩具等）' COLLATE 'utf8mb4_bin',

`contacts` VARCHAR(50) NULL DEFAULT NULL COMMENT '联系人' COLLATE 'utf8mb4_bin',

`phone_num` VARCHAR(50) NULL DEFAULT NULL COMMENT '联系电话' COLLATE 'utf8mb4_bin',

`contact_info` VARCHAR(2000) NULL DEFAULT NULL COMMENT '其它联系信息' COLLATE 'utf8mb4_bin',

`address` VARCHAR(500) NULL DEFAULT NULL COMMENT '地址' COLLATE 'utf8mb4_bin',

`shoplink` VARCHAR(500) NULL DEFAULT NULL COMMENT '商品链接' COLLATE 'utf8mb4_bin',

`shopid` BIGINT(20) UNSIGNED NULL DEFAULT NULL COMMENT '所属店铺（公司）(h)',

`operator` BIGINT(20) UNSIGNED NULL DEFAULT NULL COMMENT '操作人',

`opttime` DATETIME NULL DEFAULT NULL COMMENT '修改时间',

`oldid` CHAR(36) NULL DEFAULT NULL COLLATE 'utf8mb4_bin',

PRIMARY KEY (`id`) USING BTREE,

UNIQUE INDEX `name_shopid` (`shopid`, `name`) USING BTREE,

UNIQUE INDEX `number_shopid` (`number`, `shopid`) USING BTREE

)

COLLATE='utf8mb4_bin'

ENGINE=InnoDB

ROW_FORMAT=DYNAMIC

;

2. 优化UI 对当前供应商的编辑状态采用单独页面展示的方式，提供客户查看状态的页面与编辑状态的页面，且可以相互转换当保存之后自动变成查看状态，当在查看页面点击编辑自动变成编辑状态页面。 3.

在供应商维护页面可以新增供应商收款账户

1. 数据库结构一个供应商对应多个收款账户，可以设置默认收款账户 1.

CREATE TABLE `t_erp_customer_account` (

`id` BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT COMMENT 'ID(h)',

`customer_id` BIGINT(20) UNSIGNED NOT NULL,

`company_name` CHAR(50) NULL DEFAULT NULL COMMENT '公司名称' COLLATE 'utf8mb4_bin',

`account_number` VARCHAR(50) NULL DEFAULT NULL COMMENT '银行账号' COLLATE 'utf8mb4_bin',

`shopid` BIGINT(20) UNSIGNED NULL DEFAULT NULL COMMENT '所属店铺（公司）(h)',

`operator` BIGINT(20) UNSIGNED NULL DEFAULT NULL COMMENT '操作人',

`opttime` DATETIME NULL DEFAULT NULL COMMENT '修改时间',

`oldid` CHAR(36) NULL DEFAULT NULL COLLATE 'utf8mb4_bin',

PRIMARY KEY (`id`) USING BTREE,

UNIQUE INDEX `number_shopid` (`account_number`, `shopid`) USING BTREE,

UNIQUE INDEX `name_shopid` (`shopid`, `company_name`) USING BTREE

)

COMMENT='收款账户'

COLLATE='utf8mb4_bin'

ENGINE=InnoDB

ROW_FORMAT=DYNAMIC

;此表为新增表，需要后台添加对应实体操作和服务类等

2. 增加支持维护供应商的收款账户 3. 收款账户可多个,可设置默认. 4. 收款账户的**启用/停用**状态管理（银行账户可能变更）,不删除(只停用, 可查询) 4. 在供应商查看页面，显示近半年此供应商的采购单对应产品以及采购金额，采购数量。注意：必须以产品为中心汇总，不管有多少单有多个如果产品只有一个就只能有一笔。不分页每个产品一个小卡片，图片名称SKU ，采购金额，采购数量。依次展示，最好使用el-space wrap的方式

# 采购账户账目->采购记账模块 [https://app.wimoor.com/finance/account?title=%E9%87%87%E8%B4%AD%E8%AE%B0%E8%B4%A6&path=/finance/account](https://app.wimoor.com/finance/account?title=%E9%87%87%E8%B4%AD%E8%AE%B0%E8%B4%A6&path=/finance/account) 左侧卡片里面的paymeth支付类型和 account 账目名称调换位置。如：现在是现金在上1688支付宝\[支付宝\]在下，修改后应该是1688支付宝\[支付宝\]在上方黑字，现金在下方灰色字体 [![image.png](https://wiki.wimoor.com/uploads/images/gallery/2026-07/scaled-1680-/GWGimage.png)](https://wiki.wimoor.com/uploads/images/gallery/2026-07/GWGimage.png) # 账目-结算记录-每日费用趋势账目-结算记录页面下的“图表”这一页签的“每日费用趋势”，当前的数据是按照月汇总的，后台数据查询的时候，是查出日期区间每天的数据的，再进行按照月汇总的。请帮我把日期区间每天的数据，在图表下面新增一个类似“销售-趋势分析”页面的销量表格展示，表格的项目名称大致如：日期,当天汇率,当前选中的费用项。当前原有图表和新增的表格展示，需要加上对“站点币种“和“RMB”的切换显示。数据源里有“RMB”对应的值和本身站点币种的值。还有图表的“结算金额,FBA费,佣金”这三个选项，帮我做成动态的下拉选项，下拉选项的值来源于“报表”页签下的income项。请帮我在“图表”下的“每日费用趋势”内容下面新增这个表格和优化当前图表。根据以下代码进行： ```java public Map monthReport(Map param){ String fromDate = param.get("fromDate").toString().replaceAll("/", "-"); String endDate = param.get("endDate").toString().replaceAll("/", "-"); param.put("fromDate", fromDate); param.put("endDate", endDate); List> mapList= amzSettlementReportSummaryMonthMapper.monthReport(param); Map result=new HashMap(); String currency=null; BigDecimal totals=new BigDecimal("0"); BigDecimal total_other=new BigDecimal("0"); BigDecimal totals_rmb=new BigDecimal("0"); BigDecimal total_other_rmb=new BigDecimal("0"); for(Map map:mapList){ if(map==null){continue;} BigDecimal total=map.get("Total Income Expenses Tax")!=null?new BigDecimal(map.get("Total Income Expenses Tax").toString()):null; totals=totals.add(total); BigDecimal others=new BigDecimal("0"); Date postdate=map.get("posted_date")!=null?GeneralUtil.getDate(map.get("posted_date")):null; currency=map.get("currency").toString(); for(Map.Entry entry:map.entrySet()){ if(entry.getKey().equals("currency")||entry.getKey().equals("posted_date")){continue;} if(entry.getValue() instanceof BigDecimal){ BigDecimal value=new BigDecimal(entry.getValue().toString()); BigDecimal rmb=exchangeRateHandlerService.changeCurrencyByLocal(postdate,currency,"CNY",value); if(result.get(entry.getKey())!=null){ result.put(entry.getKey(),value.add(new BigDecimal(result.get(entry.getKey()).toString()))); result.put(entry.getKey()+"_rmb",rmb.add(new BigDecimal(result.get(entry.getKey()+"_rmb").toString()))); }else{ result.put(entry.getKey(),value); result.put(entry.getKey()+"_rmb",rmb); } if(!entry.getKey().equals("Total Income Expenses Tax")){ others=others.add(value); } } } //-----------------------------others---------------------------- assert total != null; others=total.subtract(others); map.put("Others",others); BigDecimal others_rmb=exchangeRateHandlerService.changeCurrencyByLocal(postdate,currency,"CNY",others); map.put("Others_rmb",others_rmb); total_other=total_other.add(others); total_other_rmb=total_other_rmb.add(others_rmb); } result.put("Others",total_other); result.put("Others_rmb",total_other_rmb); BigDecimal transfer = amzSettlementReportSummaryMonthMapper.TransfersToBankAccount(param); result.put("Transfers to bank account",transfer); if(transfer!=null){ BigDecimal rmb=exchangeRateHandlerService.changeCurrencyByLocal(GeneralUtil.getDatez(endDate),currency,"CNY",transfer); result.put("Transfers to bank account_rmb",rmb); } BigDecimal transferFail=amzSettlementReportSummaryMonthMapper.FailedTransfersToBankAccount(param); result.put("Failed transfers to bank account",transferFail); if(transferFail!=null){ BigDecimal rmb=exchangeRateHandlerService.changeCurrencyByLocal(GeneralUtil.getDatez(endDate),currency,"CNY",transferFail); result.put("Transfers to bank account_rmb",rmb); } List list = getTransactionTypes(); for(String item:list){ if(result.get(item)==null){ result.put(item,new BigDecimal(0)); result.put(item+"_rmb",new BigDecimal(0)); } } BigDecimal total=new BigDecimal("0"); for(Map.Entry item:result.entrySet()){ if(!item.getKey().contains("_rmb")){continue;} System.out.println(item.getKey()+" "+item.getValue()); } return result; } ```

计划最晚上线时间	模块功能拟放的位置	详细功能	备注
202603	账簿-结账-期末处理-新增自定义模板-亚马逊月度营业数据	按科目,引用数据,按模板设置生成亚马逊的月度营业数据数据源: 按国家凭证备注设置汇率: 对应币种按原币记录 + 对账簿对应的本位币的汇率按亚马逊报送中国税局的要求, 订单每日的中间币外管局的价牌. 凭证日期: 需要设置为对应数据月份.(凭证日期很重要,涉及数据的账期归属)	后续进一步增加: 月度PDF作为凭证附件.
202604	账簿-凭证-导入凭证 ; 导出凭证 > 更改 > 导入批量更改		可以导入. 导出可以放到明细账,设定成导入的格式.
202604	账簿-结账-期末处理-新增自定义模板-飞书多维表格数据连接		自动连接飞书的数据, 多维表格的数据可以直接按配置好的模板, 生成凭证.
202605	明细账总账科目余额表		复制金蝶的大部分前端逻辑. 方便查找核对.
	财务报表: 资产负债表, 利润表, 现金流表	重要: 利润表, 增加一个功能, 可选择显示或隐藏,各项成本项目的占总营业收入的比例
	现行采购模块 > 自动记账
202605	账簿 - 台账 - 进销存	凭证字号. 入, 出, 采 , 进, 销等等
	结账 - 期末处理 : 调汇 + 结转 + 损益税务相关
	结账 - 结账
	账簿 - 台账 - 发票供应商台账采购/物流对账单 <> 发票台账采购账户台账余额/对账,账期还款对账单(批量支付,还款),	发票 <> 付款全链条关联查询: 发票-采购订单-付款-税-供应商...出口.退税等等发票-报销-付款-货物等等	亚马逊等境外发票 + 境内发票
202609	离境业务流的会计凭证代收款项/划转信用卡广告等等		凭证 <> 附件
	税务报表参考报税数据
后续	员工收入台账其它平台对接应付款项 - 台账资金流分析等非亚马逊平台类的销售端+库存的接入连连台账(香港公司的明细?)

表格	需求简介	可能的方案
工资	一张表格,多家公司账薄,涉及固定的科目和格式	1. 需要前端插件. 手动更新数据后, 手动确认>发送>ERP后台生成凭证 2. ERP配置: 1. 新建模板,名称 2. 多维表格连接配置 1. 输入多维表格 token等> 拉取字段结构 3. 凭证参数配置 1. 凭证字号: 单独设置以区分(尤其是预计凭证多的时候) 2. 3. 制单人 4. 凭证备注, 等 4. 多维表格记录筛选配置 1. 完全复制多维表格的'筛选'功能 5. 凭证分录配置规则 1. 备注说明: 每条符合筛选条件的记录对应一对'借贷平衡'的凭证分录. 2. 账簿 3. 凭证日期 4. 借方科目配置 1. 当'字段',等于/包含/不等于, XX , 时 2. 科目单选/多选, 为 XX/XX 1. 多选时, 即需要前端确认 3. (本位币) 金额 , 为 '字段' 4. 如果是外币科目 1. 货币 2. 汇率 3. 原币金额 5. 贷方科目配置 1. 同上 6. 6. 其它: 1. 筛选条件的数量, 最大为多少个? 1,2个? 2. 是否需要前端确认 1. 分录的科目, 如果是多选. 则必须前端处理, 手动发送. 3. ERP收到返回处理 1. 后台给多维表格生成处理标记(时间+凭证号?) 2. "异常"处理 3. 凭证要有地方可以反查数据来源(比如备注等)
请款申请对内报销 , 对外支付, VAT支付	飞书审批同步数据	1. 前端确认. 或者加入财务审批细点. 自动生成, 审批完成后?但有风险. 报销可能科目太多? 2. 采用手动确认.
单一业务清晰的表格	VAT支付	1. 需要实现全自动流程(或者是免审流程) 1. 新旧数据比对? 如何避免重复?