财务模块-新需求整理与开发

• 财务ERP系统需求规格说明书与开发方案
• 财务ERP - 进销存模块（采购与台账）详细开发文档
• 财务ERP - 进销存模块（采购与台账）详细开发流程文档
• 财务ERP - 进销存模块（采购与台账）开发纲要
• 财务设计框架20251011-原始需求

财务ERP系统需求规格说明书与开发方案

版本历史

---

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 模块划分（后端微服务）

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. 开发计划（分阶段实施）

---

7. 关键业务规则说明

1. 损益类科目红字规则：损益类科目不允许借方蓝字，必须记贷方红字（负数），以保证利润表取数正确。

2. 凭证日期：必须等于业务实际发生日期（如付款日期、收入确认日期），不得随意提前或推后。

3. 内部往来抵消：多账套合并报表时，内部往来科目（如其他应收款-账套间）必须清零。

4. 库存成本核算：采用移动加权平均，每次出库成本 = 出库数量 × 当前移动平均单价；库存余额不通过单价×数量反算，而通过期初+入库-出库滚动计算。

5. 附件保存：所有凭证和重要业务单据（合同、发票、物流单）均需上传附件，电子档案保存不少于10年。

---

8. 开发注意事项

• 前端适配：大量表格需支持动态列、排序、筛选、导出，建议封装通用表格组件。

• 性能优化：台账页面数据量大，需后端分页、前端虚拟滚动。

• 安全性：金额字段前端展示需千分位格式化，但传输时保持原始数值。

• 国际化：预留多语言接口（目前仅中文）。

• 测试重点：凭证借贷平衡、外币折算、移动加权平均计算、自动生成凭证的异常处理。

---

9. 附录：参考文档与资源

• 金蝶会计科目体系参考

• 亚马逊SP-API文档

• 飞书多维表格API

• 公司内部《2025-财务及海关ERP设计方案》

财务ERP - 进销存模块（采购与台账）详细开发文档

版本历史

---

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

已在原文档中定义，此处补充字段说明：

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（付款）：

    text

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

  • 凭证2（在途库存）：

    text

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

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

  text

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

• 入库时（采购单收货）：

  text

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

3.1.2 账期类账户付款（先采后付、公户请款等）

• 采购单点击“付款”（即发起请款）：

  text

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

• 在途库存确认（同3.1.1）：

  text

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

• 台账付款（实际还款）：

  • 借：应付账款_1688先采后付

  • 贷：银行存款-浦发 / 其他货币资金-连连跨境直采

  • 若有跨境直采手续费，另加一笔：

    text

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

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）：

<select id="queryLedgerList" resultType="com.wimoor.finance.vo.PurchaseLedgerVO">
    SELECT 
        po.groupid,
        po.id as orderId,
        po.sku,
        s.name as supplierName,
        sb.account_no as bankAccount,
        po.total_amount,
        po.paid_amount,
        po.inventory_value,
        po.invoiced_amount,
        -- 计算待付、待入库、待开票
        (po.total_amount - po.paid_amount) as pending_pay,
        (po.inventory_value - IFNULL(SUM(ir.received_value),0)) as pending_stock,
        (po.total_amount - po.invoiced_amount) as pending_invoice,
        po.status_pay,
        po.status_stock,
        po.status_inv
    FROM fin_purchase_order po
    LEFT JOIN t_erp_supplier s ON po.supplier_id = s.id
    LEFT JOIN fin_supplier_bank sb ON s.id = sb.supplier_id AND sb.is_default=1
    LEFT JOIN fin_inventory_transaction ir ON po.id = ir.source_doc_id AND ir.trans_type='RECEIVE'
    WHERE po.groupid = #{groupid}
    <if test="accountIds != null and accountIds.size()>0">
        AND po.purchase_account_id IN 
    </if>
    <if test="startDate != null"> AND po.created_time >= #{startDate} </if>
    <if test="endDate != null"> AND po.created_time < #{endDate} </if>
    <if test="payStatus != null"> AND po.status_pay IN ... </if>
    GROUP BY po.id
    ORDER BY po.created_time DESC
</select>

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

• 后端：生成凭证：

  text

  借：预付账款-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 采购账户管理

4.2 采购订单（会计版）

4.3 采购账户台账

4.4 供应商台账

4.5 发票台账

4.6 库存台账

---

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）

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 结构：

{
  "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
• 请求体：

{
  "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
• 请求体：

{
  "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
• 请求体：

{
  "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
• 请求体：

{
  "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
• 请求体（可选）：

{
  "groupid": 1001,
  "startDate": "2026-06-01",
  "endDate": "2026-06-25"
}

• 响应：{ "code": 200, "data": { "success": 50, "failed": 2 } }

发票入账

• POST /api/finance/ledger/invoice/post
• 请求体：

{
  "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
• 响应：

{
  "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 结构：

{
  "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

基本框架

实际使用的举例

分步实施

20251016第一阶段

20260225

20260303 损益科目红字

202511029 需求补充 : 备忘记录

20251108 需求 备忘

20260311开发计划草拟

20260401 亚马逊月度营业数据: PDF数据项目对应科目

202604 进销存

功能需求

进销存 台账, 发票台账,设计重点

设计思路

20260523

20260422 发票台账

2026604 对公账户余额数据

202605 采购模块扩展改进

20260612 系统优化需求

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

税务审查便利性功能

海关申报

20260707