コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン

Revenue Recognition API公開プレビュー

プログラムで Stripe の Revenue Recognition レポートにアクセスして、発生主義会計を自動化します。

ページをコピー

Stripe Revenue Recognition は、発生主義会計のために月次のサマリーや推移表などのダウンロード可能なレポートを提供しています。これらのレポートは、ダッシュボードから CSV 形式でダウンロードすることも、API を使用してプログラムからアクセスすることもできます。

Revenue Recognitionでは、6 つのレポートタイプがサポートされています。

  • revenue_recognition.debit_credit_summary.1
  • revenue_recognition.debit_credit_by_price.1
  • revenue_recognition.debit_credit_by_product.1
  • revenue_recognition.debit_credit_by_customer.1
  • revenue_recognition.debit_credit_by_invoice.1
  • revenue_recognition.debit_credit_by_invoice_line_item.1

注意

この機能はベータ版であるため、データフィールドは変わる可能性があります。

レポートをダウンロードする

以下の例では、借方と貸方を 2021 年 5 月のサマリー別にダウンロードしています。

最初に、レポート実行の作成でレポート実行を作成します。

2023 年 5 月のレポートを取得するために、parameters[interval_start] を 2023 年 5 月 1 日に設定し、parameters[interval_end] を 2023 年 6 月 1 日に設定します。

Command Line
curl https://api.stripe.com/v1/reporting/report_runs \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d report_type="revenue_recognition.debit_credit_summary.1" \
  -d "parameters[interval_start]"=1682899200 \
  -d "parameters[interval_end]"=1685577600

次に、Report Run (レポート実行) オブジェクトを取得して、オブジェクトが成功したかどうかを確認します。

レポート実行オブジェクト ID が frr_ で始まる。

Command Line
curl https://api.stripe.com/v1/reporting/report_runs/{{REPORT_RUN_OBJECT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

オブジェクトの status が succeeded の場合、以下の例のように result.id を使用して CSV をダウンロードできます。

レポートの実行結果 ID が file_ で始まる。

Command Line
curl https://files.stripe.com/v1/files/{{REPORT_RUN_RESULT_ID}}/contents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

レポート実行パラメーター

レポートタイプ必要な実行パラメータオプションの実行パラメータ
revenue_recognition.debit_credit_summary.1
  • interval_start
  • interval_end
  • decimal_format
revenue_recognition.debit_credit_by_price.1
  • interval_start
  • interval_end
  • customer
  • decimal_format
revenue_recognition.debit_credit_by_product.1
  • interval_start
  • interval_end
  • customer
  • decimal_format
revenue_recognition.debit_credit_by_customer.1
  • interval_start
  • interval_end
  • decimal_format
revenue_recognition.debit_credit_by_invoice.1
  • interval_start
  • interval_end
  • customer
  • invoice
  • invoice_line_item
  • decimal_format
revenue_recognition.debit_credit_by_invoice_line_item.1
  • interval_start
  • interval_end
  • customer
  • invoice
  • invoice_line_item
  • decimal_format

レポート実行の列

デフォルトでは、レポートはデフォルトの列セットで実行されます。 列名のリストにオプションの列パラメーターを含めることで、出力の列の選択と順序をカスタマイズできます。各レポートタイプでサポートされている列は以下のとおりです。

サマリー

API レポートタイプ: revenue_recognition.debit_credit_summary.1

列名デフォルト説明
accounting_period会計期間
open_accounting_period確定前の会計期間。確定前の期間のエントリーは変更されることがあります
通貨金額の通貨の ISO コード (3 文字)。
デビット引き落としされた口座
クレジット入金された口座
金額通貨の主要な単位で表示された金額の変更 (例: USD の場合はドル、MXN の場合はペソ)。
credit_gl_code貸方記入の総勘定元帳のコード
debit_gl_code借方記入の総勘定元帳のコード

価格別

API レポートタイプ: revenue_recognition.debit_credit_by_price.1

列名デフォルト説明
accounting_period会計期間
open_accounting_period確定前の会計期間。確定前の期間のエントリーは変更されることがあります
通貨金額の通貨の ISO コード (3 文字)。
price_idこの変更に関連する価格。
デビット引き落としされた口座
クレジット入金された口座
金額通貨の主要な単位で表示された金額の変更 (例: USD の場合はドル、MXN の場合はペソ)。
credit_gl_code貸方記入の総勘定元帳のコード
debit_gl_code借方記入の総勘定元帳のコード

商品別

API レポートタイプ: revenue_recognition.debit_credit_by_product.1

列名デフォルト説明
accounting_period会計期間
open_accounting_period確定前の会計期間。確定前の期間のエントリーは変更されることがあります
通貨金額の通貨の ISO コード (3 文字)。
product_idこの変更に関連する商品。
デビット引き落としされた口座
クレジット入金された口座
金額通貨の主要な単位で表示された金額の変更 (例: USD の場合はドル、MXN の場合はペソ)。
credit_gl_code貸方記入の総勘定元帳のコード
debit_gl_code借方記入の総勘定元帳のコード

顧客別

API レポートタイプ: revenue_recognition.debit_credit_by_customer.1

列名デフォルト説明
accounting_period会計期間
open_accounting_period確定前の会計期間。確定前の期間のエントリーは変更されることがあります
通貨金額の通貨の ISO コード (3 文字)。
customer_idこの変更に関連する顧客。
デビット引き落としされた口座
クレジット入金された口座
金額通貨の主要な単位で表示された金額の変更 (例: USD の場合はドル、MXN の場合はペソ)。
credit_gl_code貸方記入の総勘定元帳のコード
debit_gl_code借方記入の総勘定元帳のコード

請求書別

API レポートタイプ: revenue_recognition.debit_credit_by_invoice.1

列名デフォルト説明
accounting_period会計期間
open_accounting_period確定前の会計期間。確定前の期間のエントリーは変更されることがあります
通貨金額の通貨の ISO コード (3 文字)。
transaction_model_idこの変更に関連する Stripe のモデル (請求書ラインアイテム、請求書、invoiceitem、支払いなど)。
デビット引き落としされた口座
クレジット入金された口座
booked_date元帳のエントリーが帳簿に追加された日付。
金額通貨の主要な単位で表示された金額の変更 (例: USD の場合はドル、MXN の場合はペソ)。
debit_gl_code借方記入の総勘定元帳のコード
credit_gl_code貸方記入の総勘定元帳のコード
invoice_idこの変更に関連する請求書。請求書に関連付けられていない単独の支払いまたは請求書アイテムは null です。
invoice_line_item_id請求書の line_item の ID。
invoice_item_id請求書アイテムの ID
invoice_number請求書に関連付けられている顧客の一意の番号。
subscription_item_idsubscription_item の ID。
price_idこの変更に関連する価格。価格に関連付けられていない単独の支払いまたは請求書アイテムは null です。
product_idこの価格に関連する商品。
customer_idこの変更に関連する顧客。
subscription_idこの変更に関連するサブスクリプション。
charge_idこの変更に関連する支払い。
refund_idこの変更に関連する返金。
dispute_idこの変更に関連する不審請求の申請。
presentment_currency取引の表示 (顧客向け) 通貨。
presentment_amount表示 (顧客向け) 金額。

請求書ラインアイテム別

API レポートタイプ: revenue_recognition.debit_credit_by_invoice_line_item.1

列名デフォルト説明
accounting_period会計期間
open_accounting_period確定前の会計期間。確定前の期間のエントリーは変更されることがあります
通貨金額の通貨の ISO コード (3 文字)。
transaction_model_idこの変更に関連する Stripe のモデル (請求書ラインアイテム、請求書、請求書アイテム、支払いなど)。
デビット引き落としされた口座
クレジット入金された口座
booked_date元帳のエントリーが帳簿に追加された日付。
金額通貨の主要な単位で表示された金額の変更 (例: USD の場合はドル、MXN の場合はペソ)。
debit_gl_code借方記入の総勘定元帳のコード
credit_gl_code貸方記入の総勘定元帳のコード
invoice_idこの変更に関連する請求書。請求書に関連付けられていない単独の支払いまたは請求書アイテムは null です。
invoice_line_item_id請求書の line_item の ID。
invoice_item_id請求書アイテムの ID
subscription_item_idsubscription_item の ID。
price_idこの変更に関連する価格。価格に関連付けられていない単独の支払いまたは請求書アイテムは null です。
product_idこの価格に関連する商品。
customer_idこの変更に関連する顧客。
subscription_idこの変更に関連するサブスクリプション。
charge_idこの変更に関連する支払い。
refund_idこの変更に関連する返金。
dispute_idこの変更に関連する不審請求の申請。
presentment_currency取引の表示 (顧客向け) 通貨。
presentment_amount表示 (顧客向け) 金額。

問題が発生した場合は、revenue-recognition-api-beta@stripe.com までお問い合わせください。

このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
変更ログをご覧ください。
ご不明な点がございましたら、お問い合わせください。
LLM ですか？llms.txt を読んでください。
Powered by Markdoc