orb-billing 0.2.0 → 0.3.1

data/rbi/{lib/orb → orb}/models/invoice_line_item_create_response.rbi

@@ -19,11 +19,11 @@ module Orb
         returns(
           T::Array[
             T.any(
-              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryUsageDiscountAdjustment,
-              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryAmountDiscountAdjustment,
-              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryPercentageDiscountAdjustment,
-              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryMinimumAdjustment,
-              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryMaximumAdjustment
+              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::UsageDiscount,
+              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::AmountDiscount,
+              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::PercentageDiscount,
+              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::Minimum,
+              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::Maximum
             )
           ]
         )
@@ -121,34 +121,34 @@ module Orb
         returns(
           T.nilable(
             T.any(
-              Orb::Models::Price::UnitPrice,
-              Orb::Models::Price::PackagePrice,
-              Orb::Models::Price::MatrixPrice,
-              Orb::Models::Price::TieredPrice,
-              Orb::Models::Price::TieredBpsPrice,
-              Orb::Models::Price::BpsPrice,
-              Orb::Models::Price::BulkBpsPrice,
-              Orb::Models::Price::BulkPrice,
-              Orb::Models::Price::ThresholdTotalAmountPrice,
-              Orb::Models::Price::TieredPackagePrice,
-              Orb::Models::Price::GroupedTieredPrice,
-              Orb::Models::Price::TieredWithMinimumPrice,
-              Orb::Models::Price::TieredPackageWithMinimumPrice,
-              Orb::Models::Price::PackageWithAllocationPrice,
-              Orb::Models::Price::UnitWithPercentPrice,
-              Orb::Models::Price::MatrixWithAllocationPrice,
-              Orb::Models::Price::TieredWithProrationPrice,
-              Orb::Models::Price::UnitWithProrationPrice,
-              Orb::Models::Price::GroupedAllocationPrice,
-              Orb::Models::Price::GroupedWithProratedMinimumPrice,
-              Orb::Models::Price::GroupedWithMeteredMinimumPrice,
-              Orb::Models::Price::MatrixWithDisplayNamePrice,
-              Orb::Models::Price::BulkWithProrationPrice,
-              Orb::Models::Price::GroupedTieredPackagePrice,
-              Orb::Models::Price::MaxGroupTieredPackagePrice,
-              Orb::Models::Price::ScalableMatrixWithUnitPricingPrice,
-              Orb::Models::Price::ScalableMatrixWithTieredPricingPrice,
-              Orb::Models::Price::CumulativeGroupedBulkPrice
+              Orb::Models::Price::Unit,
+              Orb::Models::Price::Package,
+              Orb::Models::Price::Matrix,
+              Orb::Models::Price::Tiered,
+              Orb::Models::Price::TieredBps,
+              Orb::Models::Price::Bps,
+              Orb::Models::Price::BulkBps,
+              Orb::Models::Price::Bulk,
+              Orb::Models::Price::ThresholdTotalAmount,
+              Orb::Models::Price::TieredPackage,
+              Orb::Models::Price::GroupedTiered,
+              Orb::Models::Price::TieredWithMinimum,
+              Orb::Models::Price::TieredPackageWithMinimum,
+              Orb::Models::Price::PackageWithAllocation,
+              Orb::Models::Price::UnitWithPercent,
+              Orb::Models::Price::MatrixWithAllocation,
+              Orb::Models::Price::TieredWithProration,
+              Orb::Models::Price::UnitWithProration,
+              Orb::Models::Price::GroupedAllocation,
+              Orb::Models::Price::GroupedWithProratedMinimum,
+              Orb::Models::Price::GroupedWithMeteredMinimum,
+              Orb::Models::Price::MatrixWithDisplayName,
+              Orb::Models::Price::BulkWithProration,
+              Orb::Models::Price::GroupedTieredPackage,
+              Orb::Models::Price::MaxGroupTieredPackage,
+              Orb::Models::Price::ScalableMatrixWithUnitPricing,
+              Orb::Models::Price::ScalableMatrixWithTieredPricing,
+              Orb::Models::Price::CumulativeGroupedBulk
             )
           )
         )
@@ -169,9 +169,9 @@ module Orb
         returns(
           T::Array[
             T.any(
-              Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::MatrixSubLineItem,
-              Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::TierSubLineItem,
-              Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::OtherSubLineItem
+              Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Matrix,
+              Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Tier,
+              Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Null
             )
           ]
         )
@@ -197,12 +197,12 @@ module Orb
           adjusted_subtotal: String,
           adjustments: T::Array[
             T.any(
-              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryUsageDiscountAdjustment,
+              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::UsageDiscount,
               Orb::Internal::AnyHash,
-              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryAmountDiscountAdjustment,
-              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryPercentageDiscountAdjustment,
-              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryMinimumAdjustment,
-              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryMaximumAdjustment
+              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::AmountDiscount,
+              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::PercentageDiscount,
+              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::Minimum,
+              Orb::Models::InvoiceLineItemCreateResponse::Adjustment::Maximum
             )
           ],
           amount: String,
@@ -227,45 +227,45 @@ module Orb
           partially_invoiced_amount: String,
           price: T.nilable(
             T.any(
-              Orb::Models::Price::UnitPrice,
+              Orb::Models::Price::Unit,
               Orb::Internal::AnyHash,
-              Orb::Models::Price::PackagePrice,
-              Orb::Models::Price::MatrixPrice,
-              Orb::Models::Price::TieredPrice,
-              Orb::Models::Price::TieredBpsPrice,
-              Orb::Models::Price::BpsPrice,
-              Orb::Models::Price::BulkBpsPrice,
-              Orb::Models::Price::BulkPrice,
-              Orb::Models::Price::ThresholdTotalAmountPrice,
-              Orb::Models::Price::TieredPackagePrice,
-              Orb::Models::Price::GroupedTieredPrice,
-              Orb::Models::Price::TieredWithMinimumPrice,
-              Orb::Models::Price::TieredPackageWithMinimumPrice,
-              Orb::Models::Price::PackageWithAllocationPrice,
-              Orb::Models::Price::UnitWithPercentPrice,
-              Orb::Models::Price::MatrixWithAllocationPrice,
-              Orb::Models::Price::TieredWithProrationPrice,
-              Orb::Models::Price::UnitWithProrationPrice,
-              Orb::Models::Price::GroupedAllocationPrice,
-              Orb::Models::Price::GroupedWithProratedMinimumPrice,
-              Orb::Models::Price::GroupedWithMeteredMinimumPrice,
-              Orb::Models::Price::MatrixWithDisplayNamePrice,
-              Orb::Models::Price::BulkWithProrationPrice,
-              Orb::Models::Price::GroupedTieredPackagePrice,
-              Orb::Models::Price::MaxGroupTieredPackagePrice,
-              Orb::Models::Price::ScalableMatrixWithUnitPricingPrice,
-              Orb::Models::Price::ScalableMatrixWithTieredPricingPrice,
-              Orb::Models::Price::CumulativeGroupedBulkPrice
+              Orb::Models::Price::Package,
+              Orb::Models::Price::Matrix,
+              Orb::Models::Price::Tiered,
+              Orb::Models::Price::TieredBps,
+              Orb::Models::Price::Bps,
+              Orb::Models::Price::BulkBps,
+              Orb::Models::Price::Bulk,
+              Orb::Models::Price::ThresholdTotalAmount,
+              Orb::Models::Price::TieredPackage,
+              Orb::Models::Price::GroupedTiered,
+              Orb::Models::Price::TieredWithMinimum,
+              Orb::Models::Price::TieredPackageWithMinimum,
+              Orb::Models::Price::PackageWithAllocation,
+              Orb::Models::Price::UnitWithPercent,
+              Orb::Models::Price::MatrixWithAllocation,
+              Orb::Models::Price::TieredWithProration,
+              Orb::Models::Price::UnitWithProration,
+              Orb::Models::Price::GroupedAllocation,
+              Orb::Models::Price::GroupedWithProratedMinimum,
+              Orb::Models::Price::GroupedWithMeteredMinimum,
+              Orb::Models::Price::MatrixWithDisplayName,
+              Orb::Models::Price::BulkWithProration,
+              Orb::Models::Price::GroupedTieredPackage,
+              Orb::Models::Price::MaxGroupTieredPackage,
+              Orb::Models::Price::ScalableMatrixWithUnitPricing,
+              Orb::Models::Price::ScalableMatrixWithTieredPricing,
+              Orb::Models::Price::CumulativeGroupedBulk
             )
           ),
           quantity: Float,
           start_date: Time,
           sub_line_items: T::Array[
             T.any(
-              Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::MatrixSubLineItem,
+              Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Matrix,
               Orb::Internal::AnyHash,
-              Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::TierSubLineItem,
-              Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::OtherSubLineItem
+              Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Tier,
+              Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Null
             )
           ],
           subtotal: String,
@@ -275,27 +275,65 @@ module Orb
           .returns(T.attached_class)
       end
       def self.new(
+        # A unique ID for this line item.
         id:,
+        # The line amount after any adjustments and before overage conversion, credits and
+        # partial invoicing.
         adjusted_subtotal:,
+        # All adjustments applied to the line item in the order they were applied based on
+        # invoice calculations (ie. usage discounts -> amount discounts -> percentage
+        # discounts -> minimums -> maximums).
         adjustments:,
+        # The final amount for a line item after all adjustments and pre paid credits have
+        # been applied.
         amount:,
+        # The number of prepaid credits applied.
         credits_applied:,
         discount:,
+        # The end date of the range of time applied for this line item's price.
         end_date:,
+        # An additional filter that was used to calculate the usage for this line item.
         filter:,
+        # [DEPRECATED] For configured prices that are split by a grouping key, this will
+        # be populated with the key and a value. The `amount` and `subtotal` will be the
+        # values for this particular grouping.
         grouping:,
+        # This field is deprecated in favor of `adjustments`.
         maximum:,
+        # This field is deprecated in favor of `adjustments`.
         maximum_amount:,
+        # This field is deprecated in favor of `adjustments`.
         minimum:,
+        # This field is deprecated in favor of `adjustments`.
         minimum_amount:,
+        # The name of the price associated with this line item.
         name:,
+        # Any amount applied from a partial invoice
         partially_invoiced_amount:,
+        # The Price resource represents a price that can be billed on a subscription,
+        # resulting in a charge on an invoice in the form of an invoice line item. Prices
+        # take a quantity and determine an amount to bill.
+        #
+        # Orb supports a few different pricing models out of the box. Each of these models
+        # is serialized differently in a given Price object. The model_type field
+        # determines the key for the configuration object that is present.
+        #
+        # For more on the types of prices, see
+        # [the core concepts documentation](/core-concepts#plan-and-price)
         price:,
+        # Either the fixed fee quantity or the usage during the service period.
         quantity:,
+        # The start date of the range of time applied for this line item's price.
         start_date:,
+        # For complex pricing structures, the line item can be broken down further in
+        # `sub_line_items`.
         sub_line_items:,
+        # The line amount before before any adjustments.
         subtotal:,
+        # An array of tax rates and their incurred tax amounts. Empty if no tax
+        # integration is configured.
         tax_amounts:,
+        # A list of customer ids that were used to calculate the usage for this line item.
         usage_customer_ids:
       ); end
       sig do
@@ -306,11 +344,11 @@ module Orb
               adjusted_subtotal: String,
               adjustments: T::Array[
                 T.any(
-                  Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryUsageDiscountAdjustment,
-                  Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryAmountDiscountAdjustment,
-                  Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryPercentageDiscountAdjustment,
-                  Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryMinimumAdjustment,
-                  Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryMaximumAdjustment
+                  Orb::Models::InvoiceLineItemCreateResponse::Adjustment::UsageDiscount,
+                  Orb::Models::InvoiceLineItemCreateResponse::Adjustment::AmountDiscount,
+                  Orb::Models::InvoiceLineItemCreateResponse::Adjustment::PercentageDiscount,
+                  Orb::Models::InvoiceLineItemCreateResponse::Adjustment::Minimum,
+                  Orb::Models::InvoiceLineItemCreateResponse::Adjustment::Maximum
                 )
               ],
               amount: String,
@@ -334,43 +372,43 @@ module Orb
               partially_invoiced_amount: String,
               price: T.nilable(
                 T.any(
-                  Orb::Models::Price::UnitPrice,
-                  Orb::Models::Price::PackagePrice,
-                  Orb::Models::Price::MatrixPrice,
-                  Orb::Models::Price::TieredPrice,
-                  Orb::Models::Price::TieredBpsPrice,
-                  Orb::Models::Price::BpsPrice,
-                  Orb::Models::Price::BulkBpsPrice,
-                  Orb::Models::Price::BulkPrice,
-                  Orb::Models::Price::ThresholdTotalAmountPrice,
-                  Orb::Models::Price::TieredPackagePrice,
-                  Orb::Models::Price::GroupedTieredPrice,
-                  Orb::Models::Price::TieredWithMinimumPrice,
-                  Orb::Models::Price::TieredPackageWithMinimumPrice,
-                  Orb::Models::Price::PackageWithAllocationPrice,
-                  Orb::Models::Price::UnitWithPercentPrice,
-                  Orb::Models::Price::MatrixWithAllocationPrice,
-                  Orb::Models::Price::TieredWithProrationPrice,
-                  Orb::Models::Price::UnitWithProrationPrice,
-                  Orb::Models::Price::GroupedAllocationPrice,
-                  Orb::Models::Price::GroupedWithProratedMinimumPrice,
-                  Orb::Models::Price::GroupedWithMeteredMinimumPrice,
-                  Orb::Models::Price::MatrixWithDisplayNamePrice,
-                  Orb::Models::Price::BulkWithProrationPrice,
-                  Orb::Models::Price::GroupedTieredPackagePrice,
-                  Orb::Models::Price::MaxGroupTieredPackagePrice,
-                  Orb::Models::Price::ScalableMatrixWithUnitPricingPrice,
-                  Orb::Models::Price::ScalableMatrixWithTieredPricingPrice,
-                  Orb::Models::Price::CumulativeGroupedBulkPrice
+                  Orb::Models::Price::Unit,
+                  Orb::Models::Price::Package,
+                  Orb::Models::Price::Matrix,
+                  Orb::Models::Price::Tiered,
+                  Orb::Models::Price::TieredBps,
+                  Orb::Models::Price::Bps,
+                  Orb::Models::Price::BulkBps,
+                  Orb::Models::Price::Bulk,
+                  Orb::Models::Price::ThresholdTotalAmount,
+                  Orb::Models::Price::TieredPackage,
+                  Orb::Models::Price::GroupedTiered,
+                  Orb::Models::Price::TieredWithMinimum,
+                  Orb::Models::Price::TieredPackageWithMinimum,
+                  Orb::Models::Price::PackageWithAllocation,
+                  Orb::Models::Price::UnitWithPercent,
+                  Orb::Models::Price::MatrixWithAllocation,
+                  Orb::Models::Price::TieredWithProration,
+                  Orb::Models::Price::UnitWithProration,
+                  Orb::Models::Price::GroupedAllocation,
+                  Orb::Models::Price::GroupedWithProratedMinimum,
+                  Orb::Models::Price::GroupedWithMeteredMinimum,
+                  Orb::Models::Price::MatrixWithDisplayName,
+                  Orb::Models::Price::BulkWithProration,
+                  Orb::Models::Price::GroupedTieredPackage,
+                  Orb::Models::Price::MaxGroupTieredPackage,
+                  Orb::Models::Price::ScalableMatrixWithUnitPricing,
+                  Orb::Models::Price::ScalableMatrixWithTieredPricing,
+                  Orb::Models::Price::CumulativeGroupedBulk
                 )
               ),
               quantity: Float,
               start_date: Time,
               sub_line_items: T::Array[
                 T.any(
-                  Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::MatrixSubLineItem,
-                  Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::TierSubLineItem,
-                  Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::OtherSubLineItem
+                  Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Matrix,
+                  Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Tier,
+                  Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Null
                 )
               ],
               subtotal: String,
@@ -384,7 +422,7 @@ module Orb
       module Adjustment
         extend Orb::Internal::Type::Union
 
-        class MonetaryUsageDiscountAdjustment < Orb::Internal::Type::BaseModel
+        class UsageDiscount < Orb::Internal::Type::BaseModel
           sig { returns(String) }
           attr_accessor :id
 
@@ -427,10 +465,17 @@ module Orb
           end
           def self.new(
             id:,
+            # The value applied by an adjustment.
             amount:,
+            # The price IDs that this adjustment applies to.
             applies_to_price_ids:,
+            # True for adjustments that apply to an entire invocice, false for adjustments
+            # that apply to only one price.
             is_invoice_level:,
+            # The reason for the adjustment.
             reason:,
+            # The number of usage units by which to discount the price this adjustment applies
+            # to in a given billing period.
             usage_discount:,
             adjustment_type: :usage_discount
           ); end
@@ -451,7 +496,7 @@ module Orb
           def to_hash; end
         end
 
-        class MonetaryAmountDiscountAdjustment < Orb::Internal::Type::BaseModel
+        class AmountDiscount < Orb::Internal::Type::BaseModel
           sig { returns(String) }
           attr_accessor :id
 
@@ -494,10 +539,17 @@ module Orb
           end
           def self.new(
             id:,
+            # The value applied by an adjustment.
             amount:,
+            # The amount by which to discount the prices this adjustment applies to in a given
+            # billing period.
             amount_discount:,
+            # The price IDs that this adjustment applies to.
             applies_to_price_ids:,
+            # True for adjustments that apply to an entire invocice, false for adjustments
+            # that apply to only one price.
             is_invoice_level:,
+            # The reason for the adjustment.
             reason:,
             adjustment_type: :amount_discount
           ); end
@@ -518,7 +570,7 @@ module Orb
           def to_hash; end
         end
 
-        class MonetaryPercentageDiscountAdjustment < Orb::Internal::Type::BaseModel
+        class PercentageDiscount < Orb::Internal::Type::BaseModel
           sig { returns(String) }
           attr_accessor :id
 
@@ -561,10 +613,17 @@ module Orb
           end
           def self.new(
             id:,
+            # The value applied by an adjustment.
             amount:,
+            # The price IDs that this adjustment applies to.
             applies_to_price_ids:,
+            # True for adjustments that apply to an entire invocice, false for adjustments
+            # that apply to only one price.
             is_invoice_level:,
+            # The percentage (as a value between 0 and 1) by which to discount the price
+            # intervals this adjustment applies to in a given billing period.
             percentage_discount:,
+            # The reason for the adjustment.
             reason:,
             adjustment_type: :percentage_discount
           ); end
@@ -585,7 +644,7 @@ module Orb
           def to_hash; end
         end
 
-        class MonetaryMinimumAdjustment < Orb::Internal::Type::BaseModel
+        class Minimum < Orb::Internal::Type::BaseModel
           sig { returns(String) }
           attr_accessor :id
 
@@ -633,11 +692,19 @@ module Orb
           end
           def self.new(
             id:,
+            # The value applied by an adjustment.
             amount:,
+            # The price IDs that this adjustment applies to.
             applies_to_price_ids:,
+            # True for adjustments that apply to an entire invocice, false for adjustments
+            # that apply to only one price.
             is_invoice_level:,
+            # The item ID that revenue from this minimum will be attributed to.
             item_id:,
+            # The minimum amount to charge in a given billing period for the prices this
+            # adjustment applies to.
             minimum_amount:,
+            # The reason for the adjustment.
             reason:,
             adjustment_type: :minimum
           ); end
@@ -659,7 +726,7 @@ module Orb
           def to_hash; end
         end
 
-        class MonetaryMaximumAdjustment < Orb::Internal::Type::BaseModel
+        class Maximum < Orb::Internal::Type::BaseModel
           sig { returns(String) }
           attr_accessor :id
 
@@ -702,10 +769,17 @@ module Orb
           end
           def self.new(
             id:,
+            # The value applied by an adjustment.
             amount:,
+            # The price IDs that this adjustment applies to.
             applies_to_price_ids:,
+            # True for adjustments that apply to an entire invocice, false for adjustments
+            # that apply to only one price.
             is_invoice_level:,
+            # The maximum amount to charge in a given billing period for the prices this
+            # adjustment applies to.
             maximum_amount:,
+            # The reason for the adjustment.
             reason:,
             adjustment_type: :maximum
           ); end
@@ -729,7 +803,7 @@ module Orb
         sig do
           override
             .returns(
-              [Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryUsageDiscountAdjustment, Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryAmountDiscountAdjustment, Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryPercentageDiscountAdjustment, Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryMinimumAdjustment, Orb::Models::InvoiceLineItemCreateResponse::Adjustment::MonetaryMaximumAdjustment]
+              [Orb::Models::InvoiceLineItemCreateResponse::Adjustment::UsageDiscount, Orb::Models::InvoiceLineItemCreateResponse::Adjustment::AmountDiscount, Orb::Models::InvoiceLineItemCreateResponse::Adjustment::PercentageDiscount, Orb::Models::InvoiceLineItemCreateResponse::Adjustment::Minimum, Orb::Models::InvoiceLineItemCreateResponse::Adjustment::Maximum]
             )
         end
         def self.variants; end
@@ -749,8 +823,13 @@ module Orb
         sig do
           params(applies_to_price_ids: T::Array[String], maximum_amount: String).returns(T.attached_class)
         end
-        def self.new(applies_to_price_ids:, maximum_amount:); end
-
+        def self.new(
+          # List of price_ids that this maximum amount applies to. For plan/plan phase
+          # maximums, this can be a subset of prices.
+          applies_to_price_ids:,
+          # Maximum amount applied
+          maximum_amount:
+        ); end
         sig { override.returns({applies_to_price_ids: T::Array[String], maximum_amount: String}) }
         def to_hash; end
       end
@@ -769,8 +848,13 @@ module Orb
         sig do
           params(applies_to_price_ids: T::Array[String], minimum_amount: String).returns(T.attached_class)
         end
-        def self.new(applies_to_price_ids:, minimum_amount:); end
-
+        def self.new(
+          # List of price_ids that this minimum amount applies to. For plan/plan phase
+          # minimums, this can be a subset of prices.
+          applies_to_price_ids:,
+          # Minimum amount applied
+          minimum_amount:
+        ); end
         sig { override.returns({applies_to_price_ids: T::Array[String], minimum_amount: String}) }
         def to_hash; end
       end
@@ -778,34 +862,31 @@ module Orb
       module SubLineItem
         extend Orb::Internal::Type::Union
 
-        class MatrixSubLineItem < Orb::Internal::Type::BaseModel
+        class Matrix < Orb::Internal::Type::BaseModel
           # The total amount for this sub line item.
           sig { returns(String) }
           attr_accessor :amount
 
-          sig { returns(T.nilable(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::MatrixSubLineItem::Grouping)) }
+          sig { returns(T.nilable(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Matrix::Grouping)) }
           attr_reader :grouping
 
           sig do
             params(
               grouping: T.nilable(
-                T.any(
-                  Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::MatrixSubLineItem::Grouping,
-                  Orb::Internal::AnyHash
-                )
+                T.any(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Matrix::Grouping, Orb::Internal::AnyHash)
               )
             )
               .void
           end
           attr_writer :grouping
 
-          sig { returns(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::MatrixSubLineItem::MatrixConfig) }
+          sig { returns(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Matrix::MatrixConfig) }
           attr_reader :matrix_config
 
           sig do
             params(
               matrix_config: T.any(
-                Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::MatrixSubLineItem::MatrixConfig,
+                Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Matrix::MatrixConfig,
                 Orb::Internal::AnyHash
               )
             )
@@ -826,13 +907,10 @@ module Orb
             params(
               amount: String,
               grouping: T.nilable(
-                T.any(
-                  Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::MatrixSubLineItem::Grouping,
-                  Orb::Internal::AnyHash
-                )
+                T.any(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Matrix::Grouping, Orb::Internal::AnyHash)
               ),
               matrix_config: T.any(
-                Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::MatrixSubLineItem::MatrixConfig,
+                Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Matrix::MatrixConfig,
                 Orb::Internal::AnyHash
               ),
               name: String,
@@ -841,15 +919,22 @@ module Orb
             )
               .returns(T.attached_class)
           end
-          def self.new(amount:, grouping:, matrix_config:, name:, quantity:, type: :matrix); end
-
+          def self.new(
+            # The total amount for this sub line item.
+            amount:,
+            grouping:,
+            matrix_config:,
+            name:,
+            quantity:,
+            type: :matrix
+          ); end
           sig do
             override
               .returns(
                 {
                   amount: String,
-                  grouping: T.nilable(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::MatrixSubLineItem::Grouping),
-                  matrix_config: Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::MatrixSubLineItem::MatrixConfig,
+                  grouping: T.nilable(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Matrix::Grouping),
+                  matrix_config: Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Matrix::MatrixConfig,
                   name: String,
                   quantity: Float,
                   type: Symbol
@@ -867,8 +952,11 @@ module Orb
             attr_accessor :value
 
             sig { params(key: String, value: T.nilable(String)).returns(T.attached_class) }
-            def self.new(key:, value:); end
-
+            def self.new(
+              key:,
+              # No value indicates the default group
+              value:
+            ); end
             sig { override.returns({key: String, value: T.nilable(String)}) }
             def to_hash; end
           end
@@ -879,28 +967,27 @@ module Orb
             attr_accessor :dimension_values
 
             sig { params(dimension_values: T::Array[T.nilable(String)]).returns(T.attached_class) }
-            def self.new(dimension_values:); end
-
+            def self.new(
+              # The ordered dimension values for this line item.
+              dimension_values:
+            ); end
             sig { override.returns({dimension_values: T::Array[T.nilable(String)]}) }
             def to_hash; end
           end
         end
 
-        class TierSubLineItem < Orb::Internal::Type::BaseModel
+        class Tier < Orb::Internal::Type::BaseModel
           # The total amount for this sub line item.
           sig { returns(String) }
           attr_accessor :amount
 
-          sig { returns(T.nilable(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::TierSubLineItem::Grouping)) }
+          sig { returns(T.nilable(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Tier::Grouping)) }
           attr_reader :grouping
 
           sig do
             params(
               grouping: T.nilable(
-                T.any(
-                  Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::TierSubLineItem::Grouping,
-                  Orb::Internal::AnyHash
-                )
+                T.any(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Tier::Grouping, Orb::Internal::AnyHash)
               )
             )
               .void
@@ -913,15 +1000,12 @@ module Orb
           sig { returns(Float) }
           attr_accessor :quantity
 
-          sig { returns(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::TierSubLineItem::TierConfig) }
+          sig { returns(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Tier::TierConfig) }
           attr_reader :tier_config
 
           sig do
             params(
-              tier_config: T.any(
-                Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::TierSubLineItem::TierConfig,
-                Orb::Internal::AnyHash
-              )
+              tier_config: T.any(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Tier::TierConfig, Orb::Internal::AnyHash)
             )
               .void
           end
@@ -934,32 +1018,33 @@ module Orb
             params(
               amount: String,
               grouping: T.nilable(
-                T.any(
-                  Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::TierSubLineItem::Grouping,
-                  Orb::Internal::AnyHash
-                )
+                T.any(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Tier::Grouping, Orb::Internal::AnyHash)
               ),
               name: String,
               quantity: Float,
-              tier_config: T.any(
-                Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::TierSubLineItem::TierConfig,
-                Orb::Internal::AnyHash
-              ),
+              tier_config: T.any(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Tier::TierConfig, Orb::Internal::AnyHash),
               type: Symbol
             )
               .returns(T.attached_class)
           end
-          def self.new(amount:, grouping:, name:, quantity:, tier_config:, type: :tier); end
-
+          def self.new(
+            # The total amount for this sub line item.
+            amount:,
+            grouping:,
+            name:,
+            quantity:,
+            tier_config:,
+            type: :tier
+          ); end
           sig do
             override
               .returns(
                 {
                   amount: String,
-                  grouping: T.nilable(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::TierSubLineItem::Grouping),
+                  grouping: T.nilable(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Tier::Grouping),
                   name: String,
                   quantity: Float,
-                  tier_config: Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::TierSubLineItem::TierConfig,
+                  tier_config: Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Tier::TierConfig,
                   type: Symbol
                 }
               )
@@ -975,8 +1060,11 @@ module Orb
             attr_accessor :value
 
             sig { params(key: String, value: T.nilable(String)).returns(T.attached_class) }
-            def self.new(key:, value:); end
-
+            def self.new(
+              key:,
+              # No value indicates the default group
+              value:
+            ); end
             sig { override.returns({key: String, value: T.nilable(String)}) }
             def to_hash; end
           end
@@ -1005,21 +1093,18 @@ module Orb
           end
         end
 
-        class OtherSubLineItem < Orb::Internal::Type::BaseModel
+        class Null < Orb::Internal::Type::BaseModel
           # The total amount for this sub line item.
           sig { returns(String) }
           attr_accessor :amount
 
-          sig { returns(T.nilable(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::OtherSubLineItem::Grouping)) }
+          sig { returns(T.nilable(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Null::Grouping)) }
           attr_reader :grouping
 
           sig do
             params(
               grouping: T.nilable(
-                T.any(
-                  Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::OtherSubLineItem::Grouping,
-                  Orb::Internal::AnyHash
-                )
+                T.any(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Null::Grouping, Orb::Internal::AnyHash)
               )
             )
               .void
@@ -1039,10 +1124,7 @@ module Orb
             params(
               amount: String,
               grouping: T.nilable(
-                T.any(
-                  Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::OtherSubLineItem::Grouping,
-                  Orb::Internal::AnyHash
-                )
+                T.any(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Null::Grouping, Orb::Internal::AnyHash)
               ),
               name: String,
               quantity: Float,
@@ -1050,14 +1132,20 @@ module Orb
             )
               .returns(T.attached_class)
           end
-          def self.new(amount:, grouping:, name:, quantity:, type: :"'null'"); end
-
+          def self.new(
+            # The total amount for this sub line item.
+            amount:,
+            grouping:,
+            name:,
+            quantity:,
+            type: :"'null'"
+          ); end
           sig do
             override
               .returns(
                 {
                   amount: String,
-                  grouping: T.nilable(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::OtherSubLineItem::Grouping),
+                  grouping: T.nilable(Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Null::Grouping),
                   name: String,
                   quantity: Float,
                   type: Symbol
@@ -1075,8 +1163,11 @@ module Orb
             attr_accessor :value
 
             sig { params(key: String, value: T.nilable(String)).returns(T.attached_class) }
-            def self.new(key:, value:); end
-
+            def self.new(
+              key:,
+              # No value indicates the default group
+              value:
+            ); end
             sig { override.returns({key: String, value: T.nilable(String)}) }
             def to_hash; end
           end
@@ -1085,7 +1176,7 @@ module Orb
         sig do
           override
             .returns(
-              [Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::MatrixSubLineItem, Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::TierSubLineItem, Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::OtherSubLineItem]
+              [Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Matrix, Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Tier, Orb::Models::InvoiceLineItemCreateResponse::SubLineItem::Null]
             )
         end
         def self.variants; end
@@ -1108,8 +1199,14 @@ module Orb
           params(amount: String, tax_rate_description: String, tax_rate_percentage: T.nilable(String))
             .returns(T.attached_class)
         end
-        def self.new(amount:, tax_rate_description:, tax_rate_percentage:); end
-
+        def self.new(
+          # The amount of additional tax incurred by this tax rate.
+          amount:,
+          # The human-readable description of the applied tax rate.
+          tax_rate_description:,
+          # The tax rate percentage, out of 100.
+          tax_rate_percentage:
+        ); end
         sig do
           override.returns(
             {