reconciliation-tax-fix

Files (3)

• SKILL.md
• fix-20260706-tax-meta.txt · sql/
• fix-20260706-tax.sql · sql/

SKILL.md (first lines)

---
type: skill
id: SKL-FC-001
title: 中台成品对账税金修复
domain: fc-reconciliation
project: lasen-rear
module: lasen-module-fc

tags:
  - type/skill
  - domain/fc
  - project/lasen
  - skill/data_fix
created: 2026-07-06
updated: 2026-07-06
---

# 中台成品对账税金修复

## 概述

lasen-rear 成品对账（fc_reconciliation_product）的历史数据修复能力。涵盖税金三字段（is_rec_part_vat / rec_part_vat_value / rec_part_vat_amount）、预留款金额、请款金额、账期子表的联动修改。

**适用场景**：
1. 历史对账单的半卖税金补充（is_rec_part_vat / rec_part_vat_value / rec_part_vat_amount）
2. 预留款含税/不含税转换（reserve_amount 的税基调整）
3. 对账单状态、请款金额修正
4. 账期子表（fc_reconciliation_period_dt）联动调整
5. 关联付款计划表（fc_rec_link_payment / fc_payment_plan_settlement）数据修正

## 表结构关系

```
fc_reconciliation_product (成品对账主表)
    ├── 1:N ── fc_reconciliation_period_dt (账期子表)
    │           via reconciliation_product_id
    ├── 1:N ── fc_rec_link_payment (对账关联付款计划)
    │           via reconciliation_product_id
    │               └── N:1 ── fc_payment_plan_settlement (付款计划结算清单)
    │                           via accounts_payable_settlement_id
```

### 核心表字段速查

#### fc_reconciliation_product — 成品对账主表

| 字段 | 类型 | 说明 |
|------|------|------|
| `reconciliation_product_id` | bigint | 主键 |
| `bill_number` | varchar | 对账单号（如 PRB250814-0003） |
| `status` | varchar | 审核状态 |
| `requested_status` | varchar | 请款状态 |
| `requested_payment_amount` | decimal | 请款金额（已请款金额） |
| `reserve_amount` | decimal | 预留款金额 |
| `is_rec_part_vat` | varchar | 半卖部分是否含税（Y/N） |
| `rec_part_vat_value` | decimal | 半卖部分税率 |
| `rec_part_vat_amount` | decimal | 半卖部分税金 |
| `reconciliation_amount` | decimal | 对账总金额（不含税） |
| `reconciliation_tax_amount` | decimal | 对账总金额（含税） |
| `is_use_period` | varchar | 是否使用账期 |
| `real_amount` | decimal | 实际支付金额（已废弃） |

#### fc_reconciliation_period_dt — 账期子表

| 字段 | 类型 | 说明 |
|------|------|------|
| `reconciliation_period_dt_id` | bigint | 主键 |
| `reconciliation_product_id` | bigint | 关联成品对账单ID |
| `period_type` | varchar | 款项期次类型（进度款/预留款/尾款/质保金/延期款...） |
| `expected_amount` | decimal | 预计请款金额（预计支付金额） |
| `expected_time` | date | 预计支付时间 |
| `is_requested` | varchar | 是否已请款（Y/N） |
| `paid_amount` | decimal | 已支付金额（已付金额） |
| `confirmed_amount` | decimal | 已开票金额 |
| `remark` | varchar | 备注 |

#### fc_rec_link_payment — 对账关联付款计划

| 字段 | 类型 | 说明 |
|------|------|------|
| `rec_link_payment_id` | bigint | 主键 |
| `reconciliation_product_id` | bigint | 成品对账单ID |
| `accounts_payable_settlement_id` | bigint | 结算单ID（→ fc_payment_plan_settlement） |
| `reconciliation_period_dt_id` | bigint | 账期ID（→ fc_reconciliation_period_dt） |
| `bill_amount` | decimal | 对账单金额 |
| `request_amount` | decimal | 请款金额 |

#### fc_payment_plan_settlement — 付款计划结算清单

| 字段 | 类型 | 说明 |
|------|------|------|
| `payment_plan_settlement_id` | bigint | 主键 |
| `bill_number` | varchar | 结算单号（如 FPPS251226-0021） |
| `payment_amount` | decimal | 应付金额 |
| `request_status` | varchar | 请款状态 |
| `paid_amount` | decimal | 已支付金额 |
| `confirmed_amount` | decimal | 已开票金额 |

## 字典映射 ⚠️ 必读

**数据库 status 字段存的是字典码，不是中文。** 写 SQL 时必须使用字典值。

字典定义源文件：`lasen-module-fc-api/.../enums/FcDictTypeConstants.java`

### 成品对账状态 (`status` 字段，字典类型: `FC_P_BILL_STATUS_*`)

| 字典码 | 中文含义 | 常量名 |
|--------|----------|--------|
| `0` | 待提交 | `FC_P_BILL_STATUS_0` |
| `1` | 待审核 | `FC_P_BILL_STATUS_1` |
| `2` | 已审核 | `FC_P_BILL_STATUS_2` |
| `3` | 已完成 | `FC_P_BILL_STATUS_3` |
| `4` | 已驳回 | `FC_P_BILL_STATUS_4` |
| `5` | 待复核 | `FC_P_BILL_STATUS_5` |
| `6` | **复核确认** | `FC_P_BILL_STATUS_6` |
| `7` | 复核驳回 | `FC_P_BILL_STATUS_7` |
| `8` | 开票确认提交态 | `FC_P_BILL_STATUS_8` |
| `9` | 开票确认审核通过 | `FC_P_BILL_STATUS_9` |
| `10` | 开票确认驳回 | `FC_P_BILL_STATUS_10` |
| `11` | 供应商确认 | `FC_P_BILL_STATUS_11` |

From GFigting/carry-god, MIT.

More from GFigting/carry-god