bankgiro_inbetalningar's Introduction

BankgiroInbetalningar

This gem parses Bankgirot's payments received files (BgMax) and returns the payment data in a relatively provider-agnostic format.

Installation

Add this line to your application's Gemfile:

gem 'bankgiro_inbetalningar'

And then execute:

$ bundle

Or install it yourself as:

$ gem install bankgiro_inbetalningar

Usage

Use the convenience method BankgiroInbetalningar.parse to parse a file:

res = BankgiroInbetalningar.parse("BgMaxfil4.txt")
# Or
data = File.read("BgMaxfil4.txt").force_encoding("ISO-8859-1")
res = BankgiroInbetalningar.parse_data(data)

raise "oops" unless res.valid?
# You can process deposit by deposit...
res.deposits.each do |d|
  puts "Received to BG #{d.bgno}:"
  d.payments.each do |p|
    puts "%10.2f %s" % [(p.cents / 100.0), p.currency]
  end
end

# ...or payment by payment
res.payments.each do |p|
  puts "%10.2f %s" % [(p.cents / 100.0), p.currency]
  puts "From #{p.payer.name}, #{p.payer.city}" if p.payer
end

See the specs for more details.

Files are expected to be ISO-8859-1 (as Bankgirot prefers), but data strings can be in any encoding, as long as String#encoding is correct. The library returns UTF-8. It is the 21st century.

Todo / Missing features

BankgiroInbetalningar works well enough for our needs, so there are no plans for further development. Pull requests are welcome.

The gem has only been tested with BgMaxfil4.txt, the sample file for users that have requested extended OCR registration. I see no reason why it wouldn't work with other settings, but YMMV.

Some attributes in the files are not reported since we didn't need them. I'll be happy to add them if you don't want to do it yourself.

Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Added some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request

Contributors:

Recommend Projects

barsoom / bankgiro_inbetalningar Goto Github PK