用途:维护 HSA「鞋盒」策略台账——用非 HSA 账户自付医疗账单、保存收据,让 HSA 免税增长,日后随时报销(只要费用发生在 HSA 开户之后,报销无时间限制)。技能负责记录、校验条目并给出未报销累计总额。
主要能力:支持两种模式。模式 A 添加单张收据,字段含 date、amount_cents、provider、description、receipt_path、paid_from_account_id、tx_id。模式 B 批量对账,扫描 category: health.* 的交易,对尚未入账的提出候选条目并请用户逐条确认。按 IRS Publication 502 校验合格类别(医疗、牙科、视力、心理健康、处方药、2020 年后 OTC 药品与经期产品、医疗设备、长期护理、针灸推拿、戒烟等),并标记不合格项(如健身房会员、美容、维生素、婚姻咨询、多数保险保费)。
工作流:校验收据日期晚于 HSA 开户日;映射合格类别;确认收据路径存在或标记 pending;确认由非 HSA 账户支付;生成 id(rcpt_<year>_<seq>)追加到 hsa.json.receipt_vault[];更新 unreimbursed_total_cents(仅统计 receipt_status=ok 且 reimbursed=false);对模糊资格、超一年旧收据、单笔超 1000 美元、疑似重复等发出警告。
限制:开户前费用不可免税报销;HSA 直接支付的收据不入台账;收据留存由用户负责,pending 条目不进入累计总额;台账只追加不修改,更正需用 correction_of;未报销总额是潜在额度,实际报销前不出现在税表上;技能不提议报销时机。OTC 与经期产品 2020 年后合格,不应惯性拒绝。