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. 各チャージについて、2 件の取引を作成します。
   • 売上：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. CSV を Google Sheets または Excel で開きます。
2. 成功していない取引を除外：データ > フィルタ > Status 列 > 「succeeded」のみを選択します
3. 入金を削除：Type 列をフィルタし、「payout」と「transfer」の選択を解除します
4. 売上行を作成：
   • カテゴリ列：すべてのチャージ行に「Revenue:Stripe」を設定します
   • 金額列には、チャージの総額がすでに入力されています
5. 手数料行を作成：各チャージについて、次の内容の行を追加します。
   • 同じ日付
   • 説明：「Stripe fee — [元の説明]」
   • 金額：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 エクスポートでは標準単位です（例：1000 ではなく 10.00 ドル）。
• 複数通貨：複数の通貨で支払いを受け付けている場合、各通貨は元の金額のままインポートされます。Wilson は通貨換算を行いません。
• Stripe の手数料率は通常、取引ごとに 2.9% + 0.30 ドルですが、プランによって異なります。実際の手数料は CSV に記載されています。
• 入金をインポートしないでください。 入金とは、Stripe から銀行口座への振り込みです。これらは銀行明細のインポートに含まれるため、Stripe からもインポートすると金額が二重に計上されます。
• Connect／プラットフォームの手数料：Stripe Connect を使用している場合、アプリケーション手数料は個別の明細項目として表示されます。該当する場合は、これらを「Fees:Platform」にインポートしてください。