metronome-sdk 3.5.0 → 3.7.0

data/lib/metronome_sdk/models/contract_v2.rb

@@ -197,11 +197,19 @@ module MetronomeSDK
       #   @return [MetronomeSDK::Models::SpendThresholdConfigurationV2, nil]
       optional :spend_threshold_configuration, -> { MetronomeSDK::SpendThresholdConfigurationV2 }
 
+      # @!attribute spend_trackers
+      #   Spend trackers attached to this contract.
+      #
+      #   @return [Array<MetronomeSDK::Models::ContractV2::SpendTracker>, nil]
+      optional :spend_trackers,
+               -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::ContractV2::SpendTracker] }
+
       # @!attribute subscriptions
       #   List of subscriptions on the contract.
       #
-      #   @return [Array<MetronomeSDK::Models::Subscription>, nil]
-      optional :subscriptions, -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::Subscription] }
+      #   @return [Array<MetronomeSDK::Models::ContractV2::Subscription>, nil]
+      optional :subscriptions,
+               -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::ContractV2::Subscription] }
 
       # @!attribute total_contract_value
       #
@@ -214,7 +222,7 @@ module MetronomeSDK
       #   @return [String, nil]
       optional :uniqueness_key, String
 
-      # @!method initialize(id:, commits:, created_at:, created_by:, customer_id:, overrides:, scheduled_charges:, starting_at:, transitions:, usage_filter:, usage_statement_schedule:, archived_at: nil, credits: nil, custom_fields: nil, customer_billing_provider_configuration: nil, discounts: nil, ending_before: nil, has_more: nil, hierarchy_configuration: nil, multiplier_override_prioritization: nil, name: nil, net_payment_terms_days: nil, netsuite_sales_order_id: nil, prepaid_balance_threshold_configuration: nil, priority: nil, professional_services: nil, rate_card_id: nil, recurring_commits: nil, recurring_credits: nil, reseller_royalties: nil, salesforce_opportunity_id: nil, scheduled_charges_on_usage_invoices: nil, spend_threshold_configuration: nil, subscriptions: nil, total_contract_value: nil, uniqueness_key: nil)
+      # @!method initialize(id:, commits:, created_at:, created_by:, customer_id:, overrides:, scheduled_charges:, starting_at:, transitions:, usage_filter:, usage_statement_schedule:, archived_at: nil, credits: nil, custom_fields: nil, customer_billing_provider_configuration: nil, discounts: nil, ending_before: nil, has_more: nil, hierarchy_configuration: nil, multiplier_override_prioritization: nil, name: nil, net_payment_terms_days: nil, netsuite_sales_order_id: nil, prepaid_balance_threshold_configuration: nil, priority: nil, professional_services: nil, rate_card_id: nil, recurring_commits: nil, recurring_credits: nil, reseller_royalties: nil, salesforce_opportunity_id: nil, scheduled_charges_on_usage_invoices: nil, spend_threshold_configuration: nil, spend_trackers: nil, subscriptions: nil, total_contract_value: nil, uniqueness_key: nil)
       #   Some parameter documentations has been truncated, see
       #   {MetronomeSDK::Models::ContractV2} for more details.
       #
@@ -284,7 +292,9 @@ module MetronomeSDK
       #
       #   @param spend_threshold_configuration [MetronomeSDK::Models::SpendThresholdConfigurationV2]
       #
-      #   @param subscriptions [Array<MetronomeSDK::Models::Subscription>] List of subscriptions on the contract.
+      #   @param spend_trackers [Array<MetronomeSDK::Models::ContractV2::SpendTracker>] Spend trackers attached to this contract.
+      #
+      #   @param subscriptions [Array<MetronomeSDK::Models::ContractV2::Subscription>] List of subscriptions on the contract.
       #
       #   @param total_contract_value [Float]
       #
@@ -451,13 +461,19 @@ module MetronomeSDK
         #   @return [Array<MetronomeSDK::Models::CommitSpecifier>, nil]
         optional :specifiers, -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::CommitSpecifier] }
 
+        # @!attribute spend_tracker_attributes
+        #   Optional attributes controlling how this commit interacts with spend trackers.
+        #
+        #   @return [MetronomeSDK::Models::ContractV2::Commit::SpendTrackerAttributes, nil]
+        optional :spend_tracker_attributes, -> { MetronomeSDK::ContractV2::Commit::SpendTrackerAttributes }
+
         # @!attribute subscription_config
         #   Attach a subscription to the recurring commit/credit.
         #
         #   @return [MetronomeSDK::Models::RecurringCommitSubscriptionConfig, nil]
         optional :subscription_config, -> { MetronomeSDK::RecurringCommitSubscriptionConfig }
 
-        # @!method initialize(id:, created_at:, product:, type:, access_schedule: nil, applicable_contract_ids: nil, applicable_product_ids: nil, applicable_product_tags: nil, archived_at: nil, balance: nil, contract: nil, custom_fields: nil, description: nil, hierarchy_configuration: nil, invoice_contract: nil, invoice_schedule: nil, ledger: nil, name: nil, netsuite_sales_order_id: nil, priority: nil, rate_type: nil, recurring_commit_id: nil, rolled_over_from: nil, rollover_fraction: nil, salesforce_opportunity_id: nil, specifiers: nil, subscription_config: nil)
+        # @!method initialize(id:, created_at:, product:, type:, access_schedule: nil, applicable_contract_ids: nil, applicable_product_ids: nil, applicable_product_tags: nil, archived_at: nil, balance: nil, contract: nil, custom_fields: nil, description: nil, hierarchy_configuration: nil, invoice_contract: nil, invoice_schedule: nil, ledger: nil, name: nil, netsuite_sales_order_id: nil, priority: nil, rate_type: nil, recurring_commit_id: nil, rolled_over_from: nil, rollover_fraction: nil, salesforce_opportunity_id: nil, specifiers: nil, spend_tracker_attributes: nil, subscription_config: nil)
         #   Some parameter documentations has been truncated, see
         #   {MetronomeSDK::Models::ContractV2::Commit} for more details.
         #
@@ -513,6 +529,8 @@ module MetronomeSDK
         #
         #   @param specifiers [Array<MetronomeSDK::Models::CommitSpecifier>] List of filters that determine what kind of customer usage draws down a commit o
         #
+        #   @param spend_tracker_attributes [MetronomeSDK::Models::ContractV2::Commit::SpendTrackerAttributes] Optional attributes controlling how this commit interacts with spend trackers.
+        #
         #   @param subscription_config [MetronomeSDK::Models::RecurringCommitSubscriptionConfig] Attach a subscription to the recurring commit/credit.
 
         # @see MetronomeSDK::Models::ContractV2::Commit#product
@@ -1229,6 +1247,25 @@ module MetronomeSDK
           #   @param commit_id [String]
           #   @param contract_id [String]
         end
+
+        # @see MetronomeSDK::Models::ContractV2::Commit#spend_tracker_attributes
+        class SpendTrackerAttributes < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute counts_as_discounted
+          #   If true, this commit is included in spend trackers with discounted set to
+          #   DISCOUNTED_ONLY
+          #
+          #   @return [Boolean]
+          required :counts_as_discounted, MetronomeSDK::Internal::Type::Boolean
+
+          # @!method initialize(counts_as_discounted:)
+          #   Some parameter documentations has been truncated, see
+          #   {MetronomeSDK::Models::ContractV2::Commit::SpendTrackerAttributes} for more
+          #   details.
+          #
+          #   Optional attributes controlling how this commit interacts with spend trackers.
+          #
+          #   @param counts_as_discounted [Boolean] If true, this commit is included in spend trackers with discounted set to DISCOU
+        end
       end
 
       class Override < MetronomeSDK::Internal::Type::BaseModel
@@ -1645,6 +1682,11 @@ module MetronomeSDK
         #   @return [Array<String>, nil]
         optional :applicable_product_tags, MetronomeSDK::Internal::Type::ArrayOf[String]
 
+        # @!attribute archived_at
+        #
+        #   @return [Time, nil]
+        optional :archived_at, Time
+
         # @!attribute balance
         #   The current balance of the credit or commit. This balance reflects the amount of
         #   credit or commit that the customer has access to use at this moment - thus,
@@ -1746,7 +1788,7 @@ module MetronomeSDK
         #   @return [MetronomeSDK::Models::RecurringCommitSubscriptionConfig, nil]
         optional :subscription_config, -> { MetronomeSDK::RecurringCommitSubscriptionConfig }
 
-        # @!method initialize(id:, product:, type:, access_schedule: nil, applicable_contract_ids: nil, applicable_product_ids: nil, applicable_product_tags: nil, balance: nil, contract: nil, created_at: nil, custom_fields: nil, description: nil, hierarchy_configuration: nil, ledger: nil, name: nil, netsuite_sales_order_id: nil, priority: nil, recurring_credit_id: nil, rolled_over_from: nil, salesforce_opportunity_id: nil, specifiers: nil, subscription_config: nil)
+        # @!method initialize(id:, product:, type:, access_schedule: nil, applicable_contract_ids: nil, applicable_product_ids: nil, applicable_product_tags: nil, archived_at: nil, balance: nil, contract: nil, created_at: nil, custom_fields: nil, description: nil, hierarchy_configuration: nil, ledger: nil, name: nil, netsuite_sales_order_id: nil, priority: nil, recurring_credit_id: nil, rolled_over_from: nil, salesforce_opportunity_id: nil, specifiers: nil, subscription_config: nil)
         #   Some parameter documentations has been truncated, see
         #   {MetronomeSDK::Models::ContractV2::Credit} for more details.
         #
@@ -1764,6 +1806,8 @@ module MetronomeSDK
         #
         #   @param applicable_product_tags [Array<String>]
         #
+        #   @param archived_at [Time]
+        #
         #   @param balance [Float] The current balance of the credit or commit. This balance reflects the amount of
         #
         #   @param contract [MetronomeSDK::Models::ContractV2::Credit::Contract]
@@ -3297,6 +3341,486 @@ module MetronomeSDK
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      class SpendTracker < MetronomeSDK::Internal::Type::BaseModel
+        # @!attribute alias_
+        #   Human-readable identifier, unique per contract.
+        #
+        #   @return [String]
+        required :alias_, String, api_name: :alias
+
+        # @!attribute applicable_spend_specifiers
+        #
+        #   @return [Array<MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier>]
+        required :applicable_spend_specifiers,
+                 -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier] }
+
+        # @!attribute credit_type_id
+        #
+        #   @return [String]
+        required :credit_type_id, String
+
+        # @!attribute reset_frequency
+        #
+        #   @return [Symbol, MetronomeSDK::Models::ContractV2::SpendTracker::ResetFrequency]
+        required :reset_frequency, enum: -> { MetronomeSDK::ContractV2::SpendTracker::ResetFrequency }
+
+        # @!attribute accumulated_spend
+        #
+        #   @return [MetronomeSDK::Models::ContractV2::SpendTracker::AccumulatedSpend, nil]
+        optional :accumulated_spend, -> { MetronomeSDK::ContractV2::SpendTracker::AccumulatedSpend }
+
+        # @!method initialize(alias_:, applicable_spend_specifiers:, credit_type_id:, reset_frequency:, accumulated_spend: nil)
+        #   @param alias_ [String] Human-readable identifier, unique per contract.
+        #
+        #   @param applicable_spend_specifiers [Array<MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier>]
+        #
+        #   @param credit_type_id [String]
+        #
+        #   @param reset_frequency [Symbol, MetronomeSDK::Models::ContractV2::SpendTracker::ResetFrequency]
+        #
+        #   @param accumulated_spend [MetronomeSDK::Models::ContractV2::SpendTracker::AccumulatedSpend]
+
+        class ApplicableSpendSpecifier < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute sources
+          #
+          #   @return [Array<Symbol, MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier::Source>]
+          required :sources,
+                   -> { MetronomeSDK::Internal::Type::ArrayOf[enum: MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Source] }
+
+          # @!attribute spend_type
+          #
+          #   @return [Symbol, MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier::SpendType]
+          required :spend_type,
+                   enum: -> { MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::SpendType }
+
+          # @!attribute discounted
+          #
+          #   @return [Symbol, MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier::Discounted, nil]
+          optional :discounted,
+                   enum: -> { MetronomeSDK::ContractV2::SpendTracker::ApplicableSpendSpecifier::Discounted }
+
+          # @!method initialize(sources:, spend_type:, discounted: nil)
+          #   @param sources [Array<Symbol, MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier::Source>]
+          #   @param spend_type [Symbol, MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier::SpendType]
+          #   @param discounted [Symbol, MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier::Discounted]
+
+          module Source
+            extend MetronomeSDK::Internal::Type::Enum
+
+            THRESHOLD_RECHARGE = :THRESHOLD_RECHARGE
+            MANUAL = :MANUAL
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier#spend_type
+          module SpendType
+            extend MetronomeSDK::Internal::Type::Enum
+
+            COMMIT_PURCHASE = :COMMIT_PURCHASE
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see MetronomeSDK::Models::ContractV2::SpendTracker::ApplicableSpendSpecifier#discounted
+          module Discounted
+            extend MetronomeSDK::Internal::Type::Enum
+
+            ANY = :ANY
+            DISCOUNTED_ONLY = :DISCOUNTED_ONLY
+            UNDISCOUNTED_ONLY = :UNDISCOUNTED_ONLY
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # @see MetronomeSDK::Models::ContractV2::SpendTracker#reset_frequency
+        module ResetFrequency
+          extend MetronomeSDK::Internal::Type::Enum
+
+          BILLING_PERIOD = :BILLING_PERIOD
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see MetronomeSDK::Models::ContractV2::SpendTracker#accumulated_spend
+        class AccumulatedSpend < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute amount
+          #
+          #   @return [Float]
+          required :amount, Float
+
+          # @!attribute period_ending_before
+          #
+          #   @return [Time]
+          required :period_ending_before, Time
+
+          # @!attribute period_starting_at
+          #
+          #   @return [Time]
+          required :period_starting_at, Time
+
+          # @!method initialize(amount:, period_ending_before:, period_starting_at:)
+          #   @param amount [Float]
+          #   @param period_ending_before [Time]
+          #   @param period_starting_at [Time]
+        end
+      end
+
+      class Subscription < MetronomeSDK::Internal::Type::BaseModel
+        # @!attribute billing_periods
+        #   Previous, current, and next billing periods for the subscription.
+        #
+        #   @return [MetronomeSDK::Models::ContractV2::Subscription::BillingPeriods]
+        required :billing_periods, -> { MetronomeSDK::ContractV2::Subscription::BillingPeriods }
+
+        # @!attribute collection_schedule
+        #
+        #   @return [Symbol, MetronomeSDK::Models::ContractV2::Subscription::CollectionSchedule]
+        required :collection_schedule, enum: -> { MetronomeSDK::ContractV2::Subscription::CollectionSchedule }
+
+        # @!attribute proration
+        #
+        #   @return [MetronomeSDK::Models::ContractV2::Subscription::Proration]
+        required :proration, -> { MetronomeSDK::ContractV2::Subscription::Proration }
+
+        # @!attribute quantity_management_mode
+        #   Determines how the subscription's quantity is controlled. Defaults to
+        #   QUANTITY_ONLY. **QUANTITY_ONLY**: The subscription quantity is specified
+        #   directly on the subscription. `initial_quantity` must be provided with this
+        #   option. Compatible with recurring commits/credits that use POOLED allocation.
+        #   **SEAT_BASED**: Use when you want to pass specific seat identifiers (e.g. add
+        #   user_123) to increment and decrement a subscription quantity, rather than
+        #   directly providing the quantity. You must use a **SEAT_BASED** subscription to
+        #   use a linked recurring credit with an allocation per seat. `seat_config` must be
+        #   provided with this option.
+        #
+        #   @return [Symbol, MetronomeSDK::Models::ContractV2::Subscription::QuantityManagementMode]
+        required :quantity_management_mode,
+                 enum: -> { MetronomeSDK::ContractV2::Subscription::QuantityManagementMode }
+
+        # @!attribute quantity_schedule
+        #   List of quantity schedule items for the subscription. Only includes the current
+        #   quantity and future quantity changes.
+        #
+        #   @return [Array<MetronomeSDK::Models::ContractV2::Subscription::QuantitySchedule>]
+        required :quantity_schedule,
+                 -> { MetronomeSDK::Internal::Type::ArrayOf[MetronomeSDK::ContractV2::Subscription::QuantitySchedule] }
+
+        # @!attribute starting_at
+        #
+        #   @return [Time]
+        required :starting_at, Time
+
+        # @!attribute subscription_rate
+        #
+        #   @return [MetronomeSDK::Models::ContractV2::Subscription::SubscriptionRate]
+        required :subscription_rate, -> { MetronomeSDK::ContractV2::Subscription::SubscriptionRate }
+
+        # @!attribute id
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute custom_fields
+        #   Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :custom_fields, MetronomeSDK::Internal::Type::HashOf[String]
+
+        # @!attribute description
+        #
+        #   @return [String, nil]
+        optional :description, String
+
+        # @!attribute ending_before
+        #
+        #   @return [Time, nil]
+        optional :ending_before, Time
+
+        # @!attribute fiat_credit_type_id
+        #
+        #   @return [String, nil]
+        optional :fiat_credit_type_id, String
+
+        # @!attribute name
+        #
+        #   @return [String, nil]
+        optional :name, String
+
+        # @!attribute seat_config
+        #
+        #   @return [MetronomeSDK::Models::ContractV2::Subscription::SeatConfig, nil]
+        optional :seat_config, -> { MetronomeSDK::ContractV2::Subscription::SeatConfig }
+
+        # @!method initialize(billing_periods:, collection_schedule:, proration:, quantity_management_mode:, quantity_schedule:, starting_at:, subscription_rate:, id: nil, custom_fields: nil, description: nil, ending_before: nil, fiat_credit_type_id: nil, name: nil, seat_config: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {MetronomeSDK::Models::ContractV2::Subscription} for more details.
+        #
+        #   @param billing_periods [MetronomeSDK::Models::ContractV2::Subscription::BillingPeriods] Previous, current, and next billing periods for the subscription.
+        #
+        #   @param collection_schedule [Symbol, MetronomeSDK::Models::ContractV2::Subscription::CollectionSchedule]
+        #
+        #   @param proration [MetronomeSDK::Models::ContractV2::Subscription::Proration]
+        #
+        #   @param quantity_management_mode [Symbol, MetronomeSDK::Models::ContractV2::Subscription::QuantityManagementMode] Determines how the subscription's quantity is controlled. Defaults to QUANTITY_O
+        #
+        #   @param quantity_schedule [Array<MetronomeSDK::Models::ContractV2::Subscription::QuantitySchedule>] List of quantity schedule items for the subscription. Only includes the current
+        #
+        #   @param starting_at [Time]
+        #
+        #   @param subscription_rate [MetronomeSDK::Models::ContractV2::Subscription::SubscriptionRate]
+        #
+        #   @param id [String]
+        #
+        #   @param custom_fields [Hash{Symbol=>String}] Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
+        #
+        #   @param description [String]
+        #
+        #   @param ending_before [Time]
+        #
+        #   @param fiat_credit_type_id [String]
+        #
+        #   @param name [String]
+        #
+        #   @param seat_config [MetronomeSDK::Models::ContractV2::Subscription::SeatConfig]
+
+        # @see MetronomeSDK::Models::ContractV2::Subscription#billing_periods
+        class BillingPeriods < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute current
+          #
+          #   @return [MetronomeSDK::Models::ContractV2::Subscription::BillingPeriods::Current, nil]
+          optional :current, -> { MetronomeSDK::ContractV2::Subscription::BillingPeriods::Current }
+
+          # @!attribute next_
+          #
+          #   @return [MetronomeSDK::Models::ContractV2::Subscription::BillingPeriods::Next, nil]
+          optional :next_,
+                   -> {
+                     MetronomeSDK::ContractV2::Subscription::BillingPeriods::Next
+                   },
+                   api_name: :next
+
+          # @!attribute previous
+          #
+          #   @return [MetronomeSDK::Models::ContractV2::Subscription::BillingPeriods::Previous, nil]
+          optional :previous, -> { MetronomeSDK::ContractV2::Subscription::BillingPeriods::Previous }
+
+          # @!method initialize(current: nil, next_: nil, previous: nil)
+          #   Previous, current, and next billing periods for the subscription.
+          #
+          #   @param current [MetronomeSDK::Models::ContractV2::Subscription::BillingPeriods::Current]
+          #   @param next_ [MetronomeSDK::Models::ContractV2::Subscription::BillingPeriods::Next]
+          #   @param previous [MetronomeSDK::Models::ContractV2::Subscription::BillingPeriods::Previous]
+
+          # @see MetronomeSDK::Models::ContractV2::Subscription::BillingPeriods#current
+          class Current < MetronomeSDK::Internal::Type::BaseModel
+            # @!attribute ending_before
+            #
+            #   @return [Time]
+            required :ending_before, Time
+
+            # @!attribute starting_at
+            #
+            #   @return [Time]
+            required :starting_at, Time
+
+            # @!method initialize(ending_before:, starting_at:)
+            #   @param ending_before [Time]
+            #   @param starting_at [Time]
+          end
+
+          # @see MetronomeSDK::Models::ContractV2::Subscription::BillingPeriods#next_
+          class Next < MetronomeSDK::Internal::Type::BaseModel
+            # @!attribute ending_before
+            #
+            #   @return [Time]
+            required :ending_before, Time
+
+            # @!attribute starting_at
+            #
+            #   @return [Time]
+            required :starting_at, Time
+
+            # @!method initialize(ending_before:, starting_at:)
+            #   @param ending_before [Time]
+            #   @param starting_at [Time]
+          end
+
+          # @see MetronomeSDK::Models::ContractV2::Subscription::BillingPeriods#previous
+          class Previous < MetronomeSDK::Internal::Type::BaseModel
+            # @!attribute ending_before
+            #
+            #   @return [Time]
+            required :ending_before, Time
+
+            # @!attribute starting_at
+            #
+            #   @return [Time]
+            required :starting_at, Time
+
+            # @!method initialize(ending_before:, starting_at:)
+            #   @param ending_before [Time]
+            #   @param starting_at [Time]
+          end
+        end
+
+        # @see MetronomeSDK::Models::ContractV2::Subscription#collection_schedule
+        module CollectionSchedule
+          extend MetronomeSDK::Internal::Type::Enum
+
+          ADVANCE = :ADVANCE
+          ARREARS = :ARREARS
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see MetronomeSDK::Models::ContractV2::Subscription#proration
+        class Proration < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute invoice_behavior
+          #
+          #   @return [Symbol, MetronomeSDK::Models::ContractV2::Subscription::Proration::InvoiceBehavior]
+          required :invoice_behavior,
+                   enum: -> { MetronomeSDK::ContractV2::Subscription::Proration::InvoiceBehavior }
+
+          # @!attribute is_prorated
+          #
+          #   @return [Boolean]
+          required :is_prorated, MetronomeSDK::Internal::Type::Boolean
+
+          # @!method initialize(invoice_behavior:, is_prorated:)
+          #   @param invoice_behavior [Symbol, MetronomeSDK::Models::ContractV2::Subscription::Proration::InvoiceBehavior]
+          #   @param is_prorated [Boolean]
+
+          # @see MetronomeSDK::Models::ContractV2::Subscription::Proration#invoice_behavior
+          module InvoiceBehavior
+            extend MetronomeSDK::Internal::Type::Enum
+
+            BILL_IMMEDIATELY = :BILL_IMMEDIATELY
+            BILL_ON_NEXT_COLLECTION_DATE = :BILL_ON_NEXT_COLLECTION_DATE
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # Determines how the subscription's quantity is controlled. Defaults to
+        # QUANTITY_ONLY. **QUANTITY_ONLY**: The subscription quantity is specified
+        # directly on the subscription. `initial_quantity` must be provided with this
+        # option. Compatible with recurring commits/credits that use POOLED allocation.
+        # **SEAT_BASED**: Use when you want to pass specific seat identifiers (e.g. add
+        # user_123) to increment and decrement a subscription quantity, rather than
+        # directly providing the quantity. You must use a **SEAT_BASED** subscription to
+        # use a linked recurring credit with an allocation per seat. `seat_config` must be
+        # provided with this option.
+        #
+        # @see MetronomeSDK::Models::ContractV2::Subscription#quantity_management_mode
+        module QuantityManagementMode
+          extend MetronomeSDK::Internal::Type::Enum
+
+          SEAT_BASED = :SEAT_BASED
+          QUANTITY_ONLY = :QUANTITY_ONLY
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        class QuantitySchedule < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute quantity
+          #
+          #   @return [Float]
+          required :quantity, Float
+
+          # @!attribute starting_at
+          #
+          #   @return [Time]
+          required :starting_at, Time
+
+          # @!attribute ending_before
+          #
+          #   @return [Time, nil]
+          optional :ending_before, Time
+
+          # @!method initialize(quantity:, starting_at:, ending_before: nil)
+          #   @param quantity [Float]
+          #   @param starting_at [Time]
+          #   @param ending_before [Time]
+        end
+
+        # @see MetronomeSDK::Models::ContractV2::Subscription#subscription_rate
+        class SubscriptionRate < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute billing_frequency
+          #
+          #   @return [Symbol, MetronomeSDK::Models::ContractV2::Subscription::SubscriptionRate::BillingFrequency]
+          required :billing_frequency,
+                   enum: -> { MetronomeSDK::ContractV2::Subscription::SubscriptionRate::BillingFrequency }
+
+          # @!attribute product
+          #
+          #   @return [MetronomeSDK::Models::ContractV2::Subscription::SubscriptionRate::Product]
+          required :product, -> { MetronomeSDK::ContractV2::Subscription::SubscriptionRate::Product }
+
+          # @!method initialize(billing_frequency:, product:)
+          #   @param billing_frequency [Symbol, MetronomeSDK::Models::ContractV2::Subscription::SubscriptionRate::BillingFrequency]
+          #   @param product [MetronomeSDK::Models::ContractV2::Subscription::SubscriptionRate::Product]
+
+          # @see MetronomeSDK::Models::ContractV2::Subscription::SubscriptionRate#billing_frequency
+          module BillingFrequency
+            extend MetronomeSDK::Internal::Type::Enum
+
+            MONTHLY = :MONTHLY
+            QUARTERLY = :QUARTERLY
+            ANNUAL = :ANNUAL
+            WEEKLY = :WEEKLY
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see MetronomeSDK::Models::ContractV2::Subscription::SubscriptionRate#product
+          class Product < MetronomeSDK::Internal::Type::BaseModel
+            # @!attribute id
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!attribute name
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!method initialize(id:, name:)
+            #   @param id [String]
+            #   @param name [String]
+          end
+        end
+
+        # @see MetronomeSDK::Models::ContractV2::Subscription#seat_config
+        class SeatConfig < MetronomeSDK::Internal::Type::BaseModel
+          # @!attribute seat_group_key
+          #   The property name, sent on usage events, that identifies the seat ID associated
+          #   with the usage event. For example, the property name might be seat_id or
+          #   user_id. The property must be set as a group key on billable metrics and a
+          #   presentation/pricing group key on contract products. This allows linked
+          #   recurring credits with an allocation per seat to be consumed by only one seat's
+          #   usage.
+          #
+          #   @return [String]
+          required :seat_group_key, String
+
+          # @!method initialize(seat_group_key:)
+          #   Some parameter documentations has been truncated, see
+          #   {MetronomeSDK::Models::ContractV2::Subscription::SeatConfig} for more details.
+          #
+          #   @param seat_group_key [String] The property name, sent on usage events, that identifies the seat ID associated
+        end
+      end
     end
   end
 end