コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成
サインイン
始める
支払い
売上
プラットフォームおよびマーケットプレイス
資金管理
開発者向けのツール
概要
バージョン管理
変更ログ
    概要
    Basil
    Acacia
    以前のバージョン
API バージョンのアップグレード
SDK バージョンをアップグレードする
開発者向けのツール
SDK
API
テスト
ワークベンチ
イベントの送信先
ワークフロー
Stripe CLI
Stripe Shell
開発者ダッシュボード
エージェントツールキット
LLM を使用した構築Visual Studio Code をご利用の場合Stripe 健全性アラートファイルのアップロード
セキュリティとプライバシー
セキュリティ
プライバシー
Stripe を拡張する
Stripe Apps
Stripe のコネクター
パートナー
Partner Ecosystem
パートナー認定
ホーム開発者向けのツールChangelogBasil2025-03-31.basil

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

最上位の税関連プロパティを、Invoice、Invoice Line Item、Credit Note Line Item の新しい税金モデルに置き換えます破壊的変更

新規情報

新しい税金オブジェクトを追加する前に、Invoice Line Item (請求書項目) と Credit Note Line Item (クレジットノート項目) に新しい taxes コンセプトを導入し、税金関連のデータを取り込み、税金オブジェクトの構造を統一する予定です。これは、Invoice Line Item オブジェクトと Credit Note Line Item オブジェクトの最上位の税金関連プロパティに置き換わります。

また、 Invoice オブジェクトと Credit Note オブジェクトに新しい total_taxes プロパティを導入して、集計された税務情報を表示します。

この変更により互換性が失われる理由

  • tax_rates と tax_amounts は、Invoice Line Item オブジェクトと Credit Note Line Item オブジェクトで使用できなくなりました。
  • total_tax_amounts は Invoice オブジェクトで使用できなくなりました。

影響

Invoice Line Item と Credit Note Line Item の税率 ID が新しい taxes プロパティに含まれるようになりました。

  • line_item.tax_rates[0] を line_item.taxes[0].tax_rate_details.tax_rate に置き換えます (line_item.taxes[0].type が tax_rate_details であることを確認した後)
  • line_item.tax_amounts[0].amount を line_item.taxes[0].amount に置き換えます

Invoice と Credit Note の税額合計が total_taxes に保存されるようになりました。

  • invoice.total_tax_amounts[0].amount を invoice.total_taxes[0].amount に置き換えます (invoice.total_taxes[0].type が tax_rate_details であることを確認した後)

変更点

パラメーター変更するリソースまたは エンドポイント
tax_amounts削除済み
CreditNoteCreditNoteLineItemInvoiceLineItem
amount_excluding_taxunit_amount_excluding_tax削除済み
CreditNoteLineItemInvoiceLineItem
tax_rates削除済み
InvoiceLineItem
taxtotal_tax_amounts削除済み
Invoice
total_taxes追加済み
CreditNoteInvoice
taxes追加済み
CreditNoteLineItemInvoiceLineItem

Upgrade

  1. View your current API version in Workbench.
  2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
    • If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-03-31.basil
  3. Upgrade the API version used for webhook endpoints.
  4. Test your integration against the new version.
  5. If you use Connect, test your Connect integration.
  6. In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

関連する変更点

  • 最上位の price フィールドを、Invoice Item と Invoice Line Item の価格モデルに置き換え
  • 請求書の複数 (一部) 支払いのサポートを追加しました
  • 請求書の手動税額に jurisdiction level と taxability reason を追加
このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
変更ログをご覧ください。
ご不明な点がございましたら、お問い合わせください。
LLM ですか?llms.txt を読んでください。
Powered by Markdoc