alegra 0.1.2.3 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 2eebfa19e7125975a60aa3d57bd38817c402a169
-  data.tar.gz: ef3b5aada690c7d468aeb9b2688c8ed323a819f1
+SHA256:
+  metadata.gz: 3fa2da362476c72c6570864ecd2c5515da43397835d85ab2d32cb66e7f5a2191
+  data.tar.gz: 8b3d7fe929ecb25a180559a7d3ff73e3124b4c691342c2777b2c2f95f9b7231e
 SHA512:
-  metadata.gz: 66974059e3819c72e44e7d107ec767c63ef98afbd7ff7f60b287468d100d87ad8f00f042194dd790e0619e0da371a06da55aa03ff13734bdfd26a97a83258260
-  data.tar.gz: a2beb44ae7e5fa57e118bf7f884f645eef2be736f50b6c4d2dffef9236c7265d89620311a5856048850f3c5304cc8bf56daf816de5969f4ce6462201ae52a3d0
+  metadata.gz: 30132d66010ea6b67b215c0625d154bf981d5676411a8876508d7ee441f22ab2babcf2a00dab3ae083b024ac0fb14d34bc76c1560aeb4a1a9bab1a7ad6826569
+  data.tar.gz: '068d64aa6e41c66886d53e1d779ccade60a008236af7db598249457ea768694dbf03001d8802c39e25e7eb1b2e4e77ffcadf6cb840d92521b1538d9ae863bd69'

data/.gitignore

@@ -7,3 +7,4 @@
 /pkg/
 /spec/reports/
 /tmp/
+.byebug_history

data/Gemfile

@@ -1,4 +1,6 @@
+# frozen_string_literal: true
+
 source 'https://rubygems.org'
 
 # Specify your gem's dependencies in alegra.gemspec
- gemspec
+gemspec

data/README.md

@@ -1,8 +1,9 @@
 # Alegra
+[![Build Status](https://travis-ci.org/degzcs/alegra.svg?branch=master)](https://travis-ci.org/degzcs/alegra)
 
-A ruby client for connecting to [Alegra](http://www.alegra.com)'s API. 
+A ruby client for connecting to [Alegra](http://www.alegra.com)'s API.
 
-Please check the official API documentation [here](http://developer.alegra.com/) 
+Please check the official API documentation [here](http://developer.alegra.com/)
 
 ## Installation
 
@@ -14,7 +15,7 @@ gem 'alegra'
 
 And then execute:
 
-    $ bundle install 
+    $ bundle install
 
 Or install it yourself as:
 
@@ -51,7 +52,7 @@ client.contacts.create(params)
 ```
 
 You can update this contact too:
-```ruby 
+```ruby
 params = {
   name: 'Sinc Hompas'
 }
@@ -59,7 +60,7 @@ client.contacts.update(1, params)
 ```
 
 Or delete it, as follows:
-```ruby 
+```ruby
 client.contacts.delete(1)
 ```
 
@@ -87,7 +88,7 @@ client.items.create(params)
 ```
 
 You can update this item too:
-```ruby 
+```ruby
 params = {
   name: 'A better name!',
 }
@@ -95,14 +96,14 @@ client.items.update(1, params)
 ```
 
 Or delete it, as follows:
-```ruby 
+```ruby
 client.items.delete(1)
 ```
 
-### Invoices 
+### Invoices
 
 You can get all invoices:
-```ruby 
+```ruby
 client.invoices.list()
 ```
 
@@ -147,7 +148,7 @@ client.invoices.create(params)
 ```
 
 Update that invoice:
-```ruby 
+```ruby
 params = { observations: 'This invoice was updated!'}
 client.invoices.update(1, params)
 ```
@@ -157,11 +158,151 @@ Send that invoice by email:
 params = { emails: ['your.email@alegra.com', 'another.eail@algra.com'], send_copy_to_user: true, invoice_type: 'copy'}
 client.invoices.send_by_email(1, params)
 ```
+
+### Payments
+
+You can get all payments:
+```ruby
+client.payments.list()
+```
+
+Or get a specific payment by id:
+```ruby
+client.payments.find(1) # the parameter is the payment id
+```
+
+Also you are able to create a new payments, as follows:
+```ruby
+params = {
+  date: "2015-12-13",
+  invoices: [
+    {
+      id: 6,
+      amount: 150
+    },
+    {
+      id: 200,
+      amount: 500
+    }
+  ],
+  bank_account: 1
+}
+
+client.payments.create(params)
+```
+### Company
+
+You can get the company:
+```ruby
+client.company.find
+```
+
+Also you can update it, as follows:
+```ruby
+params = { website: 'nominapp.com' }
+
+client.company.update(params)
+```
+
+### Users
+
+You can get the users:
+```ruby
+client.users.list
+```
+
+Also you can retrive a specific user by doing:
+```ruby
+client.users.find(1)
+```
+
+Lastly you can retrive the current user, as follows:
+```ruby
+client.users.find_current
+```
+
+### Categories
+
+You can get all the categories on the client account like this:
+```ruby
+client.categories.list #this will retrieve the tree format by default
+```
+Or if you prefer the plain format from the Alegra API just pass it as a paramater:
+```ruby
+client.categories.list(format: 'plain')
+```
+You can also retrive a specific category, as follows:
+```ruby
+client.categories.find('5047')
+```
+
+### BankAccounts
+
+To retrive all bank accounts:
+```ruby
+client.bank_accounts.list
+```
+Or get a specific bank_account by id:
+```ruby
+client.bank_accounts.find(2)
+```
+Also you are able to create a new bank accounts, as follows:
+```ruby
+params = { name: 'test',
+           type: 'bank',
+           initial_balance: '100000',
+           initial_balance_date: '2020-02-25' }
+
+client.bank_accounts.create(params)
+```
+And to create a bank transfer between accounts:
+```ruby
+params = { id_destination: 4, # 4 is the destination bank_account_id
+           amount: 100000,
+           date: '2020-02-25' }
+client.bank_accounts.transfer(7, params) # 7 is the origin bank_account_id
+```
+
+### Journals
+
+To retrive all existing journals:
+```ruby
+client.journals.list
+```
+Or get a specif journal by `:id`:
+```ruby
+client.journals.find(191)
+```
+You can create journals too, as follows:
+```ruby
+params = { date: Date.today.strftime("%Y-%m-%d"),
+           client: '416',
+           entries: [{ id: '5009', debit: 3_000_000 },
+                     { id: '5048', credit: 4_250_660 },
+                     { id: '5008', debit: 755_000 },
+                     { id: '5010', debit: 495_660 }] }
+
+client.journals.create(params)
+```
+Or update them like this:
+```ruby
+params = { client: '416'
+           entries: [{ id: '5009', debit: 3_000_000 },
+                     { id: '5048', credit: 4_150_660 },
+                     { id: '5008', debit: 655_000 },
+                     { id: '5010', debit: 495_660 }] }
+
+client.journals.update(193, params) # Where 193 is the :id of the journal in Alegra
+```
+Lastly you can delete journals, by doing the following:
+```ruby
+client.journals.delete(193, params) # Where 193 is the :id of the journal in Alegra
+```
 ## Development
 
-This gem is under construction and I'm writing it as I would like to use it. However, if you have any recommendation is well received. 
+This gem is under construction and I'm writing it with the goal that it will easy to use. However, if you have any recommendation is well received.
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rspec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
@@ -169,11 +310,18 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/degzcs/alegra. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
-## License
+## TODO
+The next endpoints are pending:
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
-
-## Contributors
+- Estimates
+- Number templates
+- Retentions
+- Sellers
+- payments
+  - cancel payment(void)
+  - open payment convert  https://developer.alegra.com/docs/convertir-pago-a-abierto
+  - Add attachment https://developer.alegra.com/docs/adjuntar-archivos-a-pagos
 
-- Diego Gomez
+## License
 
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/alegra.gemspec

@@ -21,13 +21,12 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.13"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec", "~> 3.0"
-  spec.add_development_dependency "vcr", "~> 3"
-  spec.add_development_dependency "webmock", "~> 2.1"
-  spec.add_development_dependency "jazz_fingers", "~> 4"
-
-  spec.add_dependency "faraday", "~> 0.9"
-  spec.add_dependency "json", "~> 1.7"
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_dependency 'faraday', '~> 0.17.0'
+  spec.add_development_dependency 'jazz_fingers', '~> 5.0'
+  spec.add_dependency 'json', '~> 2.2'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec', '~> 3.9.0'
+  spec.add_development_dependency 'vcr', '~> 5.0'
+  spec.add_development_dependency 'webmock', '~> 3.7'
 end

data/bin/console

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 
-require "bundler/setup"
-require "alegra"
+require 'bundler/setup'
+require 'alegra'
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.
@@ -10,5 +10,19 @@ require "alegra"
 # require "pry"
 # Pry.start
 
+def reload!(print = true)
+  puts 'Reloading ...' if print
+  # Main project directory.
+  root_dir = File.expand_path('..', __dir__)
+  # Directories within the project that should be reloaded.
+  reload_dirs = %w{lib}
+  # Loop through and reload every file in all relevant project directories.
+  reload_dirs.each do |dir|
+    Dir.glob("#{root_dir}/#{dir}/**/*.rb").each { |f| load(f) }
+  end
+  # Return true when complete.
+  true
+end
+
 require "irb"
 IRB.start

data/lib/alegra/bank_accounts.rb

@@ -0,0 +1,21 @@
+module Alegra
+  class BankAccounts < Alegra::Record
+    def list(options = { format: :formated })
+      client.get('bank-accounts', {}, options)
+    end
+
+    def find(id, options = { format: :formated })
+      client.get("bank-accounts/#{id}", {}, options)
+    end
+
+    def create(params, options = { format: :formated })
+      params = params.deep_camel_case_lower_keys
+      client.post('bank-accounts', params, options)
+    end
+
+    def transfer(id, params, options = { format: :formated })
+      params = params.deep_camel_case_lower_keys
+      client.post("bank-accounts/#{id}/transfer", params, options)
+    end
+  end
+end

data/lib/alegra/categories.rb

@@ -0,0 +1,11 @@
+module Alegra
+  class Categories < Alegra::Record
+    def list(params = {}, options = { format: :formated })
+      client.get('categories', params, options)
+    end
+
+    def find(id, options = { format: :formated })
+      client.get("categories/#{id}", {}, options)
+    end
+  end
+end

data/lib/alegra/client.rb

@@ -1,8 +1,15 @@
 require 'alegra/setup'
 require 'alegra/request'
+require 'alegra/record'
 require 'alegra/invoices'
 require 'alegra/contacts'
 require 'alegra/items'
+require 'alegra/payments'
+require 'alegra/company'
+require 'alegra/users'
+require 'alegra/categories'
+require 'alegra/bank_accounts'
+require 'alegra/journals'
 
 module Alegra
   class Client
@@ -10,36 +17,60 @@ module Alegra
       @setup = Alegra::Setup.new(username, apikey, debug)
     end
 
-    def get(url, params={})
+    def get(url, params = {}, options = { format: :formated })
       request = Alegra::Request.new(@setup.host, @setup.path, @setup.token)
-      request.get(url, params)
+      request.get(url, params, options)
     end
 
-    def post(url, params={})
+    def post(url, params = {}, options = { format: :formated })
       request = Alegra::Request.new(@setup.host, @setup.path, @setup.token)
-      request.post(url, params)
+      request.post(url, params, options)
     end
 
-    def put(url, params={})
+    def put(url, params={}, options = { format: :formated })
       request = Alegra::Request.new(@setup.host, @setup.path, @setup.token)
-      request.put(url, params)
+      request.put(url, params, options)
     end
 
-    def delete(url, params={})
+    def delete(url, params={}, options = { format: :formated })
       request = Alegra::Request.new(@setup.host, @setup.path, @setup.token)
-      request.delete(url, params)
-    end
-
-    def invoices
-      Alegra::Invoices.new(self)
+      request.delete(url, params, options)
     end
 
     def contacts
       Alegra::Contacts.new(self)
     end
 
+    def invoices
+      Alegra::Invoices.new(self)
+    end
+
     def items
       Alegra::Items.new(self)
     end
+
+    def payments
+      Alegra::Payments.new(self)
+    end
+
+    def company
+      Alegra::Company.new(self)
+    end
+
+    def users
+      Alegra::Users.new(self)
+    end
+
+    def categories
+      Alegra::Categories.new(self)
+    end
+
+    def bank_accounts
+      Alegra::BankAccounts.new(self)
+    end
+
+    def journals
+      Alegra::Journals.new(self)
+    end
   end
 end

data/lib/alegra/company.rb

@@ -0,0 +1,12 @@
+module Alegra
+  class Company < Alegra::Record
+    def find(options = { format: :formated })
+      client.get('company', {}, options)
+    end
+
+    def update(params, options = { format: :formated })
+      sanitize_params = params.deep_camel_case_lower_keys
+      client.put('company', sanitize_params, options)
+    end
+  end
+end

data/lib/alegra/contacts.rb

@@ -1,21 +1,25 @@
 module Alegra
-  class Contacts
-    attr_reader :client
-
-    def initialize(client)
-      @client = client
-    end
-
-    # @param id [ Interger ]
+  class Contacts < Alegra::Record
+    # @param id [ Integer ]
     # @return [ Hash ]
     def find(id)
       client.get("contacts/#{ id }")
     end
 
     # Returs all contacts
+    # @param params [ Hash ]
+    #   - start [ Integer ]
+    #   - limit [ Integer ]
+    #   - order_direction [ String ]
+    #   - order_field [ string ]
+    #   - query [ String ]
+    #   - type [ Integer ]
+    #   - metadata [ Boolean ]
+    #   - name [ String ]
+    #   - identification [ String ]
     # @return [ Array ]
-    def list()
-      client.get('contacts')
+    def list(params = {})
+      client.get('contacts', params)
     end
 
     # @param params [ Hash ]
@@ -36,8 +40,8 @@ module Alegra
     #   - internal_contacts [ Array ]
     # @return [ Hash ]
     def create(params)
-      _params = params.deep_camel_case_lower_keys
-      client.post('contacts', _params)
+      params = params.deep_camel_case_lower_keys
+      client.post('contacts', params)
     end
 
     # @param id [ Integer ]
@@ -59,14 +63,15 @@ module Alegra
     #   - internal_contacts [ Array ]
     # @return [ Hash ]
     def update(id, params)
-      _params = params.deep_camel_case_lower_keys
-      client.put("contacts/#{ id }", _params)
+      sanitize_params = params.deep_camel_case_lower_keys
+      client.put("contacts/#{id}", sanitize_params)
+
     end
 
     # @param id [ Integer ]
     # @return [ Hash ]
     def delete(id)
-      client.delete("contacts/#{ id }")
+      client.delete("contacts/#{id}")
     end
   end
-end
+end

data/lib/alegra/invoices.rb

@@ -1,21 +1,28 @@
 module Alegra
-  class Invoices
-    attr_reader :client
-
-    def initialize(client)
-      @client = client
-    end
-
-    # @param id [ Interger ]
+  class Invoices < Alegra::Record
+    # @param id [ Integer ]
     # @return [ Hash ]
     def find(id)
-      client.get("invoices/#{ id }")
+      client.get("invoices/#{id}")
     end
 
     # Returs all invoices
+    # @param params [ Hash ]
+    #   - start [ Integer ]
+    #   - limit [ Integer ]
+    #   - order_direction [ String ]
+    #   - order_field [ string ]
+    #   - metadata [ Boolean ]
+    #   - id [ Integer ]
+    #   - date [ String  ]
+    #   - due_date [ String ]
+    #   - status [ String ]
+    #   - client_name [ String ]
+    #   - client_identification [ String ]
+    #   - number_template_full_number
     # @return [ Array ]
-    def list()
-      client.get('invoices')
+    def list(params = {})
+      client.get('invoices', params)
     end
 
     # Creates a invoice
@@ -36,8 +43,8 @@ module Alegra
     #   - seller [ String ]
     # @return [ Hash ]
     def create(params)
-      _params = params.deep_camel_case_lower_keys
-      client.post('invoices', _params)
+      sanitize_params = params.deep_camel_case_lower_keys
+      client.post('invoices', sanitize_params)
     end
 
     # Creates a invoice
@@ -58,8 +65,8 @@ module Alegra
     #   - seller [ String ]
     # @return [ Hash ]
     def update(id, params)
-      _params = params.deep_camel_case_lower_keys
-      client.put("invoices/#{ id }", _params)
+      sanitize_params = params.deep_camel_case_lower_keys
+      client.put("invoices/#{id}", sanitize_params)
     end
 
     # @param id [ Integer ]
@@ -69,8 +76,8 @@ module Alegra
     #  - invoiceType [ String ]
     # @return [ Hash ]
     def send_by_email(id, params)
-      _params = params.deep_camel_case_lower_keys
-      client.post("invoices/#{ id }/email", _params)
+      sanitize_params = params.deep_camel_case_lower_keys
+      client.post("invoices/#{id}/email", sanitize_params)
     end
   end
 end

data/lib/alegra/items.rb

@@ -1,12 +1,6 @@
 module Alegra
-  class Items
-    attr_reader :client
-
-    def initialize(client)
-      @client = client
-    end
-
-    # @param id [ Interger ]
+  class Items < Alegra::Record
+    # @param id [ Integer ]
     # @return [ Hash ]
     def find(id)
       client.get("items/#{ id }")
@@ -53,4 +47,4 @@ module Alegra
       client.delete("items/#{ id }")
     end
   end
-end
+end

data/lib/alegra/journals.rb

@@ -0,0 +1,25 @@
+module Alegra
+  class Journals < Alegra::Record
+    def find(id)
+      client.get("journals/#{id}")
+    end
+
+    def list(params = {})
+      client.get('journals', params)
+    end
+
+    def create(params)
+      params = params.deep_camel_case_lower_keys
+      client.post('journals', params)
+    end
+
+    def update(id, params)
+      params = params.deep_camel_case_lower_keys
+      client.put("journals/#{id}", params)
+    end
+
+    def delete(id)
+      client.delete("journals/#{id}")
+    end
+  end
+end

data/lib/alegra/payments.rb

@@ -0,0 +1,70 @@
+module Alegra
+  class Payments < Alegra::Record
+    # @param id [ Integer ]
+    # @return [ Hash ]
+    def find(id)
+      client.get("payments/#{id}")
+    end
+
+    # Returs all payments
+    # @param params [ Hash ]
+    #   - start [ Integer ]
+    #   - limit [ Integer ]
+    #   - order_direction [ String ]
+    #   - order_field [ string ]
+    #   - type [ Integer ]
+    #   - metadata [ Boolean ]
+    #   - id [ Integer ]
+    # @return [ Array ]
+    def list(params = {})
+      client.get('payments', params)
+    end
+
+    # Creates a payment
+    # @param params [ Hash ]
+    #   - date [ String ]
+    #   - bank_account [ Integer ] or [ Hash ]
+    #   - payment_method [ String ]
+    #   - observations [ String  ]
+    #   - anotation [ String ]
+    #   - type [ String ]
+    #   - client [ Integer ] or [ Hash ]
+    #   - invoices [ Array ]
+    #   - bills [ Array ]
+    #   - categories [ Array ]
+    #   - retentions [ Array ]
+    #   - currency [ Array ]
+    # @return [ Hash ]
+    def create(params)
+      sanitize_params = params.deep_camel_case_lower_keys
+      client.post('payments', sanitize_params)
+    end
+
+    # Update a payment
+    # @param id [ Integer ]
+    # @param params [ Hash ]
+    #   - date [ String ]
+    #   - bank_account [ Integer ] or [ Hash ]
+    #   - payment_method [ String ]
+    #   - observations [ String  ]
+    #   - anotation [ String ]
+    #   - type [ String ]
+    #   - client [ Integer ] or [ Hash ]
+    #   - invoices [ Array ]
+    #   - bills [ Array ]
+    #   - categories [ Array ]
+    #   - retentions [ Array ]
+    #   - currency [ Array ]
+    # @return [ Hash ]
+    def update(id, params)
+      sanitize_params = params.deep_camel_case_lower_keys
+      client.put("payments/#{id}", sanitize_params)
+    end
+
+    # @param id [ Integer ]
+    # @return [ Hash ]
+    def delete(id)
+      client.delete("payments/#{id}")
+    end
+  end
+end

data/lib/alegra/record.rb

@@ -0,0 +1,9 @@
+module Alegra
+  class Record
+    attr_reader :client
+
+    def initialize(client)
+      @client = client
+    end
+  end
+end

data/lib/alegra/request.rb

@@ -9,32 +9,31 @@ module Alegra
       @session = Faraday.new url: host
     end
 
-    def get(url, params={})
-        params = JSON.generate(params)
-        response = @session.get do |req|
-          req.url "#{ @path }#{ url }"
-          req.headers['Content-Type'] = 'application/json'
-          req.headers['Accept'] = 'application/json'
-          req.headers['Authorization'] = "Basic #{ @token }"
-        end
-        cast_error(response) unless (response.status == 200 || response.status == 201)
-        return Alegra::Response.new(response.body).call
+    def get(url, params = {}, options = { format: :formated })
+      params = URI.encode_www_form(params)
+
+      response = @session.get do |req|
+        req.url "#{@path}#{url}?#{params}"
+        req.headers['Content-Type'] = 'application/json'
+        req.headers['Accept'] = 'application/json'
+        req.headers['Authorization'] = "Basic #{@token}"
+      end
+      response_of_request(response, options)
     end
 
-    def post(url, params={})
-        params = JSON.generate(params)
-        response = @session.post do |req|
-          req.url "#{ @path }#{ url }"
-          req.headers['Content-Type'] = 'application/json'
-          req.headers['Accept'] = 'application/json'
-          req.headers['Authorization'] = "Basic #{ @token }"
-          req.body = params
-        end
-        cast_error(response) unless (response.status == 200 || response.status == 201)
-        return Alegra::Response.new(response.body).call
+    def post(url, params = {}, options = { format: :formated })
+      params = JSON.generate(params)
+      response = @session.post do |req|
+        req.url "#{ @path }#{ url }"
+        req.headers['Content-Type'] = 'application/json'
+        req.headers['Accept'] = 'application/json'
+        req.headers['Authorization'] = "Basic #{ @token }"
+        req.body = params
+      end
+      response_of_request(response, options)
     end
 
-    def put(url, params={})
+    def put(url, params={}, options = { format: :formated })
       params = JSON.generate(params)
       response = @session.put do |req|
         req.url "#{ @path }#{ url }"
@@ -43,12 +42,10 @@ module Alegra
         req.headers['Authorization'] = "Basic #{ @token }"
         req.body = params
       end
-      cast_error(response) unless (response.status == 200 || response.status == 201)
-      return Alegra::Response.new(response.body).call
+      response_of_request(response, options)
     end
 
-
-    def delete(url, params={})
+    def delete(url, params={}, options = { format: :formated })
       params = JSON.generate(params)
       response = @session.delete do |req|
         req.url "#{ @path }#{ url }"
@@ -57,12 +54,28 @@ module Alegra
         req.headers['Authorization'] = "Basic #{ @token }"
         req.body = params
       end
-      cast_error(response) unless (response.status == 200 || response.status == 201)
-      return Alegra::Response.new(response.body).call
+      response_of_request(response, options)
     end
 
-    def cast_error(response)
+    private
+
+    def response_of_request(response, options = { format: :formated })
+      cast_error(response, options) unless response.status == 200 || response.status == 201
+
+      raise_invalid_format options[:format]
+
+      return response if options[:format] == :raw
+
+      Alegra::Response.new(response.body).call
+    end
+
+    def cast_error(response, options = { format: :formated })
+      raise_invalid_format options[:format]
+
+      return response if options[:format] == :raw
+
       message = response.body.empty? ? response.body : Alegra::Response.new(response.body).call['message']
+
       error_map = {
         500 => 'Sever error! Something were wrong in the server.',
         400 => "Bad request!, #{ message }",
@@ -74,5 +87,12 @@ module Alegra
       }
       raise StandardError, "Status: #{ response.status }. Error: #{ error_map[response.status] }"
     end
+
+    def raise_invalid_format(format)
+      return if %i[formated raw].include?(format)
+      return if format.nil?
+
+      raise StandardError, "#{format} is not a valid format, valid_formats[:formated, :raw]"
+    end
   end
-end
+end

data/lib/alegra/response.rb

@@ -16,4 +16,4 @@ module Alegra
       end
     end
   end
-end
+end

data/lib/alegra/setup.rb

@@ -38,7 +38,7 @@ module Alegra
     end
 
     def create_token!
-      @token = ::Base64.encode64("#{@username}:#{@apikey}")
+      @token = ::Base64.strict_encode64("#{@username}:#{@apikey}")
     end
   end
 end

data/lib/alegra/users.rb

@@ -0,0 +1,15 @@
+module Alegra
+  class Users < Alegra::Record
+    def list(options = { format: :formated })
+      client.get('users', {}, options)
+    end
+
+    def find(id, options = { format: :formated })
+      client.get("users/#{id}", {}, options)
+    end
+
+    def find_current(options = { format: :formated })
+      client.get('users/self', {}, options)
+    end
+  end
+end

data/lib/alegra/version.rb

@@ -1,3 +1,3 @@
 module Alegra
-  VERSION = "0.1.2.3"
+  VERSION = "0.4.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: alegra
 version: !ruby/object:Gem::Version
-  version: 0.1.2.3
+  version: 0.4.1
 platform: ruby
 authors:
 - Diego Gomez
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-10-27 00:00:00.000000000 Z
+date: 2020-03-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,112 +16,112 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.13'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.13'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
-  type: :development
+        version: 0.17.0
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 0.17.0
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: jazz_fingers
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '5.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '5.0'
 - !ruby/object:Gem::Dependency
-  name: vcr
+  name: json
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3'
-  type: :development
+        version: '2.2'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3'
+        version: '2.2'
 - !ruby/object:Gem::Dependency
-  name: webmock
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
-  name: jazz_fingers
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4'
+        version: 3.9.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4'
+        version: 3.9.0
 - !ruby/object:Gem::Dependency
-  name: faraday
+  name: vcr
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
-  type: :runtime
+        version: '5.0'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '5.0'
 - !ruby/object:Gem::Dependency
-  name: json
+  name: webmock
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
-  type: :runtime
+        version: '3.7'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '3.7'
 description: Gem to wrap Alegra API. This is unofficial gem (until now)
 email:
 - diego.f.gomez.pardo@gmail.com
@@ -141,14 +141,21 @@ files:
 - bin/console
 - bin/setup
 - lib/alegra.rb
+- lib/alegra/bank_accounts.rb
+- lib/alegra/categories.rb
 - lib/alegra/client.rb
+- lib/alegra/company.rb
 - lib/alegra/contacts.rb
 - lib/alegra/formatters/underscore_formatter.rb
 - lib/alegra/invoices.rb
 - lib/alegra/items.rb
+- lib/alegra/journals.rb
+- lib/alegra/payments.rb
+- lib/alegra/record.rb
 - lib/alegra/request.rb
 - lib/alegra/response.rb
 - lib/alegra/setup.rb
+- lib/alegra/users.rb
 - lib/alegra/utilities/array.rb
 - lib/alegra/utilities/hash.rb
 - lib/alegra/utilities/string.rb
@@ -173,7 +180,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.7.3
 signing_key: 
 specification_version: 4
 summary: Gem to wrap Alegra API.