orb-billing 0.2.0 → 0.3.1

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

@@ -376,45 +376,199 @@ module Orb
       end
       def self.new(
         id:,
+        # This is the final amount required to be charged to the customer and reflects the
+        # application of the customer balance to the `total` of the invoice.
         amount_due:,
         auto_collection:,
         billing_address:,
+        # The creation time of the resource in Orb.
         created_at:,
+        # A list of credit notes associated with the invoice
         credit_notes:,
+        # An ISO 4217 currency string or `credits`
         currency:,
         customer:,
         customer_balance_transactions:,
+        # Tax IDs are commonly required to be displayed on customer invoices, which are
+        # added to the headers of invoices.
+        #
+        # ### Supported Tax ID Countries and Types
+        #
+        # | Country              | Type         | Description                                                                                             |
+        # | -------------------- | ------------ | ------------------------------------------------------------------------------------------------------- |
+        # | Andorra              | `ad_nrt`     | Andorran NRT Number                                                                                     |
+        # | Argentina            | `ar_cuit`    | Argentinian Tax ID Number                                                                               |
+        # | Australia            | `au_abn`     | Australian Business Number (AU ABN)                                                                     |
+        # | Australia            | `au_arn`     | Australian Taxation Office Reference Number                                                             |
+        # | Austria              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Bahrain              | `bh_vat`     | Bahraini VAT Number                                                                                     |
+        # | Belgium              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Bolivia              | `bo_tin`     | Bolivian Tax ID                                                                                         |
+        # | Brazil               | `br_cnpj`    | Brazilian CNPJ Number                                                                                   |
+        # | Brazil               | `br_cpf`     | Brazilian CPF Number                                                                                    |
+        # | Bulgaria             | `bg_uic`     | Bulgaria Unified Identification Code                                                                    |
+        # | Bulgaria             | `eu_vat`     | European VAT Number                                                                                     |
+        # | Canada               | `ca_bn`      | Canadian BN                                                                                             |
+        # | Canada               | `ca_gst_hst` | Canadian GST/HST Number                                                                                 |
+        # | Canada               | `ca_pst_bc`  | Canadian PST Number (British Columbia)                                                                  |
+        # | Canada               | `ca_pst_mb`  | Canadian PST Number (Manitoba)                                                                          |
+        # | Canada               | `ca_pst_sk`  | Canadian PST Number (Saskatchewan)                                                                      |
+        # | Canada               | `ca_qst`     | Canadian QST Number (Québec)                                                                            |
+        # | Chile                | `cl_tin`     | Chilean TIN                                                                                             |
+        # | China                | `cn_tin`     | Chinese Tax ID                                                                                          |
+        # | Colombia             | `co_nit`     | Colombian NIT Number                                                                                    |
+        # | Costa Rica           | `cr_tin`     | Costa Rican Tax ID                                                                                      |
+        # | Croatia              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Cyprus               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Czech Republic       | `eu_vat`     | European VAT Number                                                                                     |
+        # | Denmark              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Dominican Republic   | `do_rcn`     | Dominican RCN Number                                                                                    |
+        # | Ecuador              | `ec_ruc`     | Ecuadorian RUC Number                                                                                   |
+        # | Egypt                | `eg_tin`     | Egyptian Tax Identification Number                                                                      |
+        # | El Salvador          | `sv_nit`     | El Salvadorian NIT Number                                                                               |
+        # | Estonia              | `eu_vat`     | European VAT Number                                                                                     |
+        # | EU                   | `eu_oss_vat` | European One Stop Shop VAT Number for non-Union scheme                                                  |
+        # | Finland              | `eu_vat`     | European VAT Number                                                                                     |
+        # | France               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Georgia              | `ge_vat`     | Georgian VAT                                                                                            |
+        # | Germany              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Greece               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Hong Kong            | `hk_br`      | Hong Kong BR Number                                                                                     |
+        # | Hungary              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Hungary              | `hu_tin`     | Hungary Tax Number (adószám)                                                                            |
+        # | Iceland              | `is_vat`     | Icelandic VAT                                                                                           |
+        # | India                | `in_gst`     | Indian GST Number                                                                                       |
+        # | Indonesia            | `id_npwp`    | Indonesian NPWP Number                                                                                  |
+        # | Ireland              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Israel               | `il_vat`     | Israel VAT                                                                                              |
+        # | Italy                | `eu_vat`     | European VAT Number                                                                                     |
+        # | Japan                | `jp_cn`      | Japanese Corporate Number (_Hōjin Bangō_)                                                               |
+        # | Japan                | `jp_rn`      | Japanese Registered Foreign Businesses' Registration Number (_Tōroku Kokugai Jigyōsha no Tōroku Bangō_) |
+        # | Japan                | `jp_trn`     | Japanese Tax Registration Number (_Tōroku Bangō_)                                                       |
+        # | Kazakhstan           | `kz_bin`     | Kazakhstani Business Identification Number                                                              |
+        # | Kenya                | `ke_pin`     | Kenya Revenue Authority Personal Identification Number                                                  |
+        # | Latvia               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Liechtenstein        | `li_uid`     | Liechtensteinian UID Number                                                                             |
+        # | Lithuania            | `eu_vat`     | European VAT Number                                                                                     |
+        # | Luxembourg           | `eu_vat`     | European VAT Number                                                                                     |
+        # | Malaysia             | `my_frp`     | Malaysian FRP Number                                                                                    |
+        # | Malaysia             | `my_itn`     | Malaysian ITN                                                                                           |
+        # | Malaysia             | `my_sst`     | Malaysian SST Number                                                                                    |
+        # | Malta                | `eu_vat `    | European VAT Number                                                                                     |
+        # | Mexico               | `mx_rfc`     | Mexican RFC Number                                                                                      |
+        # | Netherlands          | `eu_vat`     | European VAT Number                                                                                     |
+        # | New Zealand          | `nz_gst`     | New Zealand GST Number                                                                                  |
+        # | Nigeria              | `ng_tin`     | Nigerian Tax Identification Number                                                                      |
+        # | Norway               | `no_vat`     | Norwegian VAT Number                                                                                    |
+        # | Norway               | `no_voec`    | Norwegian VAT on e-commerce Number                                                                      |
+        # | Oman                 | `om_vat`     | Omani VAT Number                                                                                        |
+        # | Peru                 | `pe_ruc`     | Peruvian RUC Number                                                                                     |
+        # | Philippines          | `ph_tin `    | Philippines Tax Identification Number                                                                   |
+        # | Poland               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Portugal             | `eu_vat`     | European VAT Number                                                                                     |
+        # | Romania              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Romania              | `ro_tin`     | Romanian Tax ID Number                                                                                  |
+        # | Russia               | `ru_inn`     | Russian INN                                                                                             |
+        # | Russia               | `ru_kpp`     | Russian KPP                                                                                             |
+        # | Saudi Arabia         | `sa_vat`     | Saudi Arabia VAT                                                                                        |
+        # | Serbia               | `rs_pib`     | Serbian PIB Number                                                                                      |
+        # | Singapore            | `sg_gst`     | Singaporean GST                                                                                         |
+        # | Singapore            | `sg_uen`     | Singaporean UEN                                                                                         |
+        # | Slovakia             | `eu_vat`     | European VAT Number                                                                                     |
+        # | Slovenia             | `eu_vat`     | European VAT Number                                                                                     |
+        # | Slovenia             | `si_tin`     | Slovenia Tax Number (davčna številka)                                                                   |
+        # | South Africa         | `za_vat`     | South African VAT Number                                                                                |
+        # | South Korea          | `kr_brn`     | Korean BRN                                                                                              |
+        # | Spain                | `es_cif`     | Spanish NIF Number (previously Spanish CIF Number)                                                      |
+        # | Spain                | `eu_vat`     | European VAT Number                                                                                     |
+        # | Sweden               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Switzerland          | `ch_vat`     | Switzerland VAT Number                                                                                  |
+        # | Taiwan               | `tw_vat`     | Taiwanese VAT                                                                                           |
+        # | Thailand             | `th_vat`     | Thai VAT                                                                                                |
+        # | Turkey               | `tr_tin`     | Turkish Tax Identification Number                                                                       |
+        # | Ukraine              | `ua_vat`     | Ukrainian VAT                                                                                           |
+        # | United Arab Emirates | `ae_trn`     | United Arab Emirates TRN                                                                                |
+        # | United Kingdom       | `eu_vat`     | Northern Ireland VAT Number                                                                             |
+        # | United Kingdom       | `gb_vat`     | United Kingdom VAT Number                                                                               |
+        # | United States        | `us_ein`     | United States EIN                                                                                       |
+        # | Uruguay              | `uy_ruc`     | Uruguayan RUC Number                                                                                    |
+        # | Venezuela            | `ve_rif`     | Venezuelan RIF Number                                                                                   |
+        # | Vietnam              | `vn_tin`     | Vietnamese Tax ID Number                                                                                |
         customer_tax_id:,
+        # This field is deprecated in favor of `discounts`. If a `discounts` list is
+        # provided, the first discount in the list will be returned. If the list is empty,
+        # `None` will be returned.
         discount:,
         discounts:,
+        # When the invoice payment is due. The due date is null if the invoice is not yet
+        # finalized.
         due_date:,
+        # If the invoice has a status of `draft`, this will be the time that the invoice
+        # will be eligible to be issued, otherwise it will be `null`. If `auto-issue` is
+        # true, the invoice will automatically begin issuing at this time.
         eligible_to_issue_at:,
+        # A URL for the customer-facing invoice portal. This URL expires 30 days after the
+        # invoice's due date, or 60 days after being re-generated through the UI.
         hosted_invoice_url:,
+        # The scheduled date of the invoice
         invoice_date:,
+        # Automatically generated invoice number to help track and reconcile invoices.
+        # Invoice numbers have a prefix such as `RFOBWG`. These can be sequential per
+        # account or customer.
         invoice_number:,
+        # The link to download the PDF representation of the `Invoice`.
         invoice_pdf:,
         invoice_source:,
+        # If the invoice failed to issue, this will be the last time it failed to issue
+        # (even if it is now in a different state.)
         issue_failed_at:,
+        # If the invoice has been issued, this will be the time it transitioned to
+        # `issued` (even if it is now in a different state.)
         issued_at:,
+        # The breakdown of prices in this invoice.
         line_items:,
         maximum:,
         maximum_amount:,
+        # Free-form text which is available on the invoice PDF and the Orb invoice portal.
         memo:,
+        # 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`.
         metadata:,
         minimum:,
         minimum_amount:,
+        # If the invoice has a status of `paid`, this gives a timestamp when the invoice
+        # was paid.
         paid_at:,
+        # A list of payment attempts associated with the invoice
         payment_attempts:,
+        # If payment was attempted on this invoice but failed, this will be the time of
+        # the most recent attempt.
         payment_failed_at:,
+        # If payment was attempted on this invoice, this will be the start time of the
+        # most recent attempt. This field is especially useful for delayed-notification
+        # payment mechanisms (like bank transfers), where payment can take 3 days or more.
         payment_started_at:,
+        # If the invoice is in draft, this timestamp will reflect when the invoice is
+        # scheduled to be issued.
         scheduled_issue_at:,
         shipping_address:,
         status:,
         subscription:,
+        # The total before any discounts and minimums are applied.
         subtotal:,
+        # If the invoice failed to sync, this will be the last time an external invoicing
+        # provider sync was attempted. This field will always be `null` for invoices using
+        # Orb Invoicing.
         sync_failed_at:,
+        # The total after any minimums and discounts have been applied.
         total:,
+        # If the invoice has a status of `void`, this gives a timestamp when the invoice
+        # was voided.
         voided_at:,
+        # This is true if the invoice will be automatically issued in the future, and
+        # false otherwise.
         will_auto_issue:
       ); end
       sig do
@@ -500,8 +654,23 @@ module Orb
           )
             .returns(T.attached_class)
         end
-        def self.new(enabled:, next_attempt_at:, num_attempts:, previously_attempted_at:); end
-
+        def self.new(
+          # True only if auto-collection is enabled for this invoice.
+          enabled:,
+          # If the invoice is scheduled for auto-collection, this field will reflect when
+          # the next attempt will occur. If dunning has been exhausted, or auto-collection
+          # is not enabled for this invoice, this field will be `null`.
+          next_attempt_at:,
+          # Number of auto-collection payment attempts.
+          num_attempts:,
+          # If Orb has ever attempted payment auto-collection for this invoice, this field
+          # will reflect when that attempt occurred. In conjunction with `next_attempt_at`,
+          # this can be used to tell whether the invoice is currently in dunning (that is,
+          # `previously_attempted_at` is non-null, and `next_attempt_time` is non-null), or
+          # if dunning has been exhausted (`previously_attempted_at` is non-null, but
+          # `next_attempt_time` is null).
+          previously_attempted_at:
+        ); end
         sig do
           override
             .returns(
@@ -601,8 +770,18 @@ module Orb
           )
             .returns(T.attached_class)
         end
-        def self.new(id:, credit_note_number:, memo:, reason:, total:, type:, voided_at:); end
-
+        def self.new(
+          id:,
+          credit_note_number:,
+          # An optional memo supplied on the credit note.
+          memo:,
+          reason:,
+          total:,
+          type:,
+          # If the credit note has a status of `void`, this gives a timestamp when the
+          # credit note was voided.
+          voided_at:
+        ); end
         sig do
           override
             .returns(
@@ -705,14 +884,22 @@ module Orb
             .returns(T.attached_class)
         end
         def self.new(
+          # A unique id for this transaction.
           id:,
           action:,
+          # The value of the amount changed in the transaction.
           amount:,
+          # The creation time of this transaction.
           created_at:,
           credit_note:,
+          # An optional description provided for manual customer balance adjustments.
           description:,
+          # The new value of the customer's balance prior to the transaction, in the
+          # customer's currency.
           ending_balance:,
           invoice:,
+          # The original value of the customer's balance prior to the transaction, in the
+          # customer's currency.
           starting_balance:,
           type:
         ); end
@@ -739,8 +926,7 @@ module Orb
           extend Orb::Internal::Type::Enum
 
           TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::Invoice::CustomerBalanceTransaction::Action) }
-          OrSymbol =
-            T.type_alias { T.any(Symbol, String, Orb::Models::Invoice::CustomerBalanceTransaction::Action::TaggedSymbol) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
 
           APPLIED_TO_INVOICE =
             T.let(:applied_to_invoice, Orb::Models::Invoice::CustomerBalanceTransaction::Action::TaggedSymbol)
@@ -771,8 +957,10 @@ module Orb
           attr_accessor :id
 
           sig { params(id: String).returns(T.attached_class) }
-          def self.new(id:); end
-
+          def self.new(
+            # The id of the Credit note
+            id:
+          ); end
           sig { override.returns({id: String}) }
           def to_hash; end
         end
@@ -783,8 +971,10 @@ module Orb
           attr_accessor :id
 
           sig { params(id: String).returns(T.attached_class) }
-          def self.new(id:); end
-
+          def self.new(
+            # The Invoice id
+            id:
+          ); end
           sig { override.returns({id: String}) }
           def to_hash; end
         end
@@ -793,8 +983,7 @@ module Orb
           extend Orb::Internal::Type::Enum
 
           TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::Invoice::CustomerBalanceTransaction::Type) }
-          OrSymbol =
-            T.type_alias { T.any(Symbol, String, Orb::Models::Invoice::CustomerBalanceTransaction::Type::TaggedSymbol) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
 
           INCREMENT = T.let(:increment, Orb::Models::Invoice::CustomerBalanceTransaction::Type::TaggedSymbol)
           DECREMENT = T.let(:decrement, Orb::Models::Invoice::CustomerBalanceTransaction::Type::TaggedSymbol)
@@ -945,8 +1134,7 @@ module Orb
           extend Orb::Internal::Type::Enum
 
           TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::Invoice::CustomerTaxID::Country) }
-          OrSymbol =
-            T.type_alias { T.any(Symbol, String, Orb::Models::Invoice::CustomerTaxID::Country::TaggedSymbol) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
 
           AD = T.let(:AD, Orb::Models::Invoice::CustomerTaxID::Country::TaggedSymbol)
           AE = T.let(:AE, Orb::Models::Invoice::CustomerTaxID::Country::TaggedSymbol)
@@ -1035,8 +1223,7 @@ module Orb
           extend Orb::Internal::Type::Enum
 
           TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::Invoice::CustomerTaxID::Type) }
-          OrSymbol =
-            T.type_alias { T.any(Symbol, String, Orb::Models::Invoice::CustomerTaxID::Type::TaggedSymbol) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
 
           AD_NRT = T.let(:ad_nrt, Orb::Models::Invoice::CustomerTaxID::Type::TaggedSymbol)
           AE_TRN = T.let(:ae_trn, Orb::Models::Invoice::CustomerTaxID::Type::TaggedSymbol)
@@ -1119,7 +1306,7 @@ module Orb
         extend Orb::Internal::Type::Enum
 
         TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::Invoice::InvoiceSource) }
-        OrSymbol = T.type_alias { T.any(Symbol, String, Orb::Models::Invoice::InvoiceSource::TaggedSymbol) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
 
         SUBSCRIPTION = T.let(:subscription, Orb::Models::Invoice::InvoiceSource::TaggedSymbol)
         PARTIAL = T.let(:partial, Orb::Models::Invoice::InvoiceSource::TaggedSymbol)
@@ -1146,11 +1333,11 @@ module Orb
           returns(
             T::Array[
               T.any(
-                Orb::Models::Invoice::LineItem::Adjustment::MonetaryUsageDiscountAdjustment,
-                Orb::Models::Invoice::LineItem::Adjustment::MonetaryAmountDiscountAdjustment,
-                Orb::Models::Invoice::LineItem::Adjustment::MonetaryPercentageDiscountAdjustment,
-                Orb::Models::Invoice::LineItem::Adjustment::MonetaryMinimumAdjustment,
-                Orb::Models::Invoice::LineItem::Adjustment::MonetaryMaximumAdjustment
+                Orb::Models::Invoice::LineItem::Adjustment::UsageDiscount,
+                Orb::Models::Invoice::LineItem::Adjustment::AmountDiscount,
+                Orb::Models::Invoice::LineItem::Adjustment::PercentageDiscount,
+                Orb::Models::Invoice::LineItem::Adjustment::Minimum,
+                Orb::Models::Invoice::LineItem::Adjustment::Maximum
               )
             ]
           )
@@ -1238,34 +1425,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
               )
             )
           )
@@ -1286,9 +1473,9 @@ module Orb
           returns(
             T::Array[
               T.any(
-                Orb::Models::Invoice::LineItem::SubLineItem::MatrixSubLineItem,
-                Orb::Models::Invoice::LineItem::SubLineItem::TierSubLineItem,
-                Orb::Models::Invoice::LineItem::SubLineItem::OtherSubLineItem
+                Orb::Models::Invoice::LineItem::SubLineItem::Matrix,
+                Orb::Models::Invoice::LineItem::SubLineItem::Tier,
+                Orb::Models::Invoice::LineItem::SubLineItem::Null
               )
             ]
           )
@@ -1314,12 +1501,12 @@ module Orb
             adjusted_subtotal: String,
             adjustments: T::Array[
               T.any(
-                Orb::Models::Invoice::LineItem::Adjustment::MonetaryUsageDiscountAdjustment,
+                Orb::Models::Invoice::LineItem::Adjustment::UsageDiscount,
                 Orb::Internal::AnyHash,
-                Orb::Models::Invoice::LineItem::Adjustment::MonetaryAmountDiscountAdjustment,
-                Orb::Models::Invoice::LineItem::Adjustment::MonetaryPercentageDiscountAdjustment,
-                Orb::Models::Invoice::LineItem::Adjustment::MonetaryMinimumAdjustment,
-                Orb::Models::Invoice::LineItem::Adjustment::MonetaryMaximumAdjustment
+                Orb::Models::Invoice::LineItem::Adjustment::AmountDiscount,
+                Orb::Models::Invoice::LineItem::Adjustment::PercentageDiscount,
+                Orb::Models::Invoice::LineItem::Adjustment::Minimum,
+                Orb::Models::Invoice::LineItem::Adjustment::Maximum
               )
             ],
             amount: String,
@@ -1344,45 +1531,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::Invoice::LineItem::SubLineItem::MatrixSubLineItem,
+                Orb::Models::Invoice::LineItem::SubLineItem::Matrix,
                 Orb::Internal::AnyHash,
-                Orb::Models::Invoice::LineItem::SubLineItem::TierSubLineItem,
-                Orb::Models::Invoice::LineItem::SubLineItem::OtherSubLineItem
+                Orb::Models::Invoice::LineItem::SubLineItem::Tier,
+                Orb::Models::Invoice::LineItem::SubLineItem::Null
               )
             ],
             subtotal: String,
@@ -1392,27 +1579,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
@@ -1423,11 +1648,11 @@ module Orb
                 adjusted_subtotal: String,
                 adjustments: T::Array[
                   T.any(
-                    Orb::Models::Invoice::LineItem::Adjustment::MonetaryUsageDiscountAdjustment,
-                    Orb::Models::Invoice::LineItem::Adjustment::MonetaryAmountDiscountAdjustment,
-                    Orb::Models::Invoice::LineItem::Adjustment::MonetaryPercentageDiscountAdjustment,
-                    Orb::Models::Invoice::LineItem::Adjustment::MonetaryMinimumAdjustment,
-                    Orb::Models::Invoice::LineItem::Adjustment::MonetaryMaximumAdjustment
+                    Orb::Models::Invoice::LineItem::Adjustment::UsageDiscount,
+                    Orb::Models::Invoice::LineItem::Adjustment::AmountDiscount,
+                    Orb::Models::Invoice::LineItem::Adjustment::PercentageDiscount,
+                    Orb::Models::Invoice::LineItem::Adjustment::Minimum,
+                    Orb::Models::Invoice::LineItem::Adjustment::Maximum
                   )
                 ],
                 amount: String,
@@ -1451,43 +1676,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::Invoice::LineItem::SubLineItem::MatrixSubLineItem,
-                    Orb::Models::Invoice::LineItem::SubLineItem::TierSubLineItem,
-                    Orb::Models::Invoice::LineItem::SubLineItem::OtherSubLineItem
+                    Orb::Models::Invoice::LineItem::SubLineItem::Matrix,
+                    Orb::Models::Invoice::LineItem::SubLineItem::Tier,
+                    Orb::Models::Invoice::LineItem::SubLineItem::Null
                   )
                 ],
                 subtotal: String,
@@ -1501,7 +1726,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
 
@@ -1544,10 +1769,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
@@ -1568,7 +1800,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
 
@@ -1611,10 +1843,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
@@ -1635,7 +1874,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
 
@@ -1678,10 +1917,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
@@ -1702,7 +1948,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
 
@@ -1750,11 +1996,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
@@ -1776,7 +2030,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
 
@@ -1819,10 +2073,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
@@ -1846,7 +2107,7 @@ module Orb
           sig do
             override
               .returns(
-                [Orb::Models::Invoice::LineItem::Adjustment::MonetaryUsageDiscountAdjustment, Orb::Models::Invoice::LineItem::Adjustment::MonetaryAmountDiscountAdjustment, Orb::Models::Invoice::LineItem::Adjustment::MonetaryPercentageDiscountAdjustment, Orb::Models::Invoice::LineItem::Adjustment::MonetaryMinimumAdjustment, Orb::Models::Invoice::LineItem::Adjustment::MonetaryMaximumAdjustment]
+                [Orb::Models::Invoice::LineItem::Adjustment::UsageDiscount, Orb::Models::Invoice::LineItem::Adjustment::AmountDiscount, Orb::Models::Invoice::LineItem::Adjustment::PercentageDiscount, Orb::Models::Invoice::LineItem::Adjustment::Minimum, Orb::Models::Invoice::LineItem::Adjustment::Maximum]
               )
           end
           def self.variants; end
@@ -1866,8 +2127,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
@@ -1886,8 +2152,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
@@ -1895,33 +2166,28 @@ 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::Invoice::LineItem::SubLineItem::MatrixSubLineItem::Grouping)) }
+            sig { returns(T.nilable(Orb::Models::Invoice::LineItem::SubLineItem::Matrix::Grouping)) }
             attr_reader :grouping
 
             sig do
               params(
-                grouping: T.nilable(
-                  T.any(Orb::Models::Invoice::LineItem::SubLineItem::MatrixSubLineItem::Grouping, Orb::Internal::AnyHash)
-                )
+                grouping: T.nilable(T.any(Orb::Models::Invoice::LineItem::SubLineItem::Matrix::Grouping, Orb::Internal::AnyHash))
               )
                 .void
             end
             attr_writer :grouping
 
-            sig { returns(Orb::Models::Invoice::LineItem::SubLineItem::MatrixSubLineItem::MatrixConfig) }
+            sig { returns(Orb::Models::Invoice::LineItem::SubLineItem::Matrix::MatrixConfig) }
             attr_reader :matrix_config
 
             sig do
               params(
-                matrix_config: T.any(
-                  Orb::Models::Invoice::LineItem::SubLineItem::MatrixSubLineItem::MatrixConfig,
-                  Orb::Internal::AnyHash
-                )
+                matrix_config: T.any(Orb::Models::Invoice::LineItem::SubLineItem::Matrix::MatrixConfig, Orb::Internal::AnyHash)
               )
                 .void
             end
@@ -1939,28 +2205,30 @@ module Orb
             sig do
               params(
                 amount: String,
-                grouping: T.nilable(
-                  T.any(Orb::Models::Invoice::LineItem::SubLineItem::MatrixSubLineItem::Grouping, Orb::Internal::AnyHash)
-                ),
-                matrix_config: T.any(
-                  Orb::Models::Invoice::LineItem::SubLineItem::MatrixSubLineItem::MatrixConfig,
-                  Orb::Internal::AnyHash
-                ),
+                grouping: T.nilable(T.any(Orb::Models::Invoice::LineItem::SubLineItem::Matrix::Grouping, Orb::Internal::AnyHash)),
+                matrix_config: T.any(Orb::Models::Invoice::LineItem::SubLineItem::Matrix::MatrixConfig, Orb::Internal::AnyHash),
                 name: String,
                 quantity: Float,
                 type: Symbol
               )
                 .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::Invoice::LineItem::SubLineItem::MatrixSubLineItem::Grouping),
-                    matrix_config: Orb::Models::Invoice::LineItem::SubLineItem::MatrixSubLineItem::MatrixConfig,
+                    grouping: T.nilable(Orb::Models::Invoice::LineItem::SubLineItem::Matrix::Grouping),
+                    matrix_config: Orb::Models::Invoice::LineItem::SubLineItem::Matrix::MatrixConfig,
                     name: String,
                     quantity: Float,
                     type: Symbol
@@ -1978,8 +2246,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
@@ -1990,26 +2261,26 @@ 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::Invoice::LineItem::SubLineItem::TierSubLineItem::Grouping)) }
+            sig { returns(T.nilable(Orb::Models::Invoice::LineItem::SubLineItem::Tier::Grouping)) }
             attr_reader :grouping
 
             sig do
               params(
-                grouping: T.nilable(
-                  T.any(Orb::Models::Invoice::LineItem::SubLineItem::TierSubLineItem::Grouping, Orb::Internal::AnyHash)
-                )
+                grouping: T.nilable(T.any(Orb::Models::Invoice::LineItem::SubLineItem::Tier::Grouping, Orb::Internal::AnyHash))
               )
                 .void
             end
@@ -2021,12 +2292,12 @@ module Orb
             sig { returns(Float) }
             attr_accessor :quantity
 
-            sig { returns(Orb::Models::Invoice::LineItem::SubLineItem::TierSubLineItem::TierConfig) }
+            sig { returns(Orb::Models::Invoice::LineItem::SubLineItem::Tier::TierConfig) }
             attr_reader :tier_config
 
             sig do
               params(
-                tier_config: T.any(Orb::Models::Invoice::LineItem::SubLineItem::TierSubLineItem::TierConfig, Orb::Internal::AnyHash)
+                tier_config: T.any(Orb::Models::Invoice::LineItem::SubLineItem::Tier::TierConfig, Orb::Internal::AnyHash)
               )
                 .void
             end
@@ -2038,27 +2309,32 @@ module Orb
             sig do
               params(
                 amount: String,
-                grouping: T.nilable(
-                  T.any(Orb::Models::Invoice::LineItem::SubLineItem::TierSubLineItem::Grouping, Orb::Internal::AnyHash)
-                ),
+                grouping: T.nilable(T.any(Orb::Models::Invoice::LineItem::SubLineItem::Tier::Grouping, Orb::Internal::AnyHash)),
                 name: String,
                 quantity: Float,
-                tier_config: T.any(Orb::Models::Invoice::LineItem::SubLineItem::TierSubLineItem::TierConfig, Orb::Internal::AnyHash),
+                tier_config: T.any(Orb::Models::Invoice::LineItem::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::Invoice::LineItem::SubLineItem::TierSubLineItem::Grouping),
+                    grouping: T.nilable(Orb::Models::Invoice::LineItem::SubLineItem::Tier::Grouping),
                     name: String,
                     quantity: Float,
-                    tier_config: Orb::Models::Invoice::LineItem::SubLineItem::TierSubLineItem::TierConfig,
+                    tier_config: Orb::Models::Invoice::LineItem::SubLineItem::Tier::TierConfig,
                     type: Symbol
                   }
                 )
@@ -2074,8 +2350,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
@@ -2104,19 +2383,17 @@ 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::Invoice::LineItem::SubLineItem::OtherSubLineItem::Grouping)) }
+            sig { returns(T.nilable(Orb::Models::Invoice::LineItem::SubLineItem::Null::Grouping)) }
             attr_reader :grouping
 
             sig do
               params(
-                grouping: T.nilable(
-                  T.any(Orb::Models::Invoice::LineItem::SubLineItem::OtherSubLineItem::Grouping, Orb::Internal::AnyHash)
-                )
+                grouping: T.nilable(T.any(Orb::Models::Invoice::LineItem::SubLineItem::Null::Grouping, Orb::Internal::AnyHash))
               )
                 .void
             end
@@ -2134,23 +2411,27 @@ module Orb
             sig do
               params(
                 amount: String,
-                grouping: T.nilable(
-                  T.any(Orb::Models::Invoice::LineItem::SubLineItem::OtherSubLineItem::Grouping, Orb::Internal::AnyHash)
-                ),
+                grouping: T.nilable(T.any(Orb::Models::Invoice::LineItem::SubLineItem::Null::Grouping, Orb::Internal::AnyHash)),
                 name: String,
                 quantity: Float,
                 type: Symbol
               )
                 .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::Invoice::LineItem::SubLineItem::OtherSubLineItem::Grouping),
+                    grouping: T.nilable(Orb::Models::Invoice::LineItem::SubLineItem::Null::Grouping),
                     name: String,
                     quantity: Float,
                     type: Symbol
@@ -2168,8 +2449,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
@@ -2178,7 +2462,7 @@ module Orb
           sig do
             override
               .returns(
-                [Orb::Models::Invoice::LineItem::SubLineItem::MatrixSubLineItem, Orb::Models::Invoice::LineItem::SubLineItem::TierSubLineItem, Orb::Models::Invoice::LineItem::SubLineItem::OtherSubLineItem]
+                [Orb::Models::Invoice::LineItem::SubLineItem::Matrix, Orb::Models::Invoice::LineItem::SubLineItem::Tier, Orb::Models::Invoice::LineItem::SubLineItem::Null]
               )
           end
           def self.variants; end
@@ -2201,8 +2485,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(
               {
@@ -2229,8 +2519,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
@@ -2248,8 +2543,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
@@ -2290,8 +2590,20 @@ module Orb
           )
             .returns(T.attached_class)
         end
-        def self.new(id:, amount:, created_at:, payment_provider:, payment_provider_id:, succeeded:); end
-
+        def self.new(
+          # The ID of the payment attempt.
+          id:,
+          # The amount of the payment attempt.
+          amount:,
+          # The time at which the payment attempt was created.
+          created_at:,
+          # The payment provider that attempted to collect the payment.
+          payment_provider:,
+          # The ID of the payment attempt in the payment provider.
+          payment_provider_id:,
+          # Whether the payment attempt succeeded.
+          succeeded:
+        ); end
         sig do
           override
             .returns(
@@ -2312,8 +2624,7 @@ module Orb
           extend Orb::Internal::Type::Enum
 
           TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::Invoice::PaymentAttempt::PaymentProvider) }
-          OrSymbol =
-            T.type_alias { T.any(Symbol, String, Orb::Models::Invoice::PaymentAttempt::PaymentProvider::TaggedSymbol) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
 
           STRIPE = T.let(:stripe, Orb::Models::Invoice::PaymentAttempt::PaymentProvider::TaggedSymbol)
 
@@ -2374,7 +2685,7 @@ module Orb
         extend Orb::Internal::Type::Enum
 
         TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::Invoice::Status) }
-        OrSymbol = T.type_alias { T.any(Symbol, String, Orb::Models::Invoice::Status::TaggedSymbol) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
 
         ISSUED = T.let(:issued, Orb::Models::Invoice::Status::TaggedSymbol)
         PAID = T.let(:paid, Orb::Models::Invoice::Status::TaggedSymbol)