mcpField
W
wise-import

wise-import

github.com/openaccountant数据与数据库103385 次安装29 周前更新
代码仓库

关于 wise-import

wise-import 是将 Wise CSV 对账单导入 Open Accountant 的技能,支持多币种、单独记录兑换手续费,并按转账 ID 检查重复交易。

主要功能

  1. 01解析并验证 Wise CSV 表头
  2. 02按币种导入交易
  3. 03单独记录兑换手续费
  4. 04按转账 ID 去重
  5. 05预览收入、支出、手续费和净额

适用场景

  1. 01将 Wise 对账单导入 Open Accountant
  2. 02核对多个币种账户间的转账
  3. 03区分转账与兑换手续费

MCP 相关

该技能使用 Wilson 工具搜索现有交易、为导入交易分类,并导出已核对的 Wise 数据。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/openaccountant/skills --skill wise-import

安装后在 Claude Code 中输入/wise-import确认已加载。

详细介绍

Wise 导入

概述

从 Wise(原 TransferWise)CSV 对账单导出文件中导入交易数据。支持多币种账户、兑换手续费和国际转账。将 Wise 以转账为中心的格式映射为 Open Accountant 交易。

使用的 Wilson 工具

  • transaction_search — 检查是否存在 Wise 交易,以避免重复
  • categorize — 为导入的 Wise 交易分配类别
  • export_transactions — 导出已对账的 Wise 数据

列映射

Wise CSV 列Open Accountant 字段备注
TransferWise ID 或 IDreference_id用于去重的唯一转账 ID
Datedate完成日期
Descriptiondescription转账说明 / 收款人
Amountamount交易金额(带正负号)
Currencycurrency来源货币的 ISO 代码
Running Balance—不存储
Exchange Ratenotes存储在备注中以供参考
Total feesamount(单独一行)Wise 手续费(负数表示支出)

工作流

  1. 询问用户 Wise CSV 文件路径,以及要导入哪些币种账户。
  2. 解析 CSV 并验证 Wise 列标题。
  3. 处理每一行:
    • 转入款项:金额为正数,类别为“收入:转账”
    • 转出款项:金额为负数,根据说明分配类别
    • 兑换手续费:单独记录为负数,类别为“手续费:货币兑换”
    • 银行卡付款:金额为负数,按商户分类
  4. 对于多币种转账:
    • 以来源货币记录交易
    • 在备注中保存汇率和目标金额
    • 单独创建手续费记录(Wise 收取的兑换手续费不同于汇率)
  5. 使用 Wise 转账 ID 去重。
  6. 按币种预览导入摘要:流入、流出、手续费和净额。
  7. 插入交易并确认。

不使用 Wilson

手动处理 Wise 导出文件:

从 Wise 下载
  1. 登录 wise.com
  2. 点击相关币种账户(例如 USD、EUR、GBP)
  3. 前往 对账单(右侧或账户菜单下)
  4. 选择日期范围
  5. 选择 CSV 格式(也提供 PDF、XLSX)
  6. 点击 下载
  7. 对要导入的每个币种账户重复上述步骤
在电子表格中手动处理
  1. 在 Google Sheets 或 Excel 中打开 CSV。
  2. 根据说明和金额正负号识别交易类型:
    • 正数金额 = 收到款项(收入、转入款项)
    • 负数金额 = 支付款项(支出、转出款项、银行卡付款)
  3. 分离手续费:Wise 会将手续费包含在某些行中。查找说明中带有“fee”的行,或说明中提及关联转账的行。
    • 某些 Wise CSV 含有 Total fees 列,可直接使用。
    • 如果没有,手续费会作为单独的行显示,说明类似“Conversion fee”或“Transfer fee”。
  4. 多币种处理:
    • 如果有多个币种账户,请将它们放在不同工作表中,或添加“Currency”筛选器。
    • 请勿在兑换前对不同币种的金额求和。
    • 兑换方式:=Amount * ExchangeRate(使用 Wise 对账单中的汇率,而非实时汇率)。
  5. 汇总公式(按币种):
    Total Inflows:     =SUMIFS(Amount, Amount, ">0", Currency, "USD")
    Total Outflows:    =ABS(SUMIFS(Amount, Amount, "<0", Currency, "USD"))
    Total Fees:        =ABS(SUMIFS(TotalFees, Currency, "USD"))
    Net:               =Inflows - Outflows
    
  6. 对账:最后一行的滚动余额应与 Wise 账户余额一致。
替代方案:Wise API

对于开发者,Wise 提供公开 API api.transferwise.com,可通过编程方式获取对账单。需要在 Wise 企业账户设置中获取 API 密钥。

重要说明

  • Wise 的 CSV 格式在个人账户和企业账户之间略有差异。企业账户包含 Batch ID 和 Reference 等额外列。
  • 多币种:每个币种账户都会单独导出。如果你将 USD 兑换成 EUR,借记会显示在 USD 对账单中,贷记则显示在 EUR 对账单中。
  • Wise 的手续费通常低于传统银行(根据交易路径,费率为 0.3-2%),但会作为单独的明细项显示,不会计入汇率。
  • “Balance cashback”行是 Wise 支付的少量利息,请将其导入为“In­come:Interest”。
  • Wise 卡交易可能会显示临时商户描述,结算后会更新。如果你提前导入,描述可能会发生变化。

评论

支持 Markdown