使用指南

数据预检与异常处理

上传 CSV 后 TaxAlpha 会执行 FIFO 试算,检测未匹配交易。本文讲解未匹配交易的成因和补填历史持仓数量、平均成本的正确方法。

数据预检是正式计算前的关键步骤。系统会自动检测数据完整性,并引导你修复异常。

什么是数据预检?

上传 CSV 文件后,系统会进行一次试算(Dry-run):按 FIFO 规则模拟匹配所有买卖订单,但不做汇率转换。

试算的目的是检测:是否所有卖出都能找到对应的买入记录?

如果一切正常,你可以直接进入计算。如果发现问题,系统会提示你处理。

常见异常:未匹配交易

什么是未匹配交易?

当系统发现某笔卖出找不到足够的买入记录时,就会标记为「未匹配交易」。

最常见的原因:

原因说明解决方式
历史订单不完整导出的 CSV 不包含最早的买入记录导出更完整的历史订单,或手动补填
多账户分散买入在 A 账户,卖出在 B 账户(转仓)确保所有相关账户的文件都已上传
券商数据遗漏极早期交易未被券商系统记录手动补填

如何补填历史持仓

当出现未匹配交易时,预检页面会显示一个列表,列出每个有缺口的标的(ticker)。

对于每个标的,你需要填写:

  • 开仓数量(openQty):缺失的历史持仓数量
  • 平均成本(avgCost):这些持仓的平均买入价格(原币)

提示:你可以在券商 App 中查看该标的的「持仓成本」来计算平均成本参考值。不需要精确到每一笔历史买入,填写合理的加权平均值即可。

补填后会发生什么?

系统会将你补填的数据作为「虚拟买入」注入计算。这样,后续的卖出就能找到对应的买入进行匹配。

补填完所有异常项后,「计算盈亏」按钮会变为可点击状态,你就可以进入正式计算了。

注意事项

  • 补填的数据会直接影响计算结果(成本基准和盈亏金额),请尽量填写准确
  • 系统只要求你补填有实际卖出的标的,无交易的历史持仓不需要补填
  • 如果后续找到了更完整的历史订单文件,可以重新上传并重新计算

延伸阅读