stripe-import

Stripe 导入

概述

将 Stripe CSV 导出文件中的交易数据导入 Open Accountant。将收款（收入）、Stripe 处理费和退款分别作为独立的行项目处理。跳过打款，因为它们会出现在银行导入数据中，重复导入会导致重复计算。

Wilson 工具

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

列映射

Stripe CSV 列	Open Accountant 字段	备注
id	reference_id	Stripe 收款 ID（ch_xxx）
Created (UTC)	date	交易日期
Description	description	面向客户的说明
Amount	amount	收款总额（正数 = 收入）
Fee	amount（单独一行）	Stripe 处理费（负数 = 支出）
Net	—	计算字段，不直接存储
Currency	currency	3 位 ISO 代码
Status	—	仅导入状态为 succeeded 的收款
Customer Email	notes	可选，存储在备注中

工作流

1. 向用户索取 Stripe CSV 文件路径。
2. 解析 CSV 并验证预期的 Stripe 列标题。
3. 筛选行：
   • 导入：Type 为 charge 且 Status 为 succeeded 的行
   • 导入：Type 为 refund 的行
   • 跳过：Type 为 payout 或 transfer 的行（这些会出现在银行导入数据中）
   • 跳过：Status 为 failed 或 pending 的行
4. 为每笔收款创建两笔交易：
   • 收入：取 Amount 列中的正数金额，类别为 "Revenue:Stripe"
   • 费用：取 Fee 列中的负数金额，类别为 "Fees:Payment Processing"
5. 为退款创建负数收入交易，类别为 "Revenue:Refunds"
6. 使用 Stripe 收款 ID（id 列）作为引用进行去重。
7. 预览导入摘要：收款总额、费用总额、退款总额、净收入。
8. 插入交易并确认。

不使用 Wilson

手动处理 Stripe 导出数据：

从 Stripe 下载

1. 登录 dashboard.stripe.com
2. 前往 Payments（左侧边栏）
3. 点击 Export（付款列表右上角）
4. 选择日期范围和列：
   • 推荐：id、Created (UTC)、Description、Amount、Fee、Net、Currency、Status、Type、Customer Email
5. 选择 CSV 格式并下载

在电子表格中手动处理

1. 在 Google Sheets 或 Excel 中打开 CSV。
2. 筛除未成功的交易：Data > Filter > Status 列 > 仅选择 "succeeded"
3. 移除打款：筛选 Type 列 > 取消选择 "payout" 和 "transfer"
4. 创建收入行：
   • 类别列：所有收款行均设为 "Revenue:Stripe"
   • Amount 列已包含收款总额
5. 创建费用行：为每笔收款添加一行，内容如下：
   • 日期相同
   • 说明："Stripe fee — [original description]"
   • 金额：取 Fee 列中的负数值（例如，若 Fee = 2.90，则输入 -2.90）
   • 类别："Fees:Payment Processing"
6. 处理退款：退款行的 Amount 列应为负数。将类别设为 "Revenue:Refunds"
7. 摘要公式：

   Gross Revenue:    =SUMIFS(Amount, Type, "charge", Status, "succeeded")
   Total Fees:       =SUMIFS(Fee, Type, "charge", Status, "succeeded")
   Total Refunds:    =ABS(SUMIFS(Amount, Type, "refund"))
   Net Revenue:      =GrossRevenue - TotalFees - TotalRefunds
   Effective Rate:   =TotalFees / GrossRevenue * 100
   

8. 与银行对账：银行打款金额应等于各打款日期之间 Net 列数值之和。

重要说明

• Stripe 在 API 中以货币最小单位表示金额，但在 CSV 导出中以标准单位表示（例如 $10.00，而不是 1000）。
• 多币种：如果您接受多种货币付款，每种货币都会按原始金额导入。Wilson 不会进行货币兑换。
• Stripe 费用通常为每笔交易 2.9% + $0.30，但具体费用因套餐而异。实际费用会显示在 CSV 中。
• 请勿导入提现款项。 提现款项是从 Stripe 转入您银行账户的款项。这些款项会显示在您的银行对账单导入数据中，如果再从 Stripe 导入，就会导致金额重复计算。
• Connect／平台收费：如果您使用 Stripe Connect，应用费用会作为单独的明细项显示。如适用，请将这些费用导入“Fees:Platform”。