XLCS房产项目全成本测算模版 — 销售去化模块介绍

销售去化模块是 XLCS 全成本测算模板的核心组件之一，专门负责生成房产项目的月度销售去化计划。模块支持四种去化计算模式，能够灵活适配不同类型产品的销售节奏，为项目现金流测算提供精准的销售数据支撑。

经过多个版本迭代优化，目前已达到生产就绪级别，具备优秀的性能表现和稳定性，并支持敏感性分析批量调用。

📌 核心功能一览

功能	说明
四种去化模式	按默认 / 按去化率 / 按月数 / 按套数，灵活适配不同产品
产品类型区分	自动识别住宅（行137-150）和商业（行151-160）产品
基于起始日期计算	根据产品起始日期自动计算销售月份偏移
分期统计	自动统计各期总户数、各类型产品批次数
静默模式	支持敏感性分析批量调用，无弹窗干扰
全局锁保护	防止并发调用，确保批量执行稳定性

⚙️ 参数设置指南

去化模式选择（D列）

模式	说明	配套参数位置
按默认	使用全局默认月去化率	G131 单元格
按去化率	使用自定义月去化率	I131 单元格
按月数	按固定月数平均去化	O131 单元格
按套数	按固定月去化套数分配	K131（住宅）、M131（商业）

配套参数说明

参数位置	参数名称	格式要求	示例值	说明
G131	默认月去化率	小数（0-1）	0.1	按默认模式使用
I131	自定义月去化率	小数（0-1）	0.08	按去化率模式使用
O131	去化月数	正整数	12	按月数模式使用
K131	住宅月去化套数	正数	30	按套数模式使用
M131	商业月去化套数	正数	10	按套数模式使用

产品数据区域（137-160行）

列	字段	说明
C列	产品代码	唯一标识产品
D列	去化模式	选择四种模式之一
E列	分期/批次	如“1期”、“2期一批”
G列	起始日期	产品开始销售日期
第159列	总户数	自动从产品库匹配

🚀 操作流程

第一步：数据准备

确保 02基本指标录入 工作表存在，产品数据从第137行开始填写。

第二步：选择去化模式

在每行产品的 D 列选择去化模式：

按默认：使用 G131 的全局月去化率
按去化率：使用 I131 的自定义月去化率
按月数：按 O131 指定的月数平均去化
按套数：按 K131/M131 的月去化套数分配

第三步：配置配套参数

根据所选的去化模式，填写对应的配套参数单元格。

第四步：执行计算

点击按钮 “生成销售去化计划” 或运行宏 GenerateSalesPlan，观察状态栏实时进度。

📊 输出结果

输出位置	数据内容	说明
H137:FA160	月度去化率	每行代表一个产品，每列代表一个月份
FI137:FI141	各期总户数	按分期汇总
FL137:FL141	各期住宅批次数	按分期统计
FM137:FM141	各期商业批次数	按分期统计

🔍 功能详解

1. 四种去化模式

模式一：按默认（推荐）

使用全局统一的月去化率，适用于大多数标准产品。

计算公式：每月去化率 = G131 单元格的值

模式二：按去化率

为特定产品设置独立的月去化率，适用于去化速度异常的产品。

计算公式：每月去化率 = I131 单元格的值

模式三：按月数

指定产品在固定月数内均匀去化完毕。

计算公式：每月去化率 = 1 / 月数（O131）

模式四：按套数（智能分配）

按住宅和商业分别设置月去化套数，系统自动在多产品间智能分配：

平均分配：将月去化套数平均分配给当月活跃的产品
剩余分配：如有余量，继续分配给有剩余房源的产品
按比例：去化率 = 当月分配套数 / 产品总户数

💡 智能分配机制：系统会考虑每个产品的起始日期，只在产品开始销售后才参与分配，确保时间逻辑正确。

2. 产品类型自动识别

行范围	产品类型
137-150	住宅产品
151-160	商业产品

不同类型产品使用不同的月去化套数参数（K131 用于住宅，M131 用于商业）。

3. 基于起始日期的销售计算

每个产品都有独立的起始日期（G列）。系统会：

获取所有产品中最早的起始日期作为基准
计算每个产品相对于基准的月份偏移量
只在产品开始销售后才分配去化任务

4. 分期统计功能

系统自动统计：

各期总户数（FI137:FI141）：按分期汇总所有产品的总户数
各期住宅批次数（FL137:FL141）：按分期统计住宅产品数量
各期商业批次数（FM137:FM141）：按分期统计商业产品数量

5. 静默模式

支持敏感性分析等批量调用场景：

' 静默模式调用，无弹窗、无消息框
Call GenerateSalesPlan(True)

在静默模式下：

不显示完成消息框
不显示错误弹窗（错误仍会记录到即时窗口）
不影响批量分析流程

6. 全局锁保护

模块内置并发保护机制：

GenerateSalesPlanRunning：防止重复执行
SuppressGenerateSalesPlan：外部禁用标志
配合 BeginAppTask/EndAppTask 全局任务锁

📅 版本演进

版本	核心改进
v3.3	增加 silentMode，适配敏感性分析批量调用
v3.2	接入全局锁、移除 DoEvents/Wait、防并发增强
v3.1	优化套数模式分配算法
v3.0	新增按套数模式，区分住宅和商业

当前版本：v3.3 生产就绪版

🔧 调试技巧

在即时窗口（Ctrl+G）可获取：

各产品处理状态
套数模式分配明细
分期统计结果
错误定位信息

示例输出：

套数模式设置：
- 住宅月去化套数: 30
- 商业月去化套数: 10
添加产品: 行 137, 代码=住宅A, 类型=住宅, 户数=200, 月份偏移=0
产品 住宅A 在月份 1 的去化率: 15.00% (销售套数: 30, 总户数: 200, 剩余: 170)
所有按套数模式产品已完成销售分配，提前结束循环
销售去化计划处理完成：
- 总处理行数: 24
- 套数模式产品: 6