Return of Title IV Funds Calculator (R2T4)

Calculate federal financial aid return obligations when a student withdraws per HEA Section 484B and 34 CFR 668.22. Handles all program types including modules, clock hours, and leave of absence.

原始信息汇总

数据集概述：Return of Title IV Funds Calculator (R2T4)

该API用于计算当学生从联邦财政援助资格院校退学时的Title IV基金返还义务，依据《高等教育法》第484B条和联邦法规34 CFR 668.22。

• 核心功能：根据学生在支付期内完成的时间百分比，确定已获得的联邦财政援助金额，计算必须返还给联邦项目的未获得部分，并在院校和学生之间分配责任，按强制法规顺序将资金返还给Title IV项目。
• 解决的问题：R2T4是高等教育财政援助中最易出错的计算之一。每次学生退学都需要进行联邦要求的计算。教育部项目审查会特别检查R2T4计算结果，错误会导致合规调查、需要向联邦政府偿还资金，甚至可能失去Title IV项目资质。该API返回完全可审计的R2T4计算，包含完整的推理过程、每个步骤的法规引用和明确的假设，适用于合规文档和项目审查辩护。
• 已验证：7/7 教育部测试用例已通过验证。

支持的项目类型

• 标准学分制项目 (credit_hour)
• 模块制项目 (module): 课程不横跨整个支付期的项目
• 学时制项目 (clock_hour): 职业和贸易学校项目，支持小数小时
• 休学 (leave of absence): 判定及其对R2T4义务的影响
• 退学后付款 (post-withdrawal disbursement): 分析

处理的边缘情况

• 从未出勤 (Never Attended): 要求100%立即返还
• 60%门槛 (60% threshold): 学生获得100%援助，无需返还
• 计划内休息 (Scheduled Breaks): 连续5天及以上的休息从分子和分母中排除
• 休学标准验证 (Leave of Absence criteria): 检查所有六项监管要求
• 模块入学判定 (Module enrollment): 判定学生是实际退学还是在模块之间
• 退学后付款资格 (Post-withdrawal disbursement eligibility): 标记院校可能仍欠学生的援助

完整的八步计算

1. 退学日期确定
2. 支付期与休息排除
3. 支付期完成百分比
4. 已获得的Title IV援助
5. 未获得的Title IV援助
6. 院校与学生责任分割
7. 按强制顺序返还Title IV项目
8. 返还截止日期

Title IV返还顺序（强制，依据34 CFR 668.22）

1. 联邦直接无补贴贷款
2. 联邦直接补贴贷款
3. 联邦直接PLUS贷款（研究生）
4. 联邦直接PLUS贷款（家长）
5. 联邦佩尔助学金
6. 伊拉克和阿富汗服务助学金
7. TEACH助学金
8. 联邦补充教育机会助学金

每次响应包含的内容

• 完整的八步计算分解，每步带有公式和法规引用
• 按项目的返还计划，包含金额和强制顺序依据
• 院校返还截止日期（自退学确定日起45天）
• 学生还款截止日期（120天）
• 假设数组：声明计算中使用的每个条件
• 警告数组：标记需要人工审查的边缘情况
• 退学后付款分析（当提供了未发放的援助时）

目标用户

• 学生信息系统（SIS）供应商
• 财政援助软件平台
• Ellucian Banner和Workday高等教育实施顾问
• 构建自动化退学处理工作流的财政援助办公室
• 高等教育合规平台
• 院校审计员和项目审查员

核心规则

• 从未出勤: 设置 never_attended: true，则100%的Title IV援助必须立即返还。
• 60%门槛: 学生必须完成严格超过60%的支付期才能获得100%的援助。恰好60.0000%时，完整计算继续进行。
• 计划内休息: 连续5天及以上的休息从分母中排除；仅当休息在退学日期当天或之前时，才从分子中排除。重叠的休息范围会自动合并。
• 确定日期: 45天院校返还截止日期自院校确定学生退学之日起计算，而非退学日期本身。
• 休学: API可验证六项监管标准中的五项（在计算时可供检查的标准）。第六项标准（学生是否按计划从休学返回）无法在计算时确定，会在响应中标记为一项待定的监控义务。
• 模块项目: 设置 is_module_program: true 并提供 modules 数组。分母调整为仅包含入学的模块天数。withdrawal_occurred_in_module: true 表示模块中期退学。
• 学时项目: 设置 program_type: clock_hour 并提供 clock_hours 输入。百分比使用计划学时而非日历天数计算。
• 返还顺序: 院校必须按34 CFR 668.22(i)(1)定义的强制顺序返还资金。贷款先于助学金。API返回完整的按强制顺序的返还计划。
• 截止日期: 院校自确定日起45天内返还其份额。学生有120天时间偿还其份额。
• 退学后付款: 提供 undisbursed_aid 以触发初步的PWD可能性筛选。结果仅为初步可能性，并非最终资格判定。

输入验证

API在计算前会捕获以下错误：

• 模块矛盾：student_completed 和 withdrawal_occurred_in_module 不能同时为真
• 模块日期反转：结束日期早于开始日期
• 休息日期反转：结束日期早于开始日期
• 学时数不可能：已完成学时数超过计划学时数
• 确定日期早于退学日期
• 退学日期在支付期之外

响应字段

每次响应包含：results_are_preliminary、calculation_steps、unit_type、分子和分母的休息天数计数、preliminary_pwd_possibilities、assumptions、warnings、notes。

监管依据

• HEA Section 484B
• 34 CFR 668.22
• FSA Handbook Volume 5

方法论自2000年稳定未变。采用十进制精度货币运算，联邦援助金额无二进制浮点误差。零外部依赖。确定性输出——相同输入始终返回相同结果。

API端点

方法	路径	描述
POST	/calculate	完整R2T4计算——支持所有项目类型
GET	/aid-programs	按强制返还顺序列出的Title IV项目
GET	/health	健康检查