Stripeからのインポート

このガイドでは、インポートテンプレートを使用したStripe決済ファイルのファイルインポートについて説明します。何をエクスポートし、どのようにテンプレートを設定し、インポートによって何が作成されるのかを解説します。APIの詳細については、銀行口座および決済のインポートをご覧ください。

1. Stripeから決済ファイルをエクスポートする

Stripeダッシュボードで [決済] -> [エクスポート] を開き、日付範囲を選択し、[すべての列] を維持した上で、使用するメタデータ列を含めます（Stripeは各メタデータキーを <key> (metadata) という名前の列としてエクスポートします。例: orderNo (metadata)）。CSVをダウンロードします。本番環境およびテストモードの両方のエクスポートに対応しています。

お金の移動が発生しなかった行（失敗した決済試行、キャンセルされた決済、または決済手段の指定がまだ必要な決済、および一度も売上確定（capture）されなかったチャージ）は、インポート時にスキップされます。

2. Stripe用の銀行口座を作成する

すべてのインポート結果は銀行口座に反映されます。[銀行口座] で [新規銀行口座] を押し、[タイプ: Stripe] を選択します（Stripe口座にはIBANがありません）。「Stripe」などの名前を付け、決済を行う通貨とその元帳勘定（ledger account）を選択します。Stripeの残高は銀行口座のように機能します。チャージが入り、手数料が出ていき、ペイアウト（payout）によって実際の銀行口座へ残高が移動します。

3. インポートテンプレートを作成する

[銀行口座] -> [インポートテンプレート] で [新規インポートテンプレート] を押し、タイプとして [Stripe] を選択し、名前を入力します。

フィールド。 Stripeのエクスポートのすべての列が1行ずつ表示されます。「ファイルで必須 (Required in file)」チェックボックスは、アップロードするファイルにその列が含まれていなければならないことを示します。必須列が欠落しているファイルは拒否され、不足している列名が表示されます。19個の Card … 列は、一部のアカウントでStripeがこれらを省略するため、デフォルトではチェックが外されています。

元帳勘定 (Ledger account)。 お金の移動を伴う行（Amount、Fee、Amount Refunded）には、既存の元帳勘定、または同じ行から新しく作成する元帳勘定を割り当てることができます。割り当てられたフィールドから生成されたすべての資金移動は、インポート時に計上（post）されます。入金はStripe銀行口座を借方計上し、割り当てられた勘定を貸方計上します。出金はその逆を行います。そして、銀行取引は該当する仕訳（journal entry）と消込済み（matched）としてマークされます。一般的な設定は以下の通りです。

フィールド	勘定	効果
Fee	PSP手数料費用の勘定（標準勘定科目体系の6800）	すべてのStripe手数料が費用として記帳される
Amount	「未計上 (Not posted)」のままにする	請求書の消込のためにチャージを開いたままにする（ステップ5を参照）
Amount Refunded	「未計上 (Not posted)」のままにする	返金はクレジットノート（返金伝票）を通じて処理される（ステップ5を参照）

見つからない顧客を作成する (Create missing customers)。 Customer Email の行でこれをオンにします。ファイル内のメールアドレスに一致するパートナーがまだ存在しない場合、顧客が新規作成されます。名前は Customer Description（空の場合はメールアドレス）から取得され、住所は存在する場合 Card Address … 列から取得されます。既存のパートナーは大文字と小文字を区別せずにメールアドレスで認識されるため、重複して作成されることはありません。

パートナーStripeを作成する (Create partner Stripe)。 Fee の行でこれをオンにします。インポートにより、仕入先パートナーであるStripeが一度だけ作成され（同名の既存パートナーが存在する場合はそれが再利用されます）、Stripeをパートナーとしてすべての手数料のエントリが仕訳帳に記録されるため、手数料の記帳で誰に支払われたかが明確になります。

メタデータフィールド (Metadata fields)。 インポートで読み取りたいメタデータキーごとに1行を追加します（例: orderNo）。これらの行には2つのフラグを設定できます。

• 請求書の作成またはリンク (Create or link invoices) - 注文を特定するキーを指定します（ステップ5）。このフラグを設定できるのは1行のみです。作成される請求書の付加価値税（VAT）率がその横に表示され、オプションで**カタログアイテム (Catalog item)**を選択できます。これを選択すると、インポートによって作成される請求書のすべての明細行がその商品またはサービスを参照するため、収益はそのアイテムの勘定に計上されます。なお、明細行のテキストは引き続きチャージから取得されます。
• 企業フラグ (Company flag) - 購入者が企業であることを示す値を持つキーを指定します（true、1、yes、company、business、または b2b）。このようなチャージから作成された顧客は企業タイプのパートナーになり、それ以外は個人になります。

テンプレートを保存します。

4. ファイルをインポートする

[銀行口座] でStripeの銀行口座、テンプレート、およびファイルを選択し、[インポート] を押します。請求書を1件ずつ発行するため、大きなファイルの場合は完了までに数分かかることがあり、その間ボタンにはスピナーが表示されます。結果行には、インポートされた取引の数、すでに存在していた取引の数、計上された資金移動の数、および作成された顧客、請求書、クレジットノートの数が報告されます。警告には、処理できなかった注文とその理由がリストされます。

同じファイルを再度インポートしても安全です。取引はStripeのチャージID、顧客はメールアドレス、注文はメタデータ値によってそれぞれ認識されます。

5. 「請求書の作成またはリンク」の動作

チャージと返金は、選択されたメタデータキーの値（注文番号）ごとにグループ化されます。

• その値に対する売上請求書がすでに存在する場合（外部参照がその値である受注、または番号がその値である請求書）、チャージはその請求書に対する決済として消し込まれます。
• それ以外の場合は、顧客に対して売上請求書が作成されます。チャージごとに1行作成され、チャージの明細テキストと、テンプレートのVAT率を適用したVAT込み価格のチャージ金額が設定され、日付は最初のチャージの日付になります。請求書は直ちに発行・計上され、チャージがそれに消し込まれるため、支払済みとして表示されます。チャネルが stripe の受注が注文番号とともに記録されるため、次回のインポートでは新規作成ではなくリンクが行われます。
• グループ内のすべての返金は、その請求書に対する返金金額分の発行済みクレジットノートとなり、返金取引はそれに対して消し込まれます。

顧客のメールアドレスがないグループ、異なる通貨のチャージが含まれているグループ、または既存の請求書がまだ下書き状態であるか既に支払済みであるグループはスキップされ、警告にリストされます。これらの取引は [銀行口座] -> [取引] で未消込のまま残ります。

請求書番号は、以前の年を日付とするチャージであっても当年の通番シリーズから付番されるため、過去データのインポートが既存の番号と重複することはありません。

6. テンプレート下部にある6つのオプションフィールド

ほとんどの企業はこれら6つすべてを空欄のままにしており、それでもインポートは全く同じように機能します。これらは、カードの予約枠を文書として記録したい場合や、他者に一部帰属する集金を扱うという、限定的な状況のために存在しています。

ドロップダウンが空に見える理由

3つの「操作タイプ (operation type)」ドロップダウンには、企業が [アカウント] -> [操作タイプ] で作成した操作タイプがリストされます。何も作成していない場合、ドロップダウンには何も表示されません。これは不具合ではありません。事前に操作タイプを作成するか、フィールドを空のままにしてください。

貸し手メタデータフィールド (Lender metadata field) ドロップダウンには、このフォームの上部にある [メタデータフィールド] リストに入力したメタデータ列名がリストされます。事前にそこでメタデータフィールドを追加すると、ここに表示されます。

部分返金ラベル (Partial refund label) と全額返金ラベル (Full refund label)

インポートによって返金用のクレジットノートが作成されるとき、これらはそのクレジットノートのPDFの最上部に印刷される単語を指定します。

状況	使用される単語	デフォルト
返金が請求書合計よりも少ない場合	部分返金ラベル	DEPOZITAS
返金が請求書合計と同額の場合	全額返金ラベル	ANULIAVIMAS

会社でこのような文書に異なる文言を印刷する場合にのみ変更してください。これらはナンバリングや会計処理には影響しません。

承認操作タイプ (Authorization operation type)

カードの承認（オーソリ）とは、顧客のカード上でまだ受け取っていない予約された金額です。Stripeのエクスポートでは、これらの行の Captured が false に設定されています。お金の移動が発生していないため、インポートでは通常これらを無視します。

このフィールドに入力すると、そのような各行が、この操作タイプおよびその操作タイプが指すドキュメントシリーズを使用して、発行済みの販売文書になります。空のままにするとこれらの行はスキップされ、インポート結果に「authorization(s) skipped: template has no authorization operation type」という警告が表示されます。

ビジネスにおいて予約枠を文書として表示することが必須であることが分かっていない限り、空のままにしておいてください。

ペイアウト操作タイプ、手数料操作タイプ、および貸し手メタデータフィールド

他者に帰属する資金（出品者に支払を行うマーケットプレイスや、レンダーに支払を行うプラットフォームなど）を回収するビジネスでない限り、この部分は完全にスキップしてください。通常のショップでこれらに入力することはありません。

Stripeはこのデータを2つのファイルで提供します。payments エクスポートには各顧客が支払った内容が記載され、別の transfers エクスポートには相手方に送金した金額が記載されます。自分が保持した金額を算出するには、インポートの両方のファイルが必要です。

[銀行口座] のインポートフォームには、Stripeテンプレートが少なくとも1つ存在する場合に [Stripe transfers export] ファイルボックスが表示されます。paymentsファイルの隣でtransfersファイルを選択してください。API経由の場合は、bank/statements/import の transfersCsv フィールドになります。

両方のファイルが存在する場合:

フィールド	動作
ペイアウト操作タイプ	相手方への各トランスファーについて、転送された金額の元帳エントリが1件作成されます。借方勘定と貸方勘定はこの操作タイプから取得されます。空欄の場合、代わりに売掛金・買掛金の計上ルールが使用されます。
手数料操作タイプ	チャージ金額からStripe手数料を差し引き、さらに転送金額を差し引いて計算される「手元に残る部分」であり、ゼロより大きい場合にのみ書き込まれます。勘定科目はこの操作タイプから取得され、そうでない場合は売掛金・手数料収益の計上ルールから取得されます。
貸し手メタデータフィールド	資金の移動先を保持するStripeメタデータ列の名前。その値を持つパートナーが作成される（存在する場合は再利用される）し、上記の2つのエントリの両方に設定されます。空欄の場合、または値のない行の場合は、「lender not identified」という警告が表示され、パートナーなしでエントリが書き込まれます。

両方の操作タイプフィールドが空の場合、他の設定に関わらず、トランスファーや手数料のエントリは一切書き込まれません。

7. 実際の銀行口座へのペイアウト

paymentsエクスポートにはペイアウトの行が含まれていないため、Stripeから実際の銀行口座に送信された資金は、代わりにペイアウトレポートから記帳されます。Stripeダッシュボードで [レポート] -> [ペイアウト] -> [ペイアウトの照合（明細あり）] を開き、ダウンロードし、[銀行口座] -> [決済 (Settlements)] で実際の銀行口座に対してインポートし、各ペイアウトを計上します。

今回のインポートですでにStripe銀行口座に反映されているチャージ、手数料、または返金の各ペイアウト行について、計上処理を行うことで、その行の純額がStripe銀行口座から実際の銀行口座へ移動します。手数料や請求書の支払が二重に記帳されることはありません。今回のインポートで検出されなかったStripeのペイアウト行は、銀行口座および決済のインポートで説明されているように記帳されます。

各ペイアウトには [インポートされた決済との差額 (Difference to imported payments)] が表示されます。これは、ペイアウトによって移動した金額から、同じチャージおよび返金に対してStripe銀行口座が保持している金額を引いたものです。ゼロは、ペイアウトによってStripe口座が清算されることを意味します。差額がある行、またはStripe口座上でまだ未計上の資金移動がある行は、[確認対象の行 (Lines to check)] にカウントされます。paymentsエクスポートにはチャージごとの返金合計のみが保持されるため、1つのチャージのすべての返金行がその合計に対してまとめて比較されます。

paymentsファイルがインポートされる前にペイアウトが計上されていた場合、インポートはそのペイアウトのチャージ、手数料、および返金をスキップし、警告にその名前を表示します。

8. 事後確認の場所

• [銀行口座] -> [取引] - インポートされたすべての資金移動。消し込み済みのものは請求書または仕訳にリンクされます。
• [請求書] - 作成された請求書およびクレジットノート。メモに注文番号が記載されます。
• [パートナー] - 作成された顧客。
• [元帳] -> [仕訳帳] - 手数料、決済、請求書の計上データ。

課金

最大10 MBのファイル、および最大50,000件の資金移動。インポートされた資金移動10件ごとに1回のAPIリクエストとしてカウントされます。