orb-billing 1.0.1 → 1.1.0

data/rbi/orb/internal/type/converter.rbi

@@ -15,12 +15,14 @@ module Orb
         CoerceState =
           T.type_alias do
             {
-              strictness: T.any(T::Boolean, Symbol),
+              translate_names: T::Boolean,
+              strictness: T::Boolean,
               exactness: {
                 yes: Integer,
                 no: Integer,
                 maybe: Integer
               },
+              error: T::Class[StandardError],
               branched: Integer
             }
           end
@@ -84,6 +86,15 @@ module Orb
           def self.type_info(spec)
           end
 
+          # @api private
+          sig do
+            params(translate_names: T::Boolean).returns(
+              Orb::Internal::Type::Converter::CoerceState
+            )
+          end
+          def self.new_coerce_state(translate_names: true)
+          end
+
           # @api private
           #
           # Based on `target`, transform `value` into `target`, to the extent possible:
@@ -105,14 +116,11 @@ module Orb
           def self.coerce(
             target,
             value,
-            # The `strictness` is one of `true`, `false`, or `:strong`. This informs the
-            # coercion strategy when we have to decide between multiple possible conversion
-            # targets:
+            # The `strictness` is one of `true`, `false`. This informs the coercion strategy
+            # when we have to decide between multiple possible conversion targets:
             #
             # - `true`: the conversion must be exact, with minimum coercion.
             # - `false`: the conversion can be approximate, with some coercion.
-            # - `:strong`: the conversion must be exact, with no coercion, and raise an error
-            #   if not possible.
             #
             # The `exactness` is `Hash` with keys being one of `yes`, `no`, or `maybe`. For
             # any given conversion attempt, the exactness will be updated based on how closely
@@ -124,15 +132,7 @@ module Orb
             # - `no`: the value cannot be converted to the target type.
             #
             # See implementation below for more details.
-            state: {
-              strictness: true,
-              exactness: {
-                yes: 0,
-                no: 0,
-                maybe: 0
-              },
-              branched: 0
-            }
+            state: Orb::Internal::Type::Converter.new_coerce_state
           )
           end
 

data/rbi/orb/internal/type/union.rbi

@@ -78,6 +78,11 @@ module Orb
         end
 
         # @api private
+        #
+        # Tries to efficiently coerce the given value to one of the known variants.
+        #
+        # If the value cannot match any of the known variants, the coercion is considered
+        # non-viable and returns the original value.
         sig do
           override
             .params(

data/rbi/orb/internal/type/unknown.rbi

@@ -22,6 +22,8 @@ module Orb
 
         class << self
           # @api private
+          #
+          # No coercion needed for Unknown type.
           sig do
             override
               .params(

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

@@ -107,12 +107,12 @@ module Orb
               amount: Float,
               entry_type:
                 Orb::Customers::Credits::LedgerCreateEntryByExternalIDParams::EntryType::OrSymbol,
-              expiry_date: T.nilable(Time),
               target_expiry_date: Date,
               block_id: String,
               currency: T.nilable(String),
               description: T.nilable(String),
               effective_date: T.nilable(Time),
+              expiry_date: T.nilable(Time),
               invoice_settings:
                 T.nilable(
                   Orb::Customers::Credits::LedgerCreateEntryByExternalIDParams::InvoiceSettings::OrHash
@@ -131,8 +131,6 @@ module Orb
             # decrement or void operations.
             amount:,
             entry_type:,
-            # An ISO 8601 format date that identifies the origination credit block to expire
-            expiry_date:,
             # A future date (specified in YYYY-MM-DD format) used for expiration change,
             # denoting when credits transferred (as part of a partial block expiration) should
             # expire.
@@ -149,6 +147,8 @@ module Orb
             # An ISO 8601 format date that denotes when this credit balance should become
             # available for use.
             effective_date: nil,
+            # An ISO 8601 format date that identifies the origination credit block to expire
+            expiry_date: nil,
             # Passing `invoice_settings` automatically generates an invoice for the newly
             # added credits. If `invoice_settings` is passed, you must specify
             # per_unit_cost_basis, as the calculation of the invoice total is done on that

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

@@ -107,12 +107,12 @@ module Orb
               amount: Float,
               entry_type:
                 Orb::Customers::Credits::LedgerCreateEntryParams::EntryType::OrSymbol,
-              expiry_date: T.nilable(Time),
               target_expiry_date: Date,
               block_id: String,
               currency: T.nilable(String),
               description: T.nilable(String),
               effective_date: T.nilable(Time),
+              expiry_date: T.nilable(Time),
               invoice_settings:
                 T.nilable(
                   Orb::Customers::Credits::LedgerCreateEntryParams::InvoiceSettings::OrHash
@@ -131,8 +131,6 @@ module Orb
             # decrement or void operations.
             amount:,
             entry_type:,
-            # An ISO 8601 format date that identifies the origination credit block to expire
-            expiry_date:,
             # A future date (specified in YYYY-MM-DD format) used for expiration change,
             # denoting when credits transferred (as part of a partial block expiration) should
             # expire.
@@ -149,6 +147,8 @@ module Orb
             # An ISO 8601 format date that denotes when this credit balance should become
             # available for use.
             effective_date: nil,
+            # An ISO 8601 format date that identifies the origination credit block to expire
+            expiry_date: nil,
             # Passing `invoice_settings` automatically generates an invoice for the newly
             # added credits. If `invoice_settings` is passed, you must specify
             # per_unit_cost_basis, as the calculation of the invoice total is done on that

data/rbi/orb/models/invoice.rbi

@@ -1020,6 +1020,7 @@ module Orb
         sig { returns(String) }
         attr_accessor :credits_applied
 
+        # This field is deprecated in favor of `adjustments`
         sig { returns(T.nilable(Orb::Discount::Variants)) }
         attr_accessor :discount
 
@@ -1201,6 +1202,7 @@ module Orb
           amount:,
           # The number of prepaid credits applied.
           credits_applied:,
+          # This field is deprecated in favor of `adjustments`
           discount:,
           # The end date of the range of time applied for this line item's price.
           end_date:,

data/rbi/orb/models/invoice_fetch_upcoming_response.rbi

@@ -1117,6 +1117,7 @@ module Orb
         sig { returns(String) }
         attr_accessor :credits_applied
 
+        # This field is deprecated in favor of `adjustments`
         sig { returns(T.nilable(Orb::Discount::Variants)) }
         attr_accessor :discount
 
@@ -1304,6 +1305,7 @@ module Orb
           amount:,
           # The number of prepaid credits applied.
           credits_applied:,
+          # This field is deprecated in favor of `adjustments`
           discount:,
           # The end date of the range of time applied for this line item's price.
           end_date:,

data/rbi/orb/models/invoice_line_item_create_response.rbi

@@ -41,6 +41,7 @@ module Orb
       sig { returns(String) }
       attr_accessor :credits_applied
 
+      # This field is deprecated in favor of `adjustments`
       sig { returns(T.nilable(Orb::Discount::Variants)) }
       attr_accessor :discount
 
@@ -228,6 +229,7 @@ module Orb
         amount:,
         # The number of prepaid credits applied.
         credits_applied:,
+        # This field is deprecated in favor of `adjustments`
         discount:,
         # The end date of the range of time applied for this line item's price.
         end_date:,

data/rbi/orb/models/new_plan_bps_price.rbi

@@ -116,6 +116,11 @@ module Orb
       sig { returns(T.nilable(T::Hash[Symbol, T.nilable(String)])) }
       attr_accessor :metadata
 
+      # A transient ID that can be used to reference this price when adding adjustments
+      # in the same API call.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :reference_id
+
       sig do
         params(
           bps_config: Orb::BPSConfig::OrHash,
@@ -143,7 +148,8 @@ module Orb
           invoice_grouping_key: T.nilable(String),
           invoicing_cycle_configuration:
             T.nilable(Orb::NewBillingCycleConfiguration::OrHash),
-          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+          reference_id: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -186,7 +192,10 @@ module Orb
         # User-specified key/value pairs for the resource. 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: nil
+        metadata: nil,
+        # A transient ID that can be used to reference this price when adding adjustments
+        # in the same API call.
+        reference_id: nil
       )
       end
 
@@ -218,7 +227,8 @@ module Orb
             invoice_grouping_key: T.nilable(String),
             invoicing_cycle_configuration:
               T.nilable(Orb::NewBillingCycleConfiguration),
-            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+            reference_id: T.nilable(String)
           }
         )
       end

data/rbi/orb/models/new_plan_bulk_bps_price.rbi

@@ -116,6 +116,11 @@ module Orb
       sig { returns(T.nilable(T::Hash[Symbol, T.nilable(String)])) }
       attr_accessor :metadata
 
+      # A transient ID that can be used to reference this price when adding adjustments
+      # in the same API call.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :reference_id
+
       sig do
         params(
           bulk_bps_config: Orb::BulkBPSConfig::OrHash,
@@ -143,7 +148,8 @@ module Orb
           invoice_grouping_key: T.nilable(String),
           invoicing_cycle_configuration:
             T.nilable(Orb::NewBillingCycleConfiguration::OrHash),
-          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+          reference_id: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -186,7 +192,10 @@ module Orb
         # User-specified key/value pairs for the resource. 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: nil
+        metadata: nil,
+        # A transient ID that can be used to reference this price when adding adjustments
+        # in the same API call.
+        reference_id: nil
       )
       end
 
@@ -218,7 +227,8 @@ module Orb
             invoice_grouping_key: T.nilable(String),
             invoicing_cycle_configuration:
               T.nilable(Orb::NewBillingCycleConfiguration),
-            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+            reference_id: T.nilable(String)
           }
         )
       end

data/rbi/orb/models/new_plan_bulk_price.rbi

@@ -116,6 +116,11 @@ module Orb
       sig { returns(T.nilable(T::Hash[Symbol, T.nilable(String)])) }
       attr_accessor :metadata
 
+      # A transient ID that can be used to reference this price when adding adjustments
+      # in the same API call.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :reference_id
+
       sig do
         params(
           bulk_config: Orb::BulkConfig::OrHash,
@@ -143,7 +148,8 @@ module Orb
           invoice_grouping_key: T.nilable(String),
           invoicing_cycle_configuration:
             T.nilable(Orb::NewBillingCycleConfiguration::OrHash),
-          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+          reference_id: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -186,7 +192,10 @@ module Orb
         # User-specified key/value pairs for the resource. 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: nil
+        metadata: nil,
+        # A transient ID that can be used to reference this price when adding adjustments
+        # in the same API call.
+        reference_id: nil
       )
       end
 
@@ -218,7 +227,8 @@ module Orb
             invoice_grouping_key: T.nilable(String),
             invoicing_cycle_configuration:
               T.nilable(Orb::NewBillingCycleConfiguration),
-            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+            reference_id: T.nilable(String)
           }
         )
       end

data/rbi/orb/models/new_plan_bulk_with_proration_price.rbi

@@ -115,6 +115,11 @@ module Orb
       sig { returns(T.nilable(T::Hash[Symbol, T.nilable(String)])) }
       attr_accessor :metadata
 
+      # A transient ID that can be used to reference this price when adding adjustments
+      # in the same API call.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :reference_id
+
       sig do
         params(
           bulk_with_proration_config: T::Hash[Symbol, T.anything],
@@ -142,7 +147,8 @@ module Orb
           invoice_grouping_key: T.nilable(String),
           invoicing_cycle_configuration:
             T.nilable(Orb::NewBillingCycleConfiguration::OrHash),
-          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+          reference_id: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -185,7 +191,10 @@ module Orb
         # User-specified key/value pairs for the resource. 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: nil
+        metadata: nil,
+        # A transient ID that can be used to reference this price when adding adjustments
+        # in the same API call.
+        reference_id: nil
       )
       end
 
@@ -217,7 +226,8 @@ module Orb
             invoice_grouping_key: T.nilable(String),
             invoicing_cycle_configuration:
               T.nilable(Orb::NewBillingCycleConfiguration),
-            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+            reference_id: T.nilable(String)
           }
         )
       end

data/rbi/orb/models/new_plan_cumulative_grouped_bulk_price.rbi

@@ -117,6 +117,11 @@ module Orb
       sig { returns(T.nilable(T::Hash[Symbol, T.nilable(String)])) }
       attr_accessor :metadata
 
+      # A transient ID that can be used to reference this price when adding adjustments
+      # in the same API call.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :reference_id
+
       sig do
         params(
           cadence: Orb::NewPlanCumulativeGroupedBulkPrice::Cadence::OrSymbol,
@@ -145,7 +150,8 @@ module Orb
           invoice_grouping_key: T.nilable(String),
           invoicing_cycle_configuration:
             T.nilable(Orb::NewBillingCycleConfiguration::OrHash),
-          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+          reference_id: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -188,7 +194,10 @@ module Orb
         # User-specified key/value pairs for the resource. 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: nil
+        metadata: nil,
+        # A transient ID that can be used to reference this price when adding adjustments
+        # in the same API call.
+        reference_id: nil
       )
       end
 
@@ -221,7 +230,8 @@ module Orb
             invoice_grouping_key: T.nilable(String),
             invoicing_cycle_configuration:
               T.nilable(Orb::NewBillingCycleConfiguration),
-            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+            reference_id: T.nilable(String)
           }
         )
       end

data/rbi/orb/models/new_plan_grouped_allocation_price.rbi

@@ -115,6 +115,11 @@ module Orb
       sig { returns(T.nilable(T::Hash[Symbol, T.nilable(String)])) }
       attr_accessor :metadata
 
+      # A transient ID that can be used to reference this price when adding adjustments
+      # in the same API call.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :reference_id
+
       sig do
         params(
           cadence: Orb::NewPlanGroupedAllocationPrice::Cadence::OrSymbol,
@@ -142,7 +147,8 @@ module Orb
           invoice_grouping_key: T.nilable(String),
           invoicing_cycle_configuration:
             T.nilable(Orb::NewBillingCycleConfiguration::OrHash),
-          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+          reference_id: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -185,7 +191,10 @@ module Orb
         # User-specified key/value pairs for the resource. 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: nil
+        metadata: nil,
+        # A transient ID that can be used to reference this price when adding adjustments
+        # in the same API call.
+        reference_id: nil
       )
       end
 
@@ -217,7 +226,8 @@ module Orb
             invoice_grouping_key: T.nilable(String),
             invoicing_cycle_configuration:
               T.nilable(Orb::NewBillingCycleConfiguration),
-            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+            reference_id: T.nilable(String)
           }
         )
       end

data/rbi/orb/models/new_plan_grouped_tiered_package_price.rbi

@@ -117,6 +117,11 @@ module Orb
       sig { returns(T.nilable(T::Hash[Symbol, T.nilable(String)])) }
       attr_accessor :metadata
 
+      # A transient ID that can be used to reference this price when adding adjustments
+      # in the same API call.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :reference_id
+
       sig do
         params(
           cadence: Orb::NewPlanGroupedTieredPackagePrice::Cadence::OrSymbol,
@@ -145,7 +150,8 @@ module Orb
           invoice_grouping_key: T.nilable(String),
           invoicing_cycle_configuration:
             T.nilable(Orb::NewBillingCycleConfiguration::OrHash),
-          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+          reference_id: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -188,7 +194,10 @@ module Orb
         # User-specified key/value pairs for the resource. 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: nil
+        metadata: nil,
+        # A transient ID that can be used to reference this price when adding adjustments
+        # in the same API call.
+        reference_id: nil
       )
       end
 
@@ -221,7 +230,8 @@ module Orb
             invoice_grouping_key: T.nilable(String),
             invoicing_cycle_configuration:
               T.nilable(Orb::NewBillingCycleConfiguration),
-            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+            reference_id: T.nilable(String)
           }
         )
       end

data/rbi/orb/models/new_plan_grouped_tiered_price.rbi

@@ -115,6 +115,11 @@ module Orb
       sig { returns(T.nilable(T::Hash[Symbol, T.nilable(String)])) }
       attr_accessor :metadata
 
+      # A transient ID that can be used to reference this price when adding adjustments
+      # in the same API call.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :reference_id
+
       sig do
         params(
           cadence: Orb::NewPlanGroupedTieredPrice::Cadence::OrSymbol,
@@ -142,7 +147,8 @@ module Orb
           invoice_grouping_key: T.nilable(String),
           invoicing_cycle_configuration:
             T.nilable(Orb::NewBillingCycleConfiguration::OrHash),
-          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+          reference_id: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -185,7 +191,10 @@ module Orb
         # User-specified key/value pairs for the resource. 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: nil
+        metadata: nil,
+        # A transient ID that can be used to reference this price when adding adjustments
+        # in the same API call.
+        reference_id: nil
       )
       end
 
@@ -217,7 +226,8 @@ module Orb
             invoice_grouping_key: T.nilable(String),
             invoicing_cycle_configuration:
               T.nilable(Orb::NewBillingCycleConfiguration),
-            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+            reference_id: T.nilable(String)
           }
         )
       end

data/rbi/orb/models/new_plan_grouped_with_metered_minimum_price.rbi

@@ -122,6 +122,11 @@ module Orb
       sig { returns(T.nilable(T::Hash[Symbol, T.nilable(String)])) }
       attr_accessor :metadata
 
+      # A transient ID that can be used to reference this price when adding adjustments
+      # in the same API call.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :reference_id
+
       sig do
         params(
           cadence:
@@ -151,7 +156,8 @@ module Orb
           invoice_grouping_key: T.nilable(String),
           invoicing_cycle_configuration:
             T.nilable(Orb::NewBillingCycleConfiguration::OrHash),
-          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+          reference_id: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -194,7 +200,10 @@ module Orb
         # User-specified key/value pairs for the resource. 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: nil
+        metadata: nil,
+        # A transient ID that can be used to reference this price when adding adjustments
+        # in the same API call.
+        reference_id: nil
       )
       end
 
@@ -228,7 +237,8 @@ module Orb
             invoice_grouping_key: T.nilable(String),
             invoicing_cycle_configuration:
               T.nilable(Orb::NewBillingCycleConfiguration),
-            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+            reference_id: T.nilable(String)
           }
         )
       end

data/rbi/orb/models/new_plan_grouped_with_prorated_minimum_price.rbi

@@ -124,6 +124,11 @@ module Orb
       sig { returns(T.nilable(T::Hash[Symbol, T.nilable(String)])) }
       attr_accessor :metadata
 
+      # A transient ID that can be used to reference this price when adding adjustments
+      # in the same API call.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :reference_id
+
       sig do
         params(
           cadence:
@@ -153,7 +158,8 @@ module Orb
           invoice_grouping_key: T.nilable(String),
           invoicing_cycle_configuration:
             T.nilable(Orb::NewBillingCycleConfiguration::OrHash),
-          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+          metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+          reference_id: T.nilable(String)
         ).returns(T.attached_class)
       end
       def self.new(
@@ -196,7 +202,10 @@ module Orb
         # User-specified key/value pairs for the resource. 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: nil
+        metadata: nil,
+        # A transient ID that can be used to reference this price when adding adjustments
+        # in the same API call.
+        reference_id: nil
       )
       end
 
@@ -230,7 +239,8 @@ module Orb
             invoice_grouping_key: T.nilable(String),
             invoicing_cycle_configuration:
               T.nilable(Orb::NewBillingCycleConfiguration),
-            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)])
+            metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+            reference_id: T.nilable(String)
           }
         )
       end