belvo 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d7c835bc36e3ffa4aed0c08effb1c7a7ec0f64b46955f4fb59bd9bd4aabd6e98
-  data.tar.gz: 24fa5cb7a3ec5b0581eac4b04b2e58ffa9a08bd332d91512b0d33641a3185264
+  metadata.gz: 2451a25febe9bcc2e507d13977720f0886f89da8ff9e65d639846ca029717a53
+  data.tar.gz: 0ab5eb4ff9f6196ebc876011f3485e4bcba7a7888cbd20264f0abaaf9380e158
 SHA512:
-  metadata.gz: 7f7843ca0c81834407decbcccc5a136ad29800041c4d5a090cfae523a27521e0aa0e8a44abd69310ad01aa403a80114341e7735ac9168fa53f6345eb1336146e
-  data.tar.gz: 1fc654b148a1c0ff31480f593741064371baefef276d7e7df2f70d74fbe95dd8e31e15cf49e109f0468e48060d05d2b923b6a375675cf7c78d6771c1265ef0c3
+  metadata.gz: 0ecbbb2a7c36121c8f9bfffdb5dddc4e4d2eb9065e3405ae0574736c808b2d24796c292dfc98a2b50d3431875d8b25bf6db5aea9946f765f5a1dca3acf5fd4d9
+  data.tar.gz: 90490528e75a6cca01484b74094c750368191b726ad36530912c27dc560c49ae85b19856cb462947d6da9f07bce3eff5169265cb206e07a938eead59d3bd9ab1

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    belvo (1.2.0)
+    belvo (1.3.0)
       faraday
       faraday_middleware
       typhoeus

data/lib/belvo/options.rb

@@ -152,6 +152,19 @@ module Belvo
   )
   end
 
+  # @!class TaxDeclarationOptions < Faraday::Options
+  # Contains configurable properties of a TaxDeclaration
+  # @!attribute save_data [rw] Should data be persisted or not.
+  # @!attribute token [rw] OTP token required by the institution
+  # @!attribute attach_pdf [rw] Should the PDF file be included in the
+  #   response or not.
+  class TaxDeclarationOptions < Faraday::Options.new(
+    :token,
+    :save_data,
+    :attach_pdf
+  )
+  end
+
   # @!class TaxRetentionsOptions < Faraday::Options
   # Contains configurable properties of a tax retention
   # @!attribute save_data [rw] Indicates whether or not to persist the

data/lib/belvo/resources.rb

@@ -491,6 +491,37 @@ module Belvo
     end
   end
 
+  # A Tax declaration is the representation of the tax declaration document sent
+  # every year by a person or a business to the tax authority in the country.
+  class TaxDeclaration < Resource
+    def initialize(session)
+      super(session)
+      @endpoint = 'api/tax-declarations/'
+    end
+
+    # Retrieve tax declaration information for a specific fiscal link.
+    # @param link [String] Link UUID
+    # @param year_from [Integer]
+    # @param year_to [Integer]
+    # @param options [TaxDeclarationOptions] Configurable properties
+    # @return [Hash] created tax declarations details
+    # @raise [RequestError] If response code is different than 2XX
+    def retrieve(link:, year_from:, year_to:, options: nil)
+      options = TaxDeclarationOptions.from(options)
+      body = {
+        link: link,
+        year_from: year_from,
+        year_to: year_to,
+        token: options.token,
+        save_data: options.save_data || true,
+        attach_pdf: options.attach_pdf
+      }.merge(options)
+
+      body = clean body: body
+      @session.post(@endpoint, body)
+    end
+  end
+
   # A tax retention is the amount of money that the payer must deduct from the
   # total amount of a purchase invoice, according to the regulations of the
   # fiscal institution.

data/lib/belvo/version.rb

@@ -2,5 +2,5 @@
 
 module Belvo
   # belvo-ruby current version
-  VERSION = '1.2.0'
+  VERSION = '1.3.0'
 end

data/lib/belvo.rb

@@ -104,6 +104,12 @@ module Belvo
       @tax_returns = TaxReturn.new @session
     end
 
+    # Provides access to TaxDeclarations resource
+    # @return [TaxDeclaration]
+    def tax_declarations
+      @tax_declarations = TaxDeclaration.new @session
+    end
+
     # Provides access to TaxStatus resource
     # @return [TaxStatus]
     def tax_status

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: belvo
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Belvo Finance S.L.
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-09-28 00:00:00.000000000 Z
+date: 2022-11-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday