This gem parses Bankgirot's payments received files (BgMax) and returns the payment data in a relatively provider-agnostic format.
Add this line to your application's Gemfile:
gem 'bankgiro_inbetalningar'
And then execute:
$ bundle
Or install it yourself as:
$ gem install bankgiro_inbetalningar
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
endSee 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.
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.
- 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