财务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 开发步骤

创建实体类：映射新增表，使用MyBatis-Plus注解，JSON字段配置TypeHandler
创建Mapper接口：继承BaseMapper，定义必要的自定义查询方法
实现Service层： - 创建：校验参数完整性、唯一性，保存配置JSON - 更新：校验是否被引用，合并配置 - 删除：软删除或校验无引用后删除 - 列表：支持按账套、类型筛选
实现Controller层：定义REST接口，参数校验，统一响应格式
单元测试：覆盖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 台账付款核心约束

同账户约束：一次付款操作，所有选中的记录必须使用同一个账期采购账户
账户类型约束：仅账期类型账户支持台账付款
现金账户约束：选中的现金账户必须在账期账户的creditPayAccounts配置中
金额约束：付款金额不超过各订单待付金额之和
尾差处理：按比例分摊，差额归入最后一条记录

3.3.4 Excel批量上传模板

列名	类型	说明	校验规则
采购订单号	文本	订单唯一标识	必填，存在于系统
SKU	文本	SKU编码	必填，与订单匹配
应付金额	数字	订单应付金额	必填，≥0
本次付款金额	数字	本次实际支付	必填，>0，≤应付-已付
费用类型	文本	货款/运费/其他	必填，在配置中

上传流程：

用户下载模板
填写后上传
系统解析并校验
返回预览数据（含校验结果）
用户确认后提交
批量生成付款记录和凭证

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 发票同步流程

触发方式： - 定时任务：每日凌晨2点自动执行 - 手动触发：用户在页面点击"同步"按钮
数据来源：税局电子发票API（或金蝶接口）
处理逻辑： - 按日期范围拉取发票列表 - 按发票号码去重（已存在则跳过） - 按销方税号匹配内部供应商（t_erp_supplier） - 匹配成功则记录supplier_id，否则留空 - 写入fin_invoice，状态为"正常"，入账状态为"未入账"
异常处理：单条失败不影响整体，记录日志

3.4.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 移动加权平均核算规则

核心公式：

新移动单价 = (当前结存金额 + 本次入库金额) / (当前结存数量 + 本次入库数量)
出库成本 = 出库数量 × 当前移动单价

重要规则：

只有采购入库（PURCHASE_IN）、盘盈入库（ADJUST_IN）会改变移动单价
销售出库（SALE_OUT）、调拨出库（TRANSFER_OUT）不改变单价，仅减少数量
库存余额不通过"单价×数量"反算，采用滚动加减法： - 新余额 = 旧余额 + 入库金额 - 出库成本
单价保留4位小数，金额保留2位小数
尾差处理：出库时先乘后减，避免单价反算误差

期间核算：

按月汇总，每月初从上月期末结转
同一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 勾稽校验逻辑

校验目标：库存台账的期末金额与总账中"库存商品"科目余额一致

校验步骤：

查询指定期间内所有SKU的期末库存金额合计
查询总账中"库存商品"科目（及所有子科目）的期末余额
对比两者差异
若差异不为零，列出差异明细（按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 迁移顺序

采购账户：手动创建历史使用的采购账户
采购订单：按时间分批迁移，每批1000条
付款明细：从ERP付款记录中提取
库存余额：从当前库存表初始化
发票台账：从税局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 - 进销存模块（采购与台账）详细开发流程文档

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

文档说明

版本历史

1. 模块依赖关系与开发顺序

1.1 模块依赖图

1.2 开发顺序总览

2. 数据库设计（新增表）

2.1 新增表清单

2.2 表结构设计要点

2.2.1 采购账户表 fin_purchase_account

2.2.2 供应商收款账户表 fin_supplier_bank

2.2.3 采购订单表 fin_purchase_order

2.2.4 采购付款明细表 fin_purchase_payment

2.2.5 发票台账表 fin_invoice

2.2.6 库存余额表 fin_warehouse_stock

2.2.7 库存变动明细表 fin_inventory_transaction

3. 服务层开发任务（按顺序执行）

3.1 阶段一：基础配置模块（第1周）

3.1.1 任务清单

3.1.2 开发步骤

3.1.3 接口契约

3.1.4 测试用例

3.2 阶段二：采购订单（会计版）（第2-3周）

3.2.1 任务清单

3.2.2 订单状态机设计

3.2.3 凭证生成规则

3.2.4 接口契约

3.2.5 异常场景处理

3.2.6 测试用例

3.3 阶段三：采购账户台账（第3-4周）

3.3.1 任务清单

3.3.2 台账列表查询字段

3.3.3 台账付款核心约束

3.3.4 Excel批量上传模板

3.3.5 接口契约

3.3.6 测试用例

3.4 阶段四：发票台账与供应商台账（第4-5周）

3.4.1 任务清单

3.4.2 发票同步流程

3.4.3 发票入账流程

3.4.4 供应商台账查询字段

3.4.5 接口契约

3.4.6 测试用例

3.5 阶段五：库存台账（本地仓库）（第5-6周）

3.5.1 任务清单

3.5.2 移动加权平均核算规则

3.5.3 库存变动类型

3.5.4 汇总账查询结构

3.5.5 明细账查询结构

3.5.6 勾稽校验逻辑

3.5.7 接口契约

3.5.8 测试用例

4. 联调与测试（第6周）

4.1 端到端流程测试

4.2 性能测试

4.3 数据一致性测试

5. 数据迁移方案（第6周）

5.1 迁移范围

5.2 迁移顺序

5.3 迁移校验

6. 风险与应对

7. 里程碑与交付物

8. 附录：术语表

2.2.1 采购账户表 `fin_purchase_account`

2.2.2 供应商收款账户表 `fin_supplier_bank`

2.2.3 采购订单表 `fin_purchase_order`

2.2.4 采购付款明细表 `fin_purchase_payment`

2.2.5 发票台账表 `fin_invoice`

2.2.6 库存余额表 `fin_warehouse_stock`

2.2.7 库存变动明细表 `fin_inventory_transaction`