mcpField
V
venmo-reconciler

venmo-reconciler

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

关于 venmo-reconciler

venmo-reconciler 是一项财务技能,用于从 Venmo CSV 导出记录中区分个人转账和业务交易。它会标记需复核的条目、检查重复项,并将确认的业务交易导入 Open Accountant。

主要功能

  1. 01解析并验证 Venmo CSV 文件
  2. 02按状态和类型筛选交易
  3. 03将条目分类为个人、业务或待确认
  4. 04按 Venmo 交易 ID 去重
  5. 05导入已确认的业务交易

适用场景

  1. 01核对用于业务记账的 Venmo 付款
  2. 02导入交易前复核分类不明确的条目

MCP 相关

该技能使用 Wilson 工具搜索交易、分类条目、检测异常,并导出已核对的业务交易。

安装

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

$npx skills add https://github.com/openaccountant/skills --skill venmo-reconciler

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

详细介绍

Venmo 对账

概述

导入并对账 Venmo 交易导出数据,将个人转账与业务收入/支出区分开来。Venmo 将社交支付与业务交易混在同一条记录流中——此技能会对每笔交易进行分类,将有歧义的条目标记为待审核,并将与业务相关的交易导入 Open Accountant。

使用的 Wilson 工具

  • transaction_search — 检查重复项,并与银行导入数据交叉核对
  • categorize — 为 Venmo 交易分配业务类别
  • anomaly_detect — 标记在业务场景中看起来像个人交易的交易(反之亦然)
  • export_transactions — 导出已对账的业务交易

列映射

Venmo CSV 列Open Accountant 字段备注
IDreference_id用于去重的 Venmo 交易 ID
Datetimedate交易时间戳
Notedescription用户输入的付款备注
Fromdescription (prefix)付款人姓名
Todescription (prefix)收款人姓名
Amount (total)amount带正负号的金额(+ 为收到,- 为发出)
Status—仅导入 Complete 交易
Type—Payment、Charge、Transfer 等
Funding SourcenotesVenmo 余额、银行、银行卡

工作流

  1. 请用户提供 Venmo CSV 文件路径。
  2. 解析 CSV 并验证 Venmo 列标题。
  3. 按状态筛选:仅保留 Complete 交易。
  4. 按类型筛选:
    • 导入:Payment(为商品或服务收款/付款)
    • 导入:Charge(向他人开具账单并收到付款)
    • 跳过:Standard Transfer 和 Instant Transfer(银行转账,会出现在银行导入数据中)
  5. 将每笔交易分类为个人或业务交易:
    • 业务信号:备注包含“invoice”“payment for”、企业名称、服务描述等关键词,或金额超过 $100
    • 个人信号:备注中有表情符号、仅有名字、社交用语(如“谢谢晚餐”“分摊房租”)
    • 有歧义:标记为待人工审核
  6. 向用户展示分类结果以供确认:
    • 业务交易:使用适当的类别导入
    • 个人交易:跳过(或在用户需要完整记录时导入到“个人”类别)
    • 有歧义的交易:请用户逐一分类
  7. 使用 Venmo ID 与现有交易去重。
  8. 导入已确认的业务交易。

不使用 Wilson 时

手动对账 Venmo 交易:

从 Venmo 下载
  1. 登录 venmo.com(必须使用网页,而非应用)
  2. 前往 Statements(位于 Settings 下,或访问 venmo.com/account/statement)
  3. 选择日期范围(按月提供)
  4. 点击 Download CSV
  5. 其他方式:在 Venmo 应用中前往 Settings > Tax Documents,查看适用情况下的 1099-K(仅当金额超过 IRS 门槛时:2024 年及以后为 $5,000)
在电子表格中手动对账
  1. 打开 CSV。Venmo CSV 有一些特殊之处:
    • 前几行可能是元数据——删除这些行,使标题行成为第一行。
    • 金额可能采用 + $50.00 或 - $25.00 这样的格式,且带有空格。使用“查找和替换”清理:删除 $、+ 和空格,然后将此列转换为数字格式。
  2. 筛除转账:删除 Type 为 “Standard Transfer” 或 “Instant Transfer” 的行。
  3. 添加“Classification”列,并填写以下值:Business、Personal、Review。
  4. 按关键词搜索分类:
    =IF(OR(
      REGEXMATCH(Note,"(?i)invoice|payment for|consulting|freelance|order|service"),
      ABS(Amount)>100
    ), "Business",
    IF(OR(
      REGEXMATCH(Note,"(?i)dinner|lunch|drinks|rent|split|birthday|thanks"),
      LEN(Note)<10
    ), "Personal",
    "Review"))
    
  5. 人工审核:检查“Review”行并逐一分类。
  6. 业务汇总:
    Business Income:   =SUMIFS(Amount, Classification, "Business", Amount, ">0")
    Business Expenses: =ABS(SUMIFS(Amount, Classification, "Business", Amount, "<0"))
    
  7. 税务说明:如果 Venmo 业务收入超过每年 $5,000(2024 年门槛),Venmo 会签发 1099-K。你的记录应与此表格对账一致。
对账提示
  • 将 Venmo 转入银行账户的记录与银行对账单交叉核对。Venmo 中的“Standard Transfer”金额应与银行入账金额一致。
  • 如果你使用 Venmo for Business(独立的业务资料),这些交易已预先分类——请单独导出。

重要说明

  • Venmo 个人与商业交易的分类只是尽力而为的启发式判断。请务必检查结果。
  • Venmo 备注由用户自由填写,通常包含表情符号、玩笑或模糊描述。分类准确性取决于备注质量。
  • 2024 年及之后纳税年度,支付应用的 IRS 申报门槛为 $5,000。如果您通过 Venmo 收到的商业付款超过此门槛,您将收到 1099-K。
  • Venmo 的“Standard Transfer”转入银行账户需要 1-3 个工作日。“Instant Transfer”可即时到账,但需支付手续费。两者都不应作为收入导入——它们只是将资金转入您的银行账户。
  • 如果您同时使用 Venmo 个人资料和 Venmo for Business 资料,请分别导出和导入,以免混在一起。
  • Venmo CSV 文件只能通过网站下载,不能通过移动应用下载。

评论

支持 Markdown