metronome-sdk 0.1.0.pre.alpha.2 → 0.1.0.pre.alpha.4

data/rbi/metronome_sdk/models/contract_without_amendments.rbi

@@ -66,6 +66,28 @@ module MetronomeSDK
       sig { params(ending_before: Time).void }
       attr_writer :ending_before
 
+      # Either a **parent** configuration with a list of children or a **child**
+      # configuration with a single parent.
+      sig do
+        returns(
+          T.nilable(
+            MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::Variants
+          )
+        )
+      end
+      attr_reader :hierarchy_configuration
+
+      sig do
+        params(
+          hierarchy_configuration:
+            T.any(
+              MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ParentHierarchyConfiguration::OrHash,
+              MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ChildHierarchyConfiguration::OrHash
+            )
+        ).void
+      end
+      attr_writer :hierarchy_configuration
+
       sig { returns(T.nilable(String)) }
       attr_reader :name
 
@@ -260,6 +282,11 @@ module MetronomeSDK
           credits: T::Array[MetronomeSDK::Credit::OrHash],
           discounts: T::Array[MetronomeSDK::Discount::OrHash],
           ending_before: Time,
+          hierarchy_configuration:
+            T.any(
+              MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ParentHierarchyConfiguration::OrHash,
+              MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ChildHierarchyConfiguration::OrHash
+            ),
           name: String,
           net_payment_terms_days: Float,
           netsuite_sales_order_id: String,
@@ -302,6 +329,9 @@ module MetronomeSDK
         # This field's availability is dependent on your client's configuration.
         discounts: nil,
         ending_before: nil,
+        # Either a **parent** configuration with a list of children or a **child**
+        # configuration with a single parent.
+        hierarchy_configuration: nil,
         name: nil,
         net_payment_terms_days: nil,
         # This field's availability is dependent on your client's configuration.
@@ -345,6 +375,8 @@ module MetronomeSDK
             credits: T::Array[MetronomeSDK::Credit],
             discounts: T::Array[MetronomeSDK::Discount],
             ending_before: Time,
+            hierarchy_configuration:
+              MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::Variants,
             name: String,
             net_payment_terms_days: Float,
             netsuite_sales_order_id: String,
@@ -549,6 +581,187 @@ module MetronomeSDK
         end
       end
 
+      # Either a **parent** configuration with a list of children or a **child**
+      # configuration with a single parent.
+      module HierarchyConfiguration
+        extend MetronomeSDK::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ParentHierarchyConfiguration,
+              MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ChildHierarchyConfiguration
+            )
+          end
+
+        class ParentHierarchyConfiguration < MetronomeSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ParentHierarchyConfiguration,
+                MetronomeSDK::Internal::AnyHash
+              )
+            end
+
+          # List of contracts that belong to this parent.
+          sig do
+            returns(
+              T::Array[
+                MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ParentHierarchyConfiguration::Child
+              ]
+            )
+          end
+          attr_accessor :children
+
+          sig do
+            params(
+              children:
+                T::Array[
+                  MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ParentHierarchyConfiguration::Child::OrHash
+                ]
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # List of contracts that belong to this parent.
+            children:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                children:
+                  T::Array[
+                    MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ParentHierarchyConfiguration::Child
+                  ]
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class Child < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ParentHierarchyConfiguration::Child,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            sig { returns(String) }
+            attr_accessor :contract_id
+
+            sig { returns(String) }
+            attr_accessor :customer_id
+
+            sig do
+              params(contract_id: String, customer_id: String).returns(
+                T.attached_class
+              )
+            end
+            def self.new(contract_id:, customer_id:)
+            end
+
+            sig do
+              override.returns({ contract_id: String, customer_id: String })
+            end
+            def to_hash
+            end
+          end
+        end
+
+        class ChildHierarchyConfiguration < MetronomeSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ChildHierarchyConfiguration,
+                MetronomeSDK::Internal::AnyHash
+              )
+            end
+
+          # The single parent contract/customer for this child.
+          sig do
+            returns(
+              MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ChildHierarchyConfiguration::Parent
+            )
+          end
+          attr_reader :parent
+
+          sig do
+            params(
+              parent:
+                MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ChildHierarchyConfiguration::Parent::OrHash
+            ).void
+          end
+          attr_writer :parent
+
+          sig do
+            params(
+              parent:
+                MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ChildHierarchyConfiguration::Parent::OrHash
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The single parent contract/customer for this child.
+            parent:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                parent:
+                  MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ChildHierarchyConfiguration::Parent
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class Parent < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::ChildHierarchyConfiguration::Parent,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            sig { returns(String) }
+            attr_accessor :contract_id
+
+            sig { returns(String) }
+            attr_accessor :customer_id
+
+            # The single parent contract/customer for this child.
+            sig do
+              params(contract_id: String, customer_id: String).returns(
+                T.attached_class
+              )
+            end
+            def self.new(contract_id:, customer_id:)
+            end
+
+            sig do
+              override.returns({ contract_id: String, customer_id: String })
+            end
+            def to_hash
+            end
+          end
+        end
+
+        sig do
+          override.returns(
+            T::Array[
+              MetronomeSDK::ContractWithoutAmendments::HierarchyConfiguration::Variants
+            ]
+          )
+        end
+        def self.variants
+        end
+      end
+
       class PrepaidBalanceThresholdConfiguration < MetronomeSDK::Internal::Type::BaseModel
         OrHash =
           T.type_alias do
@@ -603,6 +816,14 @@ module MetronomeSDK
         sig { returns(Float) }
         attr_accessor :threshold_amount
 
+        # If provided, the threshold, recharge-to amount, and the resulting threshold
+        # commit amount will be in terms of this credit type instead of the fiat currency.
+        sig { returns(T.nilable(String)) }
+        attr_reader :custom_credit_type_id
+
+        sig { params(custom_credit_type_id: String).void }
+        attr_writer :custom_credit_type_id
+
         sig do
           params(
             commit:
@@ -611,7 +832,8 @@ module MetronomeSDK
             payment_gate_config:
               MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::OrHash,
             recharge_to_amount: Float,
-            threshold_amount: Float
+            threshold_amount: Float,
+            custom_credit_type_id: String
           ).returns(T.attached_class)
         end
         def self.new(
@@ -625,7 +847,10 @@ module MetronomeSDK
           recharge_to_amount:,
           # Specify the threshold amount for the contract. Each time the contract's prepaid
           # balance lowers to this amount, a threshold charge will be initiated.
-          threshold_amount:
+          threshold_amount:,
+          # If provided, the threshold, recharge-to amount, and the resulting threshold
+          # commit amount will be in terms of this credit type instead of the fiat currency.
+          custom_credit_type_id: nil
         )
         end
 
@@ -638,7 +863,8 @@ module MetronomeSDK
               payment_gate_config:
                 MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig,
               recharge_to_amount: Float,
-              threshold_amount: Float
+              threshold_amount: Float,
+              custom_credit_type_id: String
             }
           )
         end
@@ -659,17 +885,18 @@ module MetronomeSDK
           sig { returns(String) }
           attr_accessor :product_id
 
-          # Which products the threshold commit applies to. If both applicable_product_ids
-          # and applicable_product_tags are not provided, the commit applies to all
-          # products.
+          # Which products the threshold commit applies to. If applicable_product_ids,
+          # applicable_product_tags or specifiers are not provided, the commit applies to
+          # all products.
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :applicable_product_ids
 
           sig { params(applicable_product_ids: T::Array[String]).void }
           attr_writer :applicable_product_ids
 
-          # Which tags the threshold commit applies to. If both applicable_product_ids and
-          # applicable_product_tags are not provided, the commit applies to all products.
+          # Which tags the threshold commit applies to. If applicable_product_ids,
+          # applicable_product_tags or specifiers are not provided, the commit applies to
+          # all products.
           sig { returns(T.nilable(T::Array[String])) }
           attr_reader :applicable_product_tags
 
@@ -690,30 +917,65 @@ module MetronomeSDK
           sig { params(name: String).void }
           attr_writer :name
 
+          # List of filters that determine what kind of customer usage draws down a commit
+          # or credit. A customer's usage needs to meet the condition of at least one of the
+          # specifiers to contribute to a commit's or credit's drawdown. This field cannot
+          # be used together with `applicable_product_ids` or `applicable_product_tags`.
+          sig do
+            returns(
+              T.nilable(
+                T::Array[
+                  MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::Commit::Specifier
+                ]
+              )
+            )
+          end
+          attr_reader :specifiers
+
+          sig do
+            params(
+              specifiers:
+                T::Array[
+                  MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::Commit::Specifier::OrHash
+                ]
+            ).void
+          end
+          attr_writer :specifiers
+
           sig do
             params(
               product_id: String,
               applicable_product_ids: T::Array[String],
               applicable_product_tags: T::Array[String],
               description: String,
-              name: String
+              name: String,
+              specifiers:
+                T::Array[
+                  MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::Commit::Specifier::OrHash
+                ]
             ).returns(T.attached_class)
           end
           def self.new(
             # The commit product that will be used to generate the line item for commit
             # payment.
             product_id:,
-            # Which products the threshold commit applies to. If both applicable_product_ids
-            # and applicable_product_tags are not provided, the commit applies to all
-            # products.
+            # Which products the threshold commit applies to. If applicable_product_ids,
+            # applicable_product_tags or specifiers are not provided, the commit applies to
+            # all products.
             applicable_product_ids: nil,
-            # Which tags the threshold commit applies to. If both applicable_product_ids and
-            # applicable_product_tags are not provided, the commit applies to all products.
+            # Which tags the threshold commit applies to. If applicable_product_ids,
+            # applicable_product_tags or specifiers are not provided, the commit applies to
+            # all products.
             applicable_product_tags: nil,
             description: nil,
             # Specify the name of the line item for the threshold charge. If left blank, it
             # will default to the commit product name.
-            name: nil
+            name: nil,
+            # List of filters that determine what kind of customer usage draws down a commit
+            # or credit. A customer's usage needs to meet the condition of at least one of the
+            # specifiers to contribute to a commit's or credit's drawdown. This field cannot
+            # be used together with `applicable_product_ids` or `applicable_product_tags`.
+            specifiers: nil
           )
           end
 
@@ -724,12 +986,87 @@ module MetronomeSDK
                 applicable_product_ids: T::Array[String],
                 applicable_product_tags: T::Array[String],
                 description: String,
-                name: String
+                name: String,
+                specifiers:
+                  T::Array[
+                    MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::Commit::Specifier
+                  ]
               }
             )
           end
           def to_hash
           end
+
+          class Specifier < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::Commit::Specifier,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            sig { returns(T.nilable(T::Hash[Symbol, String])) }
+            attr_reader :presentation_group_values
+
+            sig do
+              params(presentation_group_values: T::Hash[Symbol, String]).void
+            end
+            attr_writer :presentation_group_values
+
+            sig { returns(T.nilable(T::Hash[Symbol, String])) }
+            attr_reader :pricing_group_values
+
+            sig { params(pricing_group_values: T::Hash[Symbol, String]).void }
+            attr_writer :pricing_group_values
+
+            # If provided, the specifier will only apply to the product with the specified ID.
+            sig { returns(T.nilable(String)) }
+            attr_reader :product_id
+
+            sig { params(product_id: String).void }
+            attr_writer :product_id
+
+            # If provided, the specifier will only apply to products with all the specified
+            # tags.
+            sig { returns(T.nilable(T::Array[String])) }
+            attr_reader :product_tags
+
+            sig { params(product_tags: T::Array[String]).void }
+            attr_writer :product_tags
+
+            sig do
+              params(
+                presentation_group_values: T::Hash[Symbol, String],
+                pricing_group_values: T::Hash[Symbol, String],
+                product_id: String,
+                product_tags: T::Array[String]
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              presentation_group_values: nil,
+              pricing_group_values: nil,
+              # If provided, the specifier will only apply to the product with the specified ID.
+              product_id: nil,
+              # If provided, the specifier will only apply to products with all the specified
+              # tags.
+              product_tags: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  presentation_group_values: T::Hash[Symbol, String],
+                  pricing_group_values: T::Hash[Symbol, String],
+                  product_id: String,
+                  product_tags: T::Array[String]
+                }
+              )
+            end
+            def to_hash
+            end
+          end
         end
 
         class PaymentGateConfig < MetronomeSDK::Internal::Type::BaseModel
@@ -752,7 +1089,25 @@ module MetronomeSDK
           end
           attr_accessor :payment_gate_type
 
-          # Only applicable if using Stripe as your payment gateway through Metronome.
+          # Only applicable if using PRECALCULATED as your tax type.
+          sig do
+            returns(
+              T.nilable(
+                MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig
+              )
+            )
+          end
+          attr_reader :precalculated_tax_config
+
+          sig do
+            params(
+              precalculated_tax_config:
+                MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig::OrHash
+            ).void
+          end
+          attr_writer :precalculated_tax_config
+
+          # Only applicable if using STRIPE as your payment gate type.
           sig do
             returns(
               T.nilable(
@@ -794,6 +1149,8 @@ module MetronomeSDK
             params(
               payment_gate_type:
                 MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::PaymentGateType::OrSymbol,
+              precalculated_tax_config:
+                MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig::OrHash,
               stripe_config:
                 MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::StripeConfig::OrHash,
               tax_type:
@@ -806,7 +1163,9 @@ module MetronomeSDK
             # facilitate payment using your own payment integration. Select NONE if you do not
             # wish to payment gate the commit balance.
             payment_gate_type:,
-            # Only applicable if using Stripe as your payment gateway through Metronome.
+            # Only applicable if using PRECALCULATED as your tax type.
+            precalculated_tax_config: nil,
+            # Only applicable if using STRIPE as your payment gate type.
             stripe_config: nil,
             # Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
             # not wish Metronome to calculate tax on your behalf. Leaving this field blank
@@ -820,6 +1179,8 @@ module MetronomeSDK
               {
                 payment_gate_type:
                   MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::PaymentGateType::TaggedSymbol,
+                precalculated_tax_config:
+                  MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig,
                 stripe_config:
                   MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::StripeConfig,
                 tax_type:
@@ -873,6 +1234,49 @@ module MetronomeSDK
             end
           end
 
+          class PrecalculatedTaxConfig < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            # Amount of tax to be applied. This should be in the same currency and
+            # denomination as the commit's invoice schedule
+            sig { returns(Float) }
+            attr_accessor :tax_amount
+
+            # Name of the tax to be applied. This may be used in an invoice line item
+            # description.
+            sig { returns(T.nilable(String)) }
+            attr_reader :tax_name
+
+            sig { params(tax_name: String).void }
+            attr_writer :tax_name
+
+            # Only applicable if using PRECALCULATED as your tax type.
+            sig do
+              params(tax_amount: Float, tax_name: String).returns(
+                T.attached_class
+              )
+            end
+            def self.new(
+              # Amount of tax to be applied. This should be in the same currency and
+              # denomination as the commit's invoice schedule
+              tax_amount:,
+              # Name of the tax to be applied. This may be used in an invoice line item
+              # description.
+              tax_name: nil
+            )
+            end
+
+            sig { override.returns({ tax_amount: Float, tax_name: String }) }
+            def to_hash
+            end
+          end
+
           class StripeConfig < MetronomeSDK::Internal::Type::BaseModel
             OrHash =
               T.type_alias do
@@ -890,16 +1294,28 @@ module MetronomeSDK
             end
             attr_accessor :payment_type
 
-            # Only applicable if using Stripe as your payment gateway through Metronome.
+            # Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
+            # your payment type.
+            sig { returns(T.nilable(T::Hash[Symbol, String])) }
+            attr_reader :invoice_metadata
+
+            sig { params(invoice_metadata: T::Hash[Symbol, String]).void }
+            attr_writer :invoice_metadata
+
+            # Only applicable if using STRIPE as your payment gate type.
             sig do
               params(
                 payment_type:
-                  MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::StripeConfig::PaymentType::OrSymbol
+                  MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::StripeConfig::PaymentType::OrSymbol,
+                invoice_metadata: T::Hash[Symbol, String]
               ).returns(T.attached_class)
             end
             def self.new(
               # If left blank, will default to INVOICE
-              payment_type:
+              payment_type:,
+              # Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
+              # your payment type.
+              invoice_metadata: nil
             )
             end
 
@@ -907,7 +1323,8 @@ module MetronomeSDK
               override.returns(
                 {
                   payment_type:
-                    MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::StripeConfig::PaymentType::TaggedSymbol
+                    MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::StripeConfig::PaymentType::TaggedSymbol,
+                  invoice_metadata: T::Hash[Symbol, String]
                 }
               )
             end
@@ -975,6 +1392,16 @@ module MetronomeSDK
                 :STRIPE,
                 MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::TaxType::TaggedSymbol
               )
+            ANROK =
+              T.let(
+                :ANROK,
+                MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::TaxType::TaggedSymbol
+              )
+            PRECALCULATED =
+              T.let(
+                :PRECALCULATED,
+                MetronomeSDK::ContractWithoutAmendments::PrepaidBalanceThresholdConfiguration::PaymentGateConfig::TaxType::TaggedSymbol
+              )
 
             sig do
               override.returns(
@@ -1163,7 +1590,7 @@ module MetronomeSDK
         # The frequency at which the recurring commits will be created. If not provided: -
         # The commits will be created on the usage invoice frequency. If provided: - The
         # period defined in the duration will correspond to this frequency. - Commits will
-        # be created aligned with the recurring commit's start_date rather than the usage
+        # be created aligned with the recurring commit's starting_at rather than the usage
         # invoice dates.
         sig do
           returns(
@@ -1191,6 +1618,30 @@ module MetronomeSDK
         sig { params(rollover_fraction: Float).void }
         attr_writer :rollover_fraction
 
+        # List of filters that determine what kind of customer usage draws down a commit
+        # or credit. A customer's usage needs to meet the condition of at least one of the
+        # specifiers to contribute to a commit's or credit's drawdown.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[
+                MetronomeSDK::ContractWithoutAmendments::RecurringCommit::Specifier
+              ]
+            )
+          )
+        end
+        attr_reader :specifiers
+
+        sig do
+          params(
+            specifiers:
+              T::Array[
+                MetronomeSDK::ContractWithoutAmendments::RecurringCommit::Specifier::OrHash
+              ]
+          ).void
+        end
+        attr_writer :specifiers
+
         sig do
           params(
             id: String,
@@ -1218,7 +1669,11 @@ module MetronomeSDK
               MetronomeSDK::ContractWithoutAmendments::RecurringCommit::Proration::OrSymbol,
             recurrence_frequency:
               MetronomeSDK::ContractWithoutAmendments::RecurringCommit::RecurrenceFrequency::OrSymbol,
-            rollover_fraction: Float
+            rollover_fraction: Float,
+            specifiers:
+              T::Array[
+                MetronomeSDK::ContractWithoutAmendments::RecurringCommit::Specifier::OrHash
+              ]
           ).returns(T.attached_class)
         end
         def self.new(
@@ -1255,13 +1710,17 @@ module MetronomeSDK
           # The frequency at which the recurring commits will be created. If not provided: -
           # The commits will be created on the usage invoice frequency. If provided: - The
           # period defined in the duration will correspond to this frequency. - Commits will
-          # be created aligned with the recurring commit's start_date rather than the usage
+          # be created aligned with the recurring commit's starting_at rather than the usage
           # invoice dates.
           recurrence_frequency: nil,
           # Will be passed down to the individual commits. This controls how much of an
           # individual unexpired commit will roll over upon contract transition. Must be
           # between 0 and 1.
-          rollover_fraction: nil
+          rollover_fraction: nil,
+          # List of filters that determine what kind of customer usage draws down a commit
+          # or credit. A customer's usage needs to meet the condition of at least one of the
+          # specifiers to contribute to a commit's or credit's drawdown.
+          specifiers: nil
         )
         end
 
@@ -1293,7 +1752,11 @@ module MetronomeSDK
                 MetronomeSDK::ContractWithoutAmendments::RecurringCommit::Proration::TaggedSymbol,
               recurrence_frequency:
                 MetronomeSDK::ContractWithoutAmendments::RecurringCommit::RecurrenceFrequency::TaggedSymbol,
-              rollover_fraction: Float
+              rollover_fraction: Float,
+              specifiers:
+                T::Array[
+                  MetronomeSDK::ContractWithoutAmendments::RecurringCommit::Specifier
+                ]
             }
           )
         end
@@ -1312,26 +1775,29 @@ module MetronomeSDK
           sig { returns(String) }
           attr_accessor :credit_type_id
 
-          sig { returns(Float) }
-          attr_accessor :quantity
-
           sig { returns(Float) }
           attr_accessor :unit_price
 
+          sig { returns(T.nilable(Float)) }
+          attr_reader :quantity
+
+          sig { params(quantity: Float).void }
+          attr_writer :quantity
+
           # The amount of commit to grant.
           sig do
             params(
               credit_type_id: String,
-              quantity: Float,
-              unit_price: Float
+              unit_price: Float,
+              quantity: Float
             ).returns(T.attached_class)
           end
-          def self.new(credit_type_id:, quantity:, unit_price:)
+          def self.new(credit_type_id:, unit_price:, quantity: nil)
           end
 
           sig do
             override.returns(
-              { credit_type_id: String, quantity: Float, unit_price: Float }
+              { credit_type_id: String, unit_price: Float, quantity: Float }
             )
           end
           def to_hash
@@ -1587,7 +2053,7 @@ module MetronomeSDK
         # The frequency at which the recurring commits will be created. If not provided: -
         # The commits will be created on the usage invoice frequency. If provided: - The
         # period defined in the duration will correspond to this frequency. - Commits will
-        # be created aligned with the recurring commit's start_date rather than the usage
+        # be created aligned with the recurring commit's starting_at rather than the usage
         # invoice dates.
         module RecurrenceFrequency
           extend MetronomeSDK::Internal::Type::Enum
@@ -1632,6 +2098,77 @@ module MetronomeSDK
           def self.values
           end
         end
+
+        class Specifier < MetronomeSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                MetronomeSDK::ContractWithoutAmendments::RecurringCommit::Specifier,
+                MetronomeSDK::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T.nilable(T::Hash[Symbol, String])) }
+          attr_reader :presentation_group_values
+
+          sig do
+            params(presentation_group_values: T::Hash[Symbol, String]).void
+          end
+          attr_writer :presentation_group_values
+
+          sig { returns(T.nilable(T::Hash[Symbol, String])) }
+          attr_reader :pricing_group_values
+
+          sig { params(pricing_group_values: T::Hash[Symbol, String]).void }
+          attr_writer :pricing_group_values
+
+          # If provided, the specifier will only apply to the product with the specified ID.
+          sig { returns(T.nilable(String)) }
+          attr_reader :product_id
+
+          sig { params(product_id: String).void }
+          attr_writer :product_id
+
+          # If provided, the specifier will only apply to products with all the specified
+          # tags.
+          sig { returns(T.nilable(T::Array[String])) }
+          attr_reader :product_tags
+
+          sig { params(product_tags: T::Array[String]).void }
+          attr_writer :product_tags
+
+          sig do
+            params(
+              presentation_group_values: T::Hash[Symbol, String],
+              pricing_group_values: T::Hash[Symbol, String],
+              product_id: String,
+              product_tags: T::Array[String]
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            presentation_group_values: nil,
+            pricing_group_values: nil,
+            # If provided, the specifier will only apply to the product with the specified ID.
+            product_id: nil,
+            # If provided, the specifier will only apply to products with all the specified
+            # tags.
+            product_tags: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                presentation_group_values: T::Hash[Symbol, String],
+                pricing_group_values: T::Hash[Symbol, String],
+                product_id: String,
+                product_tags: T::Array[String]
+              }
+            )
+          end
+          def to_hash
+          end
+        end
       end
 
       class RecurringCredit < MetronomeSDK::Internal::Type::BaseModel
@@ -1790,7 +2327,7 @@ module MetronomeSDK
         # The frequency at which the recurring commits will be created. If not provided: -
         # The commits will be created on the usage invoice frequency. If provided: - The
         # period defined in the duration will correspond to this frequency. - Commits will
-        # be created aligned with the recurring commit's start_date rather than the usage
+        # be created aligned with the recurring commit's starting_at rather than the usage
         # invoice dates.
         sig do
           returns(
@@ -1818,6 +2355,30 @@ module MetronomeSDK
         sig { params(rollover_fraction: Float).void }
         attr_writer :rollover_fraction
 
+        # List of filters that determine what kind of customer usage draws down a commit
+        # or credit. A customer's usage needs to meet the condition of at least one of the
+        # specifiers to contribute to a commit's or credit's drawdown.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[
+                MetronomeSDK::ContractWithoutAmendments::RecurringCredit::Specifier
+              ]
+            )
+          )
+        end
+        attr_reader :specifiers
+
+        sig do
+          params(
+            specifiers:
+              T::Array[
+                MetronomeSDK::ContractWithoutAmendments::RecurringCredit::Specifier::OrHash
+              ]
+          ).void
+        end
+        attr_writer :specifiers
+
         sig do
           params(
             id: String,
@@ -1843,7 +2404,11 @@ module MetronomeSDK
               MetronomeSDK::ContractWithoutAmendments::RecurringCredit::Proration::OrSymbol,
             recurrence_frequency:
               MetronomeSDK::ContractWithoutAmendments::RecurringCredit::RecurrenceFrequency::OrSymbol,
-            rollover_fraction: Float
+            rollover_fraction: Float,
+            specifiers:
+              T::Array[
+                MetronomeSDK::ContractWithoutAmendments::RecurringCredit::Specifier::OrHash
+              ]
           ).returns(T.attached_class)
         end
         def self.new(
@@ -1878,13 +2443,17 @@ module MetronomeSDK
           # The frequency at which the recurring commits will be created. If not provided: -
           # The commits will be created on the usage invoice frequency. If provided: - The
           # period defined in the duration will correspond to this frequency. - Commits will
-          # be created aligned with the recurring commit's start_date rather than the usage
+          # be created aligned with the recurring commit's starting_at rather than the usage
           # invoice dates.
           recurrence_frequency: nil,
           # Will be passed down to the individual commits. This controls how much of an
           # individual unexpired commit will roll over upon contract transition. Must be
           # between 0 and 1.
-          rollover_fraction: nil
+          rollover_fraction: nil,
+          # List of filters that determine what kind of customer usage draws down a commit
+          # or credit. A customer's usage needs to meet the condition of at least one of the
+          # specifiers to contribute to a commit's or credit's drawdown.
+          specifiers: nil
         )
         end
 
@@ -1914,7 +2483,11 @@ module MetronomeSDK
                 MetronomeSDK::ContractWithoutAmendments::RecurringCredit::Proration::TaggedSymbol,
               recurrence_frequency:
                 MetronomeSDK::ContractWithoutAmendments::RecurringCredit::RecurrenceFrequency::TaggedSymbol,
-              rollover_fraction: Float
+              rollover_fraction: Float,
+              specifiers:
+                T::Array[
+                  MetronomeSDK::ContractWithoutAmendments::RecurringCredit::Specifier
+                ]
             }
           )
         end
@@ -1933,26 +2506,29 @@ module MetronomeSDK
           sig { returns(String) }
           attr_accessor :credit_type_id
 
-          sig { returns(Float) }
-          attr_accessor :quantity
-
           sig { returns(Float) }
           attr_accessor :unit_price
 
+          sig { returns(T.nilable(Float)) }
+          attr_reader :quantity
+
+          sig { params(quantity: Float).void }
+          attr_writer :quantity
+
           # The amount of commit to grant.
           sig do
             params(
               credit_type_id: String,
-              quantity: Float,
-              unit_price: Float
+              unit_price: Float,
+              quantity: Float
             ).returns(T.attached_class)
           end
-          def self.new(credit_type_id:, quantity:, unit_price:)
+          def self.new(credit_type_id:, unit_price:, quantity: nil)
           end
 
           sig do
             override.returns(
-              { credit_type_id: String, quantity: Float, unit_price: Float }
+              { credit_type_id: String, unit_price: Float, quantity: Float }
             )
           end
           def to_hash
@@ -2170,7 +2746,7 @@ module MetronomeSDK
         # The frequency at which the recurring commits will be created. If not provided: -
         # The commits will be created on the usage invoice frequency. If provided: - The
         # period defined in the duration will correspond to this frequency. - Commits will
-        # be created aligned with the recurring commit's start_date rather than the usage
+        # be created aligned with the recurring commit's starting_at rather than the usage
         # invoice dates.
         module RecurrenceFrequency
           extend MetronomeSDK::Internal::Type::Enum
@@ -2215,6 +2791,77 @@ module MetronomeSDK
           def self.values
           end
         end
+
+        class Specifier < MetronomeSDK::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                MetronomeSDK::ContractWithoutAmendments::RecurringCredit::Specifier,
+                MetronomeSDK::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T.nilable(T::Hash[Symbol, String])) }
+          attr_reader :presentation_group_values
+
+          sig do
+            params(presentation_group_values: T::Hash[Symbol, String]).void
+          end
+          attr_writer :presentation_group_values
+
+          sig { returns(T.nilable(T::Hash[Symbol, String])) }
+          attr_reader :pricing_group_values
+
+          sig { params(pricing_group_values: T::Hash[Symbol, String]).void }
+          attr_writer :pricing_group_values
+
+          # If provided, the specifier will only apply to the product with the specified ID.
+          sig { returns(T.nilable(String)) }
+          attr_reader :product_id
+
+          sig { params(product_id: String).void }
+          attr_writer :product_id
+
+          # If provided, the specifier will only apply to products with all the specified
+          # tags.
+          sig { returns(T.nilable(T::Array[String])) }
+          attr_reader :product_tags
+
+          sig { params(product_tags: T::Array[String]).void }
+          attr_writer :product_tags
+
+          sig do
+            params(
+              presentation_group_values: T::Hash[Symbol, String],
+              pricing_group_values: T::Hash[Symbol, String],
+              product_id: String,
+              product_tags: T::Array[String]
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            presentation_group_values: nil,
+            pricing_group_values: nil,
+            # If provided, the specifier will only apply to the product with the specified ID.
+            product_id: nil,
+            # If provided, the specifier will only apply to products with all the specified
+            # tags.
+            product_tags: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                presentation_group_values: T::Hash[Symbol, String],
+                pricing_group_values: T::Hash[Symbol, String],
+                product_id: String,
+                product_tags: T::Array[String]
+              }
+            )
+          end
+          def to_hash
+          end
+        end
       end
 
       class ResellerRoyalty < MetronomeSDK::Internal::Type::BaseModel
@@ -2596,7 +3243,25 @@ module MetronomeSDK
           end
           attr_accessor :payment_gate_type
 
-          # Only applicable if using Stripe as your payment gateway through Metronome.
+          # Only applicable if using PRECALCULATED as your tax type.
+          sig do
+            returns(
+              T.nilable(
+                MetronomeSDK::ContractWithoutAmendments::SpendThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig
+              )
+            )
+          end
+          attr_reader :precalculated_tax_config
+
+          sig do
+            params(
+              precalculated_tax_config:
+                MetronomeSDK::ContractWithoutAmendments::SpendThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig::OrHash
+            ).void
+          end
+          attr_writer :precalculated_tax_config
+
+          # Only applicable if using STRIPE as your payment gate type.
           sig do
             returns(
               T.nilable(
@@ -2638,6 +3303,8 @@ module MetronomeSDK
             params(
               payment_gate_type:
                 MetronomeSDK::ContractWithoutAmendments::SpendThresholdConfiguration::PaymentGateConfig::PaymentGateType::OrSymbol,
+              precalculated_tax_config:
+                MetronomeSDK::ContractWithoutAmendments::SpendThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig::OrHash,
               stripe_config:
                 MetronomeSDK::ContractWithoutAmendments::SpendThresholdConfiguration::PaymentGateConfig::StripeConfig::OrHash,
               tax_type:
@@ -2650,7 +3317,9 @@ module MetronomeSDK
             # facilitate payment using your own payment integration. Select NONE if you do not
             # wish to payment gate the commit balance.
             payment_gate_type:,
-            # Only applicable if using Stripe as your payment gateway through Metronome.
+            # Only applicable if using PRECALCULATED as your tax type.
+            precalculated_tax_config: nil,
+            # Only applicable if using STRIPE as your payment gate type.
             stripe_config: nil,
             # Stripe tax is only supported for Stripe payment gateway. Select NONE if you do
             # not wish Metronome to calculate tax on your behalf. Leaving this field blank
@@ -2664,6 +3333,8 @@ module MetronomeSDK
               {
                 payment_gate_type:
                   MetronomeSDK::ContractWithoutAmendments::SpendThresholdConfiguration::PaymentGateConfig::PaymentGateType::TaggedSymbol,
+                precalculated_tax_config:
+                  MetronomeSDK::ContractWithoutAmendments::SpendThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig,
                 stripe_config:
                   MetronomeSDK::ContractWithoutAmendments::SpendThresholdConfiguration::PaymentGateConfig::StripeConfig,
                 tax_type:
@@ -2717,6 +3388,49 @@ module MetronomeSDK
             end
           end
 
+          class PrecalculatedTaxConfig < MetronomeSDK::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  MetronomeSDK::ContractWithoutAmendments::SpendThresholdConfiguration::PaymentGateConfig::PrecalculatedTaxConfig,
+                  MetronomeSDK::Internal::AnyHash
+                )
+              end
+
+            # Amount of tax to be applied. This should be in the same currency and
+            # denomination as the commit's invoice schedule
+            sig { returns(Float) }
+            attr_accessor :tax_amount
+
+            # Name of the tax to be applied. This may be used in an invoice line item
+            # description.
+            sig { returns(T.nilable(String)) }
+            attr_reader :tax_name
+
+            sig { params(tax_name: String).void }
+            attr_writer :tax_name
+
+            # Only applicable if using PRECALCULATED as your tax type.
+            sig do
+              params(tax_amount: Float, tax_name: String).returns(
+                T.attached_class
+              )
+            end
+            def self.new(
+              # Amount of tax to be applied. This should be in the same currency and
+              # denomination as the commit's invoice schedule
+              tax_amount:,
+              # Name of the tax to be applied. This may be used in an invoice line item
+              # description.
+              tax_name: nil
+            )
+            end
+
+            sig { override.returns({ tax_amount: Float, tax_name: String }) }
+            def to_hash
+            end
+          end
+
           class StripeConfig < MetronomeSDK::Internal::Type::BaseModel
             OrHash =
               T.type_alias do
@@ -2734,16 +3448,28 @@ module MetronomeSDK
             end
             attr_accessor :payment_type
 
-            # Only applicable if using Stripe as your payment gateway through Metronome.
+            # Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
+            # your payment type.
+            sig { returns(T.nilable(T::Hash[Symbol, String])) }
+            attr_reader :invoice_metadata
+
+            sig { params(invoice_metadata: T::Hash[Symbol, String]).void }
+            attr_writer :invoice_metadata
+
+            # Only applicable if using STRIPE as your payment gate type.
             sig do
               params(
                 payment_type:
-                  MetronomeSDK::ContractWithoutAmendments::SpendThresholdConfiguration::PaymentGateConfig::StripeConfig::PaymentType::OrSymbol
+                  MetronomeSDK::ContractWithoutAmendments::SpendThresholdConfiguration::PaymentGateConfig::StripeConfig::PaymentType::OrSymbol,
+                invoice_metadata: T::Hash[Symbol, String]
               ).returns(T.attached_class)
             end
             def self.new(
               # If left blank, will default to INVOICE
-              payment_type:
+              payment_type:,
+              # Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as
+              # your payment type.
+              invoice_metadata: nil
             )
             end
 
@@ -2751,7 +3477,8 @@ module MetronomeSDK
               override.returns(
                 {
                   payment_type:
-                    MetronomeSDK::ContractWithoutAmendments::SpendThresholdConfiguration::PaymentGateConfig::StripeConfig::PaymentType::TaggedSymbol
+                    MetronomeSDK::ContractWithoutAmendments::SpendThresholdConfiguration::PaymentGateConfig::StripeConfig::PaymentType::TaggedSymbol,
+                  invoice_metadata: T::Hash[Symbol, String]
                 }
               )
             end
@@ -2819,6 +3546,16 @@ module MetronomeSDK
                 :STRIPE,
                 MetronomeSDK::ContractWithoutAmendments::SpendThresholdConfiguration::PaymentGateConfig::TaxType::TaggedSymbol
               )
+            ANROK =
+              T.let(
+                :ANROK,
+                MetronomeSDK::ContractWithoutAmendments::SpendThresholdConfiguration::PaymentGateConfig::TaxType::TaggedSymbol
+              )
+            PRECALCULATED =
+              T.let(
+                :PRECALCULATED,
+                MetronomeSDK::ContractWithoutAmendments::SpendThresholdConfiguration::PaymentGateConfig::TaxType::TaggedSymbol
+              )
 
             sig do
               override.returns(