股票交易税务计算工具

这是一个专为中国海外投资设计的税务计算工具，用于解析富途证券的交易数据并自动计算资本利得税。

功能特性

• FIFO 成本匹配算法：使用先进先出（First In, First Out）方法准确匹配买卖成本
• 年度税务结算：支持按年度计算税务，正负收益自动抵消
• 资本利得税计算：按照中国个人所得税法中"财产转让所得"适用的 20% 税率计算
• 多货币支持：支持多种货币的交易记录
• 详细报告输出：生成税务汇总报告和清仓交易明细

安装

环境要求

• Python 3.8+
• pip 或 uv 包管理器

安装依赖

# 使用 uv（推荐）
uv sync

使用方法

1. 准备数据文件

将富途证券导出的交易流水文件放置在 data/ 目录下：

• 文件格式：仅支持富途证券的 Excel (.xlsx) 文件
• 文件命名：建议使用 *_年度账单_*.xlsx 格式，例如 2023_年度账单_富途.xlsx
• Sheet 名称：必须包含名为 "证券-交易流水" 的工作表

data/
├── 2023_年度账单_富途.xlsx
├── 2024_年度账单_富途.xlsx
└── ...

2. 运行计算

使用 Jupyter Notebook（推荐）

打开 tax_tool.ipynb 并按顺序运行单元格：

1. 解析所有年度交易文件
2. 计算各年度税务
3. 查看详细报告

使用 Python 脚本

from xlsx_parser import parse_all_yearly_files
from tax_calculator import calculate_tax_for_year

# 解析所有交易记录
all_transactions = parse_all_yearly_files('data')

# 计算指定年度税务
tax_year = 2024
report = calculate_tax_for_year(all_transactions, tax_year)
print(report)

3. 查看输出

程序会生成以下文件：

• all_transactions_sequence.csv：完整交易序列
• clearing_trades_{year}.csv：各年度清仓交易明细
• 控制台输出：年度税务汇总报告

文件格式要求

目前仅支持富途证券导出的交易流水 Excel 文件，包含以下列：

• 成交时间
• 账户名称
• 账户号码
• 品类
• 代码名称
• 交易所/市场
• 方向（买入开仓/卖出平仓等）
• 交收日期
• 币种
• 数量/面值
• 价格
• 成交金额
• 总费用
• 变动金额

注意事项

• 完整历史数据：必须提供所有历史交易记录，才能准确计算 FIFO 成本匹配
• 年度覆盖：程序会自动识别交易数据的年度范围
• 费用扣除：税务计算中会自动扣除交易费用
• 货币汇总：报告按货币类型分别汇总

免责声明

本工具基于中国税务法规实现税务计算，旨在帮助用户更好地理解自己的税务义务。计算结果仅供参考，正确性基本保证，但不负法律责任。最终税务申报请以专业税务顾问或官方税务机构的建议为准。