跳到正文
Hacker News (official RSS)(github.com)·· 8 天前品質評分59

美國 IRS 公開 Direct File 報稅服務原始碼,供 Tax Year 2024 參考

US IRS free online tax filing open source repo (2025)

重點導讀

美國民眾可以透過 Direct File 免費線上申報聯邦所得稅,但州稅和地方稅仍要另外處理。

  • 這項由 IRS 團隊開發的服務,會把稅法轉成民眾能回答的問題,再將答案整理成標準稅表並送交 IRS。
  • 使用者也能選擇把聯邦報稅資料交給第三方工具,接著申報州稅或地方稅。公開的程式庫包含相關問題、判斷規則和測試案例,可供 Tax Year 2024 的美國稅務產品參考。程式庫已封存且不再維護,官方提醒其中可能有未修補或未知的安全漏洞,不應用於正式系統。

AI 伴隨問答

自備 Key 深度分析

針對這篇報導有疑問?可直接點選快捷問題或向 AI 追問背景脈絡與技術細節:

正文

Direct File is a service from the United States Government that provides taxpayers the option to electronically file their federal tax return for free, directly with the Internal Revenue Service (IRS). Direct File is an interview-based service that is intended to work as well on a mobile phone as it does on a laptop, tablet, or desktop computer. It is available in English and Spanish and is designed to be accessible to taxpayers who have a variety of attitudes, aptitudes, abilities, and access needs.

Direct File interprets the United States' Internal Revenue Code (26 USC) as plain language questions, the answers to which should be known to taxpayers without need of external instructions or publications. Taxpayers' answers are then translated into standard tax forms and transmitted to the IRS's Modernized e-File (MeF) API, which is available for authorized public use. These questions and logic, developed in close collaboration with the IRS Office of Chief Counsel, as well as the associated test cases and scenarios, may be useful for others working on products that need to accurately interpret United States tax law as of Tax Year 2024.

Direct File also incorporates the Fact Graph, a declarative, XML-based knowledge graph data structure that is designed to reason about incomplete information, such as a partially completed tax return. The Fact Graph is written in the Scala programming language; it runs on the JVM on the backend and is transpiled via Scala.js to run on the client as well. Direct File's Fact Graph is not domain-specific, and it may be useful to revenue agencies and as a reference for business rules engine implementations.

Although Direct File only files federal tax returns, United States taxpayers also have state and local filing obligations. Direct File facilitates the completion of these obligations by enabling taxpayers to optionally import their federal return data into a third-party tool that can file state and/or local taxes, without needing to reenter information. This transaction is enabled via a State API, which transfers both standard MeF XML as well as an enriched JSON format that includes additional data elements that were identified as being useful to state revenue agencies to streamline the state tax experience.

Direct File was developed by an in-house team of technologists at the IRS. The blended, cross-agency team included support from USDS and GSA, as well as vendor teams TrussWorks, Coforma, and ATI.

For a more details on the program and its history see https://www.irs.gov/pub/irs-pdf/p5969.pdf and https://www.irs.gov/filing/irs-direct-file-for-free

This repository has been archived and is no longer maintained. The code is provided for historical reference and may contain unpatched or unknown vulnerabilities. It should not be used in production systems.

Where do I start?

See ONBOARDING.md if you want to jump into running Direct File locally

Exempted Code

Not all source code, documentation and metadata used in the development of Direct File is included in this repository. Specifically, any code or data that is considered Personally Identifiable Information (PII), Federal Tax Information (FTI), Sensitive But Unclassified (SBU), or source code developed for National Security Systems (NSS), as defined in 40 U.S.C. § 11103, is exempt. Due to these restrictions, certain pieces of functionality have been removed or rewritten.

Authorities

Legal foundations for work include:

  • Source code Harmonization And Reuse in Information Technology Act" of 2024, Public Law 118 - 187
  • OMB Memorandum M-16-21, “Federal Source Code Policy: Achieving Efficiency, Transparency, and Innovation through Reusable and Open Source Software,” August 8, 2016
  • Federal Acquisition Regulation (FAR) Part 27 – Patents, Data, and Copyrights
  • Digital Government Strategy: “Digital Government: Building a 21st Century Platform to Better Serve the American People,” May 23, 2012
  • Federal Information Technology Acquisition Reform Act (FITARA), December 2014 (National Defense Authorization Act for Fiscal Year 2015, Title VIII, Subtitle D)
  • E-Government Act of 2002, Public Law 107-347
  • Clinger-Cohen Act of 1996, Public Law 104-106

讀者討論

理性交流 · 即時討論