king_dtaus 2.0.0 → 2.0.1.pre
Sign up to get free protection for your applications and to get access to all the features.
- data/.rvmrc +1 -0
- data/Gemfile +1 -5
- data/Gemfile.lock +38 -0
- data/README.rdoc +120 -0
- data/Rakefile +1 -7
- data/VERSION +1 -1
- data/king_dtaus.gemspec +11 -12
- data/lib/king_dta/account.rb +29 -30
- data/lib/king_dta/dta.rb +0 -10
- data/lib/king_dta/dtaus.rb +134 -125
- data/lib/king_dta/dtazv.rb +221 -183
- data/lib/king_dta/helper.rb +1 -3
- data/lib/king_dtaus.rb +0 -1
- data/spec/account_spec.rb +150 -64
- data/spec/booking_spec.rb +3 -1
- data/spec/dtaus_spec.rb +12 -35
- data/spec/dtazv_spec.rb +155 -54
- data/spec/dtazv_test.rb +105 -0
- data/spec/spec_helper.rb +65 -43
- metadata +38 -48
- data/.travis.yml +0 -3
- data/README.markdown +0 -128
- /data/{docs/example.output → example.output} +0 -0
data/lib/king_dta/dtaus.rb
CHANGED
@@ -1,9 +1,10 @@
|
|
1
1
|
# encoding: utf-8
|
2
|
+
#Erstelle eine DTAUS-Datei.
|
3
|
+
#Typ ist 'LK' (Lastschrift Kunde) oder 'GK' (Gutschrift Kunde)
|
4
|
+
#
|
5
|
+
#Infos zu DTAUS: http://www.infodrom.org/projects/dtaus/dtaus.php3
|
6
|
+
|
2
7
|
module KingDta
|
3
|
-
#Create a DTAUS string.
|
4
|
-
# == infos
|
5
|
-
# https://www.ksk-koeln.de/formatbeschreibung_datentraegeraustausch.pdfx
|
6
|
-
# http://www.infodrom.org/projects/dtaus/dtaus.html
|
7
8
|
class Dtaus < KingDta::Dta
|
8
9
|
attr_reader :sum_bank_account_numbers, :sum_bank_numbers, :sum_values
|
9
10
|
|
@@ -12,9 +13,13 @@ module KingDta
|
|
12
13
|
# typ<String>:: valid strings are 'LK' (Lastschrift Kunde) and 'GK' (Gutschrift Kunde)
|
13
14
|
# typ<Date>:: date when the the transfer is to be created
|
14
15
|
def initialize( typ, date=Date.today )
|
16
|
+
raise ArgumentError.new("Wrong date format. Make it a Time or Date object with yyyy-mm-dd") unless date.respond_to?(:strftime)
|
15
17
|
raise ArgumentError.new("Unknown order type: #{typ}. Allowed Values are LK, GK") unless ['LK','GK'].include?(typ)
|
16
|
-
@
|
17
|
-
|
18
|
+
@date = date
|
19
|
+
@typ = typ
|
20
|
+
@value_pos = true #all values are positive by default. Variable changes with first booking entry
|
21
|
+
@closed = false
|
22
|
+
@default_text = '' # default verwendungzweck
|
18
23
|
end
|
19
24
|
|
20
25
|
# Creates the whole dta string(in the right order) and returns it
|
@@ -36,7 +41,7 @@ module KingDta
|
|
36
41
|
def set_checksums
|
37
42
|
@sum_bank_account_numbers, @sum_bank_numbers, @sum_values = 0,0,0
|
38
43
|
bookings.each do |b|
|
39
|
-
@sum_bank_account_numbers += b.account.
|
44
|
+
@sum_bank_account_numbers += b.account.account_number.to_i
|
40
45
|
@sum_bank_numbers += b.account.bank_number.to_i
|
41
46
|
@sum_values += b.value
|
42
47
|
end
|
@@ -44,99 +49,100 @@ module KingDta
|
|
44
49
|
|
45
50
|
#Erstellen A-Segment der DTAUS-Datei
|
46
51
|
#Aufbau des Segments:
|
47
|
-
# Nr.
|
48
|
-
# 1 0 4
|
49
|
-
# 2 4 1
|
50
|
-
# 3 5 2
|
51
|
-
#
|
52
|
-
#
|
53
|
-
#
|
54
|
-
#
|
55
|
-
# 4 7
|
56
|
-
# 5 15 8
|
57
|
-
# 6 23 27
|
58
|
-
# 7 50 6
|
59
|
-
# 8 56 4
|
60
|
-
# 9 60 10
|
61
|
-
# 10 70 10
|
62
|
-
# 11a 80 15
|
63
|
-
# 11b 95 8
|
64
|
-
# 11c 103
|
65
|
-
# 12 127
|
66
|
-
#
|
52
|
+
# Nr. Start Länge Beschreibung
|
53
|
+
# 1 0 4 Zeichen Länge des Datensatzes, immer 128 Bytes, also immer "0128"
|
54
|
+
# 2 4 1 Zeichen Datensatz-Typ, immer 'A'
|
55
|
+
# 3 5 2 Zeichen Art der Transaktionen
|
56
|
+
# "LB" für Lastschriften Bankseitig
|
57
|
+
# "LK" für Lastschriften Kundenseitig
|
58
|
+
# "GB" für Gutschriften Bankseitig
|
59
|
+
# "GK" für Gutschriften Kundenseitig
|
60
|
+
# 4 7 8 Zeichen Bankleitzahl des Auftraggebers
|
61
|
+
# 5 15 8 Zeichen CST, "00000000", nur belegt, wenn Diskettenabsender Kreditinstitut
|
62
|
+
# 6 23 27 Zeichen Name des Auftraggebers
|
63
|
+
# 7 50 6 Zeichen aktuelles Datum im Format DDMMJJ
|
64
|
+
# 8 56 4 Zeichen CST, " " (Blanks)
|
65
|
+
# 9 60 10 Zeichen Kontonummer des Auftraggebers
|
66
|
+
# 10 70 10 Zeichen Optionale Referenznummer
|
67
|
+
# 11a 80 15 Zeichen Reserviert, 15 Blanks
|
68
|
+
# 11b 95 8 Zeichen Ausführungsdatum im Format DDMMJJJJ. Nicht jünger als Erstellungsdatum (A7), jedoch höchstens 15 Kalendertage später. Sonst Blanks.
|
69
|
+
# 11c 103 24 Zeichen Reserviert, 24 Blanks
|
70
|
+
# 12 127 1 Zeichen Währungskennzeichen
|
71
|
+
# " " = DM
|
72
|
+
# "1" = Euro
|
67
73
|
# Insgesamt 128 Zeichen
|
68
74
|
def add_a
|
69
75
|
data = '0128'
|
70
|
-
data += 'A'
|
71
|
-
data += @typ
|
72
|
-
data += '%8i' % @account.bank_number #.rjust(8)
|
73
|
-
data += '%08i' % 0
|
74
|
-
data += '%-27.27s' % @account.
|
75
|
-
data += @date.strftime("%d%m%y")
|
76
|
-
data += ' ' * 4
|
77
|
-
data += '%010i' % @account.
|
78
|
-
data += '%010i' % 0
|
79
|
-
data += ' ' * 15
|
80
|
-
data += '%8s' % @date.strftime("%d%m%Y") #Ausführungsdatum
|
81
|
-
data += ' ' * 24
|
82
|
-
data += '1'
|
76
|
+
data += 'A' #Segment
|
77
|
+
data += @typ #Lastschriften Kunde
|
78
|
+
data += '%8i' % @account.bank_number #.rjust(8) #bank_number
|
79
|
+
data += '%08i' % 0 #belegt, wenn Bank
|
80
|
+
data += '%-27.27s' % @account.client_name
|
81
|
+
data += @date.strftime("%d%m%y") #aktuelles Datum im Format DDMMJJ
|
82
|
+
data += ' ' * 4 #bankinternes Feld
|
83
|
+
data += '%010i' % @account.account_number.to_i
|
84
|
+
data += '%010i' % 0 #Referenznummer
|
85
|
+
data += ' ' * 15 #Reserve
|
86
|
+
data += '%8s' % @date.strftime("%d%m%Y") #Ausführungsdatum (ja hier 8 Stellen, Erzeugungsdat. hat 6 Stellen)
|
87
|
+
data += ' ' * 24 #Reserve
|
88
|
+
data += '1' #Kennzeichen Euro
|
83
89
|
raise "DTAUS: Längenfehler A (#{data.size} <> 128)\n" if data.size != 128
|
84
90
|
dta_string << data
|
85
91
|
end #dataA
|
86
92
|
|
87
93
|
#Erstellen C-Segmente (Buchungen mit Texten) der DTAUS-Datei
|
88
94
|
#Aufbau:
|
89
|
-
# Nr.
|
90
|
-
# 1 0 4
|
91
|
-
# 2 4 1
|
92
|
-
# 3 5 8
|
93
|
-
# 4 13
|
94
|
-
# 5 21
|
95
|
-
# 6 31
|
96
|
-
#
|
97
|
-
#
|
98
|
-
#
|
99
|
-
#
|
100
|
-
#
|
101
|
-
#
|
102
|
-
#
|
103
|
-
#
|
104
|
-
#
|
105
|
-
#
|
106
|
-
#
|
107
|
-
#
|
108
|
-
#
|
109
|
-
#
|
110
|
-
#
|
111
|
-
#
|
112
|
-
#
|
113
|
-
# 8
|
114
|
-
#
|
115
|
-
#
|
116
|
-
#
|
117
|
-
#
|
118
|
-
#
|
119
|
-
# 14a 93 27 Name des Kunden
|
120
|
-
# 14b 120 8 Reserviert, 8 Blanks
|
95
|
+
# Nr. St Länge Beschreibung
|
96
|
+
# 1 0 4 Zeichen Länge des Datensatzes, 187 + x * 29 (x..Anzahl Erweiterungsteile)
|
97
|
+
# 2 4 1 Zeichen Datensatz-Typ, immer 'C'
|
98
|
+
# 3 5 8 Zeichen Bankleitzahl des Auftraggebers (optional)
|
99
|
+
# 4 13 8 Zeichen Bankleitzahl des Kunden
|
100
|
+
# 5 21 10 Zeichen Kontonummer des Kunden
|
101
|
+
# 6 31 13 Zeichen Verschiedenes
|
102
|
+
# 1. Zeichen: "0"
|
103
|
+
# 2. - 12. Zeichen: interne Kundennummer oder Nullen
|
104
|
+
# 13. Zeichen: "0"
|
105
|
+
# 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.
|
106
|
+
# 7 44 5 Zeichen Art der Transaktion (7a: 2 Zeichen, 7b: 3 Zeichen)
|
107
|
+
# "04000" Lastschrift des Abbuchungsauftragsverfahren
|
108
|
+
# "05000" Lastschrift des Einzugsermächtigungsverfahren
|
109
|
+
# "05005" Lastschrift aus Verfügung im elektronischen Cash-System
|
110
|
+
# "05006" Wie 05005 mit ausländischen Karten
|
111
|
+
# "51000" Überweisungs-Gutschrift
|
112
|
+
# "53000" Überweisung Lohn/Gehalt/Rente
|
113
|
+
# "5400J" Vermögenswirksame Leistung (VL) ohne Sparzulage
|
114
|
+
# "5400J" Vermögenswirksame Leistung (VL) mit Sparzulage
|
115
|
+
# "56000" Überweisung öffentlicher Kassen
|
116
|
+
# Die im Textschlüssel mit J bezeichnete Stelle, wird bei Übernahme in eine Zahlung automatisch mit der jeweils aktuellen Jahresendziffer (7, wenn 97) ersetzt.
|
117
|
+
# 8 49 1 Zeichen Reserviert, " " (Blank)
|
118
|
+
# 9 50 11 Zeichen Betrag in DM
|
119
|
+
# 10 61 8 Zeichen Bankleitzahl des Auftraggebers
|
120
|
+
# 11 69 10 Zeichen Kontonummer des Auftraggebers
|
121
|
+
# 12 79 11 Zeichen Betrag in Euro einschließlich Nachkommastellen, nur belegt, wenn Euro als Währung angegeben wurde (A12, C17a), sonst Nullen
|
122
|
+
# 13 90 3 Zeichen Reserviert, 3 Blanks
|
123
|
+
# 14a 93 27 Zeichen Name des Kunden
|
124
|
+
# 14b 120 8 Zeichen Reserviert, 8 Blanks
|
121
125
|
# Insgesamt 128 Zeichen
|
122
126
|
#
|
123
|
-
# 15 128 27 Name des Auftraggebers
|
124
|
-
# 16 155 27 Verwendungszweck
|
125
|
-
# 17a 182 1
|
126
|
-
#
|
127
|
-
#
|
128
|
-
#
|
129
|
-
#
|
130
|
-
#
|
131
|
-
#
|
132
|
-
#
|
133
|
-
#
|
134
|
-
#
|
135
|
-
#
|
127
|
+
# 15 128 27 Zeichen Name des Auftraggebers
|
128
|
+
# 16 155 27 Zeichen Verwendungszweck
|
129
|
+
# 17a 182 1 Zeichen Währungskennzeichen
|
130
|
+
# " " = DM
|
131
|
+
# "1" = Euro
|
132
|
+
# 17b 183 2 Zeichen Reserviert, 2 Blanks
|
133
|
+
# 18 185 2 Zeichen Anzahl der Erweiterungsdatensätze, "00" bis "15"
|
134
|
+
# 19 187 2 Zeichen Typ (1. Erweiterungsdatensatz)
|
135
|
+
# "01" Name des Kunden
|
136
|
+
# "02" Verwendungszweck
|
137
|
+
# "03" Name des Auftraggebers
|
138
|
+
# 20 189 27 Zeichen Beschreibung gemäß Typ
|
139
|
+
# 21 216 2 Zeichen wie C19, oder Blanks (2. Erweiterungsdatensatz)
|
140
|
+
# 22 218 27 Zeichen wie C20, oder Blanks
|
141
|
+
# 23 245 11 Zeichen 11 Blanks
|
136
142
|
# Insgesamt 256 Zeichen, kann wiederholt werden (max 3 mal)
|
137
143
|
#
|
138
144
|
# === Parameter
|
139
|
-
# booking<Object>::Booking object to be written to c-
|
145
|
+
# booking<Object>::Booking object to be written to c-sektion
|
140
146
|
#
|
141
147
|
# === Returns
|
142
148
|
# <String>:: The current dta_string
|
@@ -147,45 +153,48 @@ module KingDta
|
|
147
153
|
booking.account_key || Booking::UEBERWEISUNG_GUTSCHRIFT
|
148
154
|
end
|
149
155
|
#Extended segments Long name & booking texts
|
150
|
-
exts = []
|
151
|
-
# 1.
|
156
|
+
exts = [] #('xx', 'inhalt') xx: 01=Name 02=Verwendung 03=Name
|
157
|
+
# 1. Satzabschnitt
|
152
158
|
#data1 = '%4i' % ?? #Satzlänge kommt später
|
153
159
|
data1 = 'C'
|
154
|
-
data1 += '%08i' % 0
|
155
|
-
data1 += '
|
156
|
-
data1 += '%010i' % booking.account.
|
157
|
-
|
160
|
+
data1 += '%08i' % 0 #freigestellt
|
161
|
+
data1 += '%08i' % booking.account.bank_number
|
162
|
+
data1 += '%010i' % booking.account.account_number.to_i
|
163
|
+
# RUBY 1.9 workaround => || 0
|
164
|
+
# Ruby 1.9 '0%011i0' % nil => Exception
|
165
|
+
# Ruby 1.8 '0%011i0' % nil => "00000000000"
|
166
|
+
data1 += '0%011i0' % (booking.account.client_number || 0) #interne Kundennummer
|
158
167
|
data1 += zahlungsart
|
159
|
-
data1 += ' '
|
160
|
-
data1 += '0' * 11
|
168
|
+
data1 += ' ' #bankintern
|
169
|
+
data1 += '0' * 11 #Reserve
|
161
170
|
data1 += '%08i' % @account.bank_number
|
162
|
-
data1 += '%010i' % @account.
|
171
|
+
data1 += '%010i' % @account.account_number.to_i
|
163
172
|
data1 += '%011i' % booking.value #Betrag in Euro einschl. Nachkomma
|
164
173
|
data1 += ' ' * 3
|
165
|
-
data1 += '%-27.27s' % booking.account.
|
166
|
-
exts << ['01', booking.account.
|
174
|
+
data1 += '%-27.27s' % booking.account.client_name #Name Begünstigter/Zahlungspflichtiger
|
175
|
+
exts << ['01', booking.account.client_name[27..999] ] if booking.account.client_name.size > 27
|
167
176
|
data1 += ' ' * 8
|
168
177
|
#Einfügen erst möglich, wenn Satzlänge bekannt
|
169
178
|
|
170
|
-
# 2.
|
171
|
-
data2 = "%27.27s" % @account.
|
172
|
-
|
179
|
+
# 2. Satzabschnitt
|
180
|
+
data2 = "%27.27s" % @account.client_name
|
181
|
+
zweck = booking.text || default_text
|
173
182
|
#Erste 27 Zeichen
|
174
|
-
#
|
175
|
-
data2 +=
|
176
|
-
|
177
|
-
#
|
178
|
-
while
|
179
|
-
exts << ['02',
|
180
|
-
|
183
|
+
#Wenn text < 26 Zeichen, dann mit spaces auffüllen.
|
184
|
+
data2 += zweck[0..26].ljust(27)
|
185
|
+
zweck = zweck[27..999]
|
186
|
+
# cur text into 27 long pieces
|
187
|
+
while zweck && zweck.size > 0 && exts.size < 13
|
188
|
+
exts << ['02', zweck.ljust(27) ]
|
189
|
+
zweck = zweck[27..999]
|
181
190
|
end
|
182
|
-
exts << ['03', @account.
|
191
|
+
exts << ['03', @account.client_name[27..999] ] if @account.client_name.size > 27
|
183
192
|
|
184
|
-
data2 += '1'
|
193
|
+
data2 += '1' #Währungskennzeichen
|
185
194
|
data2 += ' ' * 2
|
186
195
|
# Gesamte Satzlänge ermitteln ( data1(+4) + data2 + Erweiterungen )
|
187
|
-
data1 = "%04i#{data1}" % ( data1.size + 4 + data2.size
|
188
|
-
raise "DTAUS: Längenfehler C/1 #{data1.size} nicht 128, #{booking.account.
|
196
|
+
data1 = "%04i#{data1}" % ( data1.size + 4 + data2.size+ 2 + exts.size * 29 )
|
197
|
+
raise "DTAUS: Längenfehler C/1 #{data1.size} nicht 128, #{booking.account.client_name}" unless data1.size == 128
|
189
198
|
dta_string << data1
|
190
199
|
#Anzahl Erweiterungen anfügen
|
191
200
|
data2 += '%02i' % exts.size #Anzahl Erweiterungsteile
|
@@ -196,9 +205,9 @@ module KingDta
|
|
196
205
|
exts[0..1].each{|e| data2 += "%2.2s%-27.27s" % format_ext(e[0], e[1]) }
|
197
206
|
data2 += ' ' * 11
|
198
207
|
# add the final piece of the second C section
|
199
|
-
raise "DTAUS: Längenfehler C/2 #{data2.size} nicht 128, #{booking.account.
|
208
|
+
raise "DTAUS: Längenfehler C/2 #{data2.size} nicht 128, #{booking.account.client_name}" unless data2.size == 128
|
200
209
|
dta_string << data2
|
201
|
-
#
|
210
|
+
#Erstellen der Texterweiterungen à vier Stück
|
202
211
|
add_ext( exts[2..5] )
|
203
212
|
add_ext( exts[6..9] )
|
204
213
|
add_ext( exts[10..13] )
|
@@ -234,27 +243,27 @@ module KingDta
|
|
234
243
|
|
235
244
|
#Erstellen E-Segment (Prüfsummen) der DTAUS-Datei
|
236
245
|
#Aufbau:
|
237
|
-
# Nr.
|
238
|
-
# 1 0 4
|
239
|
-
# 2 4 1
|
240
|
-
# 3 5 5
|
241
|
-
# 4 10
|
242
|
-
# 5 17
|
243
|
-
# 6 30
|
244
|
-
# 7 47
|
245
|
-
# 8 64
|
246
|
-
# 9 77
|
246
|
+
# Nr. Start Länge Beschreibung
|
247
|
+
# 1 0 4 Zeichen Länge des Datensatzes, immer 128 Bytes, also immer "0128"
|
248
|
+
# 2 4 1 Zeichen Datensatz-Typ, immer 'E'
|
249
|
+
# 3 5 5 Zeichen " " (Blanks)
|
250
|
+
# 4 10 7 Zeichen Anzahl der Datensätze vom Typ C
|
251
|
+
# 5 17 13 Zeichen Kontrollsumme Beträge
|
252
|
+
# 6 30 17 Zeichen Kontrollsumme Kontonummern
|
253
|
+
# 7 47 17 Zeichen Kontrollsumme Bankleitzahlen
|
254
|
+
# 8 64 13 Zeichen Kontrollsumme Euro, nur belegt, wenn Euro als Währung angegeben wurde (A12, C17a)
|
255
|
+
# 9 77 51 Zeichen 51 Blanks
|
247
256
|
# Insgesamt 128 Zeichen
|
248
257
|
def add_e
|
249
258
|
str = '0128'
|
250
259
|
str += 'E'
|
251
260
|
str += ' ' * 5
|
252
261
|
str += '%07i' % @bookings.size
|
253
|
-
str += '0' * 13
|
262
|
+
str += '0' * 13 #Reserve
|
254
263
|
str += '%017i' % @sum_bank_account_numbers
|
255
264
|
str += '%017i' % @sum_bank_numbers
|
256
265
|
str += '%013i' % @sum_values
|
257
|
-
str += ' ' * 51
|
266
|
+
str += ' ' * 51 #Abgrenzung Datensatz
|
258
267
|
raise "DTAUS: Längenfehler E #{str.size} <> 128" if str.size != 128
|
259
268
|
dta_string << str
|
260
269
|
end
|