trevol 0.1.0

data/lib/trevol_generado/models/equivalent_document_reference.rb

@@ -0,0 +1,241 @@
+=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
+  # Usa `id`, o `number` + `cude` + `issue_date` + `document_type`.
+  class EquivalentDocumentReference < ApiModelBase
+    attr_accessor :id
+
+    attr_accessor :number
+
+    attr_accessor :cude
+
+    attr_accessor :issue_date
+
+    attr_accessor :document_type
+
+    # Número o texto decimal con punto («150000.50»).
+    attr_accessor :total
+
+    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
+      {
+        :'id' => :'id',
+        :'number' => :'number',
+        :'cude' => :'cude',
+        :'issue_date' => :'issue_date',
+        :'document_type' => :'document_type',
+        :'total' => :'total'
+      }
+    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
+      {
+        :'id' => :'String',
+        :'number' => :'String',
+        :'cude' => :'String',
+        :'issue_date' => :'Date',
+        :'document_type' => :'String',
+        :'total' => :'String'
+      }
+    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::EquivalentDocumentReference` 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::EquivalentDocumentReference`. 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?(:'id')
+        self.id = attributes[:'id']
+      end
+
+      if attributes.key?(:'number')
+        self.number = attributes[:'number']
+      end
+
+      if attributes.key?(:'cude')
+        self.cude = attributes[:'cude']
+      end
+
+      if attributes.key?(:'issue_date')
+        self.issue_date = attributes[:'issue_date']
+      end
+
+      if attributes.key?(:'document_type')
+        self.document_type = attributes[:'document_type']
+      end
+
+      if attributes.key?(:'total')
+        self.total = attributes[:'total']
+      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
+      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'
+      document_type_validator = EnumAttributeValidator.new('String', ["20", "25", "27", "30", "35", "40", "45", "50", "55", "60", "unknown_default_open_api"])
+      return false unless document_type_validator.valid?(@document_type)
+      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', ["20", "25", "27", "30", "35", "40", "45", "50", "55", "60", "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
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          id == o.id &&
+          number == o.number &&
+          cude == o.cude &&
+          issue_date == o.issue_date &&
+          document_type == o.document_type &&
+          total == o.total
+    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
+      [id, number, cude, issue_date, document_type, total].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/equivalent_item.rb

@@ -0,0 +1,387 @@
+=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 EquivalentItem < ApiModelBase
+    # Código (texto).
+    attr_accessor :code
+
+    attr_accessor :description
+
+    # Unidad de medida (tabla 13.3.6). Por defecto 94 (unidad).
+    attr_accessor :unit
+
+    # Número o texto decimal con punto («150000.50»).
+    attr_accessor :quantity
+
+    # Precio unitario SIN impuestos.
+    attr_accessor :unit_price
+
+    # Impuestos de la línea: {code, rate} porcentual, {code: \"01\", excluded: true} o nominal {code, unit_amount, unit?, quantity?}.
+    attr_accessor :taxes
+
+    attr_accessor :discounts
+
+    attr_accessor :charges
+
+    # Retenciones (informativas): 05 ReteIVA, 06 ReteRenta, 07 ReteICA.
+    attr_accessor :withholdings
+
+    attr_accessor :free_of_charge
+
+    attr_accessor :standard_code
+
+    attr_accessor :brand
+
+    attr_accessor :model
+
+    # Mandatos (tabla 16.16): \"own\" (por defecto), \"collected\" (ingreso recaudado para terceros) o \"third_party\" (facturado para terceros); los dos últimos con `mandator`. En 272 y 274 la línea del mandante va con \"collected\".
+    attr_accessor :income
+
+    # El mandante de un ingreso para terceros (con NIT en 272 y 274).
+    attr_accessor :mandator
+
+    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
+      {
+        :'code' => :'code',
+        :'description' => :'description',
+        :'unit' => :'unit',
+        :'quantity' => :'quantity',
+        :'unit_price' => :'unit_price',
+        :'taxes' => :'taxes',
+        :'discounts' => :'discounts',
+        :'charges' => :'charges',
+        :'withholdings' => :'withholdings',
+        :'free_of_charge' => :'free_of_charge',
+        :'standard_code' => :'standard_code',
+        :'brand' => :'brand',
+        :'model' => :'model',
+        :'income' => :'income',
+        :'mandator' => :'mandator'
+      }
+    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
+      {
+        :'code' => :'String',
+        :'description' => :'String',
+        :'unit' => :'String',
+        :'quantity' => :'String',
+        :'unit_price' => :'String',
+        :'taxes' => :'Array<ItemTax>',
+        :'discounts' => :'Array<ItemAllowance>',
+        :'charges' => :'Array<ItemAllowance>',
+        :'withholdings' => :'Array<ItemWithholding>',
+        :'free_of_charge' => :'FreeOfCharge',
+        :'standard_code' => :'StandardCode',
+        :'brand' => :'String',
+        :'model' => :'String',
+        :'income' => :'String',
+        :'mandator' => :'ItemMandator'
+      }
+    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::EquivalentItem` 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::EquivalentItem`. 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?(:'code')
+        self.code = attributes[:'code']
+      end
+
+      if attributes.key?(:'description')
+        self.description = attributes[:'description']
+      else
+        self.description = nil
+      end
+
+      if attributes.key?(:'unit')
+        self.unit = attributes[:'unit']
+      end
+
+      if attributes.key?(:'quantity')
+        self.quantity = attributes[:'quantity']
+      else
+        self.quantity = nil
+      end
+
+      if attributes.key?(:'unit_price')
+        self.unit_price = attributes[:'unit_price']
+      else
+        self.unit_price = nil
+      end
+
+      if attributes.key?(:'taxes')
+        if (value = attributes[:'taxes']).is_a?(Array)
+          self.taxes = value
+        end
+      end
+
+      if attributes.key?(:'discounts')
+        if (value = attributes[:'discounts']).is_a?(Array)
+          self.discounts = value
+        end
+      end
+
+      if attributes.key?(:'charges')
+        if (value = attributes[:'charges']).is_a?(Array)
+          self.charges = value
+        end
+      end
+
+      if attributes.key?(:'withholdings')
+        if (value = attributes[:'withholdings']).is_a?(Array)
+          self.withholdings = value
+        end
+      end
+
+      if attributes.key?(:'free_of_charge')
+        self.free_of_charge = attributes[:'free_of_charge']
+      end
+
+      if attributes.key?(:'standard_code')
+        self.standard_code = attributes[:'standard_code']
+      end
+
+      if attributes.key?(:'brand')
+        self.brand = attributes[:'brand']
+      end
+
+      if attributes.key?(:'model')
+        self.model = attributes[:'model']
+      end
+
+      if attributes.key?(:'income')
+        self.income = attributes[:'income']
+      end
+
+      if attributes.key?(:'mandator')
+        self.mandator = attributes[:'mandator']
+      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 @description.nil?
+        invalid_properties.push('invalid value for "description", description cannot be nil.')
+      end
+
+      if @quantity.nil?
+        invalid_properties.push('invalid value for "quantity", quantity cannot be nil.')
+      end
+
+      if @unit_price.nil?
+        invalid_properties.push('invalid value for "unit_price", unit_price 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 @description.nil?
+      return false if @quantity.nil?
+      return false if @unit_price.nil?
+      income_validator = EnumAttributeValidator.new('String', ["own", "collected", "third_party", "unknown_default_open_api"])
+      return false unless income_validator.valid?(@income)
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] description Value to be assigned
+    def description=(description)
+      if description.nil?
+        fail ArgumentError, 'description cannot be nil'
+      end
+
+      @description = description
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] quantity Value to be assigned
+    def quantity=(quantity)
+      if quantity.nil?
+        fail ArgumentError, 'quantity cannot be nil'
+      end
+
+      @quantity = quantity
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] unit_price Value to be assigned
+    def unit_price=(unit_price)
+      if unit_price.nil?
+        fail ArgumentError, 'unit_price cannot be nil'
+      end
+
+      @unit_price = unit_price
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] income Object to be assigned
+    def income=(income)
+      validator = EnumAttributeValidator.new('String', ["own", "collected", "third_party", "unknown_default_open_api"])
+      unless validator.valid?(income)
+        fail ArgumentError, "invalid value for \"income\", must be one of #{validator.allowable_values}."
+      end
+      @income = income
+    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 &&
+          code == o.code &&
+          description == o.description &&
+          unit == o.unit &&
+          quantity == o.quantity &&
+          unit_price == o.unit_price &&
+          taxes == o.taxes &&
+          discounts == o.discounts &&
+          charges == o.charges &&
+          withholdings == o.withholdings &&
+          free_of_charge == o.free_of_charge &&
+          standard_code == o.standard_code &&
+          brand == o.brand &&
+          model == o.model &&
+          income == o.income &&
+          mandator == o.mandator
+    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
+      [code, description, unit, quantity, unit_price, taxes, discounts, charges, withholdings, free_of_charge, standard_code, brand, model, income, mandator].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