orb-billing 1.8.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 73eacd2178ce9b71a5008a0c26c266fcf6579d79722d724c57f57b77c8a38bad
-  data.tar.gz: a18fc7d75c927d7d2d2e76e44434343e3104806c34330c1f3fdfd53da3816ce9
+  metadata.gz: a36105fb09d02890a315ca9a50fdd6a4e34732fbea2757c84efd04e7d527277e
+  data.tar.gz: '028189302e2c0e750456640cdf3007ce55e7693620b116213fa6b6c9fe233234'
 SHA512:
-  metadata.gz: 9afea5e8284f240ee0fe7a3d911c4ae7d253f5fa8b320dd616524f68cdca6a256eae576471ca59472299e0894e51e618e3cc792818ce7a931d53ac88473ade73
-  data.tar.gz: cdb483431879ee339cf54f769f174cf8b2a08b240d64ed079c631640385c020c26a8f994083b4bdc3f6102d1ecdf26cd40aedf137aeea7f90b3c4f9a783712b6
+  metadata.gz: a4632adc1758dde42c9395047409118e314e1e51d76fbb661a6b7204d618d75e7e387e8c6375c37a1e12c1dd6fa25d254f340e2fc14b985a0372edb9d6bb1a2b
+  data.tar.gz: 84ff717a439ae6313d741341480ac9975d10c3a00e0e6f1b98a16b815b0d0cef646d6a774fb793f422274b4aa26325e746f60874f393e78b692ed480a0be8e73

data/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 1.10.0 (2025-07-24)
+
+Full Changelog: [v1.9.0...v1.10.0](https://github.com/orbcorp/orb-ruby/compare/v1.9.0...v1.10.0)
+
+### Features
+
+* **api:** api update ([d29d009](https://github.com/orbcorp/orb-ruby/commit/d29d0090db27540e1c3db6401f6da794b5d0e9eb))
+
+
+### Chores
+
+* **internal:** version bump ([ee4d38b](https://github.com/orbcorp/orb-ruby/commit/ee4d38b21b33af78599b278d378d21afc9fb6f77))
+
+## 1.9.0 (2025-07-21)
+
+Full Changelog: [v1.8.0...v1.9.0](https://github.com/orbcorp/orb-ruby/compare/v1.8.0...v1.9.0)
+
+### Features
+
+* **api:** api update ([a6e890c](https://github.com/orbcorp/orb-ruby/commit/a6e890c40ec02098aac56daf3793545df289f914))
+
+
+### Chores
+
+* **internal:** version bump ([4e5e51e](https://github.com/orbcorp/orb-ruby/commit/4e5e51e6255e54012d7aaab536a2d1cf239b30a2))
+
 ## 1.8.0 (2025-07-17)
 
 Full Changelog: [v1.7.0...v1.8.0](https://github.com/orbcorp/orb-ruby/compare/v1.7.0...v1.8.0)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "orb-billing", "~> 1.8.0"
+gem "orb-billing", "~> 1.10.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/orb/models/customer_update_by_external_id_params.rb

@@ -51,8 +51,11 @@ module Orb
       optional :email_delivery, Orb::Internal::Type::Boolean, nil?: true
 
       # @!attribute external_customer_id
-      #   The external customer ID. This can only be set if empty and the customer has no
-      #   past or current subscriptions.
+      #   The external customer ID. This can only be set if the customer has no existing
+      #   external customer ID. Since this action may change usage quantities for all
+      #   existing subscriptions, it is disallowed if the customer has issued invoices
+      #   with usage line items and subject to the same restrictions as backdated
+      #   subscription creation.
       #
       #   @return [String, nil]
       optional :external_customer_id, String, nil?: true
@@ -243,7 +246,7 @@ module Orb
       #
       #   @param email_delivery [Boolean, nil]
       #
-      #   @param external_customer_id [String, nil] The external customer ID. This can only be set if empty and the customer has no
+      #   @param external_customer_id [String, nil] The external customer ID. This can only be set if the customer has no existing e
       #
       #   @param hierarchy [Orb::Models::CustomerHierarchyConfig, nil] The hierarchical relationships for this customer.
       #

data/lib/orb/models/customer_update_params.rb

@@ -51,8 +51,11 @@ module Orb
       optional :email_delivery, Orb::Internal::Type::Boolean, nil?: true
 
       # @!attribute external_customer_id
-      #   The external customer ID. This can only be set if empty and the customer has no
-      #   past or current subscriptions.
+      #   The external customer ID. This can only be set if the customer has no existing
+      #   external customer ID. Since this action may change usage quantities for all
+      #   existing subscriptions, it is disallowed if the customer has issued invoices
+      #   with usage line items and subject to the same restrictions as backdated
+      #   subscription creation.
       #
       #   @return [String, nil]
       optional :external_customer_id, String, nil?: true
@@ -239,7 +242,7 @@ module Orb
       #
       #   @param email_delivery [Boolean, nil]
       #
-      #   @param external_customer_id [String, nil] The external customer ID. This can only be set if empty and the customer has no
+      #   @param external_customer_id [String, nil] The external customer ID. This can only be set if the customer has no existing e
       #
       #   @param hierarchy [Orb::Models::CustomerHierarchyConfig, nil] The hierarchical relationships for this customer.
       #

data/lib/orb/models/customers/cost_list_by_external_id_params.rb

@@ -9,7 +9,7 @@ module Orb
         include Orb::Internal::Type::RequestParameters
 
         # @!attribute currency
-        #   The currency to use.
+        #   The currency or custom pricing unit to use.
         #
         #   @return [String, nil]
         optional :currency, String, nil?: true
@@ -39,7 +39,7 @@ module Orb
         #   Some parameter documentations has been truncated, see
         #   {Orb::Models::Customers::CostListByExternalIDParams} for more details.
         #
-        #   @param currency [String, nil] The currency to use.
+        #   @param currency [String, nil] The currency or custom pricing unit to use.
         #
         #   @param timeframe_end [Time, nil] Costs returned are exclusive of `timeframe_end`.
         #

data/lib/orb/models/customers/cost_list_params.rb

@@ -9,7 +9,7 @@ module Orb
         include Orb::Internal::Type::RequestParameters
 
         # @!attribute currency
-        #   The currency to use.
+        #   The currency or custom pricing unit to use.
         #
         #   @return [String, nil]
         optional :currency, String, nil?: true
@@ -39,7 +39,7 @@ module Orb
         #   Some parameter documentations has been truncated, see
         #   {Orb::Models::Customers::CostListParams} for more details.
         #
-        #   @param currency [String, nil] The currency to use.
+        #   @param currency [String, nil] The currency or custom pricing unit to use.
         #
         #   @param timeframe_end [Time, nil] Costs returned are exclusive of `timeframe_end`.
         #

data/lib/orb/models/customers/credits/ledger_create_entry_by_external_id_params.rb

@@ -153,8 +153,8 @@ module Orb
             #   date for the invoice. If you intend the invoice to be due on issue, set this
             #   to 0.
             #
-            #   @return [Integer]
-            required :net_terms, Integer
+            #   @return [Integer, nil]
+            required :net_terms, Integer, nil?: true
 
             # @!attribute invoice_date
             #   An ISO 8601 format date that denotes when this invoice should be dated in the
@@ -193,7 +193,7 @@ module Orb
             #
             #   @param auto_collection [Boolean] Whether the credits purchase invoice should auto collect with the customer's sav
             #
-            #   @param net_terms [Integer] The net terms determines the difference between the invoice date and the issue d
+            #   @param net_terms [Integer, nil] The net terms determines the difference between the invoice date and the issue d
             #
             #   @param invoice_date [Date, Time, nil] An ISO 8601 format date that denotes when this invoice should be dated in the cu
             #

data/lib/orb/models/customers/credits/ledger_create_entry_params.rb

@@ -149,8 +149,8 @@ module Orb
             #   date for the invoice. If you intend the invoice to be due on issue, set this
             #   to 0.
             #
-            #   @return [Integer]
-            required :net_terms, Integer
+            #   @return [Integer, nil]
+            required :net_terms, Integer, nil?: true
 
             # @!attribute invoice_date
             #   An ISO 8601 format date that denotes when this invoice should be dated in the
@@ -189,7 +189,7 @@ module Orb
             #
             #   @param auto_collection [Boolean] Whether the credits purchase invoice should auto collect with the customer's sav
             #
-            #   @param net_terms [Integer] The net terms determines the difference between the invoice date and the issue d
+            #   @param net_terms [Integer, nil] The net terms determines the difference between the invoice date and the issue d
             #
             #   @param invoice_date [Date, Time, nil] An ISO 8601 format date that denotes when this invoice should be dated in the cu
             #

data/lib/orb/models/invoice_create_params.rb

@@ -26,15 +26,6 @@ module Orb
       #   @return [Array<Orb::Models::InvoiceCreateParams::LineItem>]
       required :line_items, -> { Orb::Internal::Type::ArrayOf[Orb::InvoiceCreateParams::LineItem] }
 
-      # @!attribute net_terms
-      #   Determines the difference between the invoice issue date for subscription
-      #   invoices as the date that they are due. A value of '0' here represents that the
-      #   invoice is due on issue, whereas a value of 30 represents that the customer has
-      #   30 days to pay the invoice.
-      #
-      #   @return [Integer]
-      required :net_terms, Integer
-
       # @!attribute customer_id
       #   The id of the `Customer` to create this invoice for. One of `customer_id` and
       #   `external_customer_id` are required.
@@ -69,6 +60,15 @@ module Orb
       #   @return [Hash{Symbol=>String, nil}, nil]
       optional :metadata, Orb::Internal::Type::HashOf[String, nil?: true], nil?: true
 
+      # @!attribute net_terms
+      #   Determines the difference between the invoice issue date for subscription
+      #   invoices as the date that they are due. A value of '0' here represents that the
+      #   invoice is due on issue, whereas a value of 30 represents that the customer has
+      #   30 days to pay the invoice.
+      #
+      #   @return [Integer, nil]
+      optional :net_terms, Integer, nil?: true
+
       # @!attribute will_auto_issue
       #   When true, this invoice will be submitted for issuance upon creation. When
       #   false, the resulting invoice will require manual review to issue. Defaulted to
@@ -77,7 +77,7 @@ module Orb
       #   @return [Boolean, nil]
       optional :will_auto_issue, Orb::Internal::Type::Boolean
 
-      # @!method initialize(currency:, invoice_date:, line_items:, net_terms:, customer_id: nil, discount: nil, external_customer_id: nil, memo: nil, metadata: nil, will_auto_issue: nil, request_options: {})
+      # @!method initialize(currency:, invoice_date:, line_items:, customer_id: nil, discount: nil, external_customer_id: nil, memo: nil, metadata: nil, net_terms: nil, will_auto_issue: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Orb::Models::InvoiceCreateParams} for more details.
       #
@@ -87,8 +87,6 @@ module Orb
       #
       #   @param line_items [Array<Orb::Models::InvoiceCreateParams::LineItem>]
       #
-      #   @param net_terms [Integer] Determines the difference between the invoice issue date for subscription invoic
-      #
       #   @param customer_id [String, nil] The id of the `Customer` to create this invoice for. One of `customer_id` and `e
       #
       #   @param discount [Orb::Models::PercentageDiscount, Orb::Models::TrialDiscount, Orb::Models::UsageDiscount, Orb::Models::AmountDiscount, nil] An optional discount to attach to the invoice.
@@ -99,6 +97,8 @@ module Orb
       #
       #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
       #
+      #   @param net_terms [Integer, nil] Determines the difference between the invoice issue date for subscription invoic
+      #
       #   @param will_auto_issue [Boolean] When true, this invoice will be submitted for issuance upon creation. When false
       #
       #   @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}]

data/lib/orb/models/subscription_fetch_costs_params.rb

@@ -8,7 +8,7 @@ module Orb
       include Orb::Internal::Type::RequestParameters
 
       # @!attribute currency
-      #   The currency to use.
+      #   The currency or custom pricing unit to use.
       #
       #   @return [String, nil]
       optional :currency, String, nil?: true
@@ -38,7 +38,7 @@ module Orb
       #   Some parameter documentations has been truncated, see
       #   {Orb::Models::SubscriptionFetchCostsParams} for more details.
       #
-      #   @param currency [String, nil] The currency to use.
+      #   @param currency [String, nil] The currency or custom pricing unit to use.
       #
       #   @param timeframe_end [Time, nil] Costs returned are exclusive of `timeframe_end`.
       #

data/lib/orb/resources/customers/costs.rb

@@ -129,7 +129,7 @@ module Orb
         #
         # @param customer_id [String]
         #
-        # @param currency [String, nil] The currency to use.
+        # @param currency [String, nil] The currency or custom pricing unit to use.
         #
         # @param timeframe_end [Time, nil] Costs returned are exclusive of `timeframe_end`.
         #
@@ -278,7 +278,7 @@ module Orb
         #
         # @param external_customer_id [String]
         #
-        # @param currency [String, nil] The currency to use.
+        # @param currency [String, nil] The currency or custom pricing unit to use.
         #
         # @param timeframe_end [Time, nil] Costs returned are exclusive of `timeframe_end`.
         #

data/lib/orb/resources/customers.rb

@@ -109,7 +109,7 @@ module Orb
       #
       # @param email_delivery [Boolean, nil]
       #
-      # @param external_customer_id [String, nil] The external customer ID. This can only be set if empty and the customer has no
+      # @param external_customer_id [String, nil] The external customer ID. This can only be set if the customer has no existing e
       #
       # @param hierarchy [Orb::Models::CustomerHierarchyConfig, nil] The hierarchical relationships for this customer.
       #
@@ -345,7 +345,7 @@ module Orb
       #
       # @param email_delivery [Boolean, nil]
       #
-      # @param external_customer_id [String, nil] The external customer ID. This can only be set if empty and the customer has no
+      # @param external_customer_id [String, nil] The external customer ID. This can only be set if the customer has no existing e
       #
       # @param hierarchy [Orb::Models::CustomerHierarchyConfig, nil] The hierarchical relationships for this customer.
       #

data/lib/orb/resources/invoices.rb

@@ -8,7 +8,7 @@ module Orb
       #
       # This endpoint is used to create a one-off invoice for a customer.
       #
-      # @overload create(currency:, invoice_date:, line_items:, net_terms:, customer_id: nil, discount: nil, external_customer_id: nil, memo: nil, metadata: nil, will_auto_issue: nil, request_options: {})
+      # @overload create(currency:, invoice_date:, line_items:, customer_id: nil, discount: nil, external_customer_id: nil, memo: nil, metadata: nil, net_terms: nil, will_auto_issue: nil, request_options: {})
       #
       # @param currency [String] An ISO 4217 currency string. Must be the same as the customer's currency if it i
       #
@@ -16,8 +16,6 @@ module Orb
       #
       # @param line_items [Array<Orb::Models::InvoiceCreateParams::LineItem>]
       #
-      # @param net_terms [Integer] Determines the difference between the invoice issue date for subscription invoic
-      #
       # @param customer_id [String, nil] The id of the `Customer` to create this invoice for. One of `customer_id` and `e
       #
       # @param discount [Orb::Models::PercentageDiscount, Orb::Models::TrialDiscount, Orb::Models::UsageDiscount, Orb::Models::AmountDiscount, nil] An optional discount to attach to the invoice.
@@ -28,6 +26,8 @@ module Orb
       #
       # @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
       #
+      # @param net_terms [Integer, nil] Determines the difference between the invoice issue date for subscription invoic
+      #
       # @param will_auto_issue [Boolean] When true, this invoice will be submitted for issuance upon creation. When false
       #
       # @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -43,11 +43,12 @@ module Orb
       # Some parameter documentations has been truncated, see
       # {Orb::Models::InvoiceUpdateParams} for more details.
       #
-      # This endpoint allows you to update the `metadata` property on an invoice. If you
-      # pass null for the metadata value, it will clear any existing metadata for that
-      # invoice.
+      # This endpoint allows you to update the `metadata`, `net_terms`, and `due_date`
+      # properties on an invoice. If you pass null for the metadata value, it will clear
+      # any existing metadata for that invoice.
       #
-      # `metadata` can be modified regardless of invoice state.
+      # `metadata` can be modified regardless of invoice state. `net_terms` and
+      # `due_date` can only be modified if the invoice is in a `draft` state.
       #
       # @overload update(invoice_id, metadata: nil, request_options: {})
       #

data/lib/orb/resources/subscriptions.rb

@@ -568,7 +568,7 @@ module Orb
       #
       # @param subscription_id [String]
       #
-      # @param currency [String, nil] The currency to use.
+      # @param currency [String, nil] The currency or custom pricing unit to use.
       #
       # @param timeframe_end [Time, nil] Costs returned are exclusive of `timeframe_end`.
       #

data/lib/orb/version.rb

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

data/rbi/orb/models/customer_update_by_external_id_params.rbi

@@ -51,8 +51,11 @@ module Orb
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :email_delivery
 
-      # The external customer ID. This can only be set if empty and the customer has no
-      # past or current subscriptions.
+      # The external customer ID. This can only be set if the customer has no existing
+      # external customer ID. Since this action may change usage quantities for all
+      # existing subscriptions, it is disallowed if the customer has issued invoices
+      # with usage line items and subject to the same restrictions as backdated
+      # subscription creation.
       sig { returns(T.nilable(String)) }
       attr_accessor :external_customer_id
 
@@ -289,8 +292,11 @@ module Orb
         # A valid customer email, to be used for invoicing and notifications.
         email: nil,
         email_delivery: nil,
-        # The external customer ID. This can only be set if empty and the customer has no
-        # past or current subscriptions.
+        # The external customer ID. This can only be set if the customer has no existing
+        # external customer ID. Since this action may change usage quantities for all
+        # existing subscriptions, it is disallowed if the customer has issued invoices
+        # with usage line items and subject to the same restrictions as backdated
+        # subscription creation.
         external_customer_id: nil,
         # The hierarchical relationships for this customer.
         hierarchy: nil,

data/rbi/orb/models/customer_update_params.rbi

@@ -51,8 +51,11 @@ module Orb
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :email_delivery
 
-      # The external customer ID. This can only be set if empty and the customer has no
-      # past or current subscriptions.
+      # The external customer ID. This can only be set if the customer has no existing
+      # external customer ID. Since this action may change usage quantities for all
+      # existing subscriptions, it is disallowed if the customer has issued invoices
+      # with usage line items and subject to the same restrictions as backdated
+      # subscription creation.
       sig { returns(T.nilable(String)) }
       attr_accessor :external_customer_id
 
@@ -283,8 +286,11 @@ module Orb
         # A valid customer email, to be used for invoicing and notifications.
         email: nil,
         email_delivery: nil,
-        # The external customer ID. This can only be set if empty and the customer has no
-        # past or current subscriptions.
+        # The external customer ID. This can only be set if the customer has no existing
+        # external customer ID. Since this action may change usage quantities for all
+        # existing subscriptions, it is disallowed if the customer has issued invoices
+        # with usage line items and subject to the same restrictions as backdated
+        # subscription creation.
         external_customer_id: nil,
         # The hierarchical relationships for this customer.
         hierarchy: nil,

data/rbi/orb/models/customers/cost_list_by_external_id_params.rbi

@@ -15,7 +15,7 @@ module Orb
             )
           end
 
-        # The currency to use.
+        # The currency or custom pricing unit to use.
         sig { returns(T.nilable(String)) }
         attr_accessor :currency
 
@@ -53,7 +53,7 @@ module Orb
           ).returns(T.attached_class)
         end
         def self.new(
-          # The currency to use.
+          # The currency or custom pricing unit to use.
           currency: nil,
           # Costs returned are exclusive of `timeframe_end`.
           timeframe_end: nil,

data/rbi/orb/models/customers/cost_list_params.rbi

@@ -12,7 +12,7 @@ module Orb
             T.any(Orb::Customers::CostListParams, Orb::Internal::AnyHash)
           end
 
-        # The currency to use.
+        # The currency or custom pricing unit to use.
         sig { returns(T.nilable(String)) }
         attr_accessor :currency
 
@@ -44,7 +44,7 @@ module Orb
           ).returns(T.attached_class)
         end
         def self.new(
-          # The currency to use.
+          # The currency or custom pricing unit to use.
           currency: nil,
           # Costs returned are exclusive of `timeframe_end`.
           timeframe_end: nil,

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

@@ -242,7 +242,7 @@ module Orb
             # The net terms determines the difference between the invoice date and the issue
             # date for the invoice. If you intend the invoice to be due on issue, set this
             # to 0.
-            sig { returns(Integer) }
+            sig { returns(T.nilable(Integer)) }
             attr_accessor :net_terms
 
             # An ISO 8601 format date that denotes when this invoice should be dated in the
@@ -276,7 +276,7 @@ module Orb
             sig do
               params(
                 auto_collection: T::Boolean,
-                net_terms: Integer,
+                net_terms: T.nilable(Integer),
                 invoice_date:
                   T.nilable(
                     Orb::Customers::Credits::LedgerCreateEntryByExternalIDParams::InvoiceSettings::InvoiceDate::Variants
@@ -309,7 +309,7 @@ module Orb
               override.returns(
                 {
                   auto_collection: T::Boolean,
-                  net_terms: Integer,
+                  net_terms: T.nilable(Integer),
                   invoice_date:
                     T.nilable(
                       Orb::Customers::Credits::LedgerCreateEntryByExternalIDParams::InvoiceSettings::InvoiceDate::Variants

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

@@ -242,7 +242,7 @@ module Orb
             # The net terms determines the difference between the invoice date and the issue
             # date for the invoice. If you intend the invoice to be due on issue, set this
             # to 0.
-            sig { returns(Integer) }
+            sig { returns(T.nilable(Integer)) }
             attr_accessor :net_terms
 
             # An ISO 8601 format date that denotes when this invoice should be dated in the
@@ -276,7 +276,7 @@ module Orb
             sig do
               params(
                 auto_collection: T::Boolean,
-                net_terms: Integer,
+                net_terms: T.nilable(Integer),
                 invoice_date:
                   T.nilable(
                     Orb::Customers::Credits::LedgerCreateEntryParams::InvoiceSettings::InvoiceDate::Variants
@@ -309,7 +309,7 @@ module Orb
               override.returns(
                 {
                   auto_collection: T::Boolean,
-                  net_terms: Integer,
+                  net_terms: T.nilable(Integer),
                   invoice_date:
                     T.nilable(
                       Orb::Customers::Credits::LedgerCreateEntryParams::InvoiceSettings::InvoiceDate::Variants

data/rbi/orb/models/invoice_create_params.rbi

@@ -22,13 +22,6 @@ module Orb
       sig { returns(T::Array[Orb::InvoiceCreateParams::LineItem]) }
       attr_accessor :line_items
 
-      # Determines the difference between the invoice issue date for subscription
-      # invoices as the date that they are due. A value of '0' here represents that the
-      # invoice is due on issue, whereas a value of 30 represents that the customer has
-      # 30 days to pay the invoice.
-      sig { returns(Integer) }
-      attr_accessor :net_terms
-
       # The id of the `Customer` to create this invoice for. One of `customer_id` and
       # `external_customer_id` are required.
       sig { returns(T.nilable(String)) }
@@ -64,6 +57,13 @@ module Orb
       sig { returns(T.nilable(T::Hash[Symbol, T.nilable(String)])) }
       attr_accessor :metadata
 
+      # Determines the difference between the invoice issue date for subscription
+      # invoices as the date that they are due. A value of '0' here represents that the
+      # invoice is due on issue, whereas a value of 30 represents that the customer has
+      # 30 days to pay the invoice.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :net_terms
+
       # When true, this invoice will be submitted for issuance upon creation. When
       # false, the resulting invoice will require manual review to issue. Defaulted to
       # false.
@@ -78,7 +78,6 @@ module Orb
           currency: String,
           invoice_date: Time,
           line_items: T::Array[Orb::InvoiceCreateParams::LineItem::OrHash],
-          net_terms: Integer,
           customer_id: T.nilable(String),
           discount:
             T.nilable(
@@ -92,6 +91,7 @@ module Orb
           external_customer_id: T.nilable(String),
           memo: T.nilable(String),
           metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+          net_terms: T.nilable(Integer),
           will_auto_issue: T::Boolean,
           request_options: Orb::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -104,11 +104,6 @@ module Orb
         # set to the current time in the customer's timezone.
         invoice_date:,
         line_items:,
-        # Determines the difference between the invoice issue date for subscription
-        # invoices as the date that they are due. A value of '0' here represents that the
-        # invoice is due on issue, whereas a value of 30 represents that the customer has
-        # 30 days to pay the invoice.
-        net_terms:,
         # The id of the `Customer` to create this invoice for. One of `customer_id` and
         # `external_customer_id` are required.
         customer_id: nil,
@@ -123,6 +118,11 @@ module Orb
         # by setting the value to `null`, and the entire metadata mapping can be cleared
         # by setting `metadata` to `null`.
         metadata: nil,
+        # Determines the difference between the invoice issue date for subscription
+        # invoices as the date that they are due. A value of '0' here represents that the
+        # invoice is due on issue, whereas a value of 30 represents that the customer has
+        # 30 days to pay the invoice.
+        net_terms: nil,
         # When true, this invoice will be submitted for issuance upon creation. When
         # false, the resulting invoice will require manual review to issue. Defaulted to
         # false.
@@ -137,7 +137,6 @@ module Orb
             currency: String,
             invoice_date: Time,
             line_items: T::Array[Orb::InvoiceCreateParams::LineItem],
-            net_terms: Integer,
             customer_id: T.nilable(String),
             discount:
               T.nilable(
@@ -151,6 +150,7 @@ module Orb
             external_customer_id: T.nilable(String),
             memo: T.nilable(String),
             metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+            net_terms: T.nilable(Integer),
             will_auto_issue: T::Boolean,
             request_options: Orb::RequestOptions
           }

data/rbi/orb/models/subscription_fetch_costs_params.rbi

@@ -11,7 +11,7 @@ module Orb
           T.any(Orb::SubscriptionFetchCostsParams, Orb::Internal::AnyHash)
         end
 
-      # The currency to use.
+      # The currency or custom pricing unit to use.
       sig { returns(T.nilable(String)) }
       attr_accessor :currency
 
@@ -45,7 +45,7 @@ module Orb
         ).returns(T.attached_class)
       end
       def self.new(
-        # The currency to use.
+        # The currency or custom pricing unit to use.
         currency: nil,
         # Costs returned are exclusive of `timeframe_end`.
         timeframe_end: nil,

data/rbi/orb/resources/customers/costs.rbi

@@ -134,7 +134,7 @@ module Orb
         end
         def list(
           customer_id,
-          # The currency to use.
+          # The currency or custom pricing unit to use.
           currency: nil,
           # Costs returned are exclusive of `timeframe_end`.
           timeframe_end: nil,
@@ -281,7 +281,7 @@ module Orb
         end
         def list_by_external_id(
           external_customer_id,
-          # The currency to use.
+          # The currency or custom pricing unit to use.
           currency: nil,
           # Costs returned are exclusive of `timeframe_end`.
           timeframe_end: nil,

data/rbi/orb/resources/customers.rbi

@@ -266,8 +266,11 @@ module Orb
         # A valid customer email, to be used for invoicing and notifications.
         email: nil,
         email_delivery: nil,
-        # The external customer ID. This can only be set if empty and the customer has no
-        # past or current subscriptions.
+        # The external customer ID. This can only be set if the customer has no existing
+        # external customer ID. Since this action may change usage quantities for all
+        # existing subscriptions, it is disallowed if the customer has issued invoices
+        # with usage line items and subject to the same restrictions as backdated
+        # subscription creation.
         external_customer_id: nil,
         # The hierarchical relationships for this customer.
         hierarchy: nil,
@@ -571,8 +574,11 @@ module Orb
         # A valid customer email, to be used for invoicing and notifications.
         email: nil,
         email_delivery: nil,
-        # The external customer ID. This can only be set if empty and the customer has no
-        # past or current subscriptions.
+        # The external customer ID. This can only be set if the customer has no existing
+        # external customer ID. Since this action may change usage quantities for all
+        # existing subscriptions, it is disallowed if the customer has issued invoices
+        # with usage line items and subject to the same restrictions as backdated
+        # subscription creation.
         external_customer_id: nil,
         # The hierarchical relationships for this customer.
         hierarchy: nil,

data/rbi/orb/resources/invoices.rbi

@@ -9,7 +9,6 @@ module Orb
           currency: String,
           invoice_date: Time,
           line_items: T::Array[Orb::InvoiceCreateParams::LineItem::OrHash],
-          net_terms: Integer,
           customer_id: T.nilable(String),
           discount:
             T.nilable(
@@ -23,6 +22,7 @@ module Orb
           external_customer_id: T.nilable(String),
           memo: T.nilable(String),
           metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+          net_terms: T.nilable(Integer),
           will_auto_issue: T::Boolean,
           request_options: Orb::RequestOptions::OrHash
         ).returns(Orb::Invoice)
@@ -35,11 +35,6 @@ module Orb
         # set to the current time in the customer's timezone.
         invoice_date:,
         line_items:,
-        # Determines the difference between the invoice issue date for subscription
-        # invoices as the date that they are due. A value of '0' here represents that the
-        # invoice is due on issue, whereas a value of 30 represents that the customer has
-        # 30 days to pay the invoice.
-        net_terms:,
         # The id of the `Customer` to create this invoice for. One of `customer_id` and
         # `external_customer_id` are required.
         customer_id: nil,
@@ -54,6 +49,11 @@ module Orb
         # by setting the value to `null`, and the entire metadata mapping can be cleared
         # by setting `metadata` to `null`.
         metadata: nil,
+        # Determines the difference between the invoice issue date for subscription
+        # invoices as the date that they are due. A value of '0' here represents that the
+        # invoice is due on issue, whereas a value of 30 represents that the customer has
+        # 30 days to pay the invoice.
+        net_terms: nil,
         # When true, this invoice will be submitted for issuance upon creation. When
         # false, the resulting invoice will require manual review to issue. Defaulted to
         # false.
@@ -62,11 +62,12 @@ module Orb
       )
       end
 
-      # This endpoint allows you to update the `metadata` property on an invoice. If you
-      # pass null for the metadata value, it will clear any existing metadata for that
-      # invoice.
+      # This endpoint allows you to update the `metadata`, `net_terms`, and `due_date`
+      # properties on an invoice. If you pass null for the metadata value, it will clear
+      # any existing metadata for that invoice.
       #
-      # `metadata` can be modified regardless of invoice state.
+      # `metadata` can be modified regardless of invoice state. `net_terms` and
+      # `due_date` can only be modified if the invoice is in a `draft` state.
       sig do
         params(
           invoice_id: String,

data/rbi/orb/resources/subscriptions.rbi

@@ -611,7 +611,7 @@ module Orb
       end
       def fetch_costs(
         subscription_id,
-        # The currency to use.
+        # The currency or custom pricing unit to use.
         currency: nil,
         # Costs returned are exclusive of `timeframe_end`.
         timeframe_end: nil,

data/sig/orb/models/customers/credits/ledger_create_entry_by_external_id_params.rbs

@@ -92,7 +92,7 @@ module Orb
           type invoice_settings =
             {
               auto_collection: bool,
-              net_terms: Integer,
+              net_terms: Integer?,
               invoice_date: Orb::Models::Customers::Credits::LedgerCreateEntryByExternalIDParams::InvoiceSettings::invoice_date?,
               memo: String?,
               require_successful_payment: bool
@@ -101,7 +101,7 @@ module Orb
           class InvoiceSettings < Orb::Internal::Type::BaseModel
             attr_accessor auto_collection: bool
 
-            attr_accessor net_terms: Integer
+            attr_accessor net_terms: Integer?
 
             attr_accessor invoice_date: Orb::Models::Customers::Credits::LedgerCreateEntryByExternalIDParams::InvoiceSettings::invoice_date?
 
@@ -113,7 +113,7 @@ module Orb
 
             def initialize: (
               auto_collection: bool,
-              net_terms: Integer,
+              net_terms: Integer?,
               ?invoice_date: Orb::Models::Customers::Credits::LedgerCreateEntryByExternalIDParams::InvoiceSettings::invoice_date?,
               ?memo: String?,
               ?require_successful_payment: bool
@@ -121,7 +121,7 @@ module Orb
 
             def to_hash: -> {
               auto_collection: bool,
-              net_terms: Integer,
+              net_terms: Integer?,
               invoice_date: Orb::Models::Customers::Credits::LedgerCreateEntryByExternalIDParams::InvoiceSettings::invoice_date?,
               memo: String?,
               require_successful_payment: bool

data/sig/orb/models/customers/credits/ledger_create_entry_params.rbs

@@ -92,7 +92,7 @@ module Orb
           type invoice_settings =
             {
               auto_collection: bool,
-              net_terms: Integer,
+              net_terms: Integer?,
               invoice_date: Orb::Models::Customers::Credits::LedgerCreateEntryParams::InvoiceSettings::invoice_date?,
               memo: String?,
               require_successful_payment: bool
@@ -101,7 +101,7 @@ module Orb
           class InvoiceSettings < Orb::Internal::Type::BaseModel
             attr_accessor auto_collection: bool
 
-            attr_accessor net_terms: Integer
+            attr_accessor net_terms: Integer?
 
             attr_accessor invoice_date: Orb::Models::Customers::Credits::LedgerCreateEntryParams::InvoiceSettings::invoice_date?
 
@@ -113,7 +113,7 @@ module Orb
 
             def initialize: (
               auto_collection: bool,
-              net_terms: Integer,
+              net_terms: Integer?,
               ?invoice_date: Orb::Models::Customers::Credits::LedgerCreateEntryParams::InvoiceSettings::invoice_date?,
               ?memo: String?,
               ?require_successful_payment: bool
@@ -121,7 +121,7 @@ module Orb
 
             def to_hash: -> {
               auto_collection: bool,
-              net_terms: Integer,
+              net_terms: Integer?,
               invoice_date: Orb::Models::Customers::Credits::LedgerCreateEntryParams::InvoiceSettings::invoice_date?,
               memo: String?,
               require_successful_payment: bool

data/sig/orb/models/invoice_create_params.rbs

@@ -5,12 +5,12 @@ module Orb
         currency: String,
         invoice_date: Time,
         line_items: ::Array[Orb::InvoiceCreateParams::LineItem],
-        net_terms: Integer,
         customer_id: String?,
         discount: Orb::Models::discount?,
         external_customer_id: String?,
         memo: String?,
         metadata: ::Hash[Symbol, String?]?,
+        net_terms: Integer?,
         will_auto_issue: bool
       }
       & Orb::Internal::Type::request_parameters
@@ -25,8 +25,6 @@ module Orb
 
       attr_accessor line_items: ::Array[Orb::InvoiceCreateParams::LineItem]
 
-      attr_accessor net_terms: Integer
-
       attr_accessor customer_id: String?
 
       attr_accessor discount: Orb::Models::discount?
@@ -37,6 +35,8 @@ module Orb
 
       attr_accessor metadata: ::Hash[Symbol, String?]?
 
+      attr_accessor net_terms: Integer?
+
       attr_reader will_auto_issue: bool?
 
       def will_auto_issue=: (bool) -> bool
@@ -45,12 +45,12 @@ module Orb
         currency: String,
         invoice_date: Time,
         line_items: ::Array[Orb::InvoiceCreateParams::LineItem],
-        net_terms: Integer,
         ?customer_id: String?,
         ?discount: Orb::Models::discount?,
         ?external_customer_id: String?,
         ?memo: String?,
         ?metadata: ::Hash[Symbol, String?]?,
+        ?net_terms: Integer?,
         ?will_auto_issue: bool,
         ?request_options: Orb::request_opts
       ) -> void
@@ -59,12 +59,12 @@ module Orb
         currency: String,
         invoice_date: Time,
         line_items: ::Array[Orb::InvoiceCreateParams::LineItem],
-        net_terms: Integer,
         customer_id: String?,
         discount: Orb::Models::discount?,
         external_customer_id: String?,
         memo: String?,
         metadata: ::Hash[Symbol, String?]?,
+        net_terms: Integer?,
         will_auto_issue: bool,
         request_options: Orb::RequestOptions
       }

data/sig/orb/resources/invoices.rbs

@@ -5,12 +5,12 @@ module Orb
         currency: String,
         invoice_date: Time,
         line_items: ::Array[Orb::InvoiceCreateParams::LineItem],
-        net_terms: Integer,
         ?customer_id: String?,
         ?discount: Orb::Models::discount?,
         ?external_customer_id: String?,
         ?memo: String?,
         ?metadata: ::Hash[Symbol, String?]?,
+        ?net_terms: Integer?,
         ?will_auto_issue: bool,
         ?request_options: Orb::request_opts
       ) -> Orb::Invoice

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: orb-billing
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 1.10.0
 platform: ruby
 authors:
 - Orb
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-17 00:00:00.000000000 Z
+date: 2025-07-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool