orb-billing 0.5.4 → 0.6.0

data/lib/orb/resources/prices.rb

@@ -10,7 +10,7 @@ module Orb
       # {Orb::Models::PriceCreateParams} for more details.
       #
       # This endpoint is used to create a [price](/product-catalog/price-configuration).
-      # A price created using this endpoint is always an add-on, meaning that it’s not
+      # A price created using this endpoint is always an add-on, meaning that it's not
       # associated with a specific plan and can instead be individually added to
       # subscriptions, including subscriptions on different plans.
       #
@@ -20,7 +20,7 @@ module Orb
       # See the [Price resource](/product-catalog/price-configuration) for the
       # specification of different price model configurations possible in this endpoint.
       #
-      # @overload create(cadence:, currency:, item_id:, model_type:, name:, unit_config:, package_config:, matrix_config:, matrix_with_allocation_config:, tiered_config:, tiered_bps_config:, bps_config:, bulk_bps_config:, bulk_config:, threshold_total_amount_config:, tiered_package_config:, grouped_tiered_config:, max_group_tiered_package_config:, tiered_with_minimum_config:, package_with_allocation_config:, tiered_package_with_minimum_config:, unit_with_percent_config:, tiered_with_proration_config:, unit_with_proration_config:, grouped_allocation_config:, grouped_with_prorated_minimum_config:, grouped_with_metered_minimum_config:, matrix_with_display_name_config:, bulk_with_proration_config:, grouped_tiered_package_config:, scalable_matrix_with_unit_pricing_config:, scalable_matrix_with_tiered_pricing_config:, cumulative_grouped_bulk_config:, billable_metric_id: nil, billed_in_advance: nil, billing_cycle_configuration: nil, conversion_rate: nil, external_price_id: nil, fixed_price_quantity: nil, invoice_grouping_key: nil, invoicing_cycle_configuration: nil, metadata: nil, request_options: {})
+      # @overload create(cadence:, currency:, item_id:, model_type:, name:, unit_config:, package_config:, matrix_config:, matrix_with_allocation_config:, tiered_config:, tiered_bps_config:, bps_config:, bulk_bps_config:, bulk_config:, threshold_total_amount_config:, tiered_package_config:, grouped_tiered_config:, max_group_tiered_package_config:, tiered_with_minimum_config:, package_with_allocation_config:, tiered_package_with_minimum_config:, unit_with_percent_config:, tiered_with_proration_config:, unit_with_proration_config:, grouped_allocation_config:, grouped_with_prorated_minimum_config:, grouped_with_metered_minimum_config:, matrix_with_display_name_config:, bulk_with_proration_config:, grouped_tiered_package_config:, scalable_matrix_with_unit_pricing_config:, scalable_matrix_with_tiered_pricing_config:, cumulative_grouped_bulk_config:, billable_metric_id: nil, billed_in_advance: nil, billing_cycle_configuration: nil, conversion_rate: nil, dimensional_price_configuration: nil, external_price_id: nil, fixed_price_quantity: nil, invoice_grouping_key: nil, invoicing_cycle_configuration: nil, metadata: nil, request_options: {})
       #
       # @param cadence [Symbol, Orb::Models::PriceCreateParams::Cadence] The cadence to bill for this price on.
       #
@@ -96,6 +96,8 @@ module Orb
       #
       # @param conversion_rate [Float, nil] The per unit conversion rate of the price currency to the invoicing currency.
       #
+      # @param dimensional_price_configuration [Orb::Models::PriceCreateParams::DimensionalPriceConfiguration, nil] For dimensional price: specifies a price group and dimension values
+      #
       # @param external_price_id [String, nil] An alias for the price.
       #
       # @param fixed_price_quantity [Float, nil] If the Price represents a fixed cost, this represents the quantity of units appl
@@ -174,17 +176,24 @@ module Orb
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {Orb::Models::PriceEvaluateParams} for more details.
-      #
-      # This endpoint is used to evaluate the output of a price for a given customer and
-      # time range. It enables filtering and grouping the output using
+      # This endpoint is used to evaluate the output of price(s) for a given customer
+      # and time range over either ingested events or preview events. It enables
+      # filtering and grouping the output using
       # [computed properties](/extensibility/advanced-metrics#computed-properties),
       # supporting the following workflows:
       #
       # 1. Showing detailed usage and costs to the end customer.
       # 2. Auditing subtotals on invoice line items.
       #
+      # Prices may either reference existing prices in your Orb account or be defined
+      # inline in the request body. Up to 100 prices can be evaluated in a single
+      # request.
+      #
+      # Price evaluation by default uses ingested events, but you can also provide a
+      # list of preview events to use instead. Up to 500 preview events can be provided
+      # in a single request. When using ingested events, the start of the time range
+      # must be no more than 100 days ago.
+      #
       # For these workflows, the expressiveness of computed properties in both the
       # filters and grouping is critical. For example, if you'd like to show your
       # customer their usage grouped by hour and another property, you can do so with
@@ -194,14 +203,11 @@ module Orb
       # with the following `filter`:
       # `my_property = 'foo' AND my_other_property = 'bar'`.
       #
-      # By default, the start of the time range must be no more than 100 days ago and
-      # the length of the results must be no greater than 1000. Note that this is a POST
+      # The length of the results must be no greater than 1000. Note that this is a POST
       # endpoint rather than a GET endpoint because it employs a JSON body rather than
       # query parameters.
       #
-      # @overload evaluate(price_id, timeframe_end:, timeframe_start:, customer_id: nil, external_customer_id: nil, filter: nil, grouping_keys: nil, request_options: {})
-      #
-      # @param price_id [String]
+      # @overload evaluate(timeframe_end:, timeframe_start:, customer_id: nil, events: nil, external_customer_id: nil, price_evaluations: nil, request_options: {})
       #
       # @param timeframe_end [Time] The exclusive upper bound for event timestamps
       #
@@ -209,22 +215,22 @@ module Orb
       #
       # @param customer_id [String, nil] The ID of the customer to which this evaluation is scoped.
       #
-      # @param external_customer_id [String, nil] The external customer ID of the customer to which this evaluation is scoped.
+      # @param events [Array<Orb::Models::PriceEvaluateParams::Event>, nil] Optional list of preview events to use instead of actual usage data (max 500)
       #
-      # @param filter [String, nil] A boolean [computed property](/extensibility/advanced-metrics#computed-propertie
+      # @param external_customer_id [String, nil] The external customer ID of the customer to which this evaluation is scoped.
       #
-      # @param grouping_keys [Array<String>] Properties (or [computed properties](/extensibility/advanced-metrics#computed-pr
+      # @param price_evaluations [Array<Orb::Models::PriceEvaluateParams::PriceEvaluation>] List of prices to evaluate (max 100)
       #
       # @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Orb::Models::PriceEvaluateResponse]
       #
       # @see Orb::Models::PriceEvaluateParams
-      def evaluate(price_id, params)
+      def evaluate(params)
         parsed, options = Orb::PriceEvaluateParams.dump_request(params)
         @client.request(
           method: :post,
-          path: ["prices/%1$s/evaluate", price_id],
+          path: "prices/evaluate",
           body: parsed,
           model: Orb::Models::PriceEvaluateResponse,
           options: options

data/lib/orb/resources/subscriptions.rb

@@ -263,7 +263,7 @@ module Orb
       # subscription. E.g. pass in `10.00` to issue an invoice when usage amounts hit
       # $10.00 for a subscription that invoices in USD.
       #
-      # @overload create(add_adjustments: nil, add_prices: nil, align_billing_with_subscription_start_date: nil, auto_collection: nil, aws_region: nil, billing_cycle_anchor_configuration: nil, coupon_redemption_code: nil, credits_overage_rate: nil, customer_id: nil, default_invoice_memo: nil, end_date: nil, external_customer_id: nil, external_marketplace: nil, external_marketplace_reporting_id: nil, external_plan_id: nil, filter: nil, initial_phase_order: nil, invoicing_threshold: nil, metadata: nil, net_terms: nil, per_credit_overage_amount: nil, plan_id: nil, plan_version_number: nil, price_overrides: nil, remove_adjustments: nil, remove_prices: nil, replace_adjustments: nil, replace_prices: nil, start_date: nil, trial_duration_days: nil, usage_customer_ids: nil, request_options: {})
+      # @overload create(add_adjustments: nil, add_prices: nil, align_billing_with_subscription_start_date: nil, auto_collection: nil, aws_region: nil, billing_cycle_anchor_configuration: nil, coupon_redemption_code: nil, credits_overage_rate: nil, currency: nil, customer_id: nil, default_invoice_memo: nil, end_date: nil, external_customer_id: nil, external_marketplace: nil, external_marketplace_reporting_id: nil, external_plan_id: nil, filter: nil, initial_phase_order: nil, invoicing_threshold: nil, metadata: nil, name: nil, net_terms: nil, per_credit_overage_amount: nil, plan_id: nil, plan_version_number: nil, price_overrides: nil, remove_adjustments: nil, remove_prices: nil, replace_adjustments: nil, replace_prices: nil, start_date: nil, trial_duration_days: nil, usage_customer_ids: nil, request_options: {})
       #
       # @param add_adjustments [Array<Orb::Models::SubscriptionCreateParams::AddAdjustment>, nil] Additional adjustments to be added to the subscription. (Only available for acco
       #
@@ -281,6 +281,8 @@ module Orb
       #
       # @param credits_overage_rate [Float, nil]
       #
+      # @param currency [String, nil] The currency to use for the subscription. If not specified, the invoicing curren
+      #
       # @param customer_id [String, nil]
       #
       # @param default_invoice_memo [String, nil] Determines the default memo on this subscription's invoices. Note that if this i
@@ -303,6 +305,8 @@ module Orb
       #
       # @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
       #
+      # @param name [String, nil] The name to use for the subscription. If not specified, the plan name will be us
+      #
       # @param net_terms [Integer, nil] The net terms determines the difference between the invoice date and the issue d
       #
       # @param per_credit_overage_amount [Float, nil]

data/lib/orb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Orb
-  VERSION = "0.5.4"
+  VERSION = "0.6.0"
 end

data/lib/orb.rb

@@ -20,7 +20,9 @@ require "uri"
 
 # We already ship the preferred sorbet manifests in the package itself.
 # `tapioca` currently does not offer us a way to opt out of unnecessary compilation.
-if Object.const_defined?(:Tapioca) && caller.chain([$PROGRAM_NAME]).chain(ARGV).grep(/tapioca/)
+if Object.const_defined?(:Tapioca) &&
+   caller.chain([$PROGRAM_NAME]).chain(ARGV).any?(/tapioca/) &&
+   ARGV.none?(/dsl/)
   return
 end
 
@@ -154,6 +156,7 @@ require_relative "orb/models/invoice_pay_params"
 require_relative "orb/models/invoice_update_params"
 require_relative "orb/models/invoice_void_params"
 require_relative "orb/models/item"
+require_relative "orb/models/item_archive_params"
 require_relative "orb/models/item_create_params"
 require_relative "orb/models/item_fetch_params"
 require_relative "orb/models/item_list_params"
@@ -168,8 +171,18 @@ require_relative "orb/models/plan"
 require_relative "orb/models/plan_create_params"
 require_relative "orb/models/plan_fetch_params"
 require_relative "orb/models/plan_list_params"
+require_relative "orb/models/plans/external_plan_id/version_create_params"
+require_relative "orb/models/plans/external_plan_id/version_create_response"
+require_relative "orb/models/plans/external_plan_id/version_retrieve_params"
+require_relative "orb/models/plans/external_plan_id/version_retrieve_response"
 require_relative "orb/models/plans/external_plan_id_fetch_params"
+require_relative "orb/models/plans/external_plan_id_set_default_version_params"
 require_relative "orb/models/plans/external_plan_id_update_params"
+require_relative "orb/models/plans/version_create_params"
+require_relative "orb/models/plans/version_create_response"
+require_relative "orb/models/plans/version_retrieve_params"
+require_relative "orb/models/plans/version_retrieve_response"
+require_relative "orb/models/plan_set_default_version_params"
 require_relative "orb/models/plan_update_params"
 require_relative "orb/models/price"
 require_relative "orb/models/price_create_params"
@@ -243,6 +256,8 @@ require_relative "orb/resources/items"
 require_relative "orb/resources/metrics"
 require_relative "orb/resources/plans"
 require_relative "orb/resources/plans/external_plan_id"
+require_relative "orb/resources/plans/external_plan_id/versions"
+require_relative "orb/resources/plans/versions"
 require_relative "orb/resources/prices"
 require_relative "orb/resources/prices/external_price_id"
 require_relative "orb/resources/subscription_changes"

data/rbi/orb/models/alert.rbi

@@ -60,6 +60,11 @@ module Orb
       sig { returns(Orb::Alert::Type::TaggedSymbol) }
       attr_accessor :type
 
+      # The current status of the alert. This field is only present for credit balance
+      # alerts.
+      sig { returns(T.nilable(T::Array[Orb::Alert::BalanceAlertStatus])) }
+      attr_accessor :balance_alert_status
+
       # [Alerts within Orb](/product-catalog/configuring-alerts) monitor spending,
       # usage, or credit balance and trigger webhooks when a threshold is exceeded.
       #
@@ -76,7 +81,9 @@ module Orb
           plan: T.nilable(Orb::Alert::Plan::OrHash),
           subscription: T.nilable(Orb::Alert::Subscription::OrHash),
           thresholds: T.nilable(T::Array[Orb::Alert::Threshold::OrHash]),
-          type: Orb::Alert::Type::OrSymbol
+          type: Orb::Alert::Type::OrSymbol,
+          balance_alert_status:
+            T.nilable(T::Array[Orb::Alert::BalanceAlertStatus::OrHash])
         ).returns(T.attached_class)
       end
       def self.new(
@@ -100,7 +107,10 @@ module Orb
         # triggered.
         thresholds:,
         # The type of alert. This must be a valid alert type.
-        type:
+        type:,
+        # The current status of the alert. This field is only present for credit balance
+        # alerts.
+        balance_alert_status: nil
       )
       end
 
@@ -116,7 +126,9 @@ module Orb
             plan: T.nilable(Orb::Alert::Plan),
             subscription: T.nilable(Orb::Alert::Subscription),
             thresholds: T.nilable(T::Array[Orb::Alert::Threshold]),
-            type: Orb::Alert::Type::TaggedSymbol
+            type: Orb::Alert::Type::TaggedSymbol,
+            balance_alert_status:
+              T.nilable(T::Array[Orb::Alert::BalanceAlertStatus])
           }
         )
       end
@@ -286,6 +298,41 @@ module Orb
         def self.values
         end
       end
+
+      class BalanceAlertStatus < Orb::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Orb::Alert::BalanceAlertStatus, Orb::Internal::AnyHash)
+          end
+
+        # Whether the alert is currently in-alert or not.
+        sig { returns(T::Boolean) }
+        attr_accessor :in_alert
+
+        # The value of the threshold that defines the alert status.
+        sig { returns(Float) }
+        attr_accessor :threshold_value
+
+        # Alert status is used to determine if an alert is currently in-alert or not.
+        sig do
+          params(in_alert: T::Boolean, threshold_value: Float).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # Whether the alert is currently in-alert or not.
+          in_alert:,
+          # The value of the threshold that defines the alert status.
+          threshold_value:
+        )
+        end
+
+        sig do
+          override.returns({ in_alert: T::Boolean, threshold_value: Float })
+        end
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/orb/models/amount_discount.rbi

@@ -10,32 +10,32 @@ module Orb
       sig { returns(String) }
       attr_accessor :amount_discount
 
+      sig { returns(Orb::AmountDiscount::DiscountType::OrSymbol) }
+      attr_accessor :discount_type
+
       # List of price_ids that this discount applies to. For plan/plan phase discounts,
       # this can be a subset of prices.
-      sig { returns(T::Array[String]) }
+      sig { returns(T.nilable(T::Array[String])) }
       attr_accessor :applies_to_price_ids
 
-      sig { returns(Orb::AmountDiscount::DiscountType::OrSymbol) }
-      attr_accessor :discount_type
-
       sig { returns(T.nilable(String)) }
       attr_accessor :reason
 
       sig do
         params(
           amount_discount: String,
-          applies_to_price_ids: T::Array[String],
           discount_type: Orb::AmountDiscount::DiscountType::OrSymbol,
+          applies_to_price_ids: T.nilable(T::Array[String]),
           reason: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
         # Only available if discount_type is `amount`.
         amount_discount:,
+        discount_type:,
         # List of price_ids that this discount applies to. For plan/plan phase discounts,
         # this can be a subset of prices.
-        applies_to_price_ids:,
-        discount_type:,
+        applies_to_price_ids: nil,
         reason: nil
       )
       end
@@ -44,8 +44,8 @@ module Orb
         override.returns(
           {
             amount_discount: String,
-            applies_to_price_ids: T::Array[String],
             discount_type: Orb::AmountDiscount::DiscountType::OrSymbol,
+            applies_to_price_ids: T.nilable(T::Array[String]),
             reason: T.nilable(String)
           }
         )

data/rbi/orb/models/credit_note_create_params.rbi

@@ -14,28 +14,28 @@ module Orb
       sig { returns(T::Array[Orb::CreditNoteCreateParams::LineItem]) }
       attr_accessor :line_items
 
+      # An optional reason for the credit note.
+      sig { returns(Orb::CreditNoteCreateParams::Reason::OrSymbol) }
+      attr_accessor :reason
+
       # An optional memo to attach to the credit note.
       sig { returns(T.nilable(String)) }
       attr_accessor :memo
 
-      # An optional reason for the credit note.
-      sig { returns(T.nilable(Orb::CreditNoteCreateParams::Reason::OrSymbol)) }
-      attr_accessor :reason
-
       sig do
         params(
           line_items: T::Array[Orb::CreditNoteCreateParams::LineItem::OrHash],
+          reason: Orb::CreditNoteCreateParams::Reason::OrSymbol,
           memo: T.nilable(String),
-          reason: T.nilable(Orb::CreditNoteCreateParams::Reason::OrSymbol),
           request_options: Orb::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
         line_items:,
+        # An optional reason for the credit note.
+        reason:,
         # An optional memo to attach to the credit note.
         memo: nil,
-        # An optional reason for the credit note.
-        reason: nil,
         request_options: {}
       )
       end
@@ -44,8 +44,8 @@ module Orb
         override.returns(
           {
             line_items: T::Array[Orb::CreditNoteCreateParams::LineItem],
+            reason: Orb::CreditNoteCreateParams::Reason::OrSymbol,
             memo: T.nilable(String),
-            reason: T.nilable(Orb::CreditNoteCreateParams::Reason::OrSymbol),
             request_options: Orb::RequestOptions
           }
         )

data/rbi/orb/models/customer_create_params.rbi

@@ -133,7 +133,8 @@ module Orb
           T.nilable(
             T.any(
               Orb::CustomerCreateParams::TaxConfiguration::Avalara,
-              Orb::CustomerCreateParams::TaxConfiguration::Taxjar
+              Orb::CustomerCreateParams::TaxConfiguration::Taxjar,
+              Orb::CustomerCreateParams::TaxConfiguration::Sphere
             )
           )
         )
@@ -289,7 +290,8 @@ module Orb
             T.nilable(
               T.any(
                 Orb::CustomerCreateParams::TaxConfiguration::Avalara::OrHash,
-                Orb::CustomerCreateParams::TaxConfiguration::Taxjar::OrHash
+                Orb::CustomerCreateParams::TaxConfiguration::Taxjar::OrHash,
+                Orb::CustomerCreateParams::TaxConfiguration::Sphere::OrHash
               )
             ),
           tax_id: T.nilable(Orb::CustomerCreateParams::TaxID::OrHash),
@@ -478,7 +480,8 @@ module Orb
               T.nilable(
                 T.any(
                   Orb::CustomerCreateParams::TaxConfiguration::Avalara,
-                  Orb::CustomerCreateParams::TaxConfiguration::Taxjar
+                  Orb::CustomerCreateParams::TaxConfiguration::Taxjar,
+                  Orb::CustomerCreateParams::TaxConfiguration::Sphere
                 )
               ),
             tax_id: T.nilable(Orb::CustomerCreateParams::TaxID),
@@ -825,7 +828,8 @@ module Orb
           T.type_alias do
             T.any(
               Orb::CustomerCreateParams::TaxConfiguration::Avalara,
-              Orb::CustomerCreateParams::TaxConfiguration::Taxjar
+              Orb::CustomerCreateParams::TaxConfiguration::Taxjar,
+              Orb::CustomerCreateParams::TaxConfiguration::Sphere
             )
           end
 
@@ -904,6 +908,36 @@ module Orb
           end
         end
 
+        class Sphere < Orb::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Orb::CustomerCreateParams::TaxConfiguration::Sphere,
+                Orb::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T::Boolean) }
+          attr_accessor :tax_exempt
+
+          sig { returns(Symbol) }
+          attr_accessor :tax_provider
+
+          sig do
+            params(tax_exempt: T::Boolean, tax_provider: Symbol).returns(
+              T.attached_class
+            )
+          end
+          def self.new(tax_exempt:, tax_provider: :sphere)
+          end
+
+          sig do
+            override.returns({ tax_exempt: T::Boolean, tax_provider: Symbol })
+          end
+          def to_hash
+          end
+        end
+
         sig do
           override.returns(
             T::Array[Orb::CustomerCreateParams::TaxConfiguration::Variants]

data/rbi/orb/models/customer_update_by_external_id_params.rbi

@@ -161,7 +161,8 @@ module Orb
           T.nilable(
             T.any(
               Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Avalara,
-              Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Taxjar
+              Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Taxjar,
+              Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Sphere
             )
           )
         )
@@ -321,7 +322,8 @@ module Orb
             T.nilable(
               T.any(
                 Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Avalara::OrHash,
-                Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Taxjar::OrHash
+                Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Taxjar::OrHash,
+                Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Sphere::OrHash
               )
             ),
           tax_id:
@@ -514,7 +516,8 @@ module Orb
               T.nilable(
                 T.any(
                   Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Avalara,
-                  Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Taxjar
+                  Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Taxjar,
+                  Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Sphere
                 )
               ),
             tax_id: T.nilable(Orb::CustomerUpdateByExternalIDParams::TaxID),
@@ -872,7 +875,8 @@ module Orb
           T.type_alias do
             T.any(
               Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Avalara,
-              Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Taxjar
+              Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Taxjar,
+              Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Sphere
             )
           end
 
@@ -951,6 +955,36 @@ module Orb
           end
         end
 
+        class Sphere < Orb::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Orb::CustomerUpdateByExternalIDParams::TaxConfiguration::Sphere,
+                Orb::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T::Boolean) }
+          attr_accessor :tax_exempt
+
+          sig { returns(Symbol) }
+          attr_accessor :tax_provider
+
+          sig do
+            params(tax_exempt: T::Boolean, tax_provider: Symbol).returns(
+              T.attached_class
+            )
+          end
+          def self.new(tax_exempt:, tax_provider: :sphere)
+          end
+
+          sig do
+            override.returns({ tax_exempt: T::Boolean, tax_provider: Symbol })
+          end
+          def to_hash
+          end
+        end
+
         sig do
           override.returns(
             T::Array[

data/rbi/orb/models/customer_update_params.rbi

@@ -134,7 +134,8 @@ module Orb
           T.nilable(
             T.any(
               Orb::CustomerUpdateParams::TaxConfiguration::Avalara,
-              Orb::CustomerUpdateParams::TaxConfiguration::Taxjar
+              Orb::CustomerUpdateParams::TaxConfiguration::Taxjar,
+              Orb::CustomerUpdateParams::TaxConfiguration::Sphere
             )
           )
         )
@@ -284,7 +285,8 @@ module Orb
             T.nilable(
               T.any(
                 Orb::CustomerUpdateParams::TaxConfiguration::Avalara::OrHash,
-                Orb::CustomerUpdateParams::TaxConfiguration::Taxjar::OrHash
+                Orb::CustomerUpdateParams::TaxConfiguration::Taxjar::OrHash,
+                Orb::CustomerUpdateParams::TaxConfiguration::Sphere::OrHash
               )
             ),
           tax_id: T.nilable(Orb::CustomerUpdateParams::TaxID::OrHash),
@@ -469,7 +471,8 @@ module Orb
               T.nilable(
                 T.any(
                   Orb::CustomerUpdateParams::TaxConfiguration::Avalara,
-                  Orb::CustomerUpdateParams::TaxConfiguration::Taxjar
+                  Orb::CustomerUpdateParams::TaxConfiguration::Taxjar,
+                  Orb::CustomerUpdateParams::TaxConfiguration::Sphere
                 )
               ),
             tax_id: T.nilable(Orb::CustomerUpdateParams::TaxID),
@@ -819,7 +822,8 @@ module Orb
           T.type_alias do
             T.any(
               Orb::CustomerUpdateParams::TaxConfiguration::Avalara,
-              Orb::CustomerUpdateParams::TaxConfiguration::Taxjar
+              Orb::CustomerUpdateParams::TaxConfiguration::Taxjar,
+              Orb::CustomerUpdateParams::TaxConfiguration::Sphere
             )
           end
 
@@ -898,6 +902,36 @@ module Orb
           end
         end
 
+        class Sphere < Orb::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Orb::CustomerUpdateParams::TaxConfiguration::Sphere,
+                Orb::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T::Boolean) }
+          attr_accessor :tax_exempt
+
+          sig { returns(Symbol) }
+          attr_accessor :tax_provider
+
+          sig do
+            params(tax_exempt: T::Boolean, tax_provider: Symbol).returns(
+              T.attached_class
+            )
+          end
+          def self.new(tax_exempt:, tax_provider: :sphere)
+          end
+
+          sig do
+            override.returns({ tax_exempt: T::Boolean, tax_provider: Symbol })
+          end
+          def to_hash
+          end
+        end
+
         sig do
           override.returns(
             T::Array[Orb::CustomerUpdateParams::TaxConfiguration::Variants]

data/rbi/orb/models/customers/credits/ledger_create_entry_by_external_id_response.rbi

@@ -102,6 +102,10 @@ module Orb
             sig { returns(Float) }
             attr_accessor :starting_balance
 
+            # If the increment resulted in invoice creation, the list of created invoices
+            sig { returns(T.nilable(T::Array[Orb::Invoice])) }
+            attr_accessor :created_invoices
+
             sig do
               params(
                 id: String,
@@ -119,6 +123,7 @@ module Orb
                 ledger_sequence_number: Integer,
                 metadata: T::Hash[Symbol, String],
                 starting_balance: Float,
+                created_invoices: T.nilable(T::Array[Orb::Invoice::OrHash]),
                 entry_type: Symbol
               ).returns(T.attached_class)
             end
@@ -139,6 +144,8 @@ module Orb
               # `null`.
               metadata:,
               starting_balance:,
+              # If the increment resulted in invoice creation, the list of created invoices
+              created_invoices: nil,
               entry_type: :increment
             )
             end
@@ -161,7 +168,8 @@ module Orb
                   entry_type: Symbol,
                   ledger_sequence_number: Integer,
                   metadata: T::Hash[Symbol, String],
-                  starting_balance: Float
+                  starting_balance: Float,
+                  created_invoices: T.nilable(T::Array[Orb::Invoice])
                 }
               )
             end

data/rbi/orb/models/customers/credits/ledger_create_entry_response.rbi

@@ -102,6 +102,10 @@ module Orb
             sig { returns(Float) }
             attr_accessor :starting_balance
 
+            # If the increment resulted in invoice creation, the list of created invoices
+            sig { returns(T.nilable(T::Array[Orb::Invoice])) }
+            attr_accessor :created_invoices
+
             sig do
               params(
                 id: String,
@@ -119,6 +123,7 @@ module Orb
                 ledger_sequence_number: Integer,
                 metadata: T::Hash[Symbol, String],
                 starting_balance: Float,
+                created_invoices: T.nilable(T::Array[Orb::Invoice::OrHash]),
                 entry_type: Symbol
               ).returns(T.attached_class)
             end
@@ -139,6 +144,8 @@ module Orb
               # `null`.
               metadata:,
               starting_balance:,
+              # If the increment resulted in invoice creation, the list of created invoices
+              created_invoices: nil,
               entry_type: :increment
             )
             end
@@ -161,7 +168,8 @@ module Orb
                   entry_type: Symbol,
                   ledger_sequence_number: Integer,
                   metadata: T::Hash[Symbol, String],
-                  starting_balance: Float
+                  starting_balance: Float,
+                  created_invoices: T.nilable(T::Array[Orb::Invoice])
                 }
               )
             end