orb-billing 1.30.0 → 1.32.0

data/lib/orb/models/price.rb

@@ -47,6 +47,8 @@ module Orb
 
       variant :matrix_with_allocation, -> { Orb::Price::MatrixWithAllocation }
 
+      variant :tiered_matrix_with_allocation, -> { Orb::Price::TieredMatrixWithAllocation }
+
       variant :matrix_with_threshold_discounts, -> { Orb::Price::MatrixWithThresholdDiscounts }
 
       variant :tiered_with_proration, -> { Orb::Price::TieredWithProration }
@@ -6014,6 +6016,453 @@ module Orb
         end
       end
 
+      class TieredMatrixWithAllocation < Orb::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute billable_metric
+        #
+        #   @return [Orb::Models::BillableMetricTiny, nil]
+        required :billable_metric, -> { Orb::BillableMetricTiny }, nil?: true
+
+        # @!attribute billing_cycle_configuration
+        #
+        #   @return [Orb::Models::BillingCycleConfiguration]
+        required :billing_cycle_configuration, -> { Orb::BillingCycleConfiguration }
+
+        # @!attribute billing_mode
+        #
+        #   @return [Symbol, Orb::Models::Price::TieredMatrixWithAllocation::BillingMode]
+        required :billing_mode, enum: -> { Orb::Price::TieredMatrixWithAllocation::BillingMode }
+
+        # @!attribute cadence
+        #
+        #   @return [Symbol, Orb::Models::Price::TieredMatrixWithAllocation::Cadence]
+        required :cadence, enum: -> { Orb::Price::TieredMatrixWithAllocation::Cadence }
+
+        # @!attribute composite_price_filters
+        #
+        #   @return [Array<Orb::Models::Price::TieredMatrixWithAllocation::CompositePriceFilter>, nil]
+        required :composite_price_filters,
+                 -> {
+                   Orb::Internal::Type::ArrayOf[Orb::Price::TieredMatrixWithAllocation::CompositePriceFilter]
+                 },
+                 nil?: true
+
+        # @!attribute conversion_rate
+        #
+        #   @return [Float, nil]
+        required :conversion_rate, Float, nil?: true
+
+        # @!attribute conversion_rate_config
+        #
+        #   @return [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil]
+        required :conversion_rate_config, union: -> { Orb::ConversionRateConfig }, nil?: true
+
+        # @!attribute created_at
+        #
+        #   @return [Time]
+        required :created_at, Time
+
+        # @!attribute credit_allocation
+        #
+        #   @return [Orb::Models::Allocation, nil]
+        required :credit_allocation, -> { Orb::Allocation }, nil?: true
+
+        # @!attribute currency
+        #
+        #   @return [String]
+        required :currency, String
+
+        # @!attribute discount
+        #   @deprecated
+        #
+        #   @return [Orb::Models::PercentageDiscount, Orb::Models::TrialDiscount, Orb::Models::UsageDiscount, Orb::Models::AmountDiscount, Orb::Models::Discount::TieredPercentage, nil]
+        required :discount, union: -> { Orb::Discount }, nil?: true
+
+        # @!attribute external_price_id
+        #
+        #   @return [String, nil]
+        required :external_price_id, String, nil?: true
+
+        # @!attribute fixed_price_quantity
+        #
+        #   @return [Float, nil]
+        required :fixed_price_quantity, Float, nil?: true
+
+        # @!attribute invoice_grouping_key
+        #
+        #   @return [String, nil]
+        required :invoice_grouping_key, String, nil?: true
+
+        # @!attribute invoicing_cycle_configuration
+        #
+        #   @return [Orb::Models::BillingCycleConfiguration, nil]
+        required :invoicing_cycle_configuration, -> { Orb::BillingCycleConfiguration }, nil?: true
+
+        # @!attribute item
+        #   A minimal representation of an Item containing only the essential identifying
+        #   information.
+        #
+        #   @return [Orb::Models::ItemSlim]
+        required :item, -> { Orb::ItemSlim }
+
+        # @!attribute maximum
+        #   @deprecated
+        #
+        #   @return [Orb::Models::Maximum, nil]
+        required :maximum, -> { Orb::Maximum }, nil?: true
+
+        # @!attribute maximum_amount
+        #   @deprecated
+        #
+        #   @return [String, nil]
+        required :maximum_amount, String, nil?: true
+
+        # @!attribute metadata
+        #   User specified key-value pairs for the resource. If not present, this defaults
+        #   to an empty dictionary. Individual keys can be removed by setting the value to
+        #   `null`, and the entire metadata mapping can be cleared by setting `metadata` to
+        #   `null`.
+        #
+        #   @return [Hash{Symbol=>String}]
+        required :metadata, Orb::Internal::Type::HashOf[String]
+
+        # @!attribute minimum
+        #   @deprecated
+        #
+        #   @return [Orb::Models::Minimum, nil]
+        required :minimum, -> { Orb::Minimum }, nil?: true
+
+        # @!attribute minimum_amount
+        #   @deprecated
+        #
+        #   @return [String, nil]
+        required :minimum_amount, String, nil?: true
+
+        # @!attribute model_type
+        #   The pricing model type
+        #
+        #   @return [Symbol, :tiered_matrix_with_allocation]
+        required :model_type, const: :tiered_matrix_with_allocation
+
+        # @!attribute name
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute plan_phase_order
+        #
+        #   @return [Integer, nil]
+        required :plan_phase_order, Integer, nil?: true
+
+        # @!attribute price_type
+        #
+        #   @return [Symbol, Orb::Models::Price::TieredMatrixWithAllocation::PriceType]
+        required :price_type, enum: -> { Orb::Price::TieredMatrixWithAllocation::PriceType }
+
+        # @!attribute replaces_price_id
+        #   The price id this price replaces. This price will take the place of the replaced
+        #   price in plan version migrations.
+        #
+        #   @return [String, nil]
+        required :replaces_price_id, String, nil?: true
+
+        # @!attribute tiered_matrix_with_allocation_config
+        #   Configuration for tiered_matrix_with_allocation pricing
+        #
+        #   @return [Orb::Models::Price::TieredMatrixWithAllocation::TieredMatrixWithAllocationConfig]
+        required :tiered_matrix_with_allocation_config,
+                 -> { Orb::Price::TieredMatrixWithAllocation::TieredMatrixWithAllocationConfig }
+
+        # @!attribute dimensional_price_configuration
+        #
+        #   @return [Orb::Models::DimensionalPriceConfiguration, nil]
+        optional :dimensional_price_configuration, -> { Orb::DimensionalPriceConfiguration }, nil?: true
+
+        # @!attribute license_type
+        #   The LicenseType resource represents a type of license that can be assigned to
+        #   users. License types are used during billing by grouping metrics on the
+        #   configured grouping key.
+        #
+        #   @return [Orb::Models::Price::TieredMatrixWithAllocation::LicenseType, nil]
+        optional :license_type, -> { Orb::Price::TieredMatrixWithAllocation::LicenseType }, nil?: true
+
+        # @!method initialize(id:, billable_metric:, billing_cycle_configuration:, billing_mode:, cadence:, composite_price_filters:, conversion_rate:, conversion_rate_config:, created_at:, credit_allocation:, currency:, discount:, external_price_id:, fixed_price_quantity:, invoice_grouping_key:, invoicing_cycle_configuration:, item:, maximum:, maximum_amount:, metadata:, minimum:, minimum_amount:, name:, plan_phase_order:, price_type:, replaces_price_id:, tiered_matrix_with_allocation_config:, dimensional_price_configuration: nil, license_type: nil, model_type: :tiered_matrix_with_allocation)
+        #   Some parameter documentations has been truncated, see
+        #   {Orb::Models::Price::TieredMatrixWithAllocation} for more details.
+        #
+        #   @param id [String]
+        #
+        #   @param billable_metric [Orb::Models::BillableMetricTiny, nil]
+        #
+        #   @param billing_cycle_configuration [Orb::Models::BillingCycleConfiguration]
+        #
+        #   @param billing_mode [Symbol, Orb::Models::Price::TieredMatrixWithAllocation::BillingMode]
+        #
+        #   @param cadence [Symbol, Orb::Models::Price::TieredMatrixWithAllocation::Cadence]
+        #
+        #   @param composite_price_filters [Array<Orb::Models::Price::TieredMatrixWithAllocation::CompositePriceFilter>, nil]
+        #
+        #   @param conversion_rate [Float, nil]
+        #
+        #   @param conversion_rate_config [Orb::Models::UnitConversionRateConfig, Orb::Models::TieredConversionRateConfig, nil]
+        #
+        #   @param created_at [Time]
+        #
+        #   @param credit_allocation [Orb::Models::Allocation, nil]
+        #
+        #   @param currency [String]
+        #
+        #   @param discount [Orb::Models::PercentageDiscount, Orb::Models::TrialDiscount, Orb::Models::UsageDiscount, Orb::Models::AmountDiscount, Orb::Models::Discount::TieredPercentage, nil]
+        #
+        #   @param external_price_id [String, nil]
+        #
+        #   @param fixed_price_quantity [Float, nil]
+        #
+        #   @param invoice_grouping_key [String, nil]
+        #
+        #   @param invoicing_cycle_configuration [Orb::Models::BillingCycleConfiguration, nil]
+        #
+        #   @param item [Orb::Models::ItemSlim] A minimal representation of an Item containing only the essential identifying in
+        #
+        #   @param maximum [Orb::Models::Maximum, nil]
+        #
+        #   @param maximum_amount [String, nil]
+        #
+        #   @param metadata [Hash{Symbol=>String}] User specified key-value pairs for the resource. If not present, this defaults t
+        #
+        #   @param minimum [Orb::Models::Minimum, nil]
+        #
+        #   @param minimum_amount [String, nil]
+        #
+        #   @param name [String]
+        #
+        #   @param plan_phase_order [Integer, nil]
+        #
+        #   @param price_type [Symbol, Orb::Models::Price::TieredMatrixWithAllocation::PriceType]
+        #
+        #   @param replaces_price_id [String, nil] The price id this price replaces. This price will take the place of the replaced
+        #
+        #   @param tiered_matrix_with_allocation_config [Orb::Models::Price::TieredMatrixWithAllocation::TieredMatrixWithAllocationConfig] Configuration for tiered_matrix_with_allocation pricing
+        #
+        #   @param dimensional_price_configuration [Orb::Models::DimensionalPriceConfiguration, nil]
+        #
+        #   @param license_type [Orb::Models::Price::TieredMatrixWithAllocation::LicenseType, nil] The LicenseType resource represents a type of license that can be assigned to us
+        #
+        #   @param model_type [Symbol, :tiered_matrix_with_allocation] The pricing model type
+
+        # @see Orb::Models::Price::TieredMatrixWithAllocation#billing_mode
+        module BillingMode
+          extend Orb::Internal::Type::Enum
+
+          IN_ADVANCE = :in_advance
+          IN_ARREAR = :in_arrear
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see Orb::Models::Price::TieredMatrixWithAllocation#cadence
+        module Cadence
+          extend Orb::Internal::Type::Enum
+
+          ONE_TIME = :one_time
+          MONTHLY = :monthly
+          QUARTERLY = :quarterly
+          SEMI_ANNUAL = :semi_annual
+          ANNUAL = :annual
+          CUSTOM = :custom
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        class CompositePriceFilter < Orb::Internal::Type::BaseModel
+          # @!attribute field
+          #   The property of the price to filter on.
+          #
+          #   @return [Symbol, Orb::Models::Price::TieredMatrixWithAllocation::CompositePriceFilter::Field]
+          required :field, enum: -> { Orb::Price::TieredMatrixWithAllocation::CompositePriceFilter::Field }
+
+          # @!attribute operator
+          #   Should prices that match the filter be included or excluded.
+          #
+          #   @return [Symbol, Orb::Models::Price::TieredMatrixWithAllocation::CompositePriceFilter::Operator]
+          required :operator, enum: -> { Orb::Price::TieredMatrixWithAllocation::CompositePriceFilter::Operator }
+
+          # @!attribute values
+          #   The IDs or values that match this filter.
+          #
+          #   @return [Array<String>]
+          required :values, Orb::Internal::Type::ArrayOf[String]
+
+          # @!method initialize(field:, operator:, values:)
+          #   @param field [Symbol, Orb::Models::Price::TieredMatrixWithAllocation::CompositePriceFilter::Field] The property of the price to filter on.
+          #
+          #   @param operator [Symbol, Orb::Models::Price::TieredMatrixWithAllocation::CompositePriceFilter::Operator] Should prices that match the filter be included or excluded.
+          #
+          #   @param values [Array<String>] The IDs or values that match this filter.
+
+          # The property of the price to filter on.
+          #
+          # @see Orb::Models::Price::TieredMatrixWithAllocation::CompositePriceFilter#field
+          module Field
+            extend Orb::Internal::Type::Enum
+
+            PRICE_ID = :price_id
+            ITEM_ID = :item_id
+            PRICE_TYPE = :price_type
+            CURRENCY = :currency
+            PRICING_UNIT_ID = :pricing_unit_id
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # Should prices that match the filter be included or excluded.
+          #
+          # @see Orb::Models::Price::TieredMatrixWithAllocation::CompositePriceFilter#operator
+          module Operator
+            extend Orb::Internal::Type::Enum
+
+            INCLUDES = :includes
+            EXCLUDES = :excludes
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # @see Orb::Models::Price::TieredMatrixWithAllocation#price_type
+        module PriceType
+          extend Orb::Internal::Type::Enum
+
+          USAGE_PRICE = :usage_price
+          FIXED_PRICE = :fixed_price
+          COMPOSITE_PRICE = :composite_price
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see Orb::Models::Price::TieredMatrixWithAllocation#tiered_matrix_with_allocation_config
+        class TieredMatrixWithAllocationConfig < Orb::Internal::Type::BaseModel
+          # @!attribute allocation
+          #   Usage allocation, pooled across all matrix cells
+          #
+          #   @return [String]
+          required :allocation, String
+
+          # @!attribute default_unit_amount
+          #   Per unit rate for usage whose matrix cell has no configured tiers
+          #
+          #   @return [String]
+          required :default_unit_amount, String
+
+          # @!attribute dimensions
+          #   One or two event property values to evaluate matrix cells by
+          #
+          #   @return [Array<String>]
+          required :dimensions, Orb::Internal::Type::ArrayOf[String]
+
+          # @!attribute tiers
+          #   Graduated tiers keyed by matrix cell; usage in a cell is tiered only against its
+          #   own rows
+          #
+          #   @return [Array<Orb::Models::Price::TieredMatrixWithAllocation::TieredMatrixWithAllocationConfig::Tier>]
+          required :tiers,
+                   -> { Orb::Internal::Type::ArrayOf[Orb::Price::TieredMatrixWithAllocation::TieredMatrixWithAllocationConfig::Tier] }
+
+          # @!method initialize(allocation:, default_unit_amount:, dimensions:, tiers:)
+          #   Some parameter documentations has been truncated, see
+          #   {Orb::Models::Price::TieredMatrixWithAllocation::TieredMatrixWithAllocationConfig}
+          #   for more details.
+          #
+          #   Configuration for tiered_matrix_with_allocation pricing
+          #
+          #   @param allocation [String] Usage allocation, pooled across all matrix cells
+          #
+          #   @param default_unit_amount [String] Per unit rate for usage whose matrix cell has no configured tiers
+          #
+          #   @param dimensions [Array<String>] One or two event property values to evaluate matrix cells by
+          #
+          #   @param tiers [Array<Orb::Models::Price::TieredMatrixWithAllocation::TieredMatrixWithAllocationConfig::Tier>] Graduated tiers keyed by matrix cell; usage in a cell is tiered only against its
+
+          class Tier < Orb::Internal::Type::BaseModel
+            # @!attribute dimension_values
+            #   The matrix cell this tier applies to, as one or two dimension values
+            #
+            #   @return [Array<String>]
+            required :dimension_values, Orb::Internal::Type::ArrayOf[String]
+
+            # @!attribute tier_lower_bound
+            #   Exclusive tier starting value. The tier runs up to and including the next bound
+            #   configured for the same matrix cell.
+            #
+            #   @return [String]
+            required :tier_lower_bound, String
+
+            # @!attribute unit_amount
+            #   Per unit amount
+            #
+            #   @return [String]
+            required :unit_amount, String
+
+            # @!method initialize(dimension_values:, tier_lower_bound:, unit_amount:)
+            #   Some parameter documentations has been truncated, see
+            #   {Orb::Models::Price::TieredMatrixWithAllocation::TieredMatrixWithAllocationConfig::Tier}
+            #   for more details.
+            #
+            #   Configuration for a single tier scoped to one matrix cell
+            #
+            #   @param dimension_values [Array<String>] The matrix cell this tier applies to, as one or two dimension values
+            #
+            #   @param tier_lower_bound [String] Exclusive tier starting value. The tier runs up to and including the next bound
+            #
+            #   @param unit_amount [String] Per unit amount
+          end
+        end
+
+        # @see Orb::Models::Price::TieredMatrixWithAllocation#license_type
+        class LicenseType < Orb::Internal::Type::BaseModel
+          # @!attribute id
+          #   The Orb-assigned unique identifier for the license type.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute grouping_key
+          #   The key used for grouping licenses of this type. This is typically a user
+          #   identifier field.
+          #
+          #   @return [String]
+          required :grouping_key, String
+
+          # @!attribute name
+          #   The name of the license type.
+          #
+          #   @return [String]
+          required :name, String
+
+          # @!method initialize(id:, grouping_key:, name:)
+          #   Some parameter documentations has been truncated, see
+          #   {Orb::Models::Price::TieredMatrixWithAllocation::LicenseType} for more details.
+          #
+          #   The LicenseType resource represents a type of license that can be assigned to
+          #   users. License types are used during billing by grouping metrics on the
+          #   configured grouping key.
+          #
+          #   @param id [String] The Orb-assigned unique identifier for the license type.
+          #
+          #   @param grouping_key [String] The key used for grouping licenses of this type. This is typically a user identi
+          #
+          #   @param name [String] The name of the license type.
+        end
+      end
+
       class MatrixWithThresholdDiscounts < Orb::Internal::Type::BaseModel
         # @!attribute id
         #
@@ -14425,7 +14874,7 @@ module Orb
       end
 
       # @!method self.variants
-      #   @return [Array(Orb::Models::Price::Unit, Orb::Models::Price::Tiered, Orb::Models::Price::Bulk, Orb::Models::Price::BulkWithFilters, Orb::Models::Price::Package, Orb::Models::Price::Matrix, Orb::Models::Price::ThresholdTotalAmount, Orb::Models::Price::TieredPackage, Orb::Models::Price::TieredWithMinimum, Orb::Models::Price::GroupedTiered, Orb::Models::Price::GroupedTieredMatrix, Orb::Models::Price::TieredPackageWithMinimum, Orb::Models::Price::PackageWithAllocation, Orb::Models::Price::UnitWithPercent, Orb::Models::Price::MatrixWithAllocation, Orb::Models::Price::MatrixWithThresholdDiscounts, Orb::Models::Price::TieredWithProration, Orb::Models::Price::UnitWithProration, Orb::Models::Price::GroupedAllocation, Orb::Models::Price::BulkWithProration, Orb::Models::Price::GroupedWithProratedMinimum, Orb::Models::Price::GroupedWithMeteredMinimum, Orb::Models::Price::GroupedWithMinMaxThresholds, Orb::Models::Price::MatrixWithDisplayName, Orb::Models::Price::GroupedTieredPackage, Orb::Models::Price::MaxGroupTieredPackage, Orb::Models::Price::ScalableMatrixWithUnitPricing, Orb::Models::Price::ScalableMatrixWithTieredPricing, Orb::Models::Price::CumulativeGroupedBulk, Orb::Models::Price::CumulativeGroupedAllocation, Orb::Models::Price::DailyCreditAllowance, Orb::Models::Price::MeteredAllowance, Orb::Models::Price::MinimumComposite, Orb::Models::Price::Percent, Orb::Models::Price::EventOutput)]
+      #   @return [Array(Orb::Models::Price::Unit, Orb::Models::Price::Tiered, Orb::Models::Price::Bulk, Orb::Models::Price::BulkWithFilters, Orb::Models::Price::Package, Orb::Models::Price::Matrix, Orb::Models::Price::ThresholdTotalAmount, Orb::Models::Price::TieredPackage, Orb::Models::Price::TieredWithMinimum, Orb::Models::Price::GroupedTiered, Orb::Models::Price::GroupedTieredMatrix, Orb::Models::Price::TieredPackageWithMinimum, Orb::Models::Price::PackageWithAllocation, Orb::Models::Price::UnitWithPercent, Orb::Models::Price::MatrixWithAllocation, Orb::Models::Price::TieredMatrixWithAllocation, Orb::Models::Price::MatrixWithThresholdDiscounts, Orb::Models::Price::TieredWithProration, Orb::Models::Price::UnitWithProration, Orb::Models::Price::GroupedAllocation, Orb::Models::Price::BulkWithProration, Orb::Models::Price::GroupedWithProratedMinimum, Orb::Models::Price::GroupedWithMeteredMinimum, Orb::Models::Price::GroupedWithMinMaxThresholds, Orb::Models::Price::MatrixWithDisplayName, Orb::Models::Price::GroupedTieredPackage, Orb::Models::Price::MaxGroupTieredPackage, Orb::Models::Price::ScalableMatrixWithUnitPricing, Orb::Models::Price::ScalableMatrixWithTieredPricing, Orb::Models::Price::CumulativeGroupedBulk, Orb::Models::Price::CumulativeGroupedAllocation, Orb::Models::Price::DailyCreditAllowance, Orb::Models::Price::MeteredAllowance, Orb::Models::Price::MinimumComposite, Orb::Models::Price::Percent, Orb::Models::Price::EventOutput)]
     end
   end
 end