教程 ↗

美国税务软件实测:UsTaxes 与 OpenTaxSolver 的 CSV 导入和导出

用同一组合成股票交易测试两款免费税务软件,核对交易配对、200 美元收益、CSV/JSON/PDF 输出,以及错误输入的处理边界。

同一组合成交易,在 UsTaxes 中使用买卖记录,在 OpenTaxSolver 中使用出售批次,最终核对 200 美元收益

一份股票交易 CSV 能否直接放进税务软件,首先取决于它记录的是什么。我用两笔合成交易测试了免费工具 UsTaxes 和 OpenTaxSolver:买入 10 股,每股 100 美元;随后全部卖出,每股 120 美元,手续费为零。两条路线都得到 1,000 美元成本、1,200 美元出售收入和 200 美元短期收益,但需要的输入文件不同。

UsTaxes 接收买入、卖出两行,再构建投资组合。OpenTaxSolver 的 Form 8949 导入器接收已经配好的出售批次,行里直接给出买入日期、出售日期、收入和成本。这个区别比“支持 CSV”更能帮助选择工作流。

这次使用 UsTaxes 公开网站的税年 2025 界面,以及 OpenTaxSolver 的税年 2025、23.07 MacM 下载包。后者的 US 1040 模块启动时显示 v23.06。范围是导入、检查和本地导出;材料全为自建合成数据,没有实际申报。UsTaxes 测到资产 CSV、JSON 备份和重新载入;OpenTaxSolver 测到计算报告和 PDF。

先准备两种含义不同的 CSV

原始交易文件 trades.csv 保留买卖动作、单价和数量:

asset,date,side,price,quantity,fee
DEMO-STOCK,2025-01-02,buy,100,10,0
DEMO-STOCK,2025-03-03,sell,120,10,0

两笔交易没有部分出售、多次买入、手续费或调整项,配对可以直接核算:成本 10 × 100 = 1000,收入 10 × 120 = 1200,收益 1200 − 1000 = 200。持有时间从 1 月 2 日到 3 月 3 日。

OpenTaxSolver 的 closed-lot.csv 把这两行整理成一笔出售记录:

Description,Date_Acquired,Date_Sold,Proceeds,Cost,Code,Adjustment
10 DEMO-STOCK,1/2/2025,3/3/2025,1200,1000,,

这里只合并了唯一的一买一卖。多批次买入、部分出售或洗售调整需要额外的批次依据,这个样本没有验证这些情况。文件格式参照下载包里的 example_f8949_spreadsheet.csv 和空白 US 1040 模板,功能出处可从官方当前税年下载页核对。

下载原始交易 CSV · 下载已配对出售 CSV

UsTaxes:先映射列,再核对组合

在 UsTaxes 选择 Start Return in Browser,确认页面上方的税年为 2025,进入 Income → Other investments。这个页面的 Load CSV File 接收交易文件,不需要先完成个人身份表单。

导入 trades.csv 后,表头不会自动成为税务字段。按原始列顺序把六列映射为 Asset Name、Transaction date、Buy or Sell、Price per unit、Quantity、Fee / commissions,并把 Drop first n rows 设成 1,跳过表头。缺少必需字段时,界面会列出仍需分配的字段。

点击 Build Portfolio 后,会出现配对后的 Portfolio;此时还需点击 Add Sales and Assets,才把结果加入资产列表。随后 Summary of sales in 2025 显示短期成本 $1,000、出售收入 $1,200、收益 $200。这两个按钮承担不同阶段:前一个便于检查配对,后一个保存到当前数据。

UsTaxes 的英文界面显示 2025 年出售汇总:成本 1000、收入 1200、短期收益 200,并提供资产导出按钮

UsTaxes 的出售汇总与合成样本逐项一致。

两种导出保留的信息不同

资产列表的 Export 1 Assets 导出了 CSV。文件含 Security、Quantity、Open Date、Open Price、Cost basis、Close Date、Proceeds、Gain / Loss 等列,这次对应值为 10 股、1000、1200、200。它适合拿到表格里继续核对。

User Settings → Save data to file 则导出 JSON 备份。实际文件包含资产的开平仓日期、单价、数量、费用和税年状态;这次身份、工资等记录都为空。我通过同一设置页的 Load 重新载入这份文件,再进入 Other investments,汇总仍为 $200。界面提示 Load 会覆盖当前数据,实际使用前应先保存当前工作。

UsTaxes 的英文设置页提供保存数据文件和载入备份,载入处明确提示会覆盖当前状态

资产 CSV 用于查看出售记录,JSON 用于恢复这款应用的数据。

查看实际资产 CSV · 查看合成 JSON 备份

这些输出格式也说明了跨软件交接的工作量:UsTaxes 导出资产 CSV 的列名和排列,与 OpenTaxSolver 要求的七列并不一致。这次把唯一一笔出售整理成了上面的 closed-lot.csv,没有验证任意备份文件之间的自动迁移。

OpenTaxSolver:输入模板连接出售 CSV

OpenTaxSolver 的本地命令行模块可读取 US 1040 文本模板。测试保留空白身份字段,设 Status Single、工资 L1a 50000 ;、联邦预扣 L25a 6000 ;,并在 f8949_spreadsheet-A/D: 后填写 closed-lot.csv。A/D 在模板中表示成本已报给 IRS 的类别;这里只是合成测试的分类假设。

输入文本和 CSV 放在同一工作目录,然后从该目录运行包内程序:

# OTS_DIR 指向解压后的软件目录
"$OTS_DIR/bin/taxsolve_US_1040_2025" ots-input.txt

程序生成 ots-input_out.txt。报告的 Form 8949 表格列出 1200 收入、1000 成本、200 收益,Schedule D 的 D7 和 1040 的 L7a 也为 200。带上工资后,报告显示调整后总收入 50,200、标准扣除 15,750、应税收入 34,450;它计算的税额为 3,899,过付款为 2,101。这些是该输入下的软件结果,UsTaxes 路线没有填写完整身份和工资表,因此本次没有做最终税额的交叉验证。

下载包还提供 PDF 生成器。按其源码给出的参数顺序,以同一报告和包内模板生成 PDF:

"$OTS_DIR/bin/universal_pdf_file_modifier" \
  "$OTS_DIR/src/formdata/f1040_meta.dat" \
  ots-input_out.txt \
  "$OTS_DIR/src/formdata/f1040_pdf.dat"

这次得到 14 页 new.pdf,包括程序显示供参考的附表。重新读取 PDF 并查看第 14 页的 Form 8949,合成名称、日期、1200、1000、200 均落在对应栏位,身份栏保持空白。计算过程还打印了 UNEXPECTED LABEL 'Round_PDF_to_Whole_Dollars';这是包内空白模板末尾字段触发的警告,本文保留原始报告供复核。

OpenTaxSolver 实际生成的英文 Form 8949,合成 DEMO-STOCK 出售记录显示收入 1200、成本 1000 和收益 200,身份栏为空

实际导出 PDF 的 Form 8949 页;样本未填写身份资料。打开原尺寸图片可放大检查栏位。

下载合成输入模板 · 查看实际文本报告 · 下载实际生成的 PDF

错误输入会在哪里停下来

我分别保留了缺买入、非数字数量、错误表头和非数字出售收入的文件或日志。

输入问题实际观察检查方法
UsTaxes 只给卖出行Transaction List Import Failed,指出卖出数量超过持有量,提示补上早期买入或检查尚未支持的卖空回到交易来源补齐买入历史
UsTaxes 数量写成 oopsCould not parse quantity value (oops) as number修改数量后重新构建组合
OTS 用原始交易 CSV 代替出售 CSV报表头不符合预期,但命令退出码为 0,报告仍生成搜索报告里的 ERROR,核对 8949 行和 D7
OTS 从另一个目录运行,相对 CSV 路径找不到文件报无法读取文件,退出码仍为 0;此次报告缺少 200 收益从正确工作目录执行,或填写准确路径
OTS 的 Proceeds 写成 oops报 Bad float,退出码为 1核对出售收入列的数值

OpenTaxSolver 的两个退出码为 0 的失败,是批处理时最容易漏掉的地方。成功报告和失败报告都可能存在;应把“CSV 已读取”“8949 出现预期出售”“D7 等于样本收益”作为一起检查的条件。

按手上的资料和需要的产物选择

读者任务这次更直接的路线仍需核对
手上是按时间排列的买入、卖出交易UsTaxes 映射列、构建组合,再导出资产 CSV多批次、费用、洗售和缺失历史,本次未测
手上已有出售批次和成本依据OTS 的 8949 CSV 加 US 1040 模板分类、调整项和实际税务资料的适用条件
想在 UsTaxes 里备份并继续编辑JSON 保存后用 Load 读回保存当前工作,避免覆盖现有状态
需要本地计算报告和 PDFOTS 的计算模块与 PDF 生成器每张表的数值、遗漏字段与打印效果

UsTaxes 项目说明描述了浏览器计算和本地存储方式;这次核对的是产品的导入、导出与重新载入,没有进行全面网络或隐私审计。州税、复杂投资规则、电子申报、支付及商业产品导入能力均未测试。

对这组资料,选择从文件的含义开始:两笔买卖走交易配对,一笔已配好的出售走 8949 导入。再用导出文件核对日期、成本、收入和收益,能把“支持导入”落实为可检查的工作流程。其他数字工具实测可从工具评测分类继续阅读。

← 返回列表