king_dtaus 2.0.1 → 2.0.2.pre

data/Gemfile

@@ -1,2 +1,7 @@
 source :rubygems
-gemspec
+
+gemspec
+
+group :test do
+  gem "rcov"
+end

data/README.markdown

@@ -10,7 +10,7 @@ therefore supported in common banking programs too.
 
 This gem saves you all the trouble when generating DTAUS- or DTAZV-text.
 
-We love building payment applications.
+We love building payment applications
 
 ## Install
 
@@ -18,38 +18,25 @@ We love building payment applications.
 
 ## Features
 
-* Create DTAUS debit transfer (Lastschrift)
-* Create DTAUS credit transfer (Gutschrift)
-* Create DTAZV debit transfer
-* 100% test coverage to ensure software quality
-* works with ruby 1.8 & 1.9.2
-
-## Version Info
-
-Version 2 has breaking changes!
-
-* account attributes now passed in as hash
-* renamed account.client_xy => owner_xy
-* renamed account.account_number => bank_account_number
-* added iban/bic to account
-* DTAZV added
-
-If you want to stay with v1 just pin it in your Gemfile:
-    
-    gem "king_dtaus", "<2"
+* Create DTAUS debit advice (Lastschrift)
+* Create DTAUS credit advice (Gutschrift)
+* Create DTAZV debit advice
+* High test coverage to ensure software quality
 
 ## TODOs
 
-* some more edge-case tests needed, we need your feedback here!
+* first gem with no todo's - never seen it, huh? - just kidding
+* some more edge-case tests needed
 
 ## Resources
 
-* SalesKing: http://salesking.eu
 * DTAZV-Viewer: http://www.meta-evolutions.de/pages/artikel-20070630-dtazv-datei-betrachter.html
 * DTA/DTAZV PHP Pear: http://pear.php.net/package/Payment_DTA
+* Ruby Kernel Module: http://www.ruby-doc.org/core/classes/Kernel.html
 * Windata ZV-Tools: http://www.windata.de/Site/2Produkte2/ZVTools.aspx
 * The Swift Codes: http://www.theswiftcodes.com/
 * StarMoney: http://www.starmoney.de/index.php?id=starmoneybusiness_testen
+* SalesKing: http://salesking.eu
 
 ## Examples
 
@@ -61,21 +48,14 @@ Here are some examples how to create a DTA- or DTAZV-File. Also check out the sp
     dta = KingDta::Dtaus.new('LK')
   
     # set sender account
-    dta.account = KingDta::Account.new(
-                    :bank_account_number => "123456789",
-                    :bank_number => "69069096",
-                    :owner_name => "Return to Sender",
-                    :bank_name => "Money Burner Bank")
+    dta.account = KingDta::Account.new(:account_number => @kto1.account_number, :bank_number => @kto1.bank_number, :client_name => @kto1.client_name, :bank_name => @kto1.bank_name)
   
-    # following should be done in a loop to add multiple bookings
+    # the following should be done in a loop to add multiple bookings
     # create receiving account
-    receiver = KingDta::Account.new(
-                    :bank_account_number => "987456123",
-                    :bank_number => "99099096",
-                    :owner_name => "Gimme More Lt.",
-                    :bank_name => "Banking Bandits")
+    rec_acnt = KingDta::Account.new(:account_number => @kto1.account_number, :bank_number => @kto1.bank_number, :client_name => @kto1.client_name, :bank_name => @kto1.bank_name)
+  
     # create booking
-    booking = KingDta::Booking.new(receiver, 100.00 )
+    booking = KingDta::Booking.new(rec_acnt, 100.00 )
   
     # set booking text if you want to
     booking.text = "Thanks for your purchase"
@@ -89,31 +69,48 @@ Here are some examples how to create a DTA- or DTAZV-File. Also check out the sp
 
 ### DTAZV
 
-    @dtazv = KingDta::Dtazv.new()
-
-    # sender account
-    @dtazv.account = KingDta::Account.new(
-      :bank_account_number => "123456789",
-      :bank_number => "40050100",
-      :bank_name => "Greedy Fuckers Bank",
-      :owner_name => "Sender name"
-    )
-
-    # receiver account
-    receiver = KingDta::Account.new(
-      :bank_account_number => "987654321",
-      :bank_iban => "PLsome-long-Iban",
-      :bank_bic => "BicCode",
-      :owner_name => "receivers name"
+    @date = Date.today
+    @dudes_dtazv_export = KingDta::Dtazv.new(@date)
+    @dudes_konto = self.dudes_konto
+    @dalai_lamas_account = self.dalai_lamas_account
+    @dudes_dtazv_export.account = KingDta::Account.new(
+      :account_number =>      @dudes_konto.account_number,
+      :bank_number =>         @dudes_konto.bank_number,
+      :client_name =>         @dudes_konto.client_name,
+      :client_number =>       @dudes_konto.client_number,
+      :bank_street =>         @dudes_konto.account_street,
+      :bank_city =>           @dudes_konto.account_city,
+      :bank_zip_code =>       @dudes_konto.account_zip_code,
+      :bank_name =>           @dudes_konto.bank_name,
+      :client_street =>       @dudes_konto.client_street,
+      :client_city =>         @dudes_konto.client_city,
+      :client_zip_code =>     @dudes_konto.client_zip_code,
+      :bank_country_code =>   @dudes_konto.bank_country_code,
+      :client_country_code => @dudes_konto.client_country_code
     )
-    # add bookings, probably in a loop
-    booking = KingDta::Booking.new(receiver, 220.25)
-    @dtazv.add(booking)
-
-    # get output as string
-    @dtazv.create
 
-also make sure to read the code and the specs
+    @dalai_lamas_booking = KingDta::Booking.new(KingDta::Account.new(
+      :account_number =>      @dalai_lamas_account.account_number,
+      :bank_number =>         @dalai_lamas_account.bank_number,
+      :client_name =>         @dalai_lamas_account.client_name,
+      :client_number =>       @dalai_lamas_account.bank_name,
+      :bank_street =>         @dalai_lamas_account.account_street,
+      :bank_city =>           @dalai_lamas_account.account_city,
+      :bank_zip_code =>       @dalai_lamas_account.account_zip_code,
+      :bank_name =>           @dalai_lamas_account.bank_name,
+      :client_street =>       @dalai_lamas_account.client_street,
+      :client_city =>         @dalai_lamas_account.client_city,
+      :client_zip_code =>     @dalai_lamas_account.client_zip_code,
+      :bank_country_code =>   @dalai_lamas_account.bank_country_code,
+      :client_country_code => @dalai_lamas_account.client_country_code
+    ), 220.25)
+
+    @dudes_dtazv_export.add(@dalai_lamas_booking)
+    @dudes_dtazv_export.create_file
+
+    # Output is DTAZV0.TXT
+
+also make sure to read the specs
 
 ## Credits
 
@@ -123,6 +120,9 @@ Bugfixes and enhancements by
 * Kim Rudolph - https://github.com/krudolph
 * Thorsten Böttger - https://github.com/alto
 * Jan Kus - https://github.com/koos
-* used https://rubygems.org/gems/DTAUS as a starting point
 
-Copyright (c) 2009-2011 Georg Leciejewski (SalesKing), Jan Kus (Railslove), released under the MIT license
+This gem used https://rubygems.org/gems/DTAUS as a starting point.
+It was disected, turned into a real class structure, bugs were fixed and
+of course a full test suite ensures its functionality.
+
+Copyright (c) 2009-2011 Georg Leciejewski (SalesKing), Jan Kus (Railslove), released under the MIT license

data/Rakefile

@@ -1,9 +1,6 @@
 require 'rake'
-require 'rspec'
 require 'rspec/core/rake_task'
-require 'rdoc/task'
-require 'bundler/gem_helper'
-Bundler::GemHelper.install_tasks
+
 desc "Run specs"
 RSpec::Core::RakeTask.new
 
@@ -15,11 +12,20 @@ RSpec::Core::RakeTask.new(:coverage) do |t|
   t.verbose = true
 end
 
-desc 'Generate documentation'
-Rake::RDocTask.new(:rdoc) do |rdoc|
-  rdoc.rdoc_dir = 'docs/rdoc'
-  rdoc.title    = 'KingPdf'
-  rdoc.options << '--line-numbers' << '--inline-source'
-  rdoc.rdoc_files.include('README')
-  rdoc.rdoc_files.include('lib/**/*.rb')
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "king_dtaus"
+    gem.summary = %Q{Generate DTAUS strings and files}
+    gem.description = %Q{DTAUS is a text-based format, to create bank transfers for german banks. This gem helps with the creation of those transfer files.}
+    gem.email = "gl@salesking.eu"
+    gem.homepage = "http://github.com/salesking/king_dtaus"
+    gem.authors = ["Georg Leciejewski", "Georg Ledermann", "Jan Kus"]
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
 end

data/VERSION

@@ -0,0 +1 @@
+2.0.2.pre

data/docs/example.output

@@ -0,0 +1,7 @@
+0256P37040044                                                     Commerzbank Köln                   5th avenue 55323                        los angeles1106080100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+
+0256Q370400447828970037                                                   GIMME YOUR MONEY AG                  6th avenue 445555                        los angeles11060801110608N000000000000000000000000000000000000000000000000000000000000000000000000000000
+
+0572T37040044EUR782897003711060837040044EUR0037040044  MARKF1100                                                                                                                                                                                                            FIDEL CASTRO                                                                                                                                           0        GR1601101250000000012300695EUR00000000000220025                                                                                                                                             0 0 0 0                        00013                          0                                  00000000000000000000000000000000000000000000000000000 00
+
+256Y000000000000000000000000000000000000000000000000000000000000000000000001                                                                                                                                                                                  0

data/king_dtaus.gemspec

@@ -1,36 +1,77 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-$:.push File.expand_path('../lib', __FILE__)
-require 'king_dta/version'
 
 Gem::Specification.new do |s|
   s.name = %q{king_dtaus}
-  s.version = KingDta::VERSION
+  s.version = "2.0.2.pre"
 
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.required_rubygems_version = Gem::Requirement.new("> 1.3.1") if s.respond_to? :required_rubygems_version=
   s.authors = ["Georg Leciejewski", "Georg Ledermann", "Jan Kus"]
-  s.date = %q{2011-11-15}
-  s.summary = %q{Generate DTA/DTAUS and DTAZV bank transfer files .. the easy way}
-  s.description = %q{DTA/DTAUS and DTAZV are text-based formats to create bank transfers for german banks.
-This gem creates DTA/DATAUS files for inner german credit and debit(Gutschrift/Lastschrift) transfers.
-It is also capable of creating DTAZV credit-files for transfers from Germany to European SEPA region.}
+  s.date = %q{2011-09-02}
+  s.description = %q{DTAUS is a text-based format, to create bank transfers for german banks. This gem helps with the creation of those transfer files.}
   s.email = %q{gl@salesking.eu}
   s.extra_rdoc_files = [
     "README.markdown"
   ]
-  s.executables   = nil
-  s.files         = `git ls-files`.split("\n").reject{|i| i[/^docs\//] }
-  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
-
+  s.files = [
+    ".travis.yml",
+    "Gemfile",
+    "MIT-LICENSE",
+    "README.markdown",
+    "Rakefile",
+    "VERSION",
+    "docs/dtazv.pdf",
+    "docs/dtazv_bank_bbk.pdf",
+    "docs/example.output",
+    "king_dtaus.gemspec",
+    "lib/king_dta/account.rb",
+    "lib/king_dta/booking.rb",
+    "lib/king_dta/dta.rb",
+    "lib/king_dta/dtaus.rb",
+    "lib/king_dta/dtazv.rb",
+    "lib/king_dta/exception.rb",
+    "lib/king_dta/helper.rb",
+    "lib/king_dtaus.rb",
+    "spec/account_spec.rb",
+    "spec/booking_spec.rb",
+    "spec/dtaus_spec.rb",
+    "spec/dtazv_spec.rb",
+    "spec/dtazv_test.rb",
+    "spec/helper_spec.rb",
+    "spec/spec_helper.rb"
+  ]
   s.homepage = %q{http://github.com/salesking/king_dtaus}
   s.require_paths = ["lib"]
   s.rubygems_version = %q{1.6.2}
+  s.summary = %q{Generate DTAUS strings and files}
 
-  s.add_runtime_dependency 'i18n'
-  s.add_development_dependency 'rdoc'
-  s.add_development_dependency 'rspec'
-  s.add_development_dependency 'simplecov'
-  s.add_development_dependency 'mocha'
-  s.add_development_dependency 'rake', '>= 0.9.2'
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
 
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<king_dtaus>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<simplecov>, [">= 0"])
+      s.add_development_dependency(%q<mocha>, [">= 0"])
+      s.add_development_dependency(%q<i18n>, [">= 0"])
+    else
+      s.add_dependency(%q<king_dtaus>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<simplecov>, [">= 0"])
+      s.add_dependency(%q<mocha>, [">= 0"])
+      s.add_dependency(%q<i18n>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<king_dtaus>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<simplecov>, [">= 0"])
+    s.add_dependency(%q<mocha>, [">= 0"])
+    s.add_dependency(%q<i18n>, [">= 0"])
+  end
 end
 

data/lib/king_dta/account.rb

@@ -1,74 +1,50 @@
 # encoding: utf-8
 module KingDta
-  # Bank account and owner information
+  # A bank account with name of the account owner,
+  # Kontodaten verwalten mit Name des Inhabers und Bank, Bankleitzahl und Kontonummer.
   class Account
     include KingDta::Helper
+    
+    attr_accessor :account_number, :bank_number, :bank_street, :bank_city,
+                  :bank_zip_code, :bank_name, :bank_country_code,
+                  :client_name, :client_number, :client_street, :client_city,
+                  :client_zip_code, :client_country_code
 
-    attr_accessor :bank_street, :bank_city,
-                  :bank_zip, :bank_name, :bank_country_code, :bank_iban,
-                  :bank_bic,
-                  :owner_name, :owner_number, :owner_street, :owner_city,
-                  :owner_zip_code, :owner_country_code
-    attr_reader :bank_account_number, :bank_number
-
+    # TODO test
     def initialize(args={})
 
       @bank_street = convert_text(args.delete(:bank_street))
       @bank_city = convert_text(args.delete(:bank_city))
       @bank_name = convert_text(args.delete(:bank_name))
-      @owner_name = convert_text(args.delete(:owner_name))
-      @owner_street = convert_text(args.delete(:owner_street))
-      @owner_city = convert_text(args.delete(:owner_city))
+      @client_name = convert_text(args.delete(:client_name))
+      @client_street = convert_text(args.delete(:client_street))
+      @client_city = convert_text(args.delete(:client_city))
 
       args.each do |key,value|
         self.send("#{key}=",value)
       end
 
-      raise ArgumentError.new('Owner number too long, max 10 allowed') if @owner_number && "#{@owner_number}".length > 10
-      raise ArgumentError.new('Owner street too long, max 35 allowed') if @owner_street && @owner_street.length > 35
-      raise ArgumentError.new('Owner city too long, max 35 allowed') if @owner_city && @owner_city.length > 35
-      raise ArgumentError.new('Owner country code too long, max 2 allowed') if @owner_country_code && @owner_country_code.length > 2
-
-
-      raise ArgumentError.new("Bank iban wrong length: #{@bank_iban.length}, must be between 15-34") if @bank_iban && !@bank_iban.length.between?(15,34)
-      raise ArgumentError.new("Bank bic wrong length: #{@bank_bic.length} must be between 8-11") if @bank_bic && !@bank_bic.length.between?(8,11)
-
-      raise ArgumentError.new('Bank street too long, max 35 allowed') if @bank_street && @bank_street.length > 35
-      raise ArgumentError.new('Bank city too long, max 35 allowed') if @bank_city && @bank_city.length > 35
-      raise ArgumentError.new('Bank name too long, max 35 allowed') if @bank_name && @bank_name.length > 35
-      raise ArgumentError.new('Bank country code too long, max 2 allowed') if @bank_country_code && @bank_country_code.length > 2
-
-      @owner_country_code = @bank_iban[0..1 ] if @bank_iban && !@owner_country_code
-    end
-
-    # Cast given account number to integer. Strips spaces and leading zeros
-    # from the bank account number.
-    # DTA relies on integers for checksums and field values.
-    # @param [String|Integer] number
-    def bank_account_number=(number)
-      raise ArgumentError.new('Bank account number too long, max 10 allowed') if "#{number}".length > 10
-      raise ArgumentError.new('Bank account number cannot be 0') if number == 0
-
-      @bank_account_number = number.is_a?(String) ? number.gsub(/\s/,'').to_i : number
-    end
-
-    # Cast given bank number to integer. Strips spaces and leading zeros
-    # from the bank account number.
-    # DTA relies on integers for checksums and field values.
-    # @param [String|Integer] number
-    def bank_number=(number)
-      raise ArgumentError.new('Bank number too long, max 8 allowed') if "#{number}".length > 8
-      raise ArgumentError.new('Bank number cannot be 0') if number == 0
+      raise ArgumentError.new('Account number too long, max 35 allowed') if @account_number && "#{@account_number}".length > 35
+      raise ArgumentError.new('Bank number too long, max 11 allowed') if @bank_number && "#{@bank_number}".length > 11
+      raise ArgumentError.new('Client number too long, max 10 allowed') if @client_number && "#{@client_number}".length > 10
+      raise ArgumentError.new("Bank account number cannot be 0")  if @account_number && @account_number == 0
+      raise ArgumentError.new("Bank number cannot be 0")   if @bank_number && @bank_number == 0
+      raise ArgumentError.new("Bank Street too long, max 35 allowed") if @bank_street && @bank_street.length > 35
+      raise ArgumentError.new("Bank City too long, max 35 allowed") if @bank_city && @bank_city.length > 35
+      raise ArgumentError.new("Bank Name too long, max 35 allowed") if @bank_name && @bank_name.length > 35
+      raise ArgumentError.new("Client Street too long, max 35 allowed") if @client_street && @client_street.length > 35
+      raise ArgumentError.new("Client City too long, max 35 allowed") if @client_city && @client_city.length > 35
+      raise ArgumentError.new("Bank Country code too long, max 2 allowed") if @bank_country_code && @bank_country_code.length > 2
+      raise ArgumentError.new("Client Country code too long, max 2 allowed") if @client_country_code && @client_country_code.length > 2
 
-      @bank_number = number.is_a?(String) ? number.gsub(/\s/,'').to_i : number
     end
 
-    def bank_zip_city
-      "#{@bank_zip} #{@bank_city}"
+    def zip_city
+      "#{@bank_zip_code} #{@bank_city}"
     end
 
-    def owner_zip_city
-      "#{@owner_zip_code} #{@owner_city}"
+    def client_zip_city
+      "#{@client_zip_code} #{@client_city}"
     end
 
   end

data/lib/king_dta/dta.rb

@@ -4,16 +4,6 @@ module KingDta
     include KingDta::Helper
     attr_reader :default_text
 
-    # Create a new dta string.
-    # === Parameter    # 
-    # typ<Date>:: date when the the transfer is to be created
-    def initialize(date=Date.today )
-      raise ArgumentError.new("Wrong date format. Make it a Time or Date object with yyyy-mm-dd") unless date.respond_to?(:strftime)
-      @date         = date
-      @value_pos    = true  #values are positive by default changed by first booking
-      @closed       = false
-      @default_text = ''
-    end
     #  Set the sending account(you own)
     # === Parameter
     # account<Account>:: the sending account, must be an instance of class

data/lib/king_dta/dtaus.rb

@@ -1,9 +1,10 @@
 # encoding: utf-8
+#Erstelle eine DTAUS-Datei.
+#Typ ist 'LK' (Lastschrift Kunde) oder 'GK' (Gutschrift Kunde)
+#
+#Infos zu DTAUS: http://www.infodrom.org/projects/dtaus/dtaus.php3
+
 module KingDta
-  #Create a DTAUS string.
-  # == infos
-  # https://www.ksk-koeln.de/formatbeschreibung_datentraegeraustausch.pdfx
-  # http://www.infodrom.org/projects/dtaus/dtaus.html
   class Dtaus < KingDta::Dta
     attr_reader :sum_bank_account_numbers, :sum_bank_numbers, :sum_values
 
@@ -12,9 +13,13 @@ module KingDta
     # typ<String>:: valid strings are 'LK' (Lastschrift Kunde) and 'GK' (Gutschrift Kunde)
     # typ<Date>:: date when the the transfer is to be created
     def initialize( typ, date=Date.today )
+      raise ArgumentError.new("Wrong date format. Make it a Time or Date object with yyyy-mm-dd") unless date.respond_to?(:strftime)
       raise ArgumentError.new("Unknown order type: #{typ}. Allowed Values are LK, GK") unless ['LK','GK'].include?(typ)
-      @typ = typ
-      super(date)
+      @date = date
+      @typ  = typ
+      @value_pos  = true  #all values are positive by default. Variable changes with first booking entry
+      @closed     = false
+      @default_text = '' # default verwendungzweck
     end
 
     # Creates the whole dta string(in the right order) and returns it
@@ -36,107 +41,108 @@ module KingDta
     def set_checksums
       @sum_bank_account_numbers, @sum_bank_numbers, @sum_values  = 0,0,0
       bookings.each do |b|
-        @sum_bank_account_numbers  += b.account.bank_account_number
-        @sum_bank_numbers += b.account.bank_number
+        @sum_bank_account_numbers  += b.account.account_number.to_i
+        @sum_bank_numbers += b.account.bank_number.to_i
         @sum_values += b.value
       end
     end
 
     #Erstellen A-Segment der DTAUS-Datei
     #Aufbau des Segments:
-    # Nr. Start Länge  Beschreibung
-    # 1   0      4     Länge des Datensatzes, immer 128 Bytes, also immer "0128"
-    # 2   4      1     Datensatz-Typ, immer 'A'
-    # 3   5      2     Art der Transaktionen
-    #                  "LB" für Lastschriften Bankseitig
-    #                  "LK" für Lastschriften Kundenseitig
-    #                  "GB" für Gutschriften Bankseitig
-    #                  "GK" für Gutschriften Kundenseitig
-    # 4   7     8      Bankleitzahl des Auftraggebers
-    # 5   15    8      CST, "00000000", nur belegt, wenn Diskettenabsender Kreditinstitut
-    # 6   23    27     Name des Auftraggebers
-    # 7   50    6      aktuelles Datum im Format DDMMJJ
-    # 8   56    4      CST, "    " (Blanks)
-    # 9   60    10     Kontonummer des Auftraggebers
-    # 10  70    10     Optionale Referenznummer
-    # 11a 80    15     Reserviert, 15 Blanks
-    # 11b 95    8      Ausführungsdatum Format DDMMJJJJ. max A7 + 15 Tage. Default Blanks.
-    # 11c 103   24     Reserviert, 24 Blanks
-    # 12  127   1      Währungskennzeichen  "1" = Euro
-    #
+    # Nr.  Start  Länge     Beschreibung
+    # 1   0      4 Zeichen    Länge des Datensatzes, immer 128 Bytes, also immer "0128"
+    # 2   4      1 Zeichen    Datensatz-Typ, immer 'A'
+    # 3   5      2 Zeichen    Art der Transaktionen
+    #            "LB" für Lastschriften Bankseitig
+    #            "LK" für Lastschriften Kundenseitig
+    #            "GB" für Gutschriften Bankseitig
+    #            "GK" für Gutschriften Kundenseitig
+    # 4   7      8 Zeichen    Bankleitzahl des Auftraggebers
+    # 5   15    8 Zeichen    CST, "00000000", nur belegt, wenn Diskettenabsender Kreditinstitut
+    # 6   23    27 Zeichen  Name des Auftraggebers
+    # 7   50    6 Zeichen    aktuelles Datum im Format DDMMJJ
+    # 8   56    4 Zeichen    CST, "    " (Blanks)
+    # 9   60    10 Zeichen  Kontonummer des Auftraggebers
+    # 10  70    10 Zeichen  Optionale Referenznummer
+    # 11a 80    15 Zeichen  Reserviert, 15 Blanks
+    # 11b 95    8 Zeichen    Ausführungsdatum im Format DDMMJJJJ. Nicht jünger als Erstellungsdatum (A7), jedoch höchstens 15 Kalendertage später. Sonst Blanks.
+    # 11c 103    24 Zeichen  Reserviert, 24 Blanks
+    # 12  127    1 Zeichen    Währungskennzeichen
+    #            " " = DM
+    #            "1" = Euro
     #    Insgesamt 128 Zeichen
     def add_a
       data = '0128'
-      data += 'A'
-      data += @typ
-      data += '%8i' % @account.bank_number #.rjust(8)
-      data += '%08i' % 0
-      data += '%-27.27s' % @account.owner_name
-      data += @date.strftime("%d%m%y")              # creation date - today
-      data += ' ' * 4
-      data += '%010i' % @account.bank_account_number
-      data += '%010i' % 0
-      data += ' '  * 15
-      data += '%8s' % @date.strftime("%d%m%Y")     #Ausführungsdatum - ja hier 8 Stellen
-      data += ' ' * 24
-      data += '1'
+      data += 'A'        #Segment
+      data += @typ        #Lastschriften Kunde
+      data += '%8i' % @account.bank_number #.rjust(8)  #bank_number
+      data += '%08i' % 0                 #belegt, wenn Bank
+      data += '%-27.27s' % @account.client_name
+      data += @date.strftime("%d%m%y")  #aktuelles Datum im Format DDMMJJ
+      data += ' ' * 4  #bankinternes Feld
+      data += '%010i' % @account.account_number.to_i
+      data += '%010i' % 0 #Referenznummer
+      data += ' '  * 15  #Reserve
+      data += '%8s' % @date.strftime("%d%m%Y")     #Ausführungsdatum (ja hier 8 Stellen, Erzeugungsdat. hat 6 Stellen)
+      data += ' ' * 24   #Reserve
+      data += '1'   #Kennzeichen Euro
       raise "DTAUS: Längenfehler A (#{data.size} <> 128)\n" if data.size != 128
       dta_string << data
     end #dataA
 
     #Erstellen C-Segmente (Buchungen mit Texten) der DTAUS-Datei
     #Aufbau:
-    #  Nr. St  Länge  Beschreibung
-    #  1   0    4     Länge des Datensatzes, 187 + x * 29 (x..Anzahl Erweiterungsteile)
-    #  2   4    1     Datensatz-Typ, immer 'C'
-    #  3   5    8     Bankleitzahl des Auftraggebers (optional)
-    #  4   13   8     Bankleitzahl des Kunden
-    #  5   21   10    Kontonummer des Kunden
-    #  6   31   13    Verschiedenes
-    #                 1. Zeichen: "0"
-    #                 2. - 12. Zeichen: interne Kundennummer oder Nullen
-    #                 13. Zeichen: "0"
-    #                 Die interne Nummer wird vom erstbeauftragten Institut zum endbegünstigten Institut weitergeleitet.
-    #                 Die Weitergabe der internenen Nummer an den Überweisungsempfänger ist der Zahlstelle freigestellt.
-    #  7   44  5    Art der Transaktion (7a: 2 Zeichen, 7b: 3 Zeichen)
-    #               "04000" Lastschrift des Abbuchungsauftragsverfahren
-    #               "05000" Lastschrift des Einzugsermächtigungsverfahren
-    #               "05005" Lastschrift aus Verfügung im elektronischen Cash-System
-    #               "05006" Wie 05005 mit ausländischen Karten
-    #               "51000" Überweisungs-Gutschrift
-    #               "53000" Überweisung Lohn/Gehalt/Rente
-    #               "5400J" Vermögenswirksame Leistung (VL) ohne Sparzulage
-    #               "5400J" Vermögenswirksame Leistung (VL) mit Sparzulage
-    #               "56000" Überweisung öffentlicher Kassen
-    #               Die im Textschlüssel mit J bezeichnete Stelle, wird bei Übernahme
-    #               in eine Zahlung automatisch mit der jeweils aktuellen Jahresendziffer (7, wenn 97) ersetzt.
-    #  8   49  1    Reserviert, " " (Blank)
-    #  9   50  11   Betrag in DM
-    #  10  61  8    Bankleitzahl des Auftraggebers
-    #  11  69  10   Kontonummer des Auftraggebers
-    #  12  79  11   Betrag in Euro einschließlich Nachkommastellen
-    #  13  90  3    Reserviert, 3 Blanks
-    #  14a 93  27   Name des Kunden
-    #  14b 120 8    Reserviert, 8 Blanks
+    #  Nr.  St  Länge    Beschreibung
+    #  1   0    4 Zeichen    Länge des Datensatzes, 187 + x * 29 (x..Anzahl Erweiterungsteile)
+    #  2   4    1 Zeichen    Datensatz-Typ, immer 'C'
+    #  3   5    8 Zeichen    Bankleitzahl des Auftraggebers (optional)
+    #  4   13  8 Zeichen    Bankleitzahl des Kunden
+    #  5   21  10 Zeichen  Kontonummer des Kunden
+    #  6   31  13 Zeichen  Verschiedenes
+    #      1. Zeichen: "0"
+    #      2. - 12. Zeichen: interne Kundennummer oder Nullen
+    #      13. Zeichen: "0"
+    #      Die interne Nummer wird vom erstbeauftragten Institut zum endbegünstigten Institut weitergeleitet. Die Weitergabe der internenen Nummer an den Überweisungsempfänger ist der Zahlstelle freigestellt.
+    #  7   44  5 Zeichen  Art der Transaktion (7a: 2 Zeichen, 7b: 3 Zeichen)
+    #      "04000" Lastschrift des Abbuchungsauftragsverfahren
+    #      "05000" Lastschrift des Einzugsermächtigungsverfahren
+    #      "05005" Lastschrift aus Verfügung im elektronischen Cash-System
+    #      "05006" Wie 05005 mit ausländischen Karten
+    #      "51000" Überweisungs-Gutschrift
+    #      "53000" Überweisung Lohn/Gehalt/Rente
+    #      "5400J" Vermögenswirksame Leistung (VL) ohne Sparzulage
+    #      "5400J" Vermögenswirksame Leistung (VL) mit Sparzulage
+    #      "56000" Überweisung öffentlicher Kassen
+    #      Die im Textschlüssel mit J bezeichnete Stelle, wird bei Übernahme in eine Zahlung automatisch mit der jeweils aktuellen Jahresendziffer (7, wenn 97) ersetzt.
+    #  8   49  1 Zeichen  Reserviert, " " (Blank)
+    #  9   50  11 Zeichen  Betrag in DM
+    #  10  61  8 Zeichen  Bankleitzahl des Auftraggebers
+    #  11  69  10 Zeichen  Kontonummer des Auftraggebers
+    #  12  79  11 Zeichen  Betrag in Euro einschließlich Nachkommastellen, nur belegt, wenn Euro als Währung angegeben wurde (A12, C17a), sonst Nullen
+    #  13  90  3 Zeichen  Reserviert, 3 Blanks
+    #  14a 93  27 Zeichen  Name des Kunden
+    #  14b 120  8 Zeichen  Reserviert, 8 Blanks
     #    Insgesamt 128 Zeichen
     #
-    #  15  128  27  Name des Auftraggebers
-    #  16  155  27  Verwendungszweck
-    #  17a 182  1   Währungskennzeichen  "1" = Euro
-    #  17b 183  2   Reserviert, 2 Blanks
-    #  18  185  2   Anzahl der Erweiterungsdatensätze, "00" bis "15"
-    #  19  187  2   Typ (1. Erweiterungsdatensatz)
-    #               "01" Name des Kunden
-    #               "02" Verwendungszweck
-    #               "03" Name des Auftraggebers
-    #  20  189  27  Beschreibung gemäß Typ
-    #  21  216  2   wie C19, oder Blanks (2. Erweiterungsdatensatz)
-    #  22  218  27  wie C20, oder Blanks
-    #  23  245  11  Blanks
+    #  15  128  27 Zeichen  Name des Auftraggebers
+    #  16  155  27 Zeichen  Verwendungszweck
+    #  17a 182  1 Zeichen  Währungskennzeichen
+    #      " " = DM
+    #      "1" = Euro
+    #  17b 183  2 Zeichen  Reserviert, 2 Blanks
+    #  18  185  2 Zeichen  Anzahl der Erweiterungsdatensätze, "00" bis "15"
+    #  19  187  2 Zeichen  Typ (1. Erweiterungsdatensatz)
+    #       "01" Name des Kunden
+    #       "02" Verwendungszweck
+    #       "03" Name des Auftraggebers
+    #  20  189  27 Zeichen  Beschreibung gemäß Typ
+    #  21  216  2 Zeichen  wie C19, oder Blanks (2. Erweiterungsdatensatz)
+    #  22  218  27 Zeichen  wie C20, oder Blanks
+    #  23  245  11 Zeichen  11 Blanks
     #  Insgesamt 256 Zeichen, kann wiederholt werden (max 3 mal)
     #
     # === Parameter
-    # booking<Object>::Booking object to be written to c-section
+    # booking<Object>::Booking object to be written to c-sektion
     #
     # === Returns
     # <String>:: The current dta_string
@@ -147,45 +153,48 @@ module KingDta
                       booking.account_key || Booking::UEBERWEISUNG_GUTSCHRIFT
                     end
       #Extended segments Long name & booking texts
-      exts = []
-      # 1. Part
+      exts = []  #('xx', 'inhalt') xx: 01=Name 02=Verwendung 03=Name
+      # 1. Satzabschnitt
       #data1 = '%4i' % ?? #Satzlänge kommt später
       data1 = 'C'
-      data1 +=  '%08i' % 0
-      data1 +=  '%-08i' % booking.account.bank_number
-      data1 +=  '%010i' % booking.account.bank_account_number
-      data1 +=  '0%011i0' % (booking.account.owner_number || 0)   #interne Kundennummer
+      data1 +=  '%08i' % 0  #freigestellt
+      data1 +=  '%08i' % booking.account.bank_number
+      data1 +=  '%010i' % booking.account.account_number.to_i
+      # RUBY 1.9 workaround => || 0
+      # Ruby 1.9 '0%011i0' % nil => Exception
+      # Ruby 1.8 '0%011i0' % nil => "00000000000"
+      data1 +=  '0%011i0' % (booking.account.client_number || 0)   #interne Kundennummer
       data1 +=  zahlungsart
-      data1 +=  ' '
-      data1 +=  '0' * 11
+      data1 +=  ' ' #bankintern
+      data1 +=  '0' * 11   #Reserve
       data1 +=  '%08i' % @account.bank_number
-      data1 +=  '%010i' % @account.bank_account_number
+      data1 +=  '%010i' % @account.account_number.to_i
       data1 +=  '%011i' % booking.value #Betrag in Euro einschl. Nachkomma
       data1 +=  ' ' * 3
-      data1 +=  '%-27.27s' % booking.account.owner_name
-      exts << ['01', booking.account.owner_name[27..999] ] if booking.account.owner_name.size > 27
+      data1 +=  '%-27.27s' % booking.account.client_name #Name Begünstigter/Zahlungspflichtiger
+      exts << ['01', booking.account.client_name[27..999] ] if booking.account.client_name.size > 27
       data1 +=  ' ' * 8
       #Einfügen erst möglich, wenn Satzlänge bekannt
 
-      # 2. Part
-      data2 = "%27.27s" % @account.owner_name
+      # 2. Satzabschnitt
+      data2 = "%27.27s" % @account.client_name
       booking_txt = booking.text || default_text
       #Erste 27 Zeichen
-      #if text < 26  fill with spaces
-      data2 += booking_txt[0..26].ljust(27)
+      #Wenn text < 26 Zeichen, dann mit spaces auffüllen.
+      data2 +=  booking_txt[0..26].ljust(27)
       booking_txt = booking_txt[27..999]
-      # cut text into 27 long pieces
+      # cur text into 27 long pieces
       while booking_txt && booking_txt.size > 0 && exts.size < 13
         exts << ['02', booking_txt.ljust(27) ]
         booking_txt = booking_txt[27..999]
       end
-      exts << ['03', @account.owner_name[27..999] ] if @account.owner_name.size > 27
+      exts << ['03', @account.client_name[27..999] ] if @account.client_name.size > 27
 
-      data2 +=  '1' #EUR
+      data2 +=  '1'     #Währungskennzeichen
       data2 +=  ' ' * 2
       # Gesamte Satzlänge ermitteln ( data1(+4) + data2 + Erweiterungen )
-      data1 = "%04i#{data1}" % ( data1.size + 4 + data2.size + 2 + exts.size * 29 )
-      raise "DTAUS: Längenfehler C/1 #{data1.size} nicht 128, #{booking.account.owner_name}" unless data1.size == 128
+      data1 = "%04i#{data1}" % ( data1.size + 4 + data2.size+ 2 + exts.size * 29 )
+      raise "DTAUS: Längenfehler C/1 #{data1.size} nicht 128, #{booking.account.client_name}" unless data1.size == 128
       dta_string << data1
       #Anzahl Erweiterungen anfügen
       data2 +=  '%02i' % exts.size  #Anzahl Erweiterungsteile
@@ -196,9 +205,9 @@ module KingDta
       exts[0..1].each{|e| data2 +=  "%2.2s%-27.27s" % format_ext(e[0], e[1]) }
       data2 +=  ' ' * 11
       # add the final piece of the second C section
-      raise "DTAUS: Längenfehler C/2 #{data2.size} nicht 128, #{booking.account.owner_name}" unless data2.size == 128
+      raise "DTAUS: Längenfehler C/2 #{data2.size} nicht 128, #{booking.account.client_name}" unless data2.size == 128
       dta_string << data2
-      #Create 4 text extensions
+      #Erstellen der Texterweiterungen à vier Stück
       add_ext( exts[2..5] )
       add_ext( exts[6..9] )
       add_ext( exts[10..13] )
@@ -234,27 +243,27 @@ module KingDta
 
     #Erstellen E-Segment (Prüfsummen) der DTAUS-Datei
     #Aufbau:
-    #  Nr. Start Länge   Beschreibung
-    #  1   0    4     Länge des Datensatzes, immer 128 Bytes, also immer "0128"
-    #  2   4    1     Datensatz-Typ, immer 'E'
-    #  3   5    5     "     " (Blanks)
-    #  4   10   7    Anzahl der Datensätze vom Typ C
-    #  5   17   13   Kontrollsumme Beträge
-    #  6   30   17   Kontrollsumme Kontonummern
-    #  7   47   17   Kontrollsumme Bankleitzahlen
-    #  8   64   13   Kontrollsumme Euro
-    #  9   77   51   Blanks
+    #  Nr.  Start Länge   Beschreibung
+    #  1   0    4 Zeichen    Länge des Datensatzes, immer 128 Bytes, also immer "0128"
+    #  2   4    1 Zeichen    Datensatz-Typ, immer 'E'
+    #  3   5    5 Zeichen    "     " (Blanks)
+    #  4   10  7 Zeichen    Anzahl der Datensätze vom Typ C
+    #  5   17  13 Zeichen  Kontrollsumme Beträge
+    #  6   30  17 Zeichen  Kontrollsumme Kontonummern
+    #  7   47  17 Zeichen  Kontrollsumme Bankleitzahlen
+    #  8   64  13 Zeichen  Kontrollsumme Euro, nur belegt, wenn Euro als Währung angegeben wurde (A12, C17a)
+    #  9   77  51 Zeichen  51 Blanks
     #  Insgesamt 128 Zeichen
     def add_e
       str = '0128'
       str += 'E'
       str += ' ' * 5
       str += '%07i' % @bookings.size
-      str += '0' * 13
+      str += '0' * 13 #Reserve
       str += '%017i' % @sum_bank_account_numbers
       str += '%017i' % @sum_bank_numbers
       str += '%013i' % @sum_values
-      str += ' '  * 51
+      str += ' '  * 51 #Abgrenzung Datensatz
       raise "DTAUS: Längenfehler E #{str.size} <> 128" if str.size != 128
       dta_string << str
     end