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. 受け取った支払いごとに、取引を 2 件作成します。
   • 収益：総額（正の値）、カテゴリは「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. 返金を処理する：「Refund」の行にはすでに負の「Gross」金額が記載されています。そのまま使用します。
6. 通貨換算：EUR で支払いを受け取り、アカウントの通貨が USD の場合、PayPal は EUR の行と USD に換算された行の 2 行を作成します。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 から銀行口座への振込です。