サブスクリプションとスケジュールで請求書アイテムのメタデータと期間のサポートを追加

新機能

サブスクリプションとサブスクリプションスケジュールによって生成される 1 回限りの請求書項目のメタデータと期間をカスタマイズする新しい方法が導入されました。

• add_invoice_items の設定時にメタデータを直接関連付けることができるため、後続の個別の API コールでこの情報を追加する必要がありません。

• デフォルトのサブスクリプション請求サイクルの日付を上書きするカスタム period.start と period.end の日付を指定できます。これにより、1 回限りの決済の収益認識期間を正確に制御できます。また、タイムスタンプインジケータ (サブスクリプションの場合は max_item_period_start と min_item_period_end、スケジュールの場合は phase_start と phase_end など) も含まれています。これにより、コンテキストに応じて、サブスクリプションの請求書期間やサブスクリプションスケジュールのフェーズの日付などの重要なタイムスタンプに日付を合わせることができます。

効果

次の API エンドポイントを使用して、add_invoice_items のメタデータまたは期間フィールドを指定します。

• サブスクリプションを作成または更新します。
• スケジュールを作成または更新します。
• schedule_detailsを指定して、プレビュー請求書を作成します。

変更点

アップグレード