# レポート作成と照合 Stripe を使用して財務レポートを生成し、消し込みを実行します。 Sigma プラットフォームのさまざまな入金タイプ、取引残高、高度なレポート作成機能をご紹介します。 ## レポート作成と入金 レポート作成と照合を簡素化するために、自動の *payouts* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) を使用します。これにより、各取引と取引が含まれる入金との間の関連性が維持されます。 API を使用してカスタムレポートを作成している場合は、[balance transaction (取引残高) エンドポイント](https://docs.stripe.com/api/balance_transactions/list.md)と `payout` パラメーターを使用して、自動入金に含まれるすべての取引を表示できます。ベストプラクティスとして、[Webhook](https://docs.stripe.com/connect/webhooks.md) ハンドラで [payout.paid](https://docs.stripe.com/api.md#event_types-payout.paid) または [payout.reconciliation_completed](https://docs.stripe.com/api/events/types.md#event_types-payout.reconciliation_completed) イベントを受信したときに、入金を非同期で自動的に取得することをお勧めします。 取引残高の数が上限を超えることがあります。この場合は、[自動ページ分割機能](https://docs.stripe.com/api/pagination/auto.md) を使用して、手動で結果をページ分割して、後続のリクエストを実行することなく、すべての取引残高の一覧を取得することをお勧めします。 入金から取引を取得するための残高履歴 API コールの例として、以下をご覧ください。 ```curl curl -G https://api.stripe.com/v1/balance_transactions \ -u "<>:" \ -d "payout={{PAYOUT_ID}}" \ -d limit=100 ``` 入金から取引を取得するための残高履歴 API コールの例 (See full diagram at https://docs.stripe.com/plan-integration/get-started/reporting-reconciliation) ```text [Stripe] -- payout.paid: payout.paid イベントまたは payout.reconciliation_completed イベント --> [サーバー] [サーバー] -- GET /v1/balance_transactions --> [Stripe] [Stripe] -- 取引のリストを返す --> [サーバー] ``` 自動入金は、サポート対象のデビットカードに売上を即座に送金する [Instant Payouts](https://docs.stripe.com/payouts.md#instant-payouts) に対応しています。週末や休日を含め、24 時間年中無休で Instant Payouts をリクエストできます。通常、売上は関連する銀行口座に 30 分以内に表示されます。自身の地域で利用可能かどうかを確認するには、[即時入金のドキュメント](https://docs.stripe.com/payouts/instant-payouts-banks.md)をご覧ください。 ### 手動入金 必要に応じて[手動入金](https://docs.stripe.com/payouts.md)を使用できます。ただし、手動入金では支払いを受ける希望額を指定するため、Stripe では手動入金された資金に対する取引レベルのレポートをサポートしていません。 アカウントでの手動入金の例を以下に示します。 ```bash curl https://api.stripe.com/v1/payouts \ -u <>: \ -X "POST" \ -d "amount"=1000 \ -d "currency"="usd" ``` ## 財務レポート Stripe は財務分析にすぐに使用できるさまざまな[レポート](https://docs.stripe.com/stripe-reports.md)をサポートしています。 - - [残高](https://docs.stripe.com/reports/balance.md): 項目別の要約された取引残高データを表示およびダウンロードし、日次、週次、または月次で帳簿の締め処理を行うことができます。これらのレポートは、Stripe 残高の変化の把握に役立ちます。 - [照合](https://docs.stripe.com/reports/payout-reconciliation.md): このレポートでは、既に入金されている取引、まだ入金されていない取引を確認できます。照合タブには、残高タブの表示と同じタイプのデータが表示されますが、入金を照合できるようにさまざまな方法でグループ化されています。 - レポートはすべて、Stripe ダッシュボードおよび API を介して利用できます。[Reports API](https://docs.stripe.com/reports/api.md) を使用し、プログラムによって Stripe の構築済みのレポートをリクエストしてダウンロードできます。 このプロセスを完全に自動化するには、Stripe の [4 段階の導入パターン](https://docs.stripe.com/reports/api.md#integration-pattern)に従います。このプロセスでは、新しいレポートデータが利用可能になったタイミングを通知するイベントをリッスンし、その時点でレポートを実行します。 これは、「都度入金に対する項目別の入金照合レポート」(別名「売上処理ファイル」) を生成するための API コールの一例です。新しいデータが利用可能であることが通知されたら、この API コールを実行します。 ```bash curl https://api.stripe.com/v1/reporting/report_runs \ -u <>: \ -X "POST" \ -d "report_type"="payout_reconciliation.by_id.itemized.4" \ -d "parameters[interval_start]"=1577865600 \ -d "parameters[interval_end]"=1580544000 ``` ## 取引残高 [取引残高](https://docs.stripe.com/reports/balance-transaction-types.md)は Stripe でのすべてのアクティビティーの構成要素です。これらのオブジェクトには以下の特徴があります。 - Stripe 残高に影響を与えたすべてのもの (クレジットとデビット) を表します。 - Stripe によって自動的に作成されます (たとえば、PaymentIntent が成功するたびに、各入金と同様に、個別の BalanceTransaction オブジェクトが生成されます)。 - 不変です (返金は、元のオブジェクトを無効にする新しい BalanceTransaction に関連付けられます)。 - 元帳として機能します (任意の時点での残高を把握するために、その時点までのすべての BalanceTransactions を再試行できます)。 また、BalanceTransactions (`txn_***` オブジェクト) はすべてのレポートの基礎となります。ほとんどのレポートでは、行レベルのデータポイントは `txn_***` オブジェクトです。 ## Sigma を使用した高度なレポート作成 [Sigma](https://docs.stripe.com/data.md) を使用すると、すべてのビジネスデータをダッシュボードのインタラクティブな SQL 環境で利用できます。その広範なスキーマを活用するクエリを作成し、取引に関する情報を使用して完全にカスタマイズされたレポートを作成できます。 Sigma を使用すると、データを CSV に直接エクスポートし、クエリのスケジュールを設定して、メールまたは *Webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) を通じて結果を配信できます。ビジネスインテリジェンスツール用のデータセットを生成したり、取引データを照合したり、カスタムレポートを生成したりできます。 [Sigma を有効](https://dashboard.stripe.com/test/get-started/sigma) にするには、ダッシュボードから**設定 > Sigma**に移動します。有効にした後、データが読み込まれてクエリ可能になるまでに最大 24 時間かかります。Sigma は、標準の ANSI SQL と幅広いレポート機能を使用します。アカウントでレポートを表示する権限を持つ人物全員が、クエリを作成して実行できます。