bankscrap-santander 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: fffe15fd930409314c9d094f0dd83cacc92421bc
+  data.tar.gz: 249762ea851947668ba414238bb02646ea48cbe7
+SHA512:
+  metadata.gz: 3e9c840b2456a31487e60aead8ca849753e5c541286b3406a3b5923b235cca1f0f5bd8559a97a6d78f2d92b2237e3bdc4566271c31dec3227671e6598a3d7371
+  data.tar.gz: 81ad254b2c20f50aae6736753cd8534c23389b815ba59889b5f905e62df50601a3dc20bc1617a4444457537cb6ffa61d296f3b06aaf859b2082ad20f98bccf53

data/.gitignore

@@ -0,0 +1 @@
+*.gem

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in bankscrap-santander.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,20 @@
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,52 @@
+# Bankscrap::Santander
+
+[Bankscrap](https://github.com/bankscrap/bankscrap) adapter for Santander.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'bankscrap-santander'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install bankscrap-santander
+
+## Usage
+
+### From terminal
+#### Bank account balance
+
+    $ bankscrap balance Santander --credentials=user:YOUR_USER password:YOUR_PASSWORD
+
+
+#### Transactions
+
+    $ bankscrap transactions Santander --credentials=user:YOUR_USER password:YOUR_PASSWORD
+    $ bankscrap transactions Santander --credentials=user:YOUR_USER password:YOUR_PASSWORD --from dd-mm-yyyy --to dd-mm-yyyy
+
+---
+
+For more details on usage instructions please read [Bankscrap readme](https://github.com/bankscrap/bankscrap/#usage).
+
+### From Ruby code
+
+```ruby
+require 'bankscrap-santander'
+santander = Bankscrap::Santander::Bank.new(YOUR_USER, YOUR_PASSWORD, extra_args: {arg: EXTRA_ARG_1})
+```
+
+
+## Contributing
+
+1. Fork it ( https://github.com/bankscrap/bankscrap-santander/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/bankscrap-santander.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'bankscrap/santander/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'bankscrap-santander'
+  spec.version       = Bankscrap::Santander::VERSION
+  spec.authors       = ['Your Name']
+  spec.email         = ['your@email.com']
+  spec.summary       = 'Santander adapter for Bankscrap'
+  spec.homepage      = ''
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'bankscrap'
+  spec.add_development_dependency 'bundler', '~> 1.7'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'byebug', '~> 8.0'
+end

data/lib/bankscrap-santander.rb

@@ -0,0 +1,2 @@
+require_relative 'bankscrap/santander/bank'
+require_relative 'bankscrap/santander/version'

data/lib/bankscrap/santander/account.rb

@@ -0,0 +1,7 @@
+module Bankscrap
+  module Santander
+    class Account < ::Bankscrap::Account
+      attr_accessor :contract_id
+    end
+  end
+end

data/lib/bankscrap/santander/bank.rb

@@ -0,0 +1,289 @@
+require 'bankscrap'
+require 'securerandom'
+require 'open-uri'
+require_relative 'account.rb'
+
+module Bankscrap
+  module Santander
+    class Bank < ::Bankscrap::Bank
+
+      # Define the endpoints for the Bank API here
+      HOST             = 'www.bsan.mobi'
+      BASE_ENDPOINT    = 'https://www.bsan.mobi'
+      LOGIN_ENDPOINT   = '/SANMOV_IPAD_NSeg_ENS/ws/SANMOVNS_Def_Listener'
+      PRODUCTS_ENDPOINT = '/SCH_BAMOBI_WS_ENS/ws/BAMOBI_WS_Def_Listener'
+      ACCOUNT_ENDPOINT = '/SCH_BAMOBI_WS_ENS/ws/BAMOBI_WS_Def_Listener'
+      USER_AGENT       = 'ksoap2-android/2.6.0+'
+
+      def initialize(credentials = {})
+        @public_ip = public_ip
+
+        super do
+          default_headers
+        end
+      end
+
+      # Fetch all the accounts for the given user
+      #
+      # Should returns an array of Bankscrap::Account objects
+      def fetch_accounts
+        log 'fetch_accounts'
+
+        headers = { "SOAPAction" => "http://www.isban.es/webservices/BAMOBI/Posglobal/F_bamobi_posicionglobal_lip/internet/BAMOBIPGL/v1/obtenerPosGlobal_LIP" }
+
+        response = with_headers(headers) { post(BASE_ENDPOINT + PRODUCTS_ENDPOINT, fields: xml_products) }
+
+        document = parse_context(response)
+
+        document.xpath('//cuentas/cuenta').map { |data| build_account(data) }
+      end
+
+      # Fetch all the cards for the given user
+      #
+      # Should returns an array of Bankscrap::Card objects
+      def fetch_cards
+        log 'fetch_cards'
+
+        headers = { "SOAPAction" => "http://www.isban.es/webservices/BAMOBI/Posglobal/F_bamobi_posicionglobal_lip/internet/BAMOBIPGL/v1/obtenerPosGlobal_LIP" }
+
+        response = with_headers(headers) { post(BASE_ENDPOINT + PRODUCTS_ENDPOINT, fields: xml_products) }
+
+        document = parse_context(response)
+
+        document.xpath('//tarjetas/tarjeta').map { |data| build_card(data) }
+      end
+
+      # Fetch all the loan for the given user
+      #
+      # Should returns an array of Bankscrap::Loan objects
+      def fetch_loans
+        log 'fetch_loans'
+
+        headers = { "SOAPAction" => "http://www.isban.es/webservices/BAMOBI/Posglobal/F_bamobi_posicionglobal_lip/internet/BAMOBIPGL/v1/obtenerPosGlobal_LIP" }
+
+        response = with_headers(headers) { post(BASE_ENDPOINT + PRODUCTS_ENDPOINT, fields: xml_products) }
+
+        document = parse_context(response)
+
+        document.xpath('//prestamos/prestamo').map { |data| build_loan(data) }
+      end
+
+      # Fetch transactions for the given account.
+      #
+      # Account should be a Bankscrap::Account object
+      # Should returns an array of Bankscrap::Account objects
+      def fetch_transactions_for(account, start_date: Date.today - 1.month, end_date: Date.today)
+        headers = { "SOAPAction" => "http://www.isban.es/webservices/BAMOBI/Cuentas/F_bamobi_cuentas_lip/internet/BAMOBICTA/v1/listaMovCuentasFechas_LIP" }
+        transactions = []
+        end_page = false
+        repo = nil
+        importe_cta = nil
+
+        # Loop over pagination
+        until end_page
+          response = with_headers(headers) { post(BASE_ENDPOINT + ACCOUNT_ENDPOINT,
+                                                  fields: xml_account(account, start_date, end_date, repo, importe_cta)) }
+          document = parse_context(response)
+
+          transactions += document.xpath('//listadoMovimientos/movimiento').map { |data| build_transaction(data, account) }
+
+          repo = document.at_xpath('//methodResult/repo')
+          importe_cta = document.at_xpath('//methodResult/importeCta')
+          end_page = !(value_at_xpath(document, '//methodResult/finLista') == 'N')
+        end
+
+        transactions
+      end
+
+      private
+
+      def default_headers
+        add_headers(
+          'Content-Type'     => 'text/xml; charset=utf-8',
+          'User-Agent'       => USER_AGENT,
+          'Host'             => HOST,
+          'Connection'       => 'Keep-Alive',
+          'Accept-Encoding'  => 'gzip'
+        )
+      end
+
+      def public_ip
+        log 'getting public ip'
+        ip = open("http://api.ipify.org").read
+        log "public ip: [#{ip}]"
+        ip
+      end
+
+      def format_user(user)
+        user.upcase
+      end
+
+      # First request to login
+      def login
+        log 'login'
+        headers = { "SOAPAction" => "http://www.isban.es/webservices/TECHNICAL_FACADES/Security/F_facseg_security/internet/loginServicesNSegSAN/v1/authenticateCredential" }
+        response = with_headers(headers) { post(BASE_ENDPOINT + LOGIN_ENDPOINT, fields: xml_login) }
+        parse_context(response)
+      end
+
+      # Build an Account object from API data
+      def build_account(data)
+        currency = value_at_xpath(data, 'impSaldoActual/DIVISA')
+        Account.new(
+          bank: self,
+          id: value_at_xpath(data, 'comunes/contratoID/NUMERO_DE_CONTRATO'),
+          name: value_at_xpath(data, 'comunes/descContrato'),
+          available_balance: money(value_at_xpath(data, 'importeDispAut/IMPORTE'), currency),
+          balance: money(value_at_xpath(data, 'impSaldoActual/IMPORTE'), currency),
+          iban: value_at_xpath(data, 'IBAN').tr(' ', ''),
+          description: value_at_xpath(data, 'comunes/alias') || value_at_xpath(data, 'comunes/descContrato'),
+          contract_id: data.at_xpath('contratoIDViejo').children.to_s
+        )
+      end
+
+      # Build an Card object from API data
+      def build_card(data)
+        currency = value_at_xpath(data, 'impSaldoDispuesto/DIVISA', 'EUR')
+        Card.new(
+          bank: self,
+          id: value_at_xpath(data, 'comunes/contratoID/NUMERO_DE_CONTRATO'),
+          name: value_at_xpath(data, 'comunes/descContrato'),
+          pan: value_at_xpath(data, 'pan'),
+          amount: money(value_at_xpath(data, 'impSaldoDispuesto/IMPORTE'), currency),
+          avaliable: money(value_at_xpath(data, 'impDisponible/IMPORTE'), currency),
+          description: value_at_xpath(data, 'comunes/alias') || value_at_xpath(data, 'comunes/descContrato'),
+          is_credit: data.at_xpath('descTipoTarjeta').children.to_s == "Crédito"
+        )
+      end
+
+      # Build an Loan object from API data
+      def build_loan(data)
+        currency = value_at_xpath(data, 'impSaldoDispuesto/DIVISA')
+        Loan.new(
+          bank: self,
+          id: value_at_xpath(data, 'comunes/contratoID/NUMERO_DE_CONTRATO'),
+          name: value_at_xpath(data, 'comunes/descContrato'),
+          amount: money(value_at_xpath(data, 'impSaldoDispuesto/IMPORTE'), currency),
+          description: value_at_xpath(data, 'comunes/alias') || value_at_xpath(data, 'comunes/descContrato'),
+        )
+      end
+
+      # Build a transaction object from API data
+      def build_transaction(data, account)
+        currency = value_at_xpath(data, 'importe/DIVISA')
+        balance = money(value_at_xpath(data, 'importeSaldo/IMPORTE'), value_at_xpath(data, 'importeSaldo/DIVISA'))
+        Transaction.new(
+          account: account,
+          id: value_at_xpath(data, 'numeroMovimiento'),
+          amount: money(value_at_xpath(data, 'importe/IMPORTE'), currency),
+          description: value_at_xpath(data, 'descripcion'),
+          effective_date: Date.strptime(value_at_xpath(data, 'fechaValor'), "%Y-%m-%d"),
+          # TODO Falta fecha operacion
+          balance: balance
+        )
+      end
+
+      def parse_context(xml)
+        document = Nokogiri::XML(xml)
+        @token_credential = value_at_xpath(document, '//tokenCredential', @token_credential)
+        @user_data = document.at_xpath('//methodResult/datosUsuario') || @user_data
+        document
+      end
+
+      def xml_security_header
+        <<-security
+          <v:Header>
+            <n0:Security v:actor="http://www.isban.es/soap/actor/wssecurityB64" v:mustUnderstand="1" n1:role="wsssecurity" xmlns:n0="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:n1="http://www.w3.org/2003/05/soap-envelope">
+              <n0:BinarySecurityToken n2:Id="SSOToken" ValueType="esquema" EncodingType="hwsse:Base64Binary" xmlns:n2="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">#{@token_credential}</n0:BinarySecurityToken>
+            </n0:Security>
+          </v:Header>
+        security
+      end
+
+      def xml_datos_cabecera
+        <<-datos
+          <datosCabecera i:type=":datosCabecera">
+            <version i:type="d:string">4.7.1</version>
+            <terminalID i:type="d:string">Android</terminalID>
+            <idioma i:type="d:string">es-ES</idioma>
+          </datosCabecera>
+        datos
+      end
+
+      def xml_products
+        <<-products
+          <v:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:d="http://www.w3.org/2001/XMLSchema" xmlns:c="http://schemas.xmlsoap.org/soap/encoding/" xmlns:v="http://schemas.xmlsoap.org/soap/envelope/">
+            #{xml_security_header}
+            <v:Body>
+              <n3:obtenerPosGlobal_LIP facade="BAMOBIPGL" xmlns:n3="http://www.isban.es/webservices/BAMOBI/Posglobal/F_bamobi_posicionglobal_lip/internet/BAMOBIPGL/v1/">
+                <entrada i:type=":entrada">#{xml_datos_cabecera}</entrada>
+              </n3:obtenerPosGlobal_LIP>
+            </v:Body>
+          </v:Envelope>
+        products
+      end
+
+      def xml_login
+        <<-login
+        <v:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:d="http://www.w3.org/2001/XMLSchema" xmlns:c="http://schemas.xmlsoap.org/soap/encoding/" xmlns:v="http://schemas.xmlsoap.org/soap/envelope/">
+          <v:Header />
+          <v:Body>
+            <n0:authenticateCredential facade="loginServicesNSegSAN" xmlns:n0="http://www.isban.es/webservices/TECHNICAL_FACADES/Security/F_facseg_security/internet/loginServicesNSegSAN/v1">
+              <CB_AuthenticationData i:type=":CB_AuthenticationData">
+                <documento i:type=":documento">
+                  <CODIGO_DOCUM_PERSONA_CORP i:type="d:string">#{@user}</CODIGO_DOCUM_PERSONA_CORP>
+                  <TIPO_DOCUM_PERSONA_CORP i:type="d:string">N</TIPO_DOCUM_PERSONA_CORP>
+                </documento>
+                <password i:type="d:string">#{@password}</password>
+              </CB_AuthenticationData>
+              <userAddress i:type="d:string">#{@public_ip}</userAddress>
+            </n0:authenticateCredential>
+          </v:Body>
+        </v:Envelope>
+        login
+      end
+
+      def xml_date(date)
+        <<-date
+        <dia i:type="d:int">#{date.day}</dia>
+        <mes i:type="d:int">#{date.month}</mes>
+        <anyo i:type="d:int">#{date.year}</anyo>
+        date
+      end
+
+      def xml_account(account, from_date, to_date, repo, importe_cta)
+        is_pagination = repo ? 'S' : 'N'
+        xml_from_date = xml_date(from_date)
+        xml_to_date = xml_date(to_date)
+        <<-account
+          <v:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:d="http://www.w3.org/2001/XMLSchema" xmlns:c="http://schemas.xmlsoap.org/soap/encoding/" xmlns:v="http://schemas.xmlsoap.org/soap/envelope/">
+            #{xml_security_header}
+            <v:Body>
+              <n3:listaMovCuentasFechas_LIP facade="BAMOBICTA" xmlns:n3="http://www.isban.es/webservices/BAMOBI/Cuentas/F_bamobi_cuentas_lip/internet/BAMOBICTA/v1/">
+                <entrada i:type=":entrada">
+                  #{xml_datos_cabecera}
+                  <datosConexion i:type=":datosConexion">#{@user_data.children.to_s}</datosConexion>
+                  <contratoID i:type=":contratoID">#{account.contract_id.to_s}</contratoID>
+                  #{importe_cta}
+                  <fechaDesde i:type=":fechaDesde">#{xml_from_date}</fechaDesde>
+                  <fechaHasta i:type=":fechaHasta">#{xml_to_date}</fechaHasta>
+                  <esUnaPaginacion i:type="d:string">#{is_pagination}</esUnaPaginacion>
+                  #{repo}
+                </entrada>
+              </n3:listaMovCuentasFechas_LIP>
+            </v:Body>
+          </v:Envelope>
+        account
+      end
+
+      def value_at_xpath(node, xpath, default = '')
+        value = node.at_xpath(xpath)
+        value && !value.content.blank? ? value.content.strip : default
+      end
+
+      def money(data, currency)
+        Money.new(data.gsub('.', ''), currency)
+      end
+    end
+  end
+end

data/lib/bankscrap/santander/version.rb

@@ -0,0 +1,5 @@
+module Bankscrap
+  module Santander
+    VERSION = '2.0.0'.freeze
+  end
+end

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: bankscrap-santander
+version: !ruby/object:Gem::Version
+  version: 2.0.0
+platform: ruby
+authors:
+- Your Name
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-07-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bankscrap
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+description: 
+email:
+- your@email.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bankscrap-santander.gemspec
+- lib/bankscrap-santander.rb
+- lib/bankscrap/santander/account.rb
+- lib/bankscrap/santander/bank.rb
+- lib/bankscrap/santander/version.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.14
+signing_key: 
+specification_version: 4
+summary: Santander adapter for Bankscrap
+test_files: []