metronome-sdk 2.0.0 → 2.2.0

data/lib/metronome_sdk/resources/v1/settings/billing_providers.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module MetronomeSDK
+  module Resources
+    class V1
+      class Settings
+        class BillingProviders
+          # Some parameter documentations has been truncated, see
+          # {MetronomeSDK::Models::V1::Settings::BillingProviderCreateParams} for more
+          # details.
+          #
+          # Set up account-level configuration for a billing provider. Once configured,
+          # individual contracts across customers can be mapped to this configuration using
+          # the returned delivery_method_id.
+          #
+          # @overload create(billing_provider:, configuration:, delivery_method:, request_options: {})
+          #
+          # @param billing_provider [Symbol, MetronomeSDK::Models::V1::Settings::BillingProviderCreateParams::BillingProvider] The billing provider set for this configuration.
+          #
+          # @param configuration [Hash{Symbol=>Object}] Account-level configuration for the billing provider. The structure of this obje
+          #
+          # @param delivery_method [Symbol, MetronomeSDK::Models::V1::Settings::BillingProviderCreateParams::DeliveryMethod] The method to use for delivering invoices for this configuration.
+          #
+          # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [MetronomeSDK::Models::V1::Settings::BillingProviderCreateResponse]
+          #
+          # @see MetronomeSDK::Models::V1::Settings::BillingProviderCreateParams
+          def create(params)
+            parsed, options = MetronomeSDK::V1::Settings::BillingProviderCreateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: "v1/setUpBillingProvider",
+              body: parsed,
+              model: MetronomeSDK::Models::V1::Settings::BillingProviderCreateResponse,
+              options: options
+            )
+          end
+
+          # Lists all configured billing providers and their delivery method configurations
+          # for your account. Returns provider details, delivery method IDs, and
+          # configuration settings needed for mapping individual customer contracts to
+          # billing integrations.
+          #
+          # @overload list(next_page: nil, request_options: {})
+          #
+          # @param next_page [String, nil] The cursor to the next page of results
+          #
+          # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [MetronomeSDK::Models::V1::Settings::BillingProviderListResponse]
+          #
+          # @see MetronomeSDK::Models::V1::Settings::BillingProviderListParams
+          def list(params = {})
+            parsed, options = MetronomeSDK::V1::Settings::BillingProviderListParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: "v1/listConfiguredBillingProviders",
+              body: parsed,
+              model: MetronomeSDK::Models::V1::Settings::BillingProviderListResponse,
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [MetronomeSDK::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/metronome_sdk/resources/v1/settings.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module MetronomeSDK
+  module Resources
+    class V1
+      class Settings
+        # @return [MetronomeSDK::Resources::V1::Settings::BillingProviders]
+        attr_reader :billing_providers
+
+        # Some parameter documentations has been truncated, see
+        # {MetronomeSDK::Models::V1::SettingUpsertAvalaraCredentialsParams} for more
+        # details.
+        #
+        # Set the Avalara credentials for some specified `delivery_method_ids`, which can
+        # be found in the `/listConfiguredBillingProviders` response. This maps the
+        # Avalara credentials to the appropriate billing entity. These credentials are
+        # only used for PLG Invoicing today.
+        #
+        # @overload upsert_avalara_credentials(avalara_environment:, avalara_password:, avalara_username:, delivery_method_ids:, commit_transactions: nil, request_options: {})
+        #
+        # @param avalara_environment [Symbol, MetronomeSDK::Models::V1::SettingUpsertAvalaraCredentialsParams::AvalaraEnvironment] The Avalara environment to use (SANDBOX or PRODUCTION).
+        #
+        # @param avalara_password [String] The password for the Avalara account.
+        #
+        # @param avalara_username [String] The username for the Avalara account.
+        #
+        # @param delivery_method_ids [Array<String>] The delivery method IDs of the billing provider configurations to update, can be
+        #
+        # @param commit_transactions [Boolean] Commit transactions if you want Metronome tax calculations used for reporting an
+        #
+        # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [MetronomeSDK::Models::V1::SettingUpsertAvalaraCredentialsResponse]
+        #
+        # @see MetronomeSDK::Models::V1::SettingUpsertAvalaraCredentialsParams
+        def upsert_avalara_credentials(params)
+          parsed, options = MetronomeSDK::V1::SettingUpsertAvalaraCredentialsParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "v1/upsertAvalaraCredentials",
+            body: parsed,
+            model: MetronomeSDK::Models::V1::SettingUpsertAvalaraCredentialsResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [MetronomeSDK::Client]
+        def initialize(client:)
+          @client = client
+          @billing_providers = MetronomeSDK::Resources::V1::Settings::BillingProviders.new(client: client)
+        end
+      end
+    end
+  end
+end

data/lib/metronome_sdk/resources/v1.rb

@@ -45,6 +45,9 @@ module MetronomeSDK
       # @return [MetronomeSDK::Resources::V1::Payments]
       attr_reader :payments
 
+      # @return [MetronomeSDK::Resources::V1::Settings]
+      attr_reader :settings
+
       # @api private
       #
       # @param client [MetronomeSDK::Client]
@@ -64,6 +67,7 @@ module MetronomeSDK
         @invoices = MetronomeSDK::Resources::V1::Invoices.new(client: client)
         @contracts = MetronomeSDK::Resources::V1::Contracts.new(client: client)
         @payments = MetronomeSDK::Resources::V1::Payments.new(client: client)
+        @settings = MetronomeSDK::Resources::V1::Settings.new(client: client)
       end
     end
   end

data/lib/metronome_sdk/resources/v2/contracts.rb

@@ -228,7 +228,7 @@ module MetronomeSDK
         #   finalized invoice. You can void the invoice beforehand and then remove the
         #   access schedule segment.
         #
-        # @overload edit_commit(commit_id:, customer_id:, access_schedule: nil, applicable_product_ids: nil, applicable_product_tags: nil, hierarchy_configuration: nil, invoice_contract_id: nil, invoice_schedule: nil, priority: nil, product_id: nil, rate_type: nil, specifiers: nil, request_options: {})
+        # @overload edit_commit(commit_id:, customer_id:, access_schedule: nil, applicable_product_ids: nil, applicable_product_tags: nil, description: nil, hierarchy_configuration: nil, invoice_contract_id: nil, invoice_schedule: nil, name: nil, priority: nil, product_id: nil, rate_type: nil, specifiers: nil, request_options: {})
         #
         # @param commit_id [String] ID of the commit to edit
         #
@@ -240,12 +240,16 @@ module MetronomeSDK
         #
         # @param applicable_product_tags [Array<String>, nil] Which tags the commit applies to. If applicable*product_ids, applicable_product*
         #
+        # @param description [String] Updated description for the commit
+        #
         # @param hierarchy_configuration [MetronomeSDK::Models::CommitHierarchyConfiguration] Optional configuration for commit hierarchy access control
         #
         # @param invoice_contract_id [String] ID of contract to use for invoicing
         #
         # @param invoice_schedule [MetronomeSDK::Models::V2::ContractEditCommitParams::InvoiceSchedule]
         #
+        # @param name [String] Updated name for the commit
+        #
         # @param priority [Float, nil] If multiple commits are applicable, the one with the lower priority will apply f
         #
         # @param product_id [String]
@@ -290,7 +294,7 @@ module MetronomeSDK
         #   invoice. You can void the invoice beforehand and then remove the access
         #   schedule segment.
         #
-        # @overload edit_credit(credit_id:, customer_id:, access_schedule: nil, applicable_product_ids: nil, applicable_product_tags: nil, hierarchy_configuration: nil, priority: nil, product_id: nil, rate_type: nil, specifiers: nil, request_options: {})
+        # @overload edit_credit(credit_id:, customer_id:, access_schedule: nil, applicable_product_ids: nil, applicable_product_tags: nil, description: nil, hierarchy_configuration: nil, name: nil, priority: nil, product_id: nil, rate_type: nil, specifiers: nil, request_options: {})
         #
         # @param credit_id [String] ID of the credit to edit
         #
@@ -302,8 +306,12 @@ module MetronomeSDK
         #
         # @param applicable_product_tags [Array<String>, nil] Which tags the credit applies to. If both applicable*product_ids and applicable*
         #
+        # @param description [String] Updated description for the credit
+        #
         # @param hierarchy_configuration [MetronomeSDK::Models::CommitHierarchyConfiguration] Optional configuration for credit hierarchy access control
         #
+        # @param name [String] Updated name for the credit
+        #
         # @param priority [Float, nil] If multiple commits are applicable, the one with the lower priority will apply f
         #
         # @param product_id [String]

data/lib/metronome_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MetronomeSDK
-  VERSION = "2.0.0"
+  VERSION = "2.2.0"
 end

data/lib/metronome_sdk.rb

@@ -3,12 +3,14 @@
 # Standard libraries.
 # rubocop:disable Lint/RedundantRequireStatement
 require "English"
+require "base64"
 require "cgi"
 require "date"
 require "erb"
 require "etc"
 require "json"
 require "net/http"
+require "openssl"
 require "pathname"
 require "rbconfig"
 require "securerandom"
@@ -235,6 +237,7 @@ require_relative "metronome_sdk/models/v1/customers/plan_list_price_adjustments_
 require_relative "metronome_sdk/models/v1/customers/plan_list_price_adjustments_response"
 require_relative "metronome_sdk/models/v1/customers/plan_list_response"
 require_relative "metronome_sdk/models/v1/customer_set_billing_configurations_params"
+require_relative "metronome_sdk/models/v1/customer_set_billing_configurations_response"
 require_relative "metronome_sdk/models/v1/customer_set_ingest_aliases_params"
 require_relative "metronome_sdk/models/v1/customer_set_name_params"
 require_relative "metronome_sdk/models/v1/customer_set_name_response"
@@ -273,6 +276,12 @@ require_relative "metronome_sdk/models/v1/rollover_amount_max_amount"
 require_relative "metronome_sdk/models/v1/rollover_amount_max_percentage"
 require_relative "metronome_sdk/models/v1/service_list_params"
 require_relative "metronome_sdk/models/v1/service_list_response"
+require_relative "metronome_sdk/models/v1/settings/billing_provider_create_params"
+require_relative "metronome_sdk/models/v1/settings/billing_provider_create_response"
+require_relative "metronome_sdk/models/v1/settings/billing_provider_list_params"
+require_relative "metronome_sdk/models/v1/settings/billing_provider_list_response"
+require_relative "metronome_sdk/models/v1/setting_upsert_avalara_credentials_params"
+require_relative "metronome_sdk/models/v1/setting_upsert_avalara_credentials_response"
 require_relative "metronome_sdk/models/v1/usage_ingest_params"
 require_relative "metronome_sdk/models/v1/usage_list_params"
 require_relative "metronome_sdk/models/v1/usage_list_response"
@@ -320,6 +329,8 @@ require_relative "metronome_sdk/resources/v1/payments"
 require_relative "metronome_sdk/resources/v1/plans"
 require_relative "metronome_sdk/resources/v1/pricing_units"
 require_relative "metronome_sdk/resources/v1/services"
+require_relative "metronome_sdk/resources/v1/settings"
+require_relative "metronome_sdk/resources/v1/settings/billing_providers"
 require_relative "metronome_sdk/resources/v1/usage"
 require_relative "metronome_sdk/resources/v2"
 require_relative "metronome_sdk/resources/v2/contracts"

data/manifest.yaml

@@ -1,11 +1,13 @@
 dependencies:
   - English
+  - base64
   - cgi
   - date
   - erb
   - etc
   - json
   - net/http
+  - openssl
   - pathname
   - rbconfig
   - securerandom

data/rbi/metronome_sdk/internal/transport/base_client.rbi

@@ -180,6 +180,11 @@ module MetronomeSDK
         private def auth_headers
         end
 
+        # @api private
+        sig { returns(String) }
+        private def user_agent
+        end
+
         # @api private
         sig { returns(String) }
         private def generate_idempotency_key

data/rbi/metronome_sdk/internal/transport/pooled_net_requester.rbi

@@ -26,8 +26,12 @@ module MetronomeSDK
 
         class << self
           # @api private
-          sig { params(url: URI::Generic).returns(Net::HTTP) }
-          def connect(url)
+          sig do
+            params(cert_store: OpenSSL::X509::Store, url: URI::Generic).returns(
+              Net::HTTP
+            )
+          end
+          def connect(cert_store:, url:)
           end
 
           # @api private

data/rbi/metronome_sdk/internal/type/base_model.rbi

@@ -31,7 +31,7 @@ module MetronomeSDK
           #
           # Assumes superclass fields are totally defined before fields are accessed /
           # defined on subclasses.
-          sig { params(child: T.self_type).void }
+          sig { params(child: MetronomeSDK::Internal::Type::BaseModel).void }
           def inherited(child)
           end
 
@@ -282,9 +282,13 @@ module MetronomeSDK
 
         # Create a new instance of a model.
         sig do
-          params(data: T.any(T::Hash[Symbol, T.anything], T.self_type)).returns(
-            T.attached_class
-          )
+          params(
+            data:
+              T.any(
+                T::Hash[Symbol, T.anything],
+                MetronomeSDK::Internal::Type::BaseModel
+              )
+          ).returns(T.attached_class)
         end
         def self.new(data = {})
         end

data/rbi/metronome_sdk/models/contract.rbi

@@ -673,6 +673,11 @@ module MetronomeSDK
               :gcp_marketplace,
               MetronomeSDK::Contract::CustomerBillingProviderConfiguration::BillingProvider::TaggedSymbol
             )
+          METRONOME =
+            T.let(
+              :metronome,
+              MetronomeSDK::Contract::CustomerBillingProviderConfiguration::BillingProvider::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/metronome_sdk/models/contract_v2.rbi

@@ -730,6 +730,20 @@ module MetronomeSDK
         end
         attr_writer :specifiers
 
+        # Attach a subscription to the recurring commit/credit.
+        sig do
+          returns(T.nilable(MetronomeSDK::RecurringCommitSubscriptionConfig))
+        end
+        attr_reader :subscription_config
+
+        sig do
+          params(
+            subscription_config:
+              MetronomeSDK::RecurringCommitSubscriptionConfig::OrHash
+          ).void
+        end
+        attr_writer :subscription_config
+
         sig do
           params(
             id: String,
@@ -777,7 +791,9 @@ module MetronomeSDK
               MetronomeSDK::ContractV2::Commit::RolledOverFrom::OrHash,
             rollover_fraction: Float,
             salesforce_opportunity_id: String,
-            specifiers: T::Array[MetronomeSDK::CommitSpecifier::OrHash]
+            specifiers: T::Array[MetronomeSDK::CommitSpecifier::OrHash],
+            subscription_config:
+              MetronomeSDK::RecurringCommitSubscriptionConfig::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
@@ -833,7 +849,9 @@ module MetronomeSDK
           # List of filters that determine what kind of customer usage draws down a commit
           # or credit. A customer's usage needs to meet the condition of at least one of the
           # specifiers to contribute to a commit's or credit's drawdown.
-          specifiers: nil
+          specifiers: nil,
+          # Attach a subscription to the recurring commit/credit.
+          subscription_config: nil
         )
         end
 
@@ -869,7 +887,9 @@ module MetronomeSDK
                 MetronomeSDK::ContractV2::Commit::RolledOverFrom,
               rollover_fraction: Float,
               salesforce_opportunity_id: String,
-              specifiers: T::Array[MetronomeSDK::CommitSpecifier]
+              specifiers: T::Array[MetronomeSDK::CommitSpecifier],
+              subscription_config:
+                MetronomeSDK::RecurringCommitSubscriptionConfig
             }
           )
         end
@@ -3202,6 +3222,16 @@ module MetronomeSDK
         end
         attr_writer :contract
 
+        # Timestamp of when the credit was created.
+        #
+        # - Recurring credits: latter of credit service period date and parent credit
+        #   start date
+        sig { returns(T.nilable(Time)) }
+        attr_reader :created_at
+
+        sig { params(created_at: Time).void }
+        attr_writer :created_at
+
         # Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
         sig { returns(T.nilable(T::Hash[Symbol, String])) }
         attr_reader :custom_fields
@@ -3297,6 +3327,20 @@ module MetronomeSDK
         end
         attr_writer :specifiers
 
+        # Attach a subscription to the recurring commit/credit.
+        sig do
+          returns(T.nilable(MetronomeSDK::RecurringCommitSubscriptionConfig))
+        end
+        attr_reader :subscription_config
+
+        sig do
+          params(
+            subscription_config:
+              MetronomeSDK::RecurringCommitSubscriptionConfig::OrHash
+          ).void
+        end
+        attr_writer :subscription_config
+
         sig do
           params(
             id: String,
@@ -3308,6 +3352,7 @@ module MetronomeSDK
             applicable_product_tags: T::Array[String],
             balance: Float,
             contract: MetronomeSDK::ContractV2::Credit::Contract::OrHash,
+            created_at: Time,
             custom_fields: T::Hash[Symbol, String],
             description: String,
             hierarchy_configuration:
@@ -3328,7 +3373,9 @@ module MetronomeSDK
             netsuite_sales_order_id: String,
             priority: Float,
             salesforce_opportunity_id: String,
-            specifiers: T::Array[MetronomeSDK::CommitSpecifier::OrHash]
+            specifiers: T::Array[MetronomeSDK::CommitSpecifier::OrHash],
+            subscription_config:
+              MetronomeSDK::RecurringCommitSubscriptionConfig::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
@@ -3350,6 +3397,11 @@ module MetronomeSDK
           # included in the balance, including future-dated manual ledger entries.
           balance: nil,
           contract: nil,
+          # Timestamp of when the credit was created.
+          #
+          # - Recurring credits: latter of credit service period date and parent credit
+          #   start date
+          created_at: nil,
           # Custom fields to be added eg. { "key1": "value1", "key2": "value2" }
           custom_fields: nil,
           description: nil,
@@ -3369,7 +3421,9 @@ module MetronomeSDK
           # List of filters that determine what kind of customer usage draws down a commit
           # or credit. A customer's usage needs to meet the condition of at least one of the
           # specifiers to contribute to a commit's or credit's drawdown.
-          specifiers: nil
+          specifiers: nil,
+          # Attach a subscription to the recurring commit/credit.
+          subscription_config: nil
         )
         end
 
@@ -3385,6 +3439,7 @@ module MetronomeSDK
               applicable_product_tags: T::Array[String],
               balance: Float,
               contract: MetronomeSDK::ContractV2::Credit::Contract,
+              created_at: Time,
               custom_fields: T::Hash[Symbol, String],
               description: String,
               hierarchy_configuration:
@@ -3395,7 +3450,9 @@ module MetronomeSDK
               netsuite_sales_order_id: String,
               priority: Float,
               salesforce_opportunity_id: String,
-              specifiers: T::Array[MetronomeSDK::CommitSpecifier]
+              specifiers: T::Array[MetronomeSDK::CommitSpecifier],
+              subscription_config:
+                MetronomeSDK::RecurringCommitSubscriptionConfig
             }
           )
         end
@@ -4232,6 +4289,11 @@ module MetronomeSDK
               :gcp_marketplace,
               MetronomeSDK::ContractV2::CustomerBillingProviderConfiguration::BillingProvider::TaggedSymbol
             )
+          METRONOME =
+            T.let(
+              :metronome,
+              MetronomeSDK::ContractV2::CustomerBillingProviderConfiguration::BillingProvider::TaggedSymbol
+            )
 
           sig do
             override.returns(
@@ -4454,10 +4516,13 @@ module MetronomeSDK
                 )
               end
 
-            # Indicates the desired behavior of consolidated invoices generated by the parent
-            # in a customer hierarchy **CONCATENATE**: Statements on the invoices of child
-            # customers will be appended to the consolidated invoice **NONE**: Do not generate
-            # consolidated invoices
+            # Account hierarchy M3 - Indicates the desired behavior of consolidated invoices
+            # generated by the parent in a customer hierarchy
+            #
+            # **CONCATENATE**: Statements on the invoices of child customers will be appended
+            # to the consolidated invoice
+            #
+            # **NONE**: Do not generate consolidated invoices
             sig do
               returns(
                 T.nilable(
@@ -4482,10 +4547,13 @@ module MetronomeSDK
               ).returns(T.attached_class)
             end
             def self.new(
-              # Indicates the desired behavior of consolidated invoices generated by the parent
-              # in a customer hierarchy **CONCATENATE**: Statements on the invoices of child
-              # customers will be appended to the consolidated invoice **NONE**: Do not generate
-              # consolidated invoices
+              # Account hierarchy M3 - Indicates the desired behavior of consolidated invoices
+              # generated by the parent in a customer hierarchy
+              #
+              # **CONCATENATE**: Statements on the invoices of child customers will be appended
+              # to the consolidated invoice
+              #
+              # **NONE**: Do not generate consolidated invoices
               invoice_consolidation_type: nil
             )
             end
@@ -4501,10 +4569,13 @@ module MetronomeSDK
             def to_hash
             end
 
-            # Indicates the desired behavior of consolidated invoices generated by the parent
-            # in a customer hierarchy **CONCATENATE**: Statements on the invoices of child
-            # customers will be appended to the consolidated invoice **NONE**: Do not generate
-            # consolidated invoices
+            # Account hierarchy M3 - Indicates the desired behavior of consolidated invoices
+            # generated by the parent in a customer hierarchy
+            #
+            # **CONCATENATE**: Statements on the invoices of child customers will be appended
+            # to the consolidated invoice
+            #
+            # **NONE**: Do not generate consolidated invoices
             module InvoiceConsolidationType
               extend MetronomeSDK::Internal::Type::Enum
 
@@ -4566,7 +4637,9 @@ module MetronomeSDK
           end
           attr_writer :parent
 
-          # Indicates whether the child or parent should pay for the child's invoice charges
+          # Account hierarchy M3 - Indicates which customer should pay for the child's
+          # invoice charges **SELF**: The child pays for its own invoice charges **PARENT**:
+          # The parent pays for the child's invoice charges
           sig do
             returns(
               T.nilable(
@@ -4584,10 +4657,14 @@ module MetronomeSDK
           end
           attr_writer :payer
 
-          # Indicates the behavior of the child's invoice statements on the parent's
-          # invoices **CONSOLIDATE**: Child's invoice statements will be added to parent's
-          # consolidated invoices **SEPARATE**: Child's invoice statements will appear not
-          # appear on parent's consolidated invoices
+          # Account hierarchy M3 - Indicates the behavior of the child's invoice statements
+          # on the parent's invoices.
+          #
+          # **CONSOLIDATE**: Child's invoice statements will be added to parent's
+          # consolidated invoices
+          #
+          # **SEPARATE**: Child's invoice statements will appear not appear on parent's
+          # consolidated invoices
           sig do
             returns(
               T.nilable(
@@ -4618,12 +4695,18 @@ module MetronomeSDK
           def self.new(
             # The single parent contract/customer for this child.
             parent:,
-            # Indicates whether the child or parent should pay for the child's invoice charges
+            # Account hierarchy M3 - Indicates which customer should pay for the child's
+            # invoice charges **SELF**: The child pays for its own invoice charges **PARENT**:
+            # The parent pays for the child's invoice charges
             payer: nil,
-            # Indicates the behavior of the child's invoice statements on the parent's
-            # invoices **CONSOLIDATE**: Child's invoice statements will be added to parent's
-            # consolidated invoices **SEPARATE**: Child's invoice statements will appear not
-            # appear on parent's consolidated invoices
+            # Account hierarchy M3 - Indicates the behavior of the child's invoice statements
+            # on the parent's invoices.
+            #
+            # **CONSOLIDATE**: Child's invoice statements will be added to parent's
+            # consolidated invoices
+            #
+            # **SEPARATE**: Child's invoice statements will appear not appear on parent's
+            # consolidated invoices
             usage_statement_behavior: nil
           )
           end
@@ -4674,7 +4757,9 @@ module MetronomeSDK
             end
           end
 
-          # Indicates whether the child or parent should pay for the child's invoice charges
+          # Account hierarchy M3 - Indicates which customer should pay for the child's
+          # invoice charges **SELF**: The child pays for its own invoice charges **PARENT**:
+          # The parent pays for the child's invoice charges
           module Payer
             extend MetronomeSDK::Internal::Type::Enum
 
@@ -4709,10 +4794,14 @@ module MetronomeSDK
             end
           end
 
-          # Indicates the behavior of the child's invoice statements on the parent's
-          # invoices **CONSOLIDATE**: Child's invoice statements will be added to parent's
-          # consolidated invoices **SEPARATE**: Child's invoice statements will appear not
-          # appear on parent's consolidated invoices
+          # Account hierarchy M3 - Indicates the behavior of the child's invoice statements
+          # on the parent's invoices.
+          #
+          # **CONSOLIDATE**: Child's invoice statements will be added to parent's
+          # consolidated invoices
+          #
+          # **SEPARATE**: Child's invoice statements will appear not appear on parent's
+          # consolidated invoices
           module UsageStatementBehavior
             extend MetronomeSDK::Internal::Type::Enum