orb-billing 0.2.0 → 0.3.1

data/lib/orb/models/customer_create_params.rb

@@ -4,8 +4,7 @@ module Orb
   module Models
     # @see Orb::Resources::Customers#create
     class CustomerCreateParams < Orb::Internal::Type::BaseModel
-      # @!parse
-      #   extend Orb::Internal::Type::RequestParameters::Converter
+      extend Orb::Internal::Type::RequestParameters::Converter
       include Orb::Internal::Type::RequestParameters
 
       # @!attribute email
@@ -112,7 +111,7 @@ module Orb
 
       # @!attribute tax_configuration
       #
-      #   @return [Orb::Models::CustomerCreateParams::TaxConfiguration::NewAvalaraTaxConfiguration, Orb::Models::CustomerCreateParams::TaxConfiguration::NewTaxJarConfiguration, nil]
+      #   @return [Orb::Models::CustomerCreateParams::TaxConfiguration::Avalara, Orb::Models::CustomerCreateParams::TaxConfiguration::Taxjar, nil]
       optional :tax_configuration, union: -> { Orb::Models::CustomerCreateParams::TaxConfiguration }, nil?: true
 
       # @!attribute tax_id
@@ -233,53 +232,57 @@ module Orb
       #   @return [String, nil]
       optional :timezone, String, nil?: true
 
-      # @!parse
-      #   # @param email [String]
-      #   # @param name [String]
-      #   # @param accounting_sync_configuration [Orb::Models::CustomerCreateParams::AccountingSyncConfiguration, nil]
-      #   # @param additional_emails [Array<String>, nil]
-      #   # @param auto_collection [Boolean, nil]
-      #   # @param billing_address [Orb::Models::CustomerCreateParams::BillingAddress, nil]
-      #   # @param currency [String, nil]
-      #   # @param email_delivery [Boolean, nil]
-      #   # @param external_customer_id [String, nil]
-      #   # @param hierarchy [Orb::Models::CustomerCreateParams::Hierarchy, nil]
-      #   # @param metadata [Hash{Symbol=>String, nil}, nil]
-      #   # @param payment_provider [Symbol, Orb::Models::CustomerCreateParams::PaymentProvider, nil]
-      #   # @param payment_provider_id [String, nil]
-      #   # @param reporting_configuration [Orb::Models::CustomerCreateParams::ReportingConfiguration, nil]
-      #   # @param shipping_address [Orb::Models::CustomerCreateParams::ShippingAddress, nil]
-      #   # @param tax_configuration [Orb::Models::CustomerCreateParams::TaxConfiguration::NewAvalaraTaxConfiguration, Orb::Models::CustomerCreateParams::TaxConfiguration::NewTaxJarConfiguration, nil]
-      #   # @param tax_id [Orb::Models::CustomerCreateParams::TaxID, nil]
-      #   # @param timezone [String, nil]
-      #   # @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}]
-      #   #
-      #   def initialize(
-      #     email:,
-      #     name:,
-      #     accounting_sync_configuration: nil,
-      #     additional_emails: nil,
-      #     auto_collection: nil,
-      #     billing_address: nil,
-      #     currency: nil,
-      #     email_delivery: nil,
-      #     external_customer_id: nil,
-      #     hierarchy: nil,
-      #     metadata: nil,
-      #     payment_provider: nil,
-      #     payment_provider_id: nil,
-      #     reporting_configuration: nil,
-      #     shipping_address: nil,
-      #     tax_configuration: nil,
-      #     tax_id: nil,
-      #     timezone: nil,
-      #     request_options: {},
-      #     **
-      #   )
-      #     super
-      #   end
-
-      # def initialize: (Hash | Orb::Internal::Type::BaseModel) -> void
+      # @!method initialize(email:, name:, accounting_sync_configuration: nil, additional_emails: nil, auto_collection: nil, billing_address: nil, currency: nil, email_delivery: nil, external_customer_id: nil, hierarchy: nil, metadata: nil, payment_provider: nil, payment_provider_id: nil, reporting_configuration: nil, shipping_address: nil, tax_configuration: nil, tax_id: nil, timezone: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Orb::Models::CustomerCreateParams} for more details.
+      #
+      #   @param email [String] A valid customer email, to be used for notifications. When Orb triggers payment
+      #   ...
+      #
+      #   @param name [String] The full name of the customer
+      #
+      #   @param accounting_sync_configuration [Orb::Models::CustomerCreateParams::AccountingSyncConfiguration, nil]
+      #
+      #   @param additional_emails [Array<String>, nil] Additional email addresses for this customer. If populated, these email addresse
+      #   ...
+      #
+      #   @param auto_collection [Boolean, nil] Used to determine if invoices for this customer will automatically attempt to ch
+      #   ...
+      #
+      #   @param billing_address [Orb::Models::CustomerCreateParams::BillingAddress, nil]
+      #
+      #   @param currency [String, nil] An ISO 4217 currency string used for the customer's invoices and balance. If not
+      #   ...
+      #
+      #   @param email_delivery [Boolean, nil]
+      #
+      #   @param external_customer_id [String, nil] An optional user-defined ID for this customer resource, used throughout the syst
+      #   ...
+      #
+      #   @param hierarchy [Orb::Models::CustomerCreateParams::Hierarchy, nil] The hierarchical relationships for this customer.
+      #
+      #   @param metadata [Hash{Symbol=>String, nil}, nil] User-specified key/value pairs for the resource. Individual keys can be removed
+      #   ...
+      #
+      #   @param payment_provider [Symbol, Orb::Models::CustomerCreateParams::PaymentProvider, nil] This is used for creating charges or invoices in an external system via Orb. Whe
+      #   ...
+      #
+      #   @param payment_provider_id [String, nil] The ID of this customer in an external payments solution, such as Stripe. This i
+      #   ...
+      #
+      #   @param reporting_configuration [Orb::Models::CustomerCreateParams::ReportingConfiguration, nil]
+      #
+      #   @param shipping_address [Orb::Models::CustomerCreateParams::ShippingAddress, nil]
+      #
+      #   @param tax_configuration [Orb::Models::CustomerCreateParams::TaxConfiguration::Avalara, Orb::Models::CustomerCreateParams::TaxConfiguration::Taxjar, nil]
+      #
+      #   @param tax_id [Orb::Models::CustomerCreateParams::TaxID, nil] Tax IDs are commonly required to be displayed on customer invoices, which are ad
+      #   ...
+      #
+      #   @param timezone [String, nil] A timezone identifier from the IANA timezone database, such as `"America/Los_Ang
+      #   ...
+      #
+      #   @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}]
 
       class AccountingSyncConfiguration < Orb::Internal::Type::BaseModel
         # @!attribute accounting_providers
@@ -294,13 +297,9 @@ module Orb
         #   @return [Boolean, nil]
         optional :excluded, Orb::Internal::Type::Boolean, nil?: true
 
-        # @!parse
-        #   # @param accounting_providers [Array<Orb::Models::CustomerCreateParams::AccountingSyncConfiguration::AccountingProvider>, nil]
-        #   # @param excluded [Boolean, nil]
-        #   #
-        #   def initialize(accounting_providers: nil, excluded: nil, **) = super
-
-        # def initialize: (Hash | Orb::Internal::Type::BaseModel) -> void
+        # @!method initialize(accounting_providers: nil, excluded: nil)
+        #   @param accounting_providers [Array<Orb::Models::CustomerCreateParams::AccountingSyncConfiguration::AccountingProvider>, nil]
+        #   @param excluded [Boolean, nil]
 
         class AccountingProvider < Orb::Internal::Type::BaseModel
           # @!attribute external_provider_id
@@ -313,13 +312,9 @@ module Orb
           #   @return [String]
           required :provider_type, String
 
-          # @!parse
-          #   # @param external_provider_id [String]
-          #   # @param provider_type [String]
-          #   #
-          #   def initialize(external_provider_id:, provider_type:, **) = super
-
-          # def initialize: (Hash | Orb::Internal::Type::BaseModel) -> void
+          # @!method initialize(external_provider_id:, provider_type:)
+          #   @param external_provider_id [String]
+          #   @param provider_type [String]
         end
       end
 
@@ -354,31 +349,23 @@ module Orb
         #   @return [String, nil]
         optional :state, String, nil?: true
 
-        # @!parse
-        #   # @param city [String, nil]
-        #   # @param country [String, nil]
-        #   # @param line1 [String, nil]
-        #   # @param line2 [String, nil]
-        #   # @param postal_code [String, nil]
-        #   # @param state [String, nil]
-        #   #
-        #   def initialize(city: nil, country: nil, line1: nil, line2: nil, postal_code: nil, state: nil, **) = super
-
-        # def initialize: (Hash | Orb::Internal::Type::BaseModel) -> void
+        # @!method initialize(city: nil, country: nil, line1: nil, line2: nil, postal_code: nil, state: nil)
+        #   @param city [String, nil]
+        #   @param country [String, nil]
+        #   @param line1 [String, nil]
+        #   @param line2 [String, nil]
+        #   @param postal_code [String, nil]
+        #   @param state [String, nil]
       end
 
       class Hierarchy < Orb::Internal::Type::BaseModel
-        # @!attribute [r] child_customer_ids
+        # @!attribute child_customer_ids
         #   A list of child customer IDs to add to the hierarchy. The desired child
         #   customers must not already be part of another hierarchy.
         #
         #   @return [Array<String>, nil]
         optional :child_customer_ids, Orb::Internal::Type::ArrayOf[String]
 
-        # @!parse
-        #   # @return [Array<String>]
-        #   attr_writer :child_customer_ids
-
         # @!attribute parent_customer_id
         #   The ID of the parent customer in the hierarchy. The desired parent customer must
         #   not be a child of another customer.
@@ -386,15 +373,17 @@ module Orb
         #   @return [String, nil]
         optional :parent_customer_id, String, nil?: true
 
-        # @!parse
-        #   # The hierarchical relationships for this customer.
-        #   #
-        #   # @param child_customer_ids [Array<String>]
-        #   # @param parent_customer_id [String, nil]
-        #   #
-        #   def initialize(child_customer_ids: nil, parent_customer_id: nil, **) = super
-
-        # def initialize: (Hash | Orb::Internal::Type::BaseModel) -> void
+        # @!method initialize(child_customer_ids: nil, parent_customer_id: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Orb::Models::CustomerCreateParams::Hierarchy} for more details.
+        #
+        #   The hierarchical relationships for this customer.
+        #
+        #   @param child_customer_ids [Array<String>] A list of child customer IDs to add to the hierarchy. The desired child customer
+        #   ...
+        #
+        #   @param parent_customer_id [String, nil] The ID of the parent customer in the hierarchy. The desired parent customer must
+        #   ...
       end
 
       # This is used for creating charges or invoices in an external system via Orb.
@@ -409,11 +398,8 @@ module Orb
         STRIPE_INVOICE = :stripe_invoice
         NETSUITE = :netsuite
 
-        finalize!
-
-        # @!parse
-        #   # @return [Array<Symbol>]
-        #   def self.values; end
+        # @!method self.values
+        #   @return [Array<Symbol>]
       end
 
       class ReportingConfiguration < Orb::Internal::Type::BaseModel
@@ -422,12 +408,8 @@ module Orb
         #   @return [Boolean]
         required :exempt, Orb::Internal::Type::Boolean
 
-        # @!parse
-        #   # @param exempt [Boolean]
-        #   #
-        #   def initialize(exempt:, **) = super
-
-        # def initialize: (Hash | Orb::Internal::Type::BaseModel) -> void
+        # @!method initialize(exempt:)
+        #   @param exempt [Boolean]
       end
 
       class ShippingAddress < Orb::Internal::Type::BaseModel
@@ -461,17 +443,13 @@ module Orb
         #   @return [String, nil]
         optional :state, String, nil?: true
 
-        # @!parse
-        #   # @param city [String, nil]
-        #   # @param country [String, nil]
-        #   # @param line1 [String, nil]
-        #   # @param line2 [String, nil]
-        #   # @param postal_code [String, nil]
-        #   # @param state [String, nil]
-        #   #
-        #   def initialize(city: nil, country: nil, line1: nil, line2: nil, postal_code: nil, state: nil, **) = super
-
-        # def initialize: (Hash | Orb::Internal::Type::BaseModel) -> void
+        # @!method initialize(city: nil, country: nil, line1: nil, line2: nil, postal_code: nil, state: nil)
+        #   @param city [String, nil]
+        #   @param country [String, nil]
+        #   @param line1 [String, nil]
+        #   @param line2 [String, nil]
+        #   @param postal_code [String, nil]
+        #   @param state [String, nil]
       end
 
       module TaxConfiguration
@@ -479,11 +457,11 @@ module Orb
 
         discriminator :tax_provider
 
-        variant :avalara, -> { Orb::Models::CustomerCreateParams::TaxConfiguration::NewAvalaraTaxConfiguration }
+        variant :avalara, -> { Orb::Models::CustomerCreateParams::TaxConfiguration::Avalara }
 
-        variant :taxjar, -> { Orb::Models::CustomerCreateParams::TaxConfiguration::NewTaxJarConfiguration }
+        variant :taxjar, -> { Orb::Models::CustomerCreateParams::TaxConfiguration::Taxjar }
 
-        class NewAvalaraTaxConfiguration < Orb::Internal::Type::BaseModel
+        class Avalara < Orb::Internal::Type::BaseModel
           # @!attribute tax_exempt
           #
           #   @return [Boolean]
@@ -499,17 +477,13 @@ module Orb
           #   @return [String, nil]
           optional :tax_exemption_code, String, nil?: true
 
-          # @!parse
-          #   # @param tax_exempt [Boolean]
-          #   # @param tax_exemption_code [String, nil]
-          #   # @param tax_provider [Symbol, :avalara]
-          #   #
-          #   def initialize(tax_exempt:, tax_exemption_code: nil, tax_provider: :avalara, **) = super
-
-          # def initialize: (Hash | Orb::Internal::Type::BaseModel) -> void
+          # @!method initialize(tax_exempt:, tax_exemption_code: nil, tax_provider: :avalara)
+          #   @param tax_exempt [Boolean]
+          #   @param tax_exemption_code [String, nil]
+          #   @param tax_provider [Symbol, :avalara]
         end
 
-        class NewTaxJarConfiguration < Orb::Internal::Type::BaseModel
+        class Taxjar < Orb::Internal::Type::BaseModel
           # @!attribute tax_exempt
           #
           #   @return [Boolean]
@@ -520,18 +494,13 @@ module Orb
           #   @return [Symbol, :taxjar]
           required :tax_provider, const: :taxjar
 
-          # @!parse
-          #   # @param tax_exempt [Boolean]
-          #   # @param tax_provider [Symbol, :taxjar]
-          #   #
-          #   def initialize(tax_exempt:, tax_provider: :taxjar, **) = super
-
-          # def initialize: (Hash | Orb::Internal::Type::BaseModel) -> void
+          # @!method initialize(tax_exempt:, tax_provider: :taxjar)
+          #   @param tax_exempt [Boolean]
+          #   @param tax_provider [Symbol, :taxjar]
         end
 
-        # @!parse
-        #   # @return [Array(Orb::Models::CustomerCreateParams::TaxConfiguration::NewAvalaraTaxConfiguration, Orb::Models::CustomerCreateParams::TaxConfiguration::NewTaxJarConfiguration)]
-        #   def self.variants; end
+        # @!method self.variants
+        #   @return [Array(Orb::Models::CustomerCreateParams::TaxConfiguration::Avalara, Orb::Models::CustomerCreateParams::TaxConfiguration::Taxjar)]
       end
 
       class TaxID < Orb::Internal::Type::BaseModel
@@ -550,120 +519,116 @@ module Orb
         #   @return [String]
         required :value, String
 
-        # @!parse
-        #   # Tax IDs are commonly required to be displayed on customer invoices, which are
-        #   # added to the headers of invoices.
-        #   #
-        #   # ### Supported Tax ID Countries and Types
-        #   #
-        #   # | Country              | Type         | Description                                                                                             |
-        #   # | -------------------- | ------------ | ------------------------------------------------------------------------------------------------------- |
-        #   # | Andorra              | `ad_nrt`     | Andorran NRT Number                                                                                     |
-        #   # | Argentina            | `ar_cuit`    | Argentinian Tax ID Number                                                                               |
-        #   # | Australia            | `au_abn`     | Australian Business Number (AU ABN)                                                                     |
-        #   # | Australia            | `au_arn`     | Australian Taxation Office Reference Number                                                             |
-        #   # | Austria              | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Bahrain              | `bh_vat`     | Bahraini VAT Number                                                                                     |
-        #   # | Belgium              | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Bolivia              | `bo_tin`     | Bolivian Tax ID                                                                                         |
-        #   # | Brazil               | `br_cnpj`    | Brazilian CNPJ Number                                                                                   |
-        #   # | Brazil               | `br_cpf`     | Brazilian CPF Number                                                                                    |
-        #   # | Bulgaria             | `bg_uic`     | Bulgaria Unified Identification Code                                                                    |
-        #   # | Bulgaria             | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Canada               | `ca_bn`      | Canadian BN                                                                                             |
-        #   # | Canada               | `ca_gst_hst` | Canadian GST/HST Number                                                                                 |
-        #   # | Canada               | `ca_pst_bc`  | Canadian PST Number (British Columbia)                                                                  |
-        #   # | Canada               | `ca_pst_mb`  | Canadian PST Number (Manitoba)                                                                          |
-        #   # | Canada               | `ca_pst_sk`  | Canadian PST Number (Saskatchewan)                                                                      |
-        #   # | Canada               | `ca_qst`     | Canadian QST Number (Québec)                                                                            |
-        #   # | Chile                | `cl_tin`     | Chilean TIN                                                                                             |
-        #   # | China                | `cn_tin`     | Chinese Tax ID                                                                                          |
-        #   # | Colombia             | `co_nit`     | Colombian NIT Number                                                                                    |
-        #   # | Costa Rica           | `cr_tin`     | Costa Rican Tax ID                                                                                      |
-        #   # | Croatia              | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Cyprus               | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Czech Republic       | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Denmark              | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Dominican Republic   | `do_rcn`     | Dominican RCN Number                                                                                    |
-        #   # | Ecuador              | `ec_ruc`     | Ecuadorian RUC Number                                                                                   |
-        #   # | Egypt                | `eg_tin`     | Egyptian Tax Identification Number                                                                      |
-        #   # | El Salvador          | `sv_nit`     | El Salvadorian NIT Number                                                                               |
-        #   # | Estonia              | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | EU                   | `eu_oss_vat` | European One Stop Shop VAT Number for non-Union scheme                                                  |
-        #   # | Finland              | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | France               | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Georgia              | `ge_vat`     | Georgian VAT                                                                                            |
-        #   # | Germany              | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Greece               | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Hong Kong            | `hk_br`      | Hong Kong BR Number                                                                                     |
-        #   # | Hungary              | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Hungary              | `hu_tin`     | Hungary Tax Number (adószám)                                                                            |
-        #   # | Iceland              | `is_vat`     | Icelandic VAT                                                                                           |
-        #   # | India                | `in_gst`     | Indian GST Number                                                                                       |
-        #   # | Indonesia            | `id_npwp`    | Indonesian NPWP Number                                                                                  |
-        #   # | Ireland              | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Israel               | `il_vat`     | Israel VAT                                                                                              |
-        #   # | Italy                | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Japan                | `jp_cn`      | Japanese Corporate Number (_Hōjin Bangō_)                                                               |
-        #   # | Japan                | `jp_rn`      | Japanese Registered Foreign Businesses' Registration Number (_Tōroku Kokugai Jigyōsha no Tōroku Bangō_) |
-        #   # | Japan                | `jp_trn`     | Japanese Tax Registration Number (_Tōroku Bangō_)                                                       |
-        #   # | Kazakhstan           | `kz_bin`     | Kazakhstani Business Identification Number                                                              |
-        #   # | Kenya                | `ke_pin`     | Kenya Revenue Authority Personal Identification Number                                                  |
-        #   # | Latvia               | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Liechtenstein        | `li_uid`     | Liechtensteinian UID Number                                                                             |
-        #   # | Lithuania            | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Luxembourg           | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Malaysia             | `my_frp`     | Malaysian FRP Number                                                                                    |
-        #   # | Malaysia             | `my_itn`     | Malaysian ITN                                                                                           |
-        #   # | Malaysia             | `my_sst`     | Malaysian SST Number                                                                                    |
-        #   # | Malta                | `eu_vat `    | European VAT Number                                                                                     |
-        #   # | Mexico               | `mx_rfc`     | Mexican RFC Number                                                                                      |
-        #   # | Netherlands          | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | New Zealand          | `nz_gst`     | New Zealand GST Number                                                                                  |
-        #   # | Nigeria              | `ng_tin`     | Nigerian Tax Identification Number                                                                      |
-        #   # | Norway               | `no_vat`     | Norwegian VAT Number                                                                                    |
-        #   # | Norway               | `no_voec`    | Norwegian VAT on e-commerce Number                                                                      |
-        #   # | Oman                 | `om_vat`     | Omani VAT Number                                                                                        |
-        #   # | Peru                 | `pe_ruc`     | Peruvian RUC Number                                                                                     |
-        #   # | Philippines          | `ph_tin `    | Philippines Tax Identification Number                                                                   |
-        #   # | Poland               | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Portugal             | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Romania              | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Romania              | `ro_tin`     | Romanian Tax ID Number                                                                                  |
-        #   # | Russia               | `ru_inn`     | Russian INN                                                                                             |
-        #   # | Russia               | `ru_kpp`     | Russian KPP                                                                                             |
-        #   # | Saudi Arabia         | `sa_vat`     | Saudi Arabia VAT                                                                                        |
-        #   # | Serbia               | `rs_pib`     | Serbian PIB Number                                                                                      |
-        #   # | Singapore            | `sg_gst`     | Singaporean GST                                                                                         |
-        #   # | Singapore            | `sg_uen`     | Singaporean UEN                                                                                         |
-        #   # | Slovakia             | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Slovenia             | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Slovenia             | `si_tin`     | Slovenia Tax Number (davčna številka)                                                                   |
-        #   # | South Africa         | `za_vat`     | South African VAT Number                                                                                |
-        #   # | South Korea          | `kr_brn`     | Korean BRN                                                                                              |
-        #   # | Spain                | `es_cif`     | Spanish NIF Number (previously Spanish CIF Number)                                                      |
-        #   # | Spain                | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Sweden               | `eu_vat`     | European VAT Number                                                                                     |
-        #   # | Switzerland          | `ch_vat`     | Switzerland VAT Number                                                                                  |
-        #   # | Taiwan               | `tw_vat`     | Taiwanese VAT                                                                                           |
-        #   # | Thailand             | `th_vat`     | Thai VAT                                                                                                |
-        #   # | Turkey               | `tr_tin`     | Turkish Tax Identification Number                                                                       |
-        #   # | Ukraine              | `ua_vat`     | Ukrainian VAT                                                                                           |
-        #   # | United Arab Emirates | `ae_trn`     | United Arab Emirates TRN                                                                                |
-        #   # | United Kingdom       | `eu_vat`     | Northern Ireland VAT Number                                                                             |
-        #   # | United Kingdom       | `gb_vat`     | United Kingdom VAT Number                                                                               |
-        #   # | United States        | `us_ein`     | United States EIN                                                                                       |
-        #   # | Uruguay              | `uy_ruc`     | Uruguayan RUC Number                                                                                    |
-        #   # | Venezuela            | `ve_rif`     | Venezuelan RIF Number                                                                                   |
-        #   # | Vietnam              | `vn_tin`     | Vietnamese Tax ID Number                                                                                |
-        #   #
-        #   # @param country [Symbol, Orb::Models::CustomerCreateParams::TaxID::Country]
-        #   # @param type [Symbol, Orb::Models::CustomerCreateParams::TaxID::Type]
-        #   # @param value [String]
-        #   #
-        #   def initialize(country:, type:, value:, **) = super
-
-        # def initialize: (Hash | Orb::Internal::Type::BaseModel) -> void
+        # @!method initialize(country:, type:, value:)
+        #   Tax IDs are commonly required to be displayed on customer invoices, which are
+        #   added to the headers of invoices.
+        #
+        #   ### Supported Tax ID Countries and Types
+        #
+        #   | Country              | Type         | Description                                                                                             |
+        #   | -------------------- | ------------ | ------------------------------------------------------------------------------------------------------- |
+        #   | Andorra              | `ad_nrt`     | Andorran NRT Number                                                                                     |
+        #   | Argentina            | `ar_cuit`    | Argentinian Tax ID Number                                                                               |
+        #   | Australia            | `au_abn`     | Australian Business Number (AU ABN)                                                                     |
+        #   | Australia            | `au_arn`     | Australian Taxation Office Reference Number                                                             |
+        #   | Austria              | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Bahrain              | `bh_vat`     | Bahraini VAT Number                                                                                     |
+        #   | Belgium              | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Bolivia              | `bo_tin`     | Bolivian Tax ID                                                                                         |
+        #   | Brazil               | `br_cnpj`    | Brazilian CNPJ Number                                                                                   |
+        #   | Brazil               | `br_cpf`     | Brazilian CPF Number                                                                                    |
+        #   | Bulgaria             | `bg_uic`     | Bulgaria Unified Identification Code                                                                    |
+        #   | Bulgaria             | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Canada               | `ca_bn`      | Canadian BN                                                                                             |
+        #   | Canada               | `ca_gst_hst` | Canadian GST/HST Number                                                                                 |
+        #   | Canada               | `ca_pst_bc`  | Canadian PST Number (British Columbia)                                                                  |
+        #   | Canada               | `ca_pst_mb`  | Canadian PST Number (Manitoba)                                                                          |
+        #   | Canada               | `ca_pst_sk`  | Canadian PST Number (Saskatchewan)                                                                      |
+        #   | Canada               | `ca_qst`     | Canadian QST Number (Québec)                                                                            |
+        #   | Chile                | `cl_tin`     | Chilean TIN                                                                                             |
+        #   | China                | `cn_tin`     | Chinese Tax ID                                                                                          |
+        #   | Colombia             | `co_nit`     | Colombian NIT Number                                                                                    |
+        #   | Costa Rica           | `cr_tin`     | Costa Rican Tax ID                                                                                      |
+        #   | Croatia              | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Cyprus               | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Czech Republic       | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Denmark              | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Dominican Republic   | `do_rcn`     | Dominican RCN Number                                                                                    |
+        #   | Ecuador              | `ec_ruc`     | Ecuadorian RUC Number                                                                                   |
+        #   | Egypt                | `eg_tin`     | Egyptian Tax Identification Number                                                                      |
+        #   | El Salvador          | `sv_nit`     | El Salvadorian NIT Number                                                                               |
+        #   | Estonia              | `eu_vat`     | European VAT Number                                                                                     |
+        #   | EU                   | `eu_oss_vat` | European One Stop Shop VAT Number for non-Union scheme                                                  |
+        #   | Finland              | `eu_vat`     | European VAT Number                                                                                     |
+        #   | France               | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Georgia              | `ge_vat`     | Georgian VAT                                                                                            |
+        #   | Germany              | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Greece               | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Hong Kong            | `hk_br`      | Hong Kong BR Number                                                                                     |
+        #   | Hungary              | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Hungary              | `hu_tin`     | Hungary Tax Number (adószám)                                                                            |
+        #   | Iceland              | `is_vat`     | Icelandic VAT                                                                                           |
+        #   | India                | `in_gst`     | Indian GST Number                                                                                       |
+        #   | Indonesia            | `id_npwp`    | Indonesian NPWP Number                                                                                  |
+        #   | Ireland              | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Israel               | `il_vat`     | Israel VAT                                                                                              |
+        #   | Italy                | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Japan                | `jp_cn`      | Japanese Corporate Number (_Hōjin Bangō_)                                                               |
+        #   | Japan                | `jp_rn`      | Japanese Registered Foreign Businesses' Registration Number (_Tōroku Kokugai Jigyōsha no Tōroku Bangō_) |
+        #   | Japan                | `jp_trn`     | Japanese Tax Registration Number (_Tōroku Bangō_)                                                       |
+        #   | Kazakhstan           | `kz_bin`     | Kazakhstani Business Identification Number                                                              |
+        #   | Kenya                | `ke_pin`     | Kenya Revenue Authority Personal Identification Number                                                  |
+        #   | Latvia               | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Liechtenstein        | `li_uid`     | Liechtensteinian UID Number                                                                             |
+        #   | Lithuania            | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Luxembourg           | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Malaysia             | `my_frp`     | Malaysian FRP Number                                                                                    |
+        #   | Malaysia             | `my_itn`     | Malaysian ITN                                                                                           |
+        #   | Malaysia             | `my_sst`     | Malaysian SST Number                                                                                    |
+        #   | Malta                | `eu_vat `    | European VAT Number                                                                                     |
+        #   | Mexico               | `mx_rfc`     | Mexican RFC Number                                                                                      |
+        #   | Netherlands          | `eu_vat`     | European VAT Number                                                                                     |
+        #   | New Zealand          | `nz_gst`     | New Zealand GST Number                                                                                  |
+        #   | Nigeria              | `ng_tin`     | Nigerian Tax Identification Number                                                                      |
+        #   | Norway               | `no_vat`     | Norwegian VAT Number                                                                                    |
+        #   | Norway               | `no_voec`    | Norwegian VAT on e-commerce Number                                                                      |
+        #   | Oman                 | `om_vat`     | Omani VAT Number                                                                                        |
+        #   | Peru                 | `pe_ruc`     | Peruvian RUC Number                                                                                     |
+        #   | Philippines          | `ph_tin `    | Philippines Tax Identification Number                                                                   |
+        #   | Poland               | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Portugal             | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Romania              | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Romania              | `ro_tin`     | Romanian Tax ID Number                                                                                  |
+        #   | Russia               | `ru_inn`     | Russian INN                                                                                             |
+        #   | Russia               | `ru_kpp`     | Russian KPP                                                                                             |
+        #   | Saudi Arabia         | `sa_vat`     | Saudi Arabia VAT                                                                                        |
+        #   | Serbia               | `rs_pib`     | Serbian PIB Number                                                                                      |
+        #   | Singapore            | `sg_gst`     | Singaporean GST                                                                                         |
+        #   | Singapore            | `sg_uen`     | Singaporean UEN                                                                                         |
+        #   | Slovakia             | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Slovenia             | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Slovenia             | `si_tin`     | Slovenia Tax Number (davčna številka)                                                                   |
+        #   | South Africa         | `za_vat`     | South African VAT Number                                                                                |
+        #   | South Korea          | `kr_brn`     | Korean BRN                                                                                              |
+        #   | Spain                | `es_cif`     | Spanish NIF Number (previously Spanish CIF Number)                                                      |
+        #   | Spain                | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Sweden               | `eu_vat`     | European VAT Number                                                                                     |
+        #   | Switzerland          | `ch_vat`     | Switzerland VAT Number                                                                                  |
+        #   | Taiwan               | `tw_vat`     | Taiwanese VAT                                                                                           |
+        #   | Thailand             | `th_vat`     | Thai VAT                                                                                                |
+        #   | Turkey               | `tr_tin`     | Turkish Tax Identification Number                                                                       |
+        #   | Ukraine              | `ua_vat`     | Ukrainian VAT                                                                                           |
+        #   | United Arab Emirates | `ae_trn`     | United Arab Emirates TRN                                                                                |
+        #   | United Kingdom       | `eu_vat`     | Northern Ireland VAT Number                                                                             |
+        #   | United Kingdom       | `gb_vat`     | United Kingdom VAT Number                                                                               |
+        #   | United States        | `us_ein`     | United States EIN                                                                                       |
+        #   | Uruguay              | `uy_ruc`     | Uruguayan RUC Number                                                                                    |
+        #   | Venezuela            | `ve_rif`     | Venezuelan RIF Number                                                                                   |
+        #   | Vietnam              | `vn_tin`     | Vietnamese Tax ID Number                                                                                |
+        #
+        #   @param country [Symbol, Orb::Models::CustomerCreateParams::TaxID::Country]
+        #   @param type [Symbol, Orb::Models::CustomerCreateParams::TaxID::Type]
+        #   @param value [String]
 
         # @see Orb::Models::CustomerCreateParams::TaxID#country
         module Country
@@ -748,11 +713,8 @@ module Orb
           VN = :VN
           ZA = :ZA
 
-          finalize!
-
-          # @!parse
-          #   # @return [Array<Symbol>]
-          #   def self.values; end
+          # @!method self.values
+          #   @return [Array<Symbol>]
         end
 
         # @see Orb::Models::CustomerCreateParams::TaxID#type
@@ -831,11 +793,8 @@ module Orb
           VN_TIN = :vn_tin
           ZA_VAT = :za_vat
 
-          finalize!
-
-          # @!parse
-          #   # @return [Array<Symbol>]
-          #   def self.values; end
+          # @!method self.values
+          #   @return [Array<Symbol>]
         end
       end
     end