返回资讯中心
外部精选
软件工程
#社区热议

美国国税局开源免费在线报税工具 Direct File 代码库

来源标题:US IRS free online tax filing open source repo (2025)

美国国税局将其免费在线报税服务 Direct File 的代码开源,相关代码库已公开。该服务让纳税人可直接向 IRS 免费电子申报联邦税,支持英文和西班牙文,并适配手机、平板和电脑。开源内容包含将税法条文转化为通俗问答的逻辑及相关测试用例,适用于 2024 纳税年度。

Hacker Newsaccountinhn2026/11/14 · 3 天前8 分钟阅读

以下正文由 AI 翻译自 Hacker News(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

Direct File 是美国政府推出的一项服务,让纳税人可以选择直接向美国国税局(IRS)免费电子申报联邦税表。Direct File 是一项基于问答的服务,设计目标是在手机上的使用体验与笔记本电脑、平板电脑或台式机同样出色。它提供英语和西班牙语版本,并且力求让态度、能力、技能水平和访问需求各不相同的纳税人都能顺利使用。

Direct File 将美国《国内税收法典》(26 USC)解读为通俗语言问题,纳税人无需借助外部说明或出版物即可作答。纳税人的回答随后会被转换为标准税表,并传输至 IRS 的 Modernized e-File(MeF)API,该 API 已面向获授权的公众开放使用。这些问题和逻辑是与 IRS 首席法律顾问办公室密切合作开发的,相关的测试用例和场景对于其他需要准确解读 2024 纳税年度美国税法的产品开发者可能也会有用。

Direct File 还集成了 Fact Graph,这是一种声明式的、基于 XML 的知识图谱数据结构,专为对不完整信息(例如填写到一半的税表)进行推理而设计。Fact Graph 使用 Scala 编程语言编写;它在后端运行于 JVM,并通过 Scala.js 转译后也能在客户端运行。Direct File 的 Fact Graph 并非领域专用,对税务机构可能有参考价值,也可作为业务规则引擎实现的参考。

尽管 Direct File 只处理联邦税表申报,美国纳税人还负有州和地方层面的申报义务。Direct File 通过允许纳税人选择性地将联邦申报数据导入可申报州税和/或地方税的第三方工具(无需重新录入信息)来帮助纳税人完成这些义务。这一交互通过 State API 实现,该 API 同时传输标准 MeF XML 以及一种增强的 JSON 格式,后者包含一些额外的数据元素——这些元素被认为有助于州税务机构简化州税申报体验。

Direct File 由 IRS 内部的技术团队开发。这支跨机构混合团队得到了 USDS 和 GSA 的支持,以及供应商团队 TrussWorks、Coforma 和 ATI 的协助。

有关该计划及其历史的更多细节,请参见 https://www.irs.gov/pub/irs-pdf/p5969.pdf 和 https://www.irs.gov/filing/irs-direct-file-for-free

本仓库已归档,不再维护。代码仅供历史参考,可能包含未修复或未知的漏洞,不应在生产系统中使用。

如果你想在本地运行 Direct File,请参阅 ONBOARDING.md

Direct File 开发过程中使用的源代码、文档和元数据并非全部包含在本仓库中。具体而言,任何被视为个人身份信息(PII)、联邦税务信息(FTI)、敏感但非机密(SBU)的代码或数据,以及依据 40 U.S.C. § 11103 定义为国家安全系统(NSS)开发的源代码,均不在收录范围内。由于这些限制,某些功能已被移除或重写。

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →