券商文件导入

券商文件导入用于处理券商 App、交易软件或网页导出的成交记录、交割单、对账单等文件。它和 “导入/导出交易” 不同：标准导入/导出面向 WealthSight 自己的 Excel 或备份文件，券商文件导入面向外部原始流水。

最小目标是：

1
2
3
4
5
选择券商文件
  -> 生成并核对预览
  -> 补充缺失标的
  -> 确认导入
  -> 查看持仓或交易

无论使用哪种券商导入方式，系统都会先生成预览，确认无误后才会正式写入。

先选哪种方式

首次适配新文件：第一次导入某个券商格式，或不确定有没有现成规则时使用。
已有规则直接导入：已经保存过适合该券商格式的规则，或推荐规则可直接使用时使用。
插件导入：仅在已安装交易导入插件时显示，适合特殊文件格式或第三方扩展场景。

如果文件只是 WealthSight 导出的标准交易 Excel 或 .txt 备份，请使用交易管理页顶部的 “导入/导出”。

首次适配新文件

适合第一次处理某个券商导出的成交文件。

打开 “券商文件导入”，进入 “首次适配新文件”。
上传券商文件，点击 “生成规则草稿”。
核对关键字段：标的代码、交易类型、数量、金额、费用、币种、日期、唯一识别号。
如果字段识别不准，在候选列中重新选择；如果交易类型未识别，补充关键词后验证规则。
确认现金利息、融资利息、贷款或透支利息是否归为 “现金利息”，不要误当成入金、出金或分红。
确认金额口径。常见情况是 “成交金额 + 费用”，也可能是券商文件已经给出净结算金额。
调整规则后，点击底部 “验证规则”。验证通过后，“保存规则” 和 “下一步” 才会可用。
建议先点击 “保存规则”，保存为全局券商导入规则；保存不会自动进入下一步，后续相同格式可直接复用。
点击 “下一步”，选择交易平台，决定是否勾选 “导入时自动调整持仓”。
进入预览，确认新增、更新、异常记录和持仓影响。

规则草稿只是起点。导入前最重要的是确认金额、费用、交易类型和日期正确；如果这些字段不可靠，不建议继续导入。

已有规则直接导入

适合同一券商、同一导出格式的后续导入。

打开 “券商文件导入”，进入 “已有规则直接导入”。
选择券商导入规则，查看规则摘要中的适用文件类型、标题行和数据起始行。
选择交易平台并上传文件。
根据需要决定是否勾选 “导入时自动调整持仓”。
点击 “验证并预览”。
如果提示文件与规则不匹配，请重新选择文件、切换规则，或回到 “首次适配新文件” 重新生成并保存规则。
在预览中确认交易记录和持仓影响后执行导入。

已有规则适合格式稳定的文件。若券商改版导致列名、标题行或工作表变化，规则可能需要重新适配。

插件导入

插件导入是可选扩展入口。只有系统中存在交易导入插件时，“券商文件导入” 才会显示这个标签页。

普通券商 CSV、Excel 或 TXT 文件，建议优先使用 “首次适配新文件” 或 “已有规则直接导入”。

选择交易导入插件。
选择交易平台。
上传插件支持的文件。
根据需要决定是否勾选 “导入时自动调整持仓”。
点击 “验证并预览”。
在预览中核对交易类型、数量、金额、币种、日期和平台。

插件导入同样需要检查预览结果。插件能帮助解析特殊文件，但不能替代您确认交易含义是否正确。

预览时重点看什么

预览会把记录分为：

可新增：系统中还没有对应交易。
需更新：交易唯一编号已存在，但内容有变化。
无变化：系统中已经有相同记录。
异常：解析失败、字段不合法或缺少标的。

优先核对：

交易日期是否正确。
交易类型是否正确。
数量、金额、费用和币种是否符合券商文件含义。
平台名称是否符合预期。
入金、出金、分红、现金利息是否被正确识别。
是否存在异常记录。

异常记录不会直接写入。预览异常时不要强行确认导入。

缺失标的怎么处理

券商文件里出现账套中不存在的标的很常见，这不是导入失败。

如果预览提示缺失标的：

点击补充缺失标的入口，打开 “批量补充缺失标的”。
系统会把缺失代码带入批量新增标的窗口。
点击 “批量查找”。
核对匹配状态和候选标的。
可以先添加 “仅标的信息” 的标的。
批量添加完成后，系统会重新生成导入预览。

只有标的信息、没有报价或历史数据源的标的，也可以先添加。这样交易和持仓可以先建立，之后再到 标的管理 → 数据维护 → 数据源配置 补充报价和历史数据源。

如果某个代码匹配到多个候选，请根据名称、币种和来源选择正确标的；不确定时可以先取消该标的，避免把交易挂到错误标的上。

金额和费用

券商文件里的金额口径不完全一致。系统会优先识别明确的净结算金额，例如发生金额、清算金额；如果没有净结算金额，才会使用成交金额并结合费用列计算。

费用可以来自总费用列，也可以来自手续费、印花税、过户费、其他费等拆分费用列合计。首次适配时，“关键字段核对” 中的 “费用” 行会显示当前费用来源；如果规则按 “成交金额 + 费用” 计算但没有费用列，系统会提示需要确认。

如果同时存在净结算金额、成交金额和费用，系统会抽样做金额口径校验。校验提示不一定表示文件不能导入，但需要抽样核对买入、卖出金额是否符合券商文件含义。

自动调整持仓

勾选 “导入时自动调整持仓” 后，系统会在导入交易的同时调整对应持仓和现金余额，并在预览中显示影响。

大多数情况下建议保持勾选。这样导入完成后可以直接去 持仓管理 核对数量、平台、现金余额和价格状态。

如果券商文件只覆盖近几年交易，自动调整后的当前持仓可能和真实持仓不同。这不是导入失败；导入完成后先去 持仓管理，对照券商 App 或网页核对当前持仓和现金余额。已导入区间内的交易回溯和归因仍然可以使用。

补录较早的历史交易时，如果您已经把当前持仓修正到与券商一致，建议取消勾选，避免历史交易改写已修正的持仓基线；取消后，本次导入只写入交易记录，不会改变当前持仓。

导入完成后

导入完成页会显示新增、更新、跳过数量，并提示本次是否调整了持仓和现金。

如果导入时勾选了 “自动调整持仓”，点击 “查看持仓”，先对照券商当前持仓核对数量和现金余额；也可以运行 “检查持仓异常”，查看是否存在负持仓或交易与持仓不一致。
如果没有勾选，点击 “查看交易”，先检查刚导入的交易记录。当前持仓不会随这些交易变化。
需要继续处理其他文件时，点击 “继续导入”。

如果导入后持仓页提示 “缺价格” 或 “缺数据源”，先配置报价数据源；价格可用后，再查看持仓分布和回溯。

首次适配新文件导入完成后，可以选择 “保存为导入规则”，方便以后复用同类券商文件；不保存也不会影响本次已经导入的数据。

导入前建议

不确定文件格式时，先使用 “首次适配新文件”。
导入前先看预览，不要只看“可识别条数”。
重点核对金额、费用、交易类型、日期和平台。
现金利息收入用正数，融资、贷款或透支利息支出用负数；这类记录不应当作入金、出金或分红。
缺失标的可以在导入流程中批量补充，不必提前手工添加所有标的。
只有标的信息但暂无数据源的标的，可以先用于导入；后续再配置数据源。
券商改版后，如果同一规则突然识别异常，应重新适配规则。
导入成功后，按完成页入口检查交易或持仓结果。

反馈导入问题

如果需要反馈导入问题，请尽量提供：

券商名称。
文件类型。
文件导出入口。
使用的导入方式：首次适配、已有规则或插件导入。
卡住步骤：选文件、生成规则、验证规则、预览、补标的、确认导入、导入后核对。
错误截图或脱敏后的字段截图。

不要在公开场合上传原始交易文件、账户名、交易明细或资产金额。确需提供样例文件时，请先脱敏，并确认提交范围。

各券商文件导出指引

WealthSight 已为主流券商提供针对性的文件导出指引，导入前可先按券商查看文件获取方式：