trevol 0.1.0

data/lib/trevol_generado/models/item.rb

@@ -0,0 +1,439 @@
+=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 Item < 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
+
+    # AIU (solo con `operation_type` \"09\"): \"A\" administración, \"I\" imprevistos, \"U\" utilidad. Solo en facturas.
+    attr_accessor :aiu
+
+    # El objeto del contrato AIU: solo en la línea A, y obligatorio en ella. Solo en facturas.
+    attr_accessor :aiu_contract
+
+    # Mandatos (11): \"own\" (por defecto) o \"third_party\" (con `mandator`). Solo en facturas.
+    attr_accessor :income
+
+    # El mandante de un ingreso para terceros. Solo en facturas.
+    attr_accessor :mandator
+
+    # La remesa del RNDC (transporte de carga, 12). Solo en facturas.
+    attr_accessor :consignment
+
+    # Matrícula inmobiliaria y valor comercial (notarios, 14). Solo en facturas.
+    attr_accessor :notary
+
+    # Propiedades libres de la línea (hasta 20; no en el transporte de carga). Solo en facturas.
+    attr_accessor :properties
+
+    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',
+        :'aiu' => :'aiu',
+        :'aiu_contract' => :'aiu_contract',
+        :'income' => :'income',
+        :'mandator' => :'mandator',
+        :'consignment' => :'consignment',
+        :'notary' => :'notary',
+        :'properties' => :'properties'
+      }
+    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',
+        :'aiu' => :'String',
+        :'aiu_contract' => :'String',
+        :'income' => :'String',
+        :'mandator' => :'ItemMandator',
+        :'consignment' => :'ItemConsignment',
+        :'notary' => :'ItemNotary',
+        :'properties' => :'Array<ItemProperty>'
+      }
+    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::Item` 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::Item`. 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?(:'aiu')
+        self.aiu = attributes[:'aiu']
+      end
+
+      if attributes.key?(:'aiu_contract')
+        self.aiu_contract = attributes[:'aiu_contract']
+      end
+
+      if attributes.key?(:'income')
+        self.income = attributes[:'income']
+      end
+
+      if attributes.key?(:'mandator')
+        self.mandator = attributes[:'mandator']
+      end
+
+      if attributes.key?(:'consignment')
+        self.consignment = attributes[:'consignment']
+      end
+
+      if attributes.key?(:'notary')
+        self.notary = attributes[:'notary']
+      end
+
+      if attributes.key?(:'properties')
+        if (value = attributes[:'properties']).is_a?(Array)
+          self.properties = value
+        end
+      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", "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", "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 &&
+          aiu == o.aiu &&
+          aiu_contract == o.aiu_contract &&
+          income == o.income &&
+          mandator == o.mandator &&
+          consignment == o.consignment &&
+          notary == o.notary &&
+          properties == o.properties
+    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, aiu, aiu_contract, income, mandator, consignment, notary, properties].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/item_allowance.rb

@@ -0,0 +1,190 @@
+=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 ItemAllowance < ApiModelBase
+    # Código (texto).
+    attr_accessor :code
+
+    attr_accessor :reason
+
+    # Número o texto decimal con punto («150000.50»).
+    attr_accessor :percent
+
+    # Número o texto decimal con punto («150000.50»).
+    attr_accessor :amount
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'code' => :'code',
+        :'reason' => :'reason',
+        :'percent' => :'percent',
+        :'amount' => :'amount'
+      }
+    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',
+        :'reason' => :'String',
+        :'percent' => :'String',
+        :'amount' => :'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::ItemAllowance` 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::ItemAllowance`. 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?(:'reason')
+        self.reason = attributes[:'reason']
+      end
+
+      if attributes.key?(:'percent')
+        self.percent = attributes[:'percent']
+      end
+
+      if attributes.key?(:'amount')
+        self.amount = attributes[:'amount']
+      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'
+      true
+    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 &&
+          reason == o.reason &&
+          percent == o.percent &&
+          amount == o.amount
+    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, reason, percent, amount].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