paypal-import

PayPal 导入

概览

从 PayPal CSV 导出文件导入交易数据。支持收到的付款、手续费、退款和货币兑换。PayPal CSV 包含多种交易类型——此技能会筛选出具有财务意义的条目，并将其映射为 Open Accountant 的格式。

使用的 Wilson 工具

• transaction_search — 检查是否与现有交易重复
• categorize — 为导入的 PayPal 交易分配类别
• export_transactions — 导出已对账的 PayPal 数据

列映射

PayPal CSV 列	Open Accountant 字段	说明
Date	date	交易日期（MM/DD/YYYY 格式）
Time	—	不存储，日期已足够
Name	description	交易对方名称
Type	—	用于筛选（参见工作流）
Status	—	仅导入 Completed 交易
Gross	amount	扣除手续费前的交易金额
Fee	amount（单独一行）	PayPal 手续费（负数 = 支出）
Net	—	计算得出，不直接存储
Transaction ID	reference_id	用于去重的 PayPal 交易 ID
Currency	currency	3 位 ISO 代码
Subject 或 Item Title	notes	可选详情

工作流

1. 请用户提供 PayPal CSV 文件路径。
2. 解析 CSV（PayPal 使用带引号字段的逗号分隔格式）。
3. 按交易类型筛选：
   • 导入：Payment Received、Mobile Payment、Website Payment、Invoice Received
   • 导入：Refund、Reversal、Chargeback
   • 导入：Subscription Payment
   • 跳过：Transfer to Bank、Bank Deposit（会出现在银行导入文件中）
   • 跳过：Currency Conversion（作为父交易的一部分处理）
   • 跳过：Authorization、Pending、Temporary Hold
4. 按状态筛选：仅保留 Completed 交易。
5. 对每笔收到的付款，创建两笔交易：
   • 收入：总额（正数），类别为「Revenue:PayPal」
   • 手续费：手续费金额（负数），类别为「Fees:Payment Processing」
6. 对退款或冲正，创建一笔负数收入交易。
7. 对于货币兑换：将兑换率附加到父交易的备注中。
8. 使用 PayPal 交易 ID 去重。
9. 预览并确认导入。

不使用 Wilson

如需手动处理 PayPal 导出文件：

从 PayPal 下载

1. 登录 paypal.com
2. 前往 Activity（顶部导航栏）
3. 点击 Statements > Activity download（企业账户中为 Reports > Activity download）
4. 选择日期范围（每次最长 1 年）
5. 文件类型：CSV
6. 点击 Download
7. 对于企业账户：Reports > All reports > Transactions > 选择日期范围 > Download CSV

在电子表格中手动处理

1. 打开 CSV。PayPal CSV 使用 Windows-1252 编码——如果看到乱码，请使用 UTF-8 编码重新打开。
2. 筛选状态：仅保留「Completed」行。
3. 筛选类型：移除「Transfer to Bank」、「Bank Deposit」、「Currency Conversion」和「Authorization」行。
4. 拆分收入和手续费：
   • 对每笔付款，Gross 列是收入，Fee 列是 PayPal 手续费。
   • 为每笔手续费创建新行，并填写负数手续费金额。
5. 处理退款：退款行的 Gross 金额已经是负数，保持原样即可。
6. 货币兑换：如果你收到一笔 EUR 付款，但账户使用 USD，PayPal 会创建两行——一行以 EUR 计价，另一行显示兑换后的 USD 金额。使用 USD 行，并注明原始货币。
7. 汇总公式：

   Gross Revenue:  =SUMIFS(Gross, Type, "Payment Received", Status, "Completed")
   Total Fees:     =ABS(SUMIFS(Fee, Type, "Payment Received", Status, "Completed"))
   Total Refunds:  =ABS(SUMIFS(Gross, Type, "Refund", Status, "Completed"))
   Net Revenue:    =GrossRevenue - TotalFees - TotalRefunds
   Fee Rate:       =TotalFees / GrossRevenue * 100
   

对账

• PayPal 转入银行的金额应与两次转账日期之间的 Net 金额总和一致。
• 如果金额不一致，请检查是否存在冻结资金、争议或货币兑换差异。

重要说明

• PayPal CSV 编码可能会导致问题。如果文件无法解析，请先尝试将其另存为 UTF-8。
• PayPal 日期格式为 MM/DD/YYYY（美国账户）或 DD/MM/YYYY（国际账户）。Wilson 会根据账户区域设置自动检测。
• PayPal 中的 “General Payment” 类型既可能表示已发送，也可能表示已收到——请查看 Gross 金额的正负号。
• PayPal 商业账户的 CSV 比个人账户包含更详细的信息。上方的列映射适用于这两种账户。
• 请勿导入 “Transfer to Bank” 行——这些是 PayPal 转入银行的转账，会显示在银行对账单中。