国泰海通证券交易记录(交割单)导出与导入指南
WealthSight 已内置 国泰海通证券 的推荐导入规则。您只需选择对应的规则、上传券商导出文件, 即可验证并预览导入结果。导入前请务必检查预览结果, 确认交易类型、金额、费用、币种和日期没有明显异常后再写入账套。 不同终端的导出方式有所差异,请根据下方指引操作。
⚠️ 通用安全警告(必读)
- 日期限制:单次导出均最多支持 1 年历史数据, 若需更长周期请分批次导出。
- 无效记录过滤:系统会自动跳过“撤单”、“废单”、“取消”等记录,预览时若发现正常交易被跳过,请检查“交易类别”或“操作”列是否包含这些关键词。
- 金额口径:系统默认使用“资金发生数”(净额结算模式),该列通常已包含所有费用。也可切换为“成交金额 + 费用”模式(买入加费用,卖出减费用)。
- 异常处理:预览时请特别关注 异常 状态的记录。这些记录不会被导入,请确认它们是否属于需要处理的数据;若仅为券商导出时附带的无用信息,可忽略后继续导入。
按终端查看导出教程
请根据您使用的电脑操作系统和交易软件,选择下方对应的导出教程。
国泰海通富易 Windows 终端
📁 导出操作步骤:
- 打开国泰海通富易 Windows 终端并登录账户。
- 切换至 「极简版」 模式。
- 进入 「历史查询」 → 「交割单」 功能模块。
- 设置起始日期和终止日期(区间最多 1 年),点击 「查询」。
- 查询结果加载后,点击 「导出」,保存
.xlsx文件。
📋 文件特征:
- 真实格式:标准
Excel (.xlsx)文件。 - 关键字段识别:系统会自动从文件中识别“标的代码”、“交易日期”、“交易类型”、“数量”、“金额”、“费用”、“币种”等关键字段。
- 交易类型识别:系统会根据“交易类别”列中的关键词自动匹配
TradeType枚举(买入/卖出/分红/现金利息/入金/出金)。若出现未识别的关键词,预览时会标记为异常,您可手动添加关键词。 - 金额口径:系统默认使用“资金发生数”(净额结算模式),该列已包含所有费用。也可切换为“成交金额 + 费用”模式,系统将读取“成交金额”和“费用合计”列进行计算。
- 去重机制:该导出文件无可用唯一标识列,系统会使用整行哈希值生成
TradeKey(唯一标识),避免重复导入。

- 富易导出的
.xlsx文件表头从第 6 行开始,格式较为特殊。若预览时出现字段错位或大量异常记录,请切换到 「首次适配新文件」 重新生成规则。
📄 系统字段 ↔ 文件列映射(点击展开)
| 系统字段 | 来源列名(文件) |
|---|---|
| 标的代码 | 证券代码 |
| 交易日期 | 交收日期 |
| 交易类型 | 交易类别 |
| 数量 | 成交数量 |
| 金额(总金额) | 资金发生数 |
| 费用 | 费用合计 |
| 币种 | 币种 |
| 唯一标识(TradeKey) | (未识别到可用唯一标识列,使用整行哈希) |
同花顺免费 Windows 终端(委托交易)
📁 导出操作步骤:
- 打开同花顺免费 PC 版,点击 「委托交易」 图标,登录国泰海通账户。
- 进入 「交割单」 查询页面,筛选日期范围(最长 1 年)。
- 查询结果加载后,在表格区域内 右键点击,选择 「保存」 或 「导出数据」,保存为
table.xls。
📋 文件特征:
- 真实格式:披着 .xls 外衣的 TSV 文本文件(制表符分隔,编码
GB18030)。 - 关键字段识别:系统会自动从文件中识别“标的代码”、“交易日期”、“交易类型”、“数量”、“金额”、“费用”、“币种”、“唯一标识(TradeKey)”等关键字段。
- 交易类型识别:系统使用 「操作」 列(而非“交易类别”)匹配
TradeType。 - 去重机制:推荐使用“成交编号”作为
TradeKey,该列通常唯一。 - 费用处理:支持“手续费”、“印花税”、“其他杂费”的拆分累加。
- 币种:系统自动识别文件中的“币种”列,支持多币种交易。

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