modern_treasury 0.0.0 → 0.1.0.pre.alpha.15

data/lib/modern_treasury/models/legal_entity_association_create_params.rb

@@ -0,0 +1,620 @@
+# frozen_string_literal: true
+
+module ModernTreasury
+  module Models
+    class LegalEntityAssociationCreateParams < ModernTreasury::BaseModel
+      # @!parse
+      #   extend ModernTreasury::RequestParameters::Converter
+      include ModernTreasury::RequestParameters
+
+      # @!attribute parent_legal_entity_id
+      #   The ID of the parent legal entity. This must be a business or joint legal
+      #     entity.
+      #
+      #   @return [String]
+      required :parent_legal_entity_id, String
+
+      # @!attribute relationship_types
+      #
+      #   @return [Array<Symbol, ModernTreasury::Models::LegalEntityAssociationCreateParams::RelationshipType>]
+      required :relationship_types,
+               -> { ModernTreasury::ArrayOf[enum: ModernTreasury::Models::LegalEntityAssociationCreateParams::RelationshipType] }
+
+      # @!attribute [r] child_legal_entity
+      #   The child legal entity.
+      #
+      #   @return [ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity, nil]
+      optional :child_legal_entity,
+               -> { ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity }
+
+      # @!parse
+      #   # @return [ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity]
+      #   attr_writer :child_legal_entity
+
+      # @!attribute [r] child_legal_entity_id
+      #   The ID of the child legal entity.
+      #
+      #   @return [String, nil]
+      optional :child_legal_entity_id, String
+
+      # @!parse
+      #   # @return [String]
+      #   attr_writer :child_legal_entity_id
+
+      # @!attribute ownership_percentage
+      #   The child entity's ownership percentage iff they are a beneficial owner.
+      #
+      #   @return [Integer, nil]
+      optional :ownership_percentage, Integer, nil?: true
+
+      # @!attribute title
+      #   The job title of the child entity at the parent entity.
+      #
+      #   @return [String, nil]
+      optional :title, String, nil?: true
+
+      # @!parse
+      #   # @param parent_legal_entity_id [String]
+      #   # @param relationship_types [Array<Symbol, ModernTreasury::Models::LegalEntityAssociationCreateParams::RelationshipType>]
+      #   # @param child_legal_entity [ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity]
+      #   # @param child_legal_entity_id [String]
+      #   # @param ownership_percentage [Integer, nil]
+      #   # @param title [String, nil]
+      #   # @param request_options [ModernTreasury::RequestOptions, Hash{Symbol=>Object}]
+      #   #
+      #   def initialize(
+      #     parent_legal_entity_id:,
+      #     relationship_types:,
+      #     child_legal_entity: nil,
+      #     child_legal_entity_id: nil,
+      #     ownership_percentage: nil,
+      #     title: nil,
+      #     request_options: {},
+      #     **
+      #   )
+      #     super
+      #   end
+
+      # def initialize: (Hash | ModernTreasury::BaseModel) -> void
+
+      # @abstract
+      #
+      # A list of relationship types for how the child entity relates to parent entity.
+      #
+      # @example
+      # ```ruby
+      # case relationship_type
+      # in :beneficial_owner
+      #   # ...
+      # in :control_person
+      #   # ...
+      # end
+      # ```
+      class RelationshipType < ModernTreasury::Enum
+        BENEFICIAL_OWNER = :beneficial_owner
+        CONTROL_PERSON = :control_person
+
+        finalize!
+
+        # @!parse
+        #   # @return [Array<Symbol>]
+        #   #
+        #   def self.values; end
+      end
+
+      class ChildLegalEntity < ModernTreasury::BaseModel
+        # @!attribute [r] addresses
+        #   A list of addresses for the entity.
+        #
+        #   @return [Array<ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::Address>, nil]
+        optional :addresses,
+                 -> { ModernTreasury::ArrayOf[ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::Address] }
+
+        # @!parse
+        #   # @return [Array<ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::Address>]
+        #   attr_writer :addresses
+
+        # @!attribute bank_settings
+        #
+        #   @return [ModernTreasury::Models::BankSettings, nil]
+        optional :bank_settings, -> { ModernTreasury::Models::BankSettings }, nil?: true
+
+        # @!attribute business_name
+        #   The business's legal business name.
+        #
+        #   @return [String, nil]
+        optional :business_name, String, nil?: true
+
+        # @!attribute citizenship_country
+        #   The country of citizenship for an individual.
+        #
+        #   @return [String, nil]
+        optional :citizenship_country, String, nil?: true
+
+        # @!attribute date_formed
+        #   A business's formation date (YYYY-MM-DD).
+        #
+        #   @return [Date, nil]
+        optional :date_formed, Date, nil?: true
+
+        # @!attribute date_of_birth
+        #   An individual's date of birth (YYYY-MM-DD).
+        #
+        #   @return [Date, nil]
+        optional :date_of_birth, Date, nil?: true
+
+        # @!attribute [r] doing_business_as_names
+        #
+        #   @return [Array<String>, nil]
+        optional :doing_business_as_names, ModernTreasury::ArrayOf[String]
+
+        # @!parse
+        #   # @return [Array<String>]
+        #   attr_writer :doing_business_as_names
+
+        # @!attribute email
+        #   The entity's primary email.
+        #
+        #   @return [String, nil]
+        optional :email, String, nil?: true
+
+        # @!attribute first_name
+        #   An individual's first name.
+        #
+        #   @return [String, nil]
+        optional :first_name, String, nil?: true
+
+        # @!attribute [r] identifications
+        #   A list of identifications for the legal entity.
+        #
+        #   @return [Array<ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::Identification>, nil]
+        optional :identifications,
+                 -> { ModernTreasury::ArrayOf[ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::Identification] }
+
+        # @!parse
+        #   # @return [Array<ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::Identification>]
+        #   attr_writer :identifications
+
+        # @!attribute last_name
+        #   An individual's last name.
+        #
+        #   @return [String, nil]
+        optional :last_name, String, nil?: true
+
+        # @!attribute [r] legal_entity_type
+        #   The type of legal entity.
+        #
+        #   @return [Symbol, ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::LegalEntityType, nil]
+        optional :legal_entity_type,
+                 enum: -> { ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::LegalEntityType }
+
+        # @!parse
+        #   # @return [Symbol, ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::LegalEntityType]
+        #   attr_writer :legal_entity_type
+
+        # @!attribute legal_structure
+        #   The business's legal structure.
+        #
+        #   @return [Symbol, ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::LegalStructure, nil]
+        optional :legal_structure,
+                 enum: -> { ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::LegalStructure },
+                 nil?: true
+
+        # @!attribute [r] metadata
+        #   Additional data represented as key-value pairs. Both the key and value must be
+        #     strings.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :metadata, ModernTreasury::HashOf[String]
+
+        # @!parse
+        #   # @return [Hash{Symbol=>String}]
+        #   attr_writer :metadata
+
+        # @!attribute middle_name
+        #   An individual's middle name.
+        #
+        #   @return [String, nil]
+        optional :middle_name, String, nil?: true
+
+        # @!attribute [r] phone_numbers
+        #
+        #   @return [Array<ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::PhoneNumber>, nil]
+        optional :phone_numbers,
+                 -> { ModernTreasury::ArrayOf[ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::PhoneNumber] }
+
+        # @!parse
+        #   # @return [Array<ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::PhoneNumber>]
+        #   attr_writer :phone_numbers
+
+        # @!attribute politically_exposed_person
+        #   Whether the individual is a politically exposed person.
+        #
+        #   @return [Boolean, nil]
+        optional :politically_exposed_person, ModernTreasury::BooleanModel, nil?: true
+
+        # @!attribute preferred_name
+        #   An individual's preferred name.
+        #
+        #   @return [String, nil]
+        optional :preferred_name, String, nil?: true
+
+        # @!attribute prefix
+        #   An individual's prefix.
+        #
+        #   @return [String, nil]
+        optional :prefix, String, nil?: true
+
+        # @!attribute risk_rating
+        #   The risk rating of the legal entity. One of low, medium, high.
+        #
+        #   @return [Symbol, ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::RiskRating, nil]
+        optional :risk_rating,
+                 enum: -> { ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::RiskRating },
+                 nil?: true
+
+        # @!attribute suffix
+        #   An individual's suffix.
+        #
+        #   @return [String, nil]
+        optional :suffix, String, nil?: true
+
+        # @!attribute wealth_and_employment_details
+        #
+        #   @return [ModernTreasury::Models::WealthAndEmploymentDetails, nil]
+        optional :wealth_and_employment_details,
+                 -> { ModernTreasury::Models::WealthAndEmploymentDetails },
+                 nil?: true
+
+        # @!attribute website
+        #   The entity's primary website URL.
+        #
+        #   @return [String, nil]
+        optional :website, String, nil?: true
+
+        # @!parse
+        #   # The child legal entity.
+        #   #
+        #   # @param addresses [Array<ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::Address>]
+        #   # @param bank_settings [ModernTreasury::Models::BankSettings, nil]
+        #   # @param business_name [String, nil]
+        #   # @param citizenship_country [String, nil]
+        #   # @param date_formed [Date, nil]
+        #   # @param date_of_birth [Date, nil]
+        #   # @param doing_business_as_names [Array<String>]
+        #   # @param email [String, nil]
+        #   # @param first_name [String, nil]
+        #   # @param identifications [Array<ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::Identification>]
+        #   # @param last_name [String, nil]
+        #   # @param legal_entity_type [Symbol, ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::LegalEntityType]
+        #   # @param legal_structure [Symbol, ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::LegalStructure, nil]
+        #   # @param metadata [Hash{Symbol=>String}]
+        #   # @param middle_name [String, nil]
+        #   # @param phone_numbers [Array<ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::PhoneNumber>]
+        #   # @param politically_exposed_person [Boolean, nil]
+        #   # @param preferred_name [String, nil]
+        #   # @param prefix [String, nil]
+        #   # @param risk_rating [Symbol, ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::RiskRating, nil]
+        #   # @param suffix [String, nil]
+        #   # @param wealth_and_employment_details [ModernTreasury::Models::WealthAndEmploymentDetails, nil]
+        #   # @param website [String, nil]
+        #   #
+        #   def initialize(
+        #     addresses: nil,
+        #     bank_settings: nil,
+        #     business_name: nil,
+        #     citizenship_country: nil,
+        #     date_formed: nil,
+        #     date_of_birth: nil,
+        #     doing_business_as_names: nil,
+        #     email: nil,
+        #     first_name: nil,
+        #     identifications: nil,
+        #     last_name: nil,
+        #     legal_entity_type: nil,
+        #     legal_structure: nil,
+        #     metadata: nil,
+        #     middle_name: nil,
+        #     phone_numbers: nil,
+        #     politically_exposed_person: nil,
+        #     preferred_name: nil,
+        #     prefix: nil,
+        #     risk_rating: nil,
+        #     suffix: nil,
+        #     wealth_and_employment_details: nil,
+        #     website: nil,
+        #     **
+        #   )
+        #     super
+        #   end
+
+        # def initialize: (Hash | ModernTreasury::BaseModel) -> void
+
+        class Address < ModernTreasury::BaseModel
+          # @!attribute country
+          #   Country code conforms to [ISO 3166-1 alpha-2]
+          #
+          #   @return [String, nil]
+          required :country, String, nil?: true
+
+          # @!attribute line1
+          #
+          #   @return [String, nil]
+          required :line1, String, nil?: true
+
+          # @!attribute locality
+          #   Locality or City.
+          #
+          #   @return [String, nil]
+          required :locality, String, nil?: true
+
+          # @!attribute postal_code
+          #   The postal code of the address.
+          #
+          #   @return [String, nil]
+          required :postal_code, String, nil?: true
+
+          # @!attribute region
+          #   Region or State.
+          #
+          #   @return [String, nil]
+          required :region, String, nil?: true
+
+          # @!attribute [r] address_types
+          #   The types of this address.
+          #
+          #   @return [Array<Symbol, ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::Address::AddressType>, nil]
+          optional :address_types,
+                   -> { ModernTreasury::ArrayOf[enum: ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::Address::AddressType] }
+
+          # @!parse
+          #   # @return [Array<Symbol, ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::Address::AddressType>]
+          #   attr_writer :address_types
+
+          # @!attribute line2
+          #
+          #   @return [String, nil]
+          optional :line2, String, nil?: true
+
+          # @!parse
+          #   # @param country [String, nil]
+          #   # @param line1 [String, nil]
+          #   # @param locality [String, nil]
+          #   # @param postal_code [String, nil]
+          #   # @param region [String, nil]
+          #   # @param address_types [Array<Symbol, ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::Address::AddressType>]
+          #   # @param line2 [String, nil]
+          #   #
+          #   def initialize(country:, line1:, locality:, postal_code:, region:, address_types: nil, line2: nil, **) = super
+
+          # def initialize: (Hash | ModernTreasury::BaseModel) -> void
+
+          # @abstract
+          #
+          # @example
+          # ```ruby
+          # case address_type
+          # in :business
+          #   # ...
+          # in :mailing
+          #   # ...
+          # in :other
+          #   # ...
+          # in :po_box
+          #   # ...
+          # in :residential
+          #   # ...
+          # end
+          # ```
+          class AddressType < ModernTreasury::Enum
+            BUSINESS = :business
+            MAILING = :mailing
+            OTHER = :other
+            PO_BOX = :po_box
+            RESIDENTIAL = :residential
+
+            finalize!
+
+            # @!parse
+            #   # @return [Array<Symbol>]
+            #   #
+            #   def self.values; end
+          end
+        end
+
+        class Identification < ModernTreasury::BaseModel
+          # @!attribute id_number
+          #   The ID number of identification document.
+          #
+          #   @return [String]
+          required :id_number, String
+
+          # @!attribute id_type
+          #   The type of ID number.
+          #
+          #   @return [Symbol, ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::Identification::IDType]
+          required :id_type,
+                   enum: -> { ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::Identification::IDType }
+
+          # @!attribute issuing_country
+          #   The ISO 3166-1 alpha-2 country code of the country that issued the
+          #     identification
+          #
+          #   @return [String, nil]
+          optional :issuing_country, String, nil?: true
+
+          # @!parse
+          #   # @param id_number [String]
+          #   # @param id_type [Symbol, ModernTreasury::Models::LegalEntityAssociationCreateParams::ChildLegalEntity::Identification::IDType]
+          #   # @param issuing_country [String, nil]
+          #   #
+          #   def initialize(id_number:, id_type:, issuing_country: nil, **) = super
+
+          # def initialize: (Hash | ModernTreasury::BaseModel) -> void
+
+          # @abstract
+          #
+          # The type of ID number.
+          #
+          # @example
+          # ```ruby
+          # case id_type
+          # in :ar_cuil
+          #   # ...
+          # in :ar_cuit
+          #   # ...
+          # in :br_cnpj
+          #   # ...
+          # in :br_cpf
+          #   # ...
+          # in :cl_run
+          #   # ...
+          # in ...
+          #   #...
+          # end
+          # ```
+          class IDType < ModernTreasury::Enum
+            AR_CUIL = :ar_cuil
+            AR_CUIT = :ar_cuit
+            BR_CNPJ = :br_cnpj
+            BR_CPF = :br_cpf
+            CL_RUN = :cl_run
+            CL_RUT = :cl_rut
+            CO_CEDULAS = :co_cedulas
+            CO_NIT = :co_nit
+            HN_ID = :hn_id
+            HN_RTN = :hn_rtn
+            IN_LEI = :in_lei
+            KR_BRN = :kr_brn
+            KR_CRN = :kr_crn
+            KR_RRN = :kr_rrn
+            PASSPORT = :passport
+            SA_TIN = :sa_tin
+            SA_VAT = :sa_vat
+            US_EIN = :us_ein
+            US_ITIN = :us_itin
+            US_SSN = :us_ssn
+            VN_TIN = :vn_tin
+
+            finalize!
+
+            # @!parse
+            #   # @return [Array<Symbol>]
+            #   #
+            #   def self.values; end
+          end
+        end
+
+        # @abstract
+        #
+        # The type of legal entity.
+        #
+        # @example
+        # ```ruby
+        # case legal_entity_type
+        # in :business
+        #   # ...
+        # in :individual
+        #   # ...
+        # end
+        # ```
+        class LegalEntityType < ModernTreasury::Enum
+          BUSINESS = :business
+          INDIVIDUAL = :individual
+
+          finalize!
+
+          # @!parse
+          #   # @return [Array<Symbol>]
+          #   #
+          #   def self.values; end
+        end
+
+        # @abstract
+        #
+        # The business's legal structure.
+        #
+        # @example
+        # ```ruby
+        # case legal_structure
+        # in :corporation
+        #   # ...
+        # in :llc
+        #   # ...
+        # in :non_profit
+        #   # ...
+        # in :partnership
+        #   # ...
+        # in :sole_proprietorship
+        #   # ...
+        # in ...
+        #   #...
+        # end
+        # ```
+        class LegalStructure < ModernTreasury::Enum
+          CORPORATION = :corporation
+          LLC = :llc
+          NON_PROFIT = :non_profit
+          PARTNERSHIP = :partnership
+          SOLE_PROPRIETORSHIP = :sole_proprietorship
+          TRUST = :trust
+
+          finalize!
+
+          # @!parse
+          #   # @return [Array<Symbol>]
+          #   #
+          #   def self.values; end
+        end
+
+        class PhoneNumber < ModernTreasury::BaseModel
+          # @!attribute [r] phone_number
+          #
+          #   @return [String, nil]
+          optional :phone_number, String
+
+          # @!parse
+          #   # @return [String]
+          #   attr_writer :phone_number
+
+          # @!parse
+          #   # A list of phone numbers in E.164 format.
+          #   #
+          #   # @param phone_number [String]
+          #   #
+          #   def initialize(phone_number: nil, **) = super
+
+          # def initialize: (Hash | ModernTreasury::BaseModel) -> void
+        end
+
+        # @abstract
+        #
+        # The risk rating of the legal entity. One of low, medium, high.
+        #
+        # @example
+        # ```ruby
+        # case risk_rating
+        # in :low
+        #   # ...
+        # in :medium
+        #   # ...
+        # in :high
+        #   # ...
+        # end
+        # ```
+        class RiskRating < ModernTreasury::Enum
+          LOW = :low
+          MEDIUM = :medium
+          HIGH = :high
+
+          finalize!
+
+          # @!parse
+          #   # @return [Array<Symbol>]
+          #   #
+          #   def self.values; end
+        end
+      end
+    end
+  end
+end