trevol 0.1.0

data/lib/trevol_generado/models/top_up_buyer.rb

@@ -0,0 +1,352 @@
+=begin
+#API de Trevol
+
+#Trevol API. Documentación: https://platform.trevol.si/docs
+
+The version of the OpenAPI document: 2026-10-22
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.26.0
+
+=end
+
+require 'date'
+require 'time'
+
+module TrevolGenerado
+  # El comprador de la factura de la recarga. Sin él, la empresa de la llave.
+  class TopUpBuyer < ApiModelBase
+    # 13 cédula, 31 NIT, 22 cédula de extranjería, 41 pasaporte (lo que acepta la facturación de la recarga).
+    attr_accessor :document_type
+
+    # Sin DV ni puntos (con 13 y 31, solo dígitos).
+    attr_accessor :document_number
+
+    # Con NIT, obligatorio: el DV del NIT. No va con los demás. (Tipos admitidos: string, integer.)
+    attr_accessor :check_digit
+
+    # legal (persona jurídica, solo con NIT) o natural.
+    attr_accessor :person_type
+
+    # Razón social o, para una persona natural, nombres y apellidos (al menos dos palabras).
+    attr_accessor :name
+
+    # A dónde llega la factura de la recarga.
+    attr_accessor :email
+
+    attr_accessor :phone
+
+    attr_accessor :address
+
+    # Código DANE del municipio (5 dígitos).
+    attr_accessor :municipality_code
+
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'document_type' => :'document_type',
+        :'document_number' => :'document_number',
+        :'check_digit' => :'check_digit',
+        :'person_type' => :'person_type',
+        :'name' => :'name',
+        :'email' => :'email',
+        :'phone' => :'phone',
+        :'address' => :'address',
+        :'municipality_code' => :'municipality_code'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'document_type' => :'String',
+        :'document_number' => :'String',
+        :'check_digit' => :'Object',
+        :'person_type' => :'String',
+        :'name' => :'String',
+        :'email' => :'String',
+        :'phone' => :'String',
+        :'address' => :'String',
+        :'municipality_code' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+        :'check_digit',
+      ])
+    end
+
+    # Returns attribute type mapping
+    def self.acceptable_openapi_types
+      openapi_types
+    end
+
+    # Returns the nullable attributes
+    def self.acceptable_openapi_nullable
+      openapi_nullable
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `TrevolGenerado::TopUpBuyer` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `TrevolGenerado::TopUpBuyer`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'document_type')
+        self.document_type = attributes[:'document_type']
+      else
+        self.document_type = nil
+      end
+
+      if attributes.key?(:'document_number')
+        self.document_number = attributes[:'document_number']
+      else
+        self.document_number = nil
+      end
+
+      if attributes.key?(:'check_digit')
+        self.check_digit = attributes[:'check_digit']
+      end
+
+      if attributes.key?(:'person_type')
+        self.person_type = attributes[:'person_type']
+      else
+        self.person_type = nil
+      end
+
+      if attributes.key?(:'name')
+        self.name = attributes[:'name']
+      else
+        self.name = nil
+      end
+
+      if attributes.key?(:'email')
+        self.email = attributes[:'email']
+      else
+        self.email = nil
+      end
+
+      if attributes.key?(:'phone')
+        self.phone = attributes[:'phone']
+      end
+
+      if attributes.key?(:'address')
+        self.address = attributes[:'address']
+      end
+
+      if attributes.key?(:'municipality_code')
+        self.municipality_code = attributes[:'municipality_code']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @document_type.nil?
+        invalid_properties.push('invalid value for "document_type", document_type cannot be nil.')
+      end
+
+      if @document_number.nil?
+        invalid_properties.push('invalid value for "document_number", document_number cannot be nil.')
+      end
+
+      if @person_type.nil?
+        invalid_properties.push('invalid value for "person_type", person_type cannot be nil.')
+      end
+
+      if @name.nil?
+        invalid_properties.push('invalid value for "name", name cannot be nil.')
+      end
+
+      if @email.nil?
+        invalid_properties.push('invalid value for "email", email cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @document_type.nil?
+      document_type_validator = EnumAttributeValidator.new('String', ["13", "31", "22", "41", "unknown_default_open_api"])
+      return false unless document_type_validator.valid?(@document_type)
+      return false if @document_number.nil?
+      return false if @person_type.nil?
+      person_type_validator = EnumAttributeValidator.new('String', ["legal", "natural", "unknown_default_open_api"])
+      return false unless person_type_validator.valid?(@person_type)
+      return false if @name.nil?
+      return false if @email.nil?
+      true
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] document_type Object to be assigned
+    def document_type=(document_type)
+      validator = EnumAttributeValidator.new('String', ["13", "31", "22", "41", "unknown_default_open_api"])
+      unless validator.valid?(document_type)
+        fail ArgumentError, "invalid value for \"document_type\", must be one of #{validator.allowable_values}."
+      end
+      @document_type = document_type
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] document_number Value to be assigned
+    def document_number=(document_number)
+      if document_number.nil?
+        fail ArgumentError, 'document_number cannot be nil'
+      end
+
+      @document_number = document_number
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] person_type Object to be assigned
+    def person_type=(person_type)
+      validator = EnumAttributeValidator.new('String', ["legal", "natural", "unknown_default_open_api"])
+      unless validator.valid?(person_type)
+        fail ArgumentError, "invalid value for \"person_type\", must be one of #{validator.allowable_values}."
+      end
+      @person_type = person_type
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] name Value to be assigned
+    def name=(name)
+      if name.nil?
+        fail ArgumentError, 'name cannot be nil'
+      end
+
+      @name = name
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] email Value to be assigned
+    def email=(email)
+      if email.nil?
+        fail ArgumentError, 'email cannot be nil'
+      end
+
+      @email = email
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          document_type == o.document_type &&
+          document_number == o.document_number &&
+          check_digit == o.check_digit &&
+          person_type == o.person_type &&
+          name == o.name &&
+          email == o.email &&
+          phone == o.phone &&
+          address == o.address &&
+          municipality_code == o.municipality_code
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [document_type, document_number, check_digit, person_type, name, email, phone, address, municipality_code].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      # include attributes inherited from allOf parents (the nearest declaration wins)
+      map = acceptable_attribute_map
+      transformed_hash = {}
+      acceptable_openapi_types.each_pair do |key, type|
+        if attributes.key?(map[key]) && attributes[map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      # include attributes inherited from allOf parents (the nearest declaration wins)
+      self.class.acceptable_attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.acceptable_openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/trevol_generado/models/top_up_input.rb

@@ -0,0 +1,187 @@
+=begin
+#API de Trevol
+
+#Trevol API. Documentación: https://platform.trevol.si/docs
+
+The version of the OpenAPI document: 2026-10-22
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.26.0
+
+=end
+
+require 'date'
+require 'time'
+
+module TrevolGenerado
+  class TopUpInput < ApiModelBase
+    # En pesos, entre la recarga mínima y la máxima.
+    attr_accessor :amount_cop
+
+    attr_accessor :buyer
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'amount_cop' => :'amount_cop',
+        :'buyer' => :'buyer'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'amount_cop' => :'Integer',
+        :'buyer' => :'TopUpBuyer'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Returns attribute type mapping
+    def self.acceptable_openapi_types
+      openapi_types
+    end
+
+    # Returns the nullable attributes
+    def self.acceptable_openapi_nullable
+      openapi_nullable
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `TrevolGenerado::TopUpInput` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `TrevolGenerado::TopUpInput`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'amount_cop')
+        self.amount_cop = attributes[:'amount_cop']
+      else
+        self.amount_cop = nil
+      end
+
+      if attributes.key?(:'buyer')
+        self.buyer = attributes[:'buyer']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @amount_cop.nil?
+        invalid_properties.push('invalid value for "amount_cop", amount_cop cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @amount_cop.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] amount_cop Value to be assigned
+    def amount_cop=(amount_cop)
+      if amount_cop.nil?
+        fail ArgumentError, 'amount_cop cannot be nil'
+      end
+
+      @amount_cop = amount_cop
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          amount_cop == o.amount_cop &&
+          buyer == o.buyer
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [amount_cop, buyer].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      # include attributes inherited from allOf parents (the nearest declaration wins)
+      map = acceptable_attribute_map
+      transformed_hash = {}
+      acceptable_openapi_types.each_pair do |key, type|
+        if attributes.key?(map[key]) && attributes[map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      # include attributes inherited from allOf parents (the nearest declaration wins)
+      self.class.acceptable_attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.acceptable_openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end