czech_banks_parser 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 90760afe5261a775da7b946a741ee042e2b5cd77
-  data.tar.gz: 5cc2a10717afe03b300b1d9a3ff5aed07b36ceb1
+  metadata.gz: 02b6f09487b8f5996d133e6508414c3b87c837e4
+  data.tar.gz: a46b19f3a24957b2cc3f38f204a82efc4c20c85e
 SHA512:
-  metadata.gz: ecdf88d215ded20ef1d3fd9053dd076099351cc11a21df63c68f5b8df18dd7dc21db61fb22ee58068397148ea12a8e90b940936655cefe168a0d945146e75b38
-  data.tar.gz: 37bc9c921fce49d6a3863a814a833590d5d1466254d121385bba532aaab7cfd7b179f132c87161cb0b7f5df8cb82ea5d7ec1c52dd5f541b47e10d31f06b318f5
+  metadata.gz: 65d26cfa0eb74655f38c81bbea70776226a47cc1f12bac70fb05aa717140d68802272ac98b32aa16ece3d882a58cffec94baeb0700889030ef33422cd220ab92
+  data.tar.gz: 942d9c93d29a309e7be7b06658699e7ffaf07ac3f81c8dfeb450a5967e5a7bc55d9dbedbddf40148d6042664461067b43f54baf17d0fe3758ca67bf3f3e6fee2

data/.gitignore

@@ -1,2 +1,2 @@
 .idea
-.gem
+*.gem

data/README.md

@@ -0,0 +1,96 @@
+Connect Czech banks FIO and CSAS with your Ruby application
+
+# Initializing API
+
+### FIO:
+
+```ruby
+
+token = 'sdiohsiodgsr75rg7e8r7gh' # FIO bank token
+
+@parser = CzechBanksParser.new.connect(token, 'fio')
+
+```
+
+### CSAS:
+
+```ruby
+
+token = 'sdiohsiodgsr75rg7e8r7gh' # CSAS Oauth2 refresh token
+
+opts = {}
+opts[:web_api_key] = CSAS_WEB_API_KEY
+opts[:client_id] = CSAS_CLIENT_ID
+opts[:secret] = CSAS_SECRET
+otps[:mode] = 'production' # or sandbox
+
+@parser = CzechBanksParser.new(opts).connect(token, 'csas')
+
+```
+
+
+# Downloading transactions
+
+
+```ruby
+
+date_from = Date.today - 1.week
+date_to = Date.today
+iban = 'CZ8788665897' # important only for CSAS
+
+@parser.transactions(date_from, date_to, iban).each do |tr|
+    # output: {trans_id: tr[:id], variable_symbol: tr[:variable_symbol], date: tr[:date], amount: tr[:amount], currency: tr[:currency], from_account: tr[:account], bank: tr[:bank], name: tr[:name], message: tr[:message]}
+end
+
+```
+
+# Other
+
+### Obtaining CSAS refresh token
+
+```ruby
+
+class BankTokensController < ApplicationController
+  load_resource :account
+  load_resource through: :account
+
+  def auth
+    config = parser.config(params[:state])
+    redirect_to "#{config[:auth_uri]}?state=profil&redirect_uri=#{callback_account_bank_tokens_url(@account)}&client_id=#{config[:client_id]}&response_type=code&access_type=offline"
+  end
+
+  def callback
+    config = parser.config('csas')
+    redirect_to "#{config[:token_uri]}?grant_type=authorization_code&code=#{params[:code]}&client_id=#{config[:client_id]}&client_secret=#{config[:secret]}&redirect_uri=#{get_token_account_bank_tokens_url(@account)}&state=csas"
+  end
+
+  def get_token
+    if params[:refresh_token].present?
+
+      ibans = parser.connect(params[:refresh_token], 'csas').ibans # get accounts ibans from CSAS
+
+      if ibans.include?(@account.bank_account.iban)
+        bt = @account.bank_tokens.new(bank: 'csas', token: params[:refresh_token], active: true)
+        bt.save!
+        redirect_to accounts_path, notice: t('bank_account_connected')
+      else
+        flash[:error] = t('no_iban_match', iban: @account.bank_account.iban, ibans: ibans.join(', '))
+        redirect_to accounts_path
+      end
+    end
+  end
+
+  private
+
+  def parser
+    CzechBanksParser.new({web_api_key: CSAS_WEB_API_KEY, client_id: CSAS_CLIENT_ID, secret: CSAS_SECRET})
+  end
+
+
+end
+
+```
+
+# About
+
+&copy; Author: Richard Lapiš

data/czech_banks_parser.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name               = "czech_banks_parser"
-  s.version            = "0.0.1"
+  s.version            = "0.0.2"
   s.default_executable = "czech_banks_parser"
   s.platform    = Gem::Platform::RUBY
   s.required_ruby_version = '>= 2.0.0'

data/lib/banks/csas.rb

@@ -9,19 +9,44 @@ module Banks
     end
 
     def accounts
-      JSON.parse(RestClient.get(@config[:base_uri] + '/netbanking/my/accounts', headers), symbolize_names: true)[:accounts]
+      JSON.parse(RestClient.get(@config[:base_uri] + '/netbanking/my/accounts', headers), symbolize_keys: true)['accounts']
     end
 
     def ibans
-      accounts.collect{|ac| ac[:accountno][:iban]}
+      accounts.collect{|ac| ac['accountno']['cz-iban']}
     end
 
     def transactions(time_start = nil, time_end = nil, iban = nil)
-      url = @config[:base_uri] + '/netbanking/my/accounts/' + iban.to_s + '/transactions'
+      url = @config[:base_uri] + '/netbanking/cz/my/accounts/' + iban.to_s + '/transactions'
       url += "?dateStart=#{time_start.iso8601}" if time_start.present?
       url += "#{url =~ /\?/ ? '&' : '?'}dateEnd=#{time_end.iso8601}" if time_end.present?
 
-      JSON.parse RestClient.get(url, headers), symbolize_names: true
+      # RestClient.log = 'stdout'
+
+      trans = []
+      transaction_get(url, trans, 0)
+      trans
+    end
+
+    def transaction_get(url, trans, page)
+      response = JSON.parse(RestClient.get(url+"&page=#{page}", headers), symbolize_keys: true)
+
+      response['transactions'].each do |tr|
+        trans << {
+            id: tr['id'],
+            date: tr['bookingDate'],
+            amount: tr['amount']['value'],
+            currency: tr['amount']['currency'],
+            account: "#{tr['accountParty']['accountPrefix']}#{tr['accountParty']['accountNumber']}/#{tr['accountParty']['bankCode']}",
+            bank: tr['accountParty']['iban'],
+            name: tr['accountParty']['partyInfo'],
+            variable_symbol: tr['variableSymbol'],
+            message: tr['payeeNote']
+        }
+      end
+
+      transaction_get(url, trans, response['nextPage']) if response['nextPage'] != response['pageNumber']
+      trans
     end
 
     private
@@ -31,8 +56,8 @@ module Banks
     end
 
     def get_token(token)
-      response = RestClient.post @config[:token_uri], {grant_type: 'refresh_token', client_id: @config[:client_id], client_secret: @config[:secret], refresh_token: token}
-      JSON.parse(response, symbolize_names: true)[:access_token]
+      response = RestClient.post @config[:token_uri], {grant_type: 'refresh_token', client_id: @config[:client_id], redirect_uri: '/', client_secret: @config[:secret], refresh_token: token}, content_type: 'application/x-www-form-urlencoded'
+      JSON.parse(response, symbolize_keys: true)['access_token']
     end
   end
 end

data/lib/banks/fio.rb

@@ -6,7 +6,7 @@ module Banks
       @token = token
     end
 
-    def transactions(time_start, time_end, iban)
+    def transactions(time_start, time_end, iban = nil)
       url = "#{@config[:base_uri]}/periods/#{@token}/#{time_start.strftime('%Y-%m-%d')}/#{time_end.strftime('%Y-%m-%d')}/transactions.json"
 
       trans = []

data/lib/czech_banks_parser.rb

@@ -3,8 +3,11 @@ require 'banks/fio.rb'
 require 'banks/csas.rb'
 
 class CzechBanksParser
-  def initialize(token, bank, opts = {})
+  def initialize(opts = {})
     @opts = opts
+  end
+
+  def connect(token, bank)
     case bank
       when 'csas' then Banks::Csas.new(token, config('csas'))
       when 'fio' then Banks::Fio.new(token, config('fio'))
@@ -16,9 +19,9 @@ class CzechBanksParser
     case state
       when 'csas'
         {
-          base_uri: 'https://api.csas.cz/sandbox/webapi/api/v1',
-          auth_uri: 'https://api.csas.cz/sandbox/widp/oauth2/auth',
-          token_uri: 'https://api.csas.cz/sandbox/widp/oauth2/token',
+          base_uri: @opts[:mode] == 'production' ? '' : 'https://www.csast.csas.cz/webapi/api/v3',
+          auth_uri: @opts[:mode] == 'production' ? '' : 'https://www.csast.csas.cz/widp/oauth2/auth',
+          token_uri: @opts[:mode] == 'production' ? '' : 'https://www.csast.csas.cz/widp/oauth2/token',
           client_id: @opts[:client_id],
           secret: @opts[:secret],
           web_api_key: @opts[:web_api_key]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: czech_banks_parser
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Richard Lapiš
@@ -14,20 +14,20 @@ dependencies:
   name: rest-client
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 1.6.7
-    - - ">="
+    - - '>='
       - !ruby/object:Gem::Version
         version: 1.6.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 1.6.7
-    - - ">="
+    - - '>='
       - !ruby/object:Gem::Version
         version: 1.6.7
 description: A parser from Czech Banks API's - CSAS, FIO
@@ -36,7 +36,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
+- .gitignore
+- README.md
 - czech_banks_parser.gemspec
 - lib/banks/csas.rb
 - lib/banks/fio.rb
@@ -51,12 +52,12 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: 2.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []