norma43 0.1

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+*.tmproj

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in norma43.gemspec
+gemspec

data/README

@@ -0,0 +1,11 @@
+Parser for NORMA43 Files. (a standard from the spanish banking industry for account movements)
+
+Usage
+=====
+
+require 'lib/norma43'
+data = Norma43.read(PATH_TO_FILE)
+
+Until we write a better documentation, check what is being read with:
+
+puts data.to_yaml

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/autotest/discover.rb

@@ -0,0 +1 @@
+Autotest.add_discovery { "rspec2" }

data/doc/descripcion_ficheros_n43.txt

@@ -0,0 +1,93 @@
+2. Contenido de Registros
+
+- Cabecera de cuenta. 
+- Principal de movimientos. 
+- En su caso, complementarios de conceptos, hasta un máximo de 5 registros opcionales. 
+- Final de cuenta. 
+- Final de fichero
+
+Dentro de un mismo soporte magnético puede venir contenida información de más de una cuenta (esto es, se pueden repetir los cuatro primeros bloques)
+
+Los registros opcionales "Complementarios de concepto", hasta un máximo de 5, contienen dos campos con una longitud de 38 posiciones cada uno de ellos. En su caso de no ser necesarios los dos campos, el no utilizado irá en blanco.
+
+
+
+00-REGISTRO CABECERA DE ARCHIVO
+
+  DESCRIPCION CAMPO                                                     POS       LONGITUD      TIPO
+  Código de Registro, 2 posiciones 00                                   1         2             NUM
+  Clave de Banco que constituye el fichero                              3         4             NUM
+  Fecha Contable del periodo al que corresponde la información AAMMDD   7         6             NUM
+  Libre: 68 posiciones                                                  13        68            ---
+
+
+11-REGISTRO DE CABECERA DE CUENTA
+
+  DESCRIPCION CAMPO                                                     POS       LONGITUD      TIPO
+  Código de Registro, 2 posiciones  (11)                                1         2             NUM
+  Clave de Banco que constituye el fichero                              3         4             NUM
+  Clave de Oficina donde está la cuenta                                 7         4             NUM
+  No de Cuenta                                                          11        10            NUM
+  Fecha Inicial del periodo AAMMDD                                      21        6             NUM
+  Fecha Final del periodo AAMMDD                                        27        6             NUM
+  Código de saldo inicial, signo del campo inicial: 1deudor, 2 acreedor 33        1             NUM
+  Importe del saldo inicial de la cuenta, 2 decimales                   34        14            NUM
+  Clase de Divisa, clave numérica                                       48        3             NUM
+  Código de la Modalidad de Información (en este caso es:3)             51        1             NUM
+  Nombre abreviado (del Cliente Propietario de la Cuenta)               52        26            ALFANUM
+  Código del Cliente                                                    78        3             NUM
+
+
+22 REGISTRO PRINCIPAL DE MOVIMIENTOS
+
+  DESCRIPCION CAMPO                                                     POS       LONGITUD      TIPO
+  Código de Registro, 22                                                1         2             NUM
+  Libre (relleno a espacios. excepcionalmente la clave de banco)        3         4             ---
+  Clave de Oficina de origen( donde se formaliza el apunte )            7         4             NUM
+  Fecha de Operación AAMMDD                                             11        6             NUM
+  Fecha de Valor AAMMDD                                                 17        6             NUM
+  Concepto común                                                        23        2             NUM
+  Concepto Propio (el de cada Banco para sus operaciones)               25        3             NUM
+  Clave Debe o Haber: 1= Apuntes Debe, 2= Apuntes Haber                 28        1             NUM
+  Importe(del Apunte, 12 posiciones para enteros y 2 para decimales)    29        14            NUM
+  No de Documento                                                       43        10            NUM
+  Referencia 1                                                          53        12            NUM
+  Referencia 2                                                          65        16            ALFANUM
+
+
+23-REGISTROS COMPLEMENTARIOS DE CONCEPTOS OPCIONALES (5 máximo)
+
+  DESCRIPCION CAMPO                                                     POS       LONGITUD      TIPO
+  Código de Registro, 23                                                1         2             NUM
+  Código de Dato: 01 para el primer registro complementario,            3         2             NUM
+    02 para el segundo, 03 para el tercero, 04 para el cuarto, 
+    05 para el quinto
+  Concepto (Primer Campo complementario de Concepto)                    5         38            ALFANUM
+  Concepto (Segundo Campo complementario de Concepto)                   43        38            ALFANUM
+
+
+33-REGISTRO FINAL DE CUENTA
+
+  DESCRIPCION CAMPO                                                     POS       LONGITUD      TIPO
+  Código de Registro, 2 posiciones  (33)                                1         2             NUM
+  Clave de Banco que constituye el fichero                              3         4             NUM
+  Clave de Oficina donde está la cuenta                                 7         4             NUM
+  No de Cuenta                                                          11        10            NUM
+  No de Apunte Debe                                                     21        5             NUM
+  Total Importes Debe                                                   26        14            NUM
+  No Apuntes Haber                                                      40        5             NUM
+  Total Importes Haber                                                  45        14            NUM
+  Código de Saldo Final: 1= Deudor, 2= Acreedor                         59        1             NUM
+  Importe de Saldo Final                                                60        14            NUM
+  Clave de Divisa                                                       74        3             NUM
+  Libre                                                                 77        4             ---
+  
+88-REGISTRO FIN DE FICHERO
+
+  DESCRIPCION CAMPO                                                     POS       LONGITUD      TIPO
+  Código de Registro, 2 posiciones  (88)                                1         2             NUM
+  Nueves (relleno a Nueves)                                             3         18            NUM
+  No de Registro (No Total de Registros que contiene el Fichero,        21        6             NUM
+    excluyéndose a si mismo y al registro 00 Cabecera de Archivo)
+  Libre                                                                 27        54            ---
+  

data/lib/norma43.rb

@@ -0,0 +1,60 @@
+module Norma43
+  
+  DATE_FORMAT = '%y%m%d'
+  
+  def self.read(path_to_file)
+    data = Hash.new
+    data[:movements] = Array.new
+    File.open(path_to_file, "r").each_line do |line|
+      code = line[0..1]
+      data[:info] = self.parse_header(line) if code == '11'
+      data[:movements] << self.parse_movement_main(line) if code == '22'
+      #TODO support multiple '23' lines (there may be up to 5)
+      data[:movements].last.merge!(self.parse_movement_optional(line)) if code == '23'
+      #TODO check amount values against those on record 33 
+      data[:info].merge!(self.parse_end(line)) if code == '33'
+      #TODO parse record 88, end of file
+    end
+    data
+  end
+  
+  protected
+
+    def self.parse_header(line)
+      account = {:bank => line[2..5].to_s, :office => line[6..9].to_s, 
+                 :number => line[10..19].to_s, :control => "??"}
+      {
+        :account => account,
+        :begin_date => Date.strptime(line[20..25], DATE_FORMAT), #Date.from_nor43(line[20..25])
+        :end_date => Date.strptime(line[26..31], DATE_FORMAT),
+        :initial_balance => parse_amount(line[33..46], line[32]),
+        :account_owner => line[51..76].strip,
+        :currency => line[47..49]          
+      }
+    end
+
+    def self.parse_movement_main(line)
+      {
+        :operation_date => Date.strptime(line[10..15], DATE_FORMAT),
+        :value_date => Date.strptime(line[16..21], DATE_FORMAT),
+        :operation => line[42..51],
+        :reference_1 => line[52..63],
+        :reference_2 => line[64..79].strip,
+        :amount => parse_amount(line[28..41], line[27]),
+        :office => line[6..9]
+      }
+    end
+
+    def self.parse_movement_optional(line)
+      {:concept => line[4, 79].strip}
+    end
+
+    def self.parse_end(line)
+      {:final_balance => parse_amount(line[59..72], line[28])}
+    end
+    
+    def self.parse_amount(value, sign)
+      value.to_f / 100 * (sign == 1 ? -1 : 1)
+    end
+  
+end

data/lib/norma43/version.rb

@@ -0,0 +1,3 @@
+module Norma43
+  VERSION = "0.1"
+end

data/norma43.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "norma43/version"
+
+Gem::Specification.new do |s|
+  s.name        = "norma43"
+  s.version     = Norma43::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Linking Paths"]
+  s.email       = ["hello@linkingpaths.com"]
+  s.homepage    = "https://github.com/linkingpaths/norma43"
+  s.summary     = %q{A parser for norma43 files, a standard from the spanish banking industry for account movements)}
+  s.description = %q{A parser for norma43 files, a standard from the spanish banking industry for account movements)}
+
+  s.rubyforge_project = "norma43"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+  s.add_development_dependency "rspec"
+end

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+# This file is copied to spec/ when you run 'rails generate rspec:install'
+ENV["RAILS_ENV"] ||= 'test'
+#require File.expand_path("../../config/environment", __FILE__)
+require File.expand_path("../../spec/factories", __FILE__)
+
+# Requires supporting ruby files with custom matchers and macros, etc,
+# in spec/support/ and its subdirectories.
+Dir[File.dirname(__FILE__) + "/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  # == Mock Framework
+  #
+  # If you prefer to use mocha, flexmock or RR, uncomment the appropriate line:
+  #
+  # config.mock_with :mocha
+  # config.mock_with :flexmock
+  # config.mock_with :rr
+  config.mock_with :rspec
+    
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification 
+name: norma43
+version: !ruby/object:Gem::Version 
+  hash: 9
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  version: "0.1"
+platform: ruby
+authors: 
+- Linking Paths
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-16 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+description: A parser for norma43 files, a standard from the spanish banking industry for account movements)
+email: 
+- hello@linkingpaths.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README
+- Rakefile
+- autotest/discover.rb
+- doc/descripcion_ficheros_n43.txt
+- doc/norma_43.pdf
+- lib/norma43.rb
+- lib/norma43/version.rb
+- norma43.gemspec
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: https://github.com/linkingpaths/norma43
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: norma43
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A parser for norma43 files, a standard from the spanish banking industry for account movements)
+test_files: 
+- spec/spec_helper.rb