华泰证券导入指南
WealthSight 已内置 华泰证券 的推荐导入规则。您只需选择对应的规则、上传券商导出文件， 即可验证并预览导入结果。导入前请务必检查预览结果， 确认交易类型、金额、费用、币种和日期没有明显异常后再写入账套。 不同终端的导出方式有所差异，请根据下方指引操作。
⚠️ 通用安全警告（必读）
- 日期限制：单次导出均最多支持 100天（闭市期间）历史数据， 若需更长周期请分批次导出。
- 无效记录过滤：系统会自动跳过“撤单”、“废单”、“取消”等记录，预览时若发现正常交易被跳过，请检查“业务名称”列是否包含这些关键词。
- 金额口径：系统默认使用“发生金额”（净额结算模式），该列通常已包含所有费用。也可切换为“成交金额 + 费用”模式（买入加费用，卖出减费用）。
- 异常处理：预览时请特别关注 异常 状态的记录。这些记录不会被导入，请确认它们是否属于需要处理的数据；若仅为券商导出时附带的无用信息，可忽略后继续导入。
按终端查看导出教程
请根据您使用的电脑操作系统和交易软件，选择下方对应的导出教程。
华泰证券高级版 Windows 终端
📁 导出操作步骤：
- 打开华泰证券高级版 Windows 终端并登录。
- 进入 「经典交易」 → 「查询」 → 「资金流水」 功能模块。
- 设置起始日期和终止日期（区间最多 100天（闭市期间）），币种建议选择“所有币种”。
- 点击 「查询」 加载数据，确认记录无误后点击 「输出」，选择 「输出到 Excel 表格」，保存文件。
📋 文件特征：
- 真实格式：披着 .xls 外衣的 TSV 文本文件（制表符分隔，编码
GB18030）。 - 关键字段识别：系统会自动从文件中识别“标的代码”、“交易日期”、“交易类型”、“数量”、“金额”、“费用”、“币种”等关键字段。
- 交易类型识别：系统会根据“业务名称”列中的关键词自动匹配
TradeType枚举（买入/卖出/分红/现金利息/入金/出金）。若出现未识别的关键词，预览时会标记为异常，您可手动添加关键词。 - 金额口径：系统默认使用“发生金额”（净额结算模式），该列已包含所有费用。也可切换为“成交金额 + 费用”模式，系统将读取“成交金额”并累加“手续费”、“印花税”、“过户费”、“其他费”等费用列。
- 去重机制：该导出文件无可用唯一标识列，系统会使用整行哈希值生成
TradeKey（唯一标识），避免重复导入。 - 币种：该文件包含 “币种”列，系统会自动识别并正确处理。
- 该终端通过 「资金流水」 导出，包含完整的出入金和交易记录，比交割单更全面。推荐优先使用此方式导入。
📄 系统字段 ↔ 文件列映射（点击展开）
| 系统字段 | 来源列名（文件） |
|---|---|
| 标的代码 | 证券代码 |
| 交易日期 | 发生日期 |
| 交易类型 | 业务名称 |
| 数量 | 成交数量 |
| 金额（总金额） | 发生金额 |
| 费用 | 手续费/印花税/过户费/其他费（累加） |
| 币种 | 币种 |
| 唯一标识（TradeKey） | （未识别到可用唯一标识列，使用整行哈希） |
华泰证券专业版Ⅲ Windows 终端
📁 导出操作步骤：
- 打开华泰证券专业版Ⅲ Windows 终端，点击右上角 「交易登录」 进入委托交易。
- 进入 「交割单」 查询页面。
- 设置起始日期和终止日期（区间最多 100天（闭市期间）），点击 「确定」 加载数据。
- 查询结果加载后，在表格区域内 右键点击，选择 「保存」，保存为
table.xls。
📋 文件特征：
- 真实格式：披着 .xls 外衣的 TSV 文本文件（制表符分隔，编码
GB18030）。 - 关键字段识别：系统会自动从文件中识别“标的代码”、“交易日期”、“交易类型”、“数量”、“金额”、“费用”等关键字段。
- 交易类型识别：系统会根据“业务名称”列中的关键词自动匹配
TradeType枚举（买入/卖出/分红/现金利息/入金/出金）。若出现未识别的关键词，预览时会标记为异常，您可手动添加关键词。 - 金额口径：系统默认使用“发生金额”（净额结算模式），该列已包含所有费用。也可切换为“成交金额 + 费用”模式，系统将读取“成交金额”并累加“手续费”、“印花税”、“过户费”、“其他杂费”等费用列。
- 去重机制：该导出文件无可用唯一标识列，系统会使用整行哈希值生成
TradeKey（唯一标识），避免重复导入。 - 币种：该文件 无“币种”列，系统默认所有交易为
CNY。
- 该导出文件 无“币种”列，系统默认所有交易为 CNY。如您的账户涉及非人民币交易，导入后请核对币种是否正确。
📄 系统字段 ↔ 文件列映射（点击展开）
| 系统字段 | 来源列名（文件） |
|---|---|
| 标的代码 | 证券代码 |
| 交易日期 | 成交日期 |
| 交易类型 | 业务名称 |
| 数量 | 成交数量 |
| 金额（总金额） | 发生金额 |
| 费用 | 手续费/印花税/过户费/其他杂费（累加） |
| 币种 | （无此列，默认 CNY） |
| 唯一标识（TradeKey） | （未识别到可用唯一标识列，使用整行哈希） |
在 WealthSight 中使用已有规则导入
华泰证券 的推荐规则已内置。您只需选择规则、上传文件，验证通过即可预览导入结果。 若文件与规则不匹配，系统会提示您切换到“首次适配新文件”。
导出文件
参考上方对应终端的指引，从券商软件中导出 .xls 或 .csv 文件。
选择规则并验证文件
在“已有规则直接导入”中选择 华泰证券 对应的推荐规则，上传文件后点击“验证并预览”。系统会自动识别文件中的交易记录。
预览导入结果
预览结果会显示 新增、更新、不变、异常 四类记录的数量。请特别关注异常记录，确认是否需要处理。
确认导入
预览中的异常记录若确认可以忽略，或已处理完毕，点击确认写入账套。若规则与文件明显不匹配，请切换到“首次适配新文件”重新生成规则。
✅ 导入前检查清单
⚠️ 规则验证失败怎么办？
如果验证后出现大量异常记录，或系统提示规则与文件不匹配，可能原因有：
- 券商更新了交易软件，导出的文件格式发生了变化
- 选择了其他券商或终端的规则
- 文件中存在当前规则未覆盖的特殊业务类型
此时请切换到 「首次适配新文件」，重新生成适配当前文件格式的规则，保存后即可继续使用。
导入前后高频 Q&A
导出的 .xls 文件用 Excel 打开显示为制表符分隔的文本，正常吗？ ▼
正常。 国内多数券商导出的 .xls 本质是 TSV（制表符分隔） 文本文件。Excel 和 WPS 都能自动识别并正确展示为表格形式，您也可以使用记事本打开查看原始内容，显示为制表符分隔的文本属于正常现象。
WealthSight 导入引擎会自动识别文件格式并正确解析，直接上传即可，无需任何转换。
预览时出现“异常”记录，怎么处理？ ▼
异常记录不会被导入。常见原因及解决办法：
- 未识别的交易类型：在“核对规则”步骤，将文件中对应的关键词添加到正确的交易类型（买入/卖出/分红等）关键词列表中，然后重新验证。
- 日期格式无法解析：检查文件中的日期列是否包含非标准格式，若仍异常，可手动调整规则中的日期格式列表。
- 关键字段为空：检查字段映射是否正确（如“标的代码”列是否选对）。
根据异常原因判断是否需要处理：若异常记录属于需要导入的关键数据，请按上述方式修正后重新验证；若仅为券商导出时附带的无用信息，可确认后直接忽略，继续导入流程。
为什么有些记录显示“更新”而不是“新增”？ ▼
系统通过 TradeKey（唯一标识）判断记录是否已存在。若文件中某条记录的 TradeKey 与账套中已有记录的 TradeKey 相同，则该记录会被标记为“更新”，并用新数据覆盖旧数据。
建议：导入前先查看“更新”记录的数量和具体内容，确认是否确实需要更新这些记录，避免意外覆盖。
TradeKey 的生成逻辑：系统会尝试从文件中识别可用的唯一标识字段，若候选字段不存在或不符合唯一性/长度校验标准，则自动退化为使用整行内容的哈希值。您也可以在规则编辑界面手动指定或调整 TradeKey 的字段来源。
“成交金额”和“发生金额”不一致，导入以哪个为准？ ▼
系统提供两种金额口径，您可以在“核对规则”步骤自由切换，预览结果会实时反映差异：
- 净结算金额：直接使用文件中的“发生金额”列，此列通常已是净额（已包含费用）。推荐选择此模式，适用于大多数券商导出文件。
- 成交金额 + 费用：系统会读取“成交金额”和各项费用列，按“买入加费用，卖出减费用”计算。适用于“发生金额”不存在或不可靠的情况。
只能导出有限时间范围的数据，想导入更久的历史怎么办？ ▼
大多数券商终端限制单次查询最大跨度为 1 年（部分为 3 个月）。若您需要导入更长时间的数据，请按年度或半年度分多次导出。
分批次导入时，系统会根据 TradeKey 自动去重，不会产生重复记录，您可以放心多次导入。
“自动调整持仓”开关是什么意思？应该开启吗？ ▼
在“导入设置”步骤，您可以选择是否开启 「导入时自动调整持仓」。
- 开启（推荐）：系统会根据导入的交易记录自动更新账套中的持仓数量和现金持仓。这是最常用的方式。
- 关闭：仅将交易记录写入账套，但不调整持仓和现金。适用于您只想记录交易流水，或打算手动调整持仓的场景。
建议保持开启，除非有特殊需求。
保存规则后，在哪里可以复用？ ▼
在“核对规则”或“完成”步骤，您可以点击 「保存规则」，将当前适配好的规则保存为全局券商导入规则。
保存后，下次导入相同格式的文件时，您可以直接在“已有规则直接导入”中选择该规则，无需重新适配，大大提升效率。
规则保存在用户级别，不随账套切换而丢失。
导入后发现重复记录，如何清理？ ▼
正常情况下，系统通过 TradeKey 去重，重复导入同一文件会被自动跳过（预览显示为“不变”）。
如果出现重复记录，通常是因为：
- 手动修改过导出的原始文件（如调整了日期格式），导致哈希值变化（对于无可用唯一标识列的文件）。
- 分批导入时，部分文件的时间区间重叠且可用唯一标识列缺失。
解决方案：建议先手动删除账套内的重复交易记录，或通过“数据清理”功能按时间范围删除后重新导入。
导入后如何验证数据是否正确？ ▼
建议按以下步骤验证：
- 对比账套中的持仓数量和现金余额，是否与券商软件中的实际持仓数据一致。
- 检查交易记录总数是否等于预览时的“新增 + 更新”数量。
- 若发现金额偏差，优先检查费用列是否被正确累加，或金额口径是否选错。
- 随机抽样几笔交易，核对标的代码、数量、单价是否与原始文件一致。
文件中有撤单/废单记录，会影响导入吗？ ▼
系统会自动过滤“撤单”、“废单”、“取消”等无效记录，它们不会进入账套，预览时会被标记为“跳过”。
如果您发现某笔正常交易也被跳过，请检查文件中的交易类型列是否意外包含了上述关键词（例如“买入撤单”），此时需要手动调整关键词列表或修正文件。
券商更新了交易软件，导出的文件格式变了怎么办？ ▼
如果文件列名、列顺序或格式发生变化，已有的导入规则可能无法正确解析。建议：
- 使用“首次适配新文件”功能重新生成规则草稿。
- 如果变化较大，请通过页面底部的反馈按钮联系我们，我们会尽快更新内置规则。
建议在券商软件更新后，先用少量数据测试导入，确认无误后再批量导入。
专业版Ⅲ和高级版有什么区别？应该用哪个导入？ ▼
华泰证券提供了两款 Windows 交易终端，导出文件的覆盖范围不同：
- 专业版Ⅲ（交割单）：仅包含证券交易记录，不包含出入金记录。文件无“币种”列，系统默认所有交易为 CNY。
- 高级版（资金流水）：包含完整的交易记录 + 出入金记录，推荐优先使用。文件包含“币种”列，系统会自动识别处理。
两款终端导出的文件均无可用唯一标识列，系统统一使用整行哈希值生成 TradeKey 用于去重。