dtaus 0.1
Sign up to get free protection for your applications and to get access to all the features.
- data/LICENSE +19 -0
- data/README.markdown +56 -0
- data/lib/dtaus.rb +210 -0
- data/lib/dtaus/buchung.rb +116 -0
- data/lib/dtaus/erweiterung.rb +50 -0
- data/lib/dtaus/konto.rb +36 -0
- metadata +66 -0
data/LICENSE
ADDED
@@ -0,0 +1,19 @@
|
|
1
|
+
Copyright (c) 2010 Michael Strüder
|
2
|
+
|
3
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
4
|
+
of this software and associated documentation files (the "Software"), to deal
|
5
|
+
in the Software without restriction, including without limitation the rights
|
6
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
7
|
+
copies of the Software, and to permit persons to whom the Software is
|
8
|
+
furnished to do so, subject to the following conditions:
|
9
|
+
|
10
|
+
The above copyright notice and this permission notice shall be included in
|
11
|
+
all copies or substantial portions of the Software.
|
12
|
+
|
13
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
14
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
15
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
16
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
17
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
18
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
19
|
+
THE SOFTWARE.
|
data/README.markdown
ADDED
@@ -0,0 +1,56 @@
|
|
1
|
+
DTAUS
|
2
|
+
=====
|
3
|
+
|
4
|
+
This is a library specific to the german banking sector. Therefore the documentation will be in german. If you have any questions please feel free to email me at mikezter@gmail.com
|
5
|
+
|
6
|
+
Beim Datenträgeraustausch (DTA) werden Zahlungsverkehrsdaten - also Überweisungen und Lastschriften - als Datei an ein Geldinstitut übergeben. Dieser Gem stellt Klassen bereit solche Dateien zu erzeugen.
|
7
|
+
|
8
|
+
How-To:
|
9
|
+
-------------
|
10
|
+
|
11
|
+
Ablauf:
|
12
|
+
|
13
|
+
* Erstelle ein Auftraggeber-Konto
|
14
|
+
* Erstelle ein DTAUS Objekt für diesen Auftraggeber
|
15
|
+
* Erstelle ein oder mehrerere Kunden-Konten mit dazugehörigen Buchungen
|
16
|
+
* Füge die Buchungen dem DTAUS Objekt hinzu
|
17
|
+
* Schreibe eine DTAUS Datei
|
18
|
+
* _Alternativ:_ Gebe die Daten als String aus
|
19
|
+
|
20
|
+
In Ruby:
|
21
|
+
|
22
|
+
auftraggeber = DTAUS::Konto.new(1234567890, 12345670, 'Muster GmbH', 'Deutsche Bank', true)
|
23
|
+
|
24
|
+
dta = DTAUS.new(auftraggeber)
|
25
|
+
|
26
|
+
kunde = DTAUS::Konto.new(1234567890, 12345670, 'Max Meier-Schulze', 'Sparkasse')
|
27
|
+
buchung = DTAUS::Buchung.new(auftraggeber, kunde, 39.99, 'Vielen Dank für ihren Einkauf vom 01.01.2010. Rechnungsnummer 12345')
|
28
|
+
|
29
|
+
dta.add(buchung)
|
30
|
+
|
31
|
+
dta.to_file
|
32
|
+
|
33
|
+
puts dta
|
34
|
+
|
35
|
+
|
36
|
+
Einschränkungen:
|
37
|
+
----------------
|
38
|
+
|
39
|
+
* Es sind nur Lastschriften möglich. __Typ der Datei ist LK__ (Lastschrift Kunde).
|
40
|
+
* Auftraggeber, Empfänger und Verwendungszweck können jeweils 27 Zeichen enthalten. Es stehen 15 Erweiterungen à 27 Zeichen zur Verfügung. Jede Erweiterung kann entweder Auftraggeber, Empfänger oder Verwendungszweck erweitern.
|
41
|
+
|
42
|
+
Todo:
|
43
|
+
------
|
44
|
+
|
45
|
+
* Gutschriften ermöglichen
|
46
|
+
* Refactor to Module instead of Class with Subclasses
|
47
|
+
* Parameter als Hash annehmen (vor allem für `Konto` und `Buchung`)
|
48
|
+
* weiteres?
|
49
|
+
|
50
|
+
Weitere Informationen
|
51
|
+
---------------------
|
52
|
+
|
53
|
+
Infos zu DTAUS: http://www.infodrom.org/projects/dtaus/dtaus.html
|
54
|
+
|
55
|
+
DTAUS online check: http://www.xpecto.de/index.php?id=148,7
|
56
|
+
|
data/lib/dtaus.rb
ADDED
@@ -0,0 +1,210 @@
|
|
1
|
+
require 'dtaus/buchung'
|
2
|
+
require 'dtaus/konto'
|
3
|
+
|
4
|
+
#
|
5
|
+
# :title:DTAUS-Datei erstellen
|
6
|
+
#
|
7
|
+
# =DTAUS-Datei für Sammellastschrift erstellen
|
8
|
+
#
|
9
|
+
# Quick How-To:
|
10
|
+
# auftraggeber = DTAUS::Konto.new(1234567890, 12345670, 'Muster GmbH', 'Deutsche Bank', true)
|
11
|
+
# kunde = DTAUS::Konto.new(1234567890, 12345670, 'Max Meier-Schulze', 'Sparkasse')
|
12
|
+
# buchung = DTAUS::Buchung.new(auftraggeber, kunde, 39.99, 'Vielen Dank für ihren Einkauf vom 01.01.2010. Rechnungsnummer 12345')
|
13
|
+
# dta = DTAUS.new(auftraggeber)
|
14
|
+
# dta.add(buchung)
|
15
|
+
# dta.to_file
|
16
|
+
#
|
17
|
+
# Typ der Datei ist 'LK' (Lastschrift Kunde)
|
18
|
+
#
|
19
|
+
# Infos zu DTAUS: http://www.infodrom.org/projects/dtaus/dtaus.php3
|
20
|
+
# DTAUS online check: http://www.xpecto.de/index.php?id=148,7
|
21
|
+
#
|
22
|
+
class DTAUS
|
23
|
+
|
24
|
+
class DTAUSException < Exception
|
25
|
+
end
|
26
|
+
|
27
|
+
class IncorrectSize < DTAUSException
|
28
|
+
end
|
29
|
+
|
30
|
+
attr_reader :auftraggeber, :buchungen, :datum, :positiv
|
31
|
+
alias :positiv? :positiv
|
32
|
+
|
33
|
+
def initialize(auftraggeber, datum = Time.new)
|
34
|
+
raise DTAUSException.new("Konto expected, got #{auftraggeber.class}") unless auftraggeber.is_a?(DTAUS::Konto)
|
35
|
+
raise DTAUSException.new("Date or Time expected, got #{datum.class}") unless datum.is_a?(Date) or datum.is_a?(Time)
|
36
|
+
|
37
|
+
@datum = datum
|
38
|
+
@auftraggeber = auftraggeber
|
39
|
+
@buchungen = []
|
40
|
+
end
|
41
|
+
|
42
|
+
# 2 Zeichen Art der Transaktionen
|
43
|
+
# "LB" für Lastschriften Bankseitig
|
44
|
+
# "LK" für Lastschriften Kundenseitig
|
45
|
+
# "GB" für Gutschriften Bankseitig
|
46
|
+
# "GK" für Gutschriften Kundenseitig
|
47
|
+
#
|
48
|
+
def typ
|
49
|
+
'LK'
|
50
|
+
end
|
51
|
+
|
52
|
+
# Eine Buchung hinzufügen.
|
53
|
+
# Es wird geprüft, ob das Vorzeichen identisch mit den bisherigen Vorzeichen ist.
|
54
|
+
#
|
55
|
+
def add(buchung)
|
56
|
+
raise DTAUSException.new("Buchung expected, got #{buchung.class}") unless buchung.is_a?(DTAUS::Buchung)
|
57
|
+
# Die erste Buchung bestimmt, ob alle Beträge positiv oder negativ sind.
|
58
|
+
if buchungen == []
|
59
|
+
@positiv = buchung.positiv? # alle Beträge sind positiv. Variable wird mit erstem Eintrag geändert
|
60
|
+
end
|
61
|
+
raise DTAusException.new("Das Vorzeichen wechselte") if @positiv != buchung.positiv?
|
62
|
+
@buchungen << buchung
|
63
|
+
end
|
64
|
+
|
65
|
+
# Gibt die DTAUS-Datei als String zurück
|
66
|
+
#
|
67
|
+
def to_dta
|
68
|
+
raise DTAUSException.new("Keine Buchungen vorhanden") unless buchungen.size > 0
|
69
|
+
temp = dataA
|
70
|
+
temp += buchungen.inject(''){|temp, buchung| temp += buchung.to_dta}
|
71
|
+
temp += dataE
|
72
|
+
raise IncorrectSize.new("Datensatzlänge ist nicht durch 128 teilbar: #{temp.size}") if temp.size % 128 != 0
|
73
|
+
temp
|
74
|
+
end
|
75
|
+
alias :to_s :to_dta
|
76
|
+
|
77
|
+
# Schreibt die DTAUS-Datei
|
78
|
+
# Standarddateiname ist DTAUS0.TXT
|
79
|
+
#
|
80
|
+
def to_file(filename ='DTAUS0.TXT')
|
81
|
+
File.open(filename, 'w') do |file|
|
82
|
+
file << to_dta
|
83
|
+
end
|
84
|
+
end
|
85
|
+
|
86
|
+
# Zeichen umsetzen gemäss DTA-Norm
|
87
|
+
#
|
88
|
+
def self.convert_text(_text)
|
89
|
+
tmp = _text.to_s.dup
|
90
|
+
tmp = tmp.upcase()
|
91
|
+
tmp = tmp.gsub('Ä', 'AE')
|
92
|
+
tmp = tmp.gsub('Ü', 'UE')
|
93
|
+
tmp = tmp.gsub('Ö', 'OE')
|
94
|
+
tmp = tmp.gsub('ä', 'AE')
|
95
|
+
tmp = tmp.gsub('ü', 'UE')
|
96
|
+
tmp = tmp.gsub('ö', 'OE')
|
97
|
+
tmp = tmp.gsub('ß', 'SS')
|
98
|
+
tmp = tmp.strip
|
99
|
+
end
|
100
|
+
|
101
|
+
# Konvertiert einen String in einen Integer
|
102
|
+
# indem alle Nicht-Digits entfernt werden.
|
103
|
+
# Lässt Integer unberührt.
|
104
|
+
#
|
105
|
+
def self.convert_number(_number)
|
106
|
+
case _number
|
107
|
+
when Integer then _number
|
108
|
+
when String then _number.strip.gsub(/\D/, '').to_i
|
109
|
+
else raise DTAUSException.new("Cannot convert #{_number.class} to Integer")
|
110
|
+
end
|
111
|
+
end
|
112
|
+
|
113
|
+
private
|
114
|
+
|
115
|
+
# Checksumme der Kontonummern
|
116
|
+
#
|
117
|
+
def checksum_konto
|
118
|
+
@buchungen.inject(0){|sum, buchung| sum += buchung.konto.nummer}
|
119
|
+
end
|
120
|
+
|
121
|
+
# Checksumme der Bankleitzahlen
|
122
|
+
#
|
123
|
+
def checksum_blz
|
124
|
+
@buchungen.inject(0){|sum, buchung| sum += buchung.konto.blz}
|
125
|
+
end
|
126
|
+
|
127
|
+
# Checksumme der Beträge
|
128
|
+
#
|
129
|
+
def checksum_betrag
|
130
|
+
@buchungen.inject(0){|sum, buchung| sum += buchung.betrag}
|
131
|
+
end
|
132
|
+
|
133
|
+
# Erstellt A-Segment der DTAUS-Datei
|
134
|
+
# Aufbau des Segments:
|
135
|
+
#
|
136
|
+
# Nr. Start Länge Beschreibung
|
137
|
+
# 1 0 4 Zeichen Länge des Datensatzes, immer 128 Bytes, also immer "0128"
|
138
|
+
# 2 4 1 Zeichen Datensatz-Typ, immer 'A'
|
139
|
+
# 3 5 2 Zeichen Art der Transaktionen
|
140
|
+
# "LB" für Lastschriften Bankseitig
|
141
|
+
# "LK" für Lastschriften Kundenseitig
|
142
|
+
# "GB" für Gutschriften Bankseitig
|
143
|
+
# "GK" für Gutschriften Kundenseitig
|
144
|
+
# 4 7 8 Zeichen Bankleitzahl des Auftraggebers
|
145
|
+
# 5 15 8 Zeichen CST, "00000000", nur belegt, wenn Diskettenabsender Kreditinstitut
|
146
|
+
# 6 23 27 Zeichen Name des Auftraggebers
|
147
|
+
# 7 50 6 Zeichen aktuelles Datum im Format DDMMJJ
|
148
|
+
# 8 56 4 Zeichen CST, " " (Blanks)
|
149
|
+
# 9 60 10 Zeichen Kontonummer des Auftraggebers
|
150
|
+
# 10 70 10 Zeichen Optionale Referenznummer
|
151
|
+
# 11a 80 15 Zeichen Reserviert, 15 Blanks
|
152
|
+
# 11b 95 8 Zeichen Ausführungsdatum im Format DDMMJJJJ. Nicht jünger als Erstellungsdatum (A7), jedoch höchstens 15 Kalendertage später. Sonst Blanks.
|
153
|
+
# 11c 103 24 Zeichen Reserviert, 24 Blanks
|
154
|
+
# 12 127 1 Zeichen Währungskennzeichen
|
155
|
+
# " " = DM
|
156
|
+
# "1" = Euro
|
157
|
+
#
|
158
|
+
# Insgesamt 128 Zeichen
|
159
|
+
#
|
160
|
+
def dataA( )
|
161
|
+
dta = '0128' # 4 Zeichen Länge des Datensatzes, immer 128 Bytes, also immer "0128"
|
162
|
+
dta += 'A' # 1 Zeichen Datensatz-Typ, immer 'A'
|
163
|
+
dta += typ # 2 Zeichen Art der Transaktionen
|
164
|
+
dta += '%8i' % auftraggeber.blz # 8 Zeichen Bankleitzahl des Auftraggebers
|
165
|
+
dta += '%08i' % 0 # 8 Zeichen CST, "00000000", nur belegt, wenn Diskettenabsender Kreditinstitut
|
166
|
+
dta += '%-27.27s' % auftraggeber.name # 27 Zeichen Name des Auftraggebers
|
167
|
+
dta += @datum.strftime("%d%m%y") # 6 Zeichen aktuelles Datum im Format DDMMJJ
|
168
|
+
dta += ' ' * 4 # 4 Zeichen CST, " " (Blanks)
|
169
|
+
dta += '%010i' % auftraggeber.nummer # 10 Zeichen Kontonummer des Auftraggebers
|
170
|
+
dta += '%010i' % 0 # 10 Zeichen Optionale Referenznummer
|
171
|
+
dta += ' ' * 15 # 15 Zeichen Reserviert, 15 Blanks
|
172
|
+
dta += '%8s' % @datum.strftime("%d%m%Y") # 8 Zeichen Optionales Ausführungsdatum im Format DDMMJJJJ. Nicht jünger als Erstellungsdatum (A7), jedoch höchstens 15 Kalendertage später. Sonst Blanks.
|
173
|
+
dta += ' ' * 24 # 24 Zeichen Reserviert, 24 Blanks
|
174
|
+
dta += '1' # 1 Zeichen Währungskennzeichen ('1' = Euro)
|
175
|
+
raise IncorrectSize.new("A-Segment: #{dta.size} Zeichen, 128 erwartet.") if dta.size != 128
|
176
|
+
return dta
|
177
|
+
end
|
178
|
+
|
179
|
+
# Erstellt E-Segment (Prüfsummen) der DTAUS-Datei
|
180
|
+
# Aufbau:
|
181
|
+
#
|
182
|
+
# Nr. Start Länge Beschreibung
|
183
|
+
# 1 0 4 Zeichen Länge des Datensatzes, immer 128 Bytes, also immer "0128"
|
184
|
+
# 2 4 1 Zeichen Datensatz-Typ, immer 'E'
|
185
|
+
# 3 5 5 Zeichen 5 Blanks
|
186
|
+
# 4 10 7 Zeichen Anzahl der Datensätze vom Typ C
|
187
|
+
# 5 17 13 Zeichen Kontrollsumme Beträge
|
188
|
+
# 6 30 17 Zeichen Kontrollsumme Kontonummern
|
189
|
+
# 7 47 17 Zeichen Kontrollsumme Bankleitzahlen
|
190
|
+
# 8 64 13 Zeichen Kontrollsumme Euro, nur belegt, wenn Euro als Währung angegeben wurde (A12, C17a)
|
191
|
+
# 9 77 51 Zeichen 51 Blanks
|
192
|
+
#
|
193
|
+
# Insgesamt 128 Zeichen
|
194
|
+
#
|
195
|
+
def dataE()
|
196
|
+
dta = '0128' # 4 Zeichen Länge des Datensatzes, immer 128 Bytes, also immer "0128"
|
197
|
+
dta += 'E' # 1 Zeichen Datensatz-Typ, immer 'E'
|
198
|
+
dta += ' ' * 5 # 5 Zeichen 5 Blanks
|
199
|
+
dta += '%07i' % @buchungen.size # 7 Zeichen Anzahl der Datensätze vom Typ C
|
200
|
+
dta += '0' * 13 # 13 Zeichen Kontrollsumme Beträge in DM
|
201
|
+
dta += '%017i' % checksum_konto # 17 Zeichen Kontrollsumme Kontonummern
|
202
|
+
dta += '%017i' % checksum_blz # 17 Zeichen Kontrollsumme Bankleitzahlen
|
203
|
+
dta += '%013i' % checksum_betrag # 13 Zeichen Kontrollsumme Beträge in Euro
|
204
|
+
dta += ' ' * 51 # 51 Zeichen 51 Blanks
|
205
|
+
raise IncorrectSize.new("E-Segment: #{dta.size}, 128 erwartet") if dta.size != 128
|
206
|
+
return dta
|
207
|
+
end
|
208
|
+
|
209
|
+
end
|
210
|
+
|
@@ -0,0 +1,116 @@
|
|
1
|
+
require 'enumerator'
|
2
|
+
require 'dtaus/erweiterung'
|
3
|
+
|
4
|
+
class DTAUS
|
5
|
+
|
6
|
+
# Buchung erstellen
|
7
|
+
# buchung = Buchung.new(auftraggeber_konto, kunden_konto, betrag, verwendungszweck)
|
8
|
+
#
|
9
|
+
# auftraggeber_konto und kunden_konto müssen ein DTAUS::Konto sein
|
10
|
+
# betrag muss ein Float sein
|
11
|
+
#
|
12
|
+
class Buchung
|
13
|
+
attr_reader :betrag, :konto, :text, :positiv, :auftraggeber
|
14
|
+
alias :positiv? :positiv
|
15
|
+
|
16
|
+
def initialize(_auftraggeber, _konto, _betrag, _text = "")
|
17
|
+
raise DTAusException.new("Konto expected, got #{_konto.class}") unless _konto.is_a?(Konto)
|
18
|
+
raise DTAUSException.new("Betrag is a #{_betrag.class}, expected Float") unless _betrag.is_a?(Float)
|
19
|
+
raise DTAUSException.new("Betrag ist 0.0") unless _betrag > 0
|
20
|
+
|
21
|
+
@auftraggeber = _auftraggeber
|
22
|
+
@konto = _konto
|
23
|
+
@text = DTAUS.convert_text(_text)
|
24
|
+
|
25
|
+
raise IncorrectSize.new("Zuviele Erweiterungen: #{erweiterungen.size}, maximal 15. Verwendungszweck zu lang?") if erweiterungen.size > 15
|
26
|
+
|
27
|
+
@betrag = (_betrag * 100 ).to_i # Euro-Cent
|
28
|
+
if betrag > 0
|
29
|
+
@positiv = true
|
30
|
+
else
|
31
|
+
@betrag = -betrag # only store positive amounts
|
32
|
+
@positiv = false
|
33
|
+
end
|
34
|
+
end
|
35
|
+
|
36
|
+
|
37
|
+
# 5 Zeichen Art der Transaktion (7a: 2 Zeichen, 7b: 3 Zeichen)
|
38
|
+
# "04000" Lastschrift des Abbuchungsauftragsverfahren
|
39
|
+
# "05000" Lastschrift des Einzugsermächtigungsverfahren
|
40
|
+
# "05005" Lastschrift aus Verfügung im elektronischen Cash-System
|
41
|
+
# "05006" Wie 05005 mit ausländischen Karten
|
42
|
+
# "05015" Lastschrift aus Verfügung im elec. Cash-System - POZ
|
43
|
+
# "51000" Überweisungs-Gutschrift
|
44
|
+
# "53000" Überweisung Lohn/Gehalt/Rente
|
45
|
+
# "54XXJ" Vermögenswirksame Leistung (VL) mit Sparzulage
|
46
|
+
# "56000" Überweisung öffentlicher Kassen
|
47
|
+
# Die im Textschlüssel mit XX bezeichnete Stelle ist 00 oder der Prozentsatz der Sparzulage.
|
48
|
+
# Die im Textschlüssel mit J bezeichnete Stelle wird bei Übernahme in eine Zahlung automatisch mit der jeweils aktuellen Jahresendziffer (z.B. 7, wenn 97) ersetzt.
|
49
|
+
#
|
50
|
+
def zahlungsart
|
51
|
+
'05000'
|
52
|
+
end
|
53
|
+
|
54
|
+
def verwendungszweck_erweiterungen
|
55
|
+
Erweiterung.from_string(:verwendungszweck, text)
|
56
|
+
end
|
57
|
+
|
58
|
+
def erweiterungen
|
59
|
+
@erweiterungen ||= konto.erweiterungen + auftraggeber.erweiterungen + verwendungszweck_erweiterungen
|
60
|
+
end
|
61
|
+
|
62
|
+
def to_dta
|
63
|
+
"#{dataC}#{dataC_erweiterungen}"
|
64
|
+
end
|
65
|
+
|
66
|
+
def size
|
67
|
+
(187 + erweiterungen.size * 29)
|
68
|
+
end
|
69
|
+
|
70
|
+
private
|
71
|
+
|
72
|
+
# Erstellt den Erweiterungen-Teil des C-Segments für diese Buchung
|
73
|
+
#
|
74
|
+
def dataC_erweiterungen
|
75
|
+
dta = auftraggeber.name[0..26].ljust(27) # 27 Zeichen Name des Auftraggebers
|
76
|
+
dta += text[0..26].ljust(27) # 27 Zeichen Verwendungszweck
|
77
|
+
dta += '1' # 1 Zeichen Währungskennzeichen ('1' = Euro)
|
78
|
+
dta += ' ' # 2 Zeichen Reserviert, 2 Blanks
|
79
|
+
dta += "%02i" % erweiterungen.size # 2 Zeichen Anzahl der Erweiterungsdatensätze, "00" bis "15"
|
80
|
+
dta += erweiterungen[0..1].inject('') {|data, erweiterung| data += erweiterung.to_dta}
|
81
|
+
dta = dta.ljust(128)
|
82
|
+
if erweiterungen.size > 2
|
83
|
+
erweiterungen[2..-1].each_slice(4) do |slice|
|
84
|
+
dta += slice.inject('') {|dta, erweiterung| dta += erweiterung.to_dta}.ljust(128)
|
85
|
+
end
|
86
|
+
end
|
87
|
+
raise IncorrectSize.new("Erweiterungen: #{dta.size} Zeichen") if dta.size > 256 * 3 or dta.size % 128 != 0
|
88
|
+
return dta
|
89
|
+
|
90
|
+
end
|
91
|
+
|
92
|
+
# Erstellt ein C-Segments für diese Buchung
|
93
|
+
#
|
94
|
+
def dataC
|
95
|
+
dta = '%04i' % size # 4 Zeichen Länge des Datensatzes, 187 + x * 29 (x..Anzahl Erweiterungsteile)
|
96
|
+
dta += 'C' # 1 Zeichen Datensatz-Typ, immer 'C'
|
97
|
+
dta += '%08i' % 0 # 8 Zeichen Bankleitzahl des Auftraggebers (optional)
|
98
|
+
dta += '%08i' % konto.blz # 8 Zeichen Bankleitzahl des Kunden
|
99
|
+
dta += '%010i' % konto.nummer # 10 Zeichen Kontonummer des Kunden
|
100
|
+
dta += '0%011i0' % konto.kunnr # 13 Zeichen Verschiedenes 1. Zeichen: "0" 2. - 12. Zeichen: interne Kundennummer oder Nullen 13. Zeichen: "0"
|
101
|
+
dta += zahlungsart # 5 Zeichen Art der Transaktion (7a: 2 Zeichen, 7b: 3 Zeichen)
|
102
|
+
dta += ' ' # 1 Zeichen Reserviert, " " (Blank)
|
103
|
+
dta += '0' * 11 # 11 Zeichen Betrag
|
104
|
+
dta += '%08i' % auftraggeber.blz # 8 Zeichen Bankleitzahl des Auftraggebers
|
105
|
+
dta += '%010i' % auftraggeber.nummer # 10 Zeichen Kontonummer des Auftraggebers
|
106
|
+
dta += '%011i' % betrag # 11 Zeichen Betrag in Euro einschließlich Nachkommastellen, nur belegt, wenn Euro als Währung angegeben wurde
|
107
|
+
dta += ' ' * 3 # 3 Zeichen Reserviert, 3 Blanks
|
108
|
+
dta += konto.name[0..26].ljust(27) # 27 Zeichen Name des Kunden
|
109
|
+
dta += ' ' * 8 # 8 Zeichen Reserviert, 8 Blanks
|
110
|
+
raise IncorrectSize.new("C-Segement 1: #{dta.size} Zeichen, 128 erwartet (#{konto.name})") if dta.size != 128
|
111
|
+
return dta
|
112
|
+
end
|
113
|
+
|
114
|
+
end
|
115
|
+
end
|
116
|
+
|
@@ -0,0 +1,50 @@
|
|
1
|
+
class DTAUS
|
2
|
+
# Eine Erweiterung eines C-Segments
|
3
|
+
# Stellt eine Länge von 27 Zeichen sicher
|
4
|
+
#
|
5
|
+
class Erweiterung
|
6
|
+
TYPE_KUNDE = '01'
|
7
|
+
TYPE_VERWENDUNGZWECK = '02'
|
8
|
+
TYPE_AUFTRAGGEBER = '03'
|
9
|
+
|
10
|
+
TYPES = {
|
11
|
+
:kunde => TYPE_KUNDE,
|
12
|
+
:verwendungszweck => TYPE_VERWENDUNGZWECK,
|
13
|
+
:auftraggeber => TYPE_AUFTRAGGEBER
|
14
|
+
}
|
15
|
+
|
16
|
+
class IncorrectErweiterungType; end;
|
17
|
+
attr_reader :type, :text
|
18
|
+
|
19
|
+
# Erstellt ein Array von Erweiterungen aus einem beliebig langem String
|
20
|
+
#
|
21
|
+
def self.from_string(_typ, _text)
|
22
|
+
erweiterungen = []
|
23
|
+
_text = DTAUS.convert_text(_text)
|
24
|
+
if _text.size > 27
|
25
|
+
index = 27
|
26
|
+
while index < _text.size
|
27
|
+
erweiterungen << Erweiterung.new(_typ, _text[index..index += 26])
|
28
|
+
end
|
29
|
+
end
|
30
|
+
erweiterungen
|
31
|
+
end
|
32
|
+
|
33
|
+
# erweiterung = Erweiterung.new(:verwendungszweck, 'Rechnung Nr 12345')
|
34
|
+
# _type muss ein Symbol aus :kunde, :verwendungszweck, :auftraggeber sein.
|
35
|
+
#
|
36
|
+
def initialize(_type, _text)
|
37
|
+
raise IncorrectErweiterungType.new unless TYPES.keys.include?(_type) or TYPES.values.include?(_type)
|
38
|
+
@text = DTAUS.convert_text(_text).ljust(27)
|
39
|
+
raise IncorrectSize.new("Text size may not exceed 27 Chars") if text.size > 27
|
40
|
+
@type = TYPES[_type] || _type
|
41
|
+
end
|
42
|
+
|
43
|
+
def to_dta
|
44
|
+
"#{type}#{text}"
|
45
|
+
end
|
46
|
+
|
47
|
+
end
|
48
|
+
|
49
|
+
end
|
50
|
+
|
data/lib/dtaus/konto.rb
ADDED
@@ -0,0 +1,36 @@
|
|
1
|
+
require 'dtaus/erweiterung'
|
2
|
+
|
3
|
+
class DTAUS
|
4
|
+
# Kontodaten verwalten mit Name des Inhabers und Bank, Bankleitzahl und Kontonummer.
|
5
|
+
#
|
6
|
+
# Kundenkonto:
|
7
|
+
# konto = Konto.new(kontonummer, bankleitzahl, inhaber, bankname, false, kundennummer)
|
8
|
+
# oder einfach
|
9
|
+
# konto = Konto.new(kontonummer, bankleitzahl, inhaber, bankname)
|
10
|
+
#
|
11
|
+
# Auftraggeberkonto:
|
12
|
+
# konto = Konto.new(kontonummer, bankleitzahl, inhaber, bankname, true)
|
13
|
+
#
|
14
|
+
class Konto
|
15
|
+
attr_reader :blz, :bank, :name, :kunnr, :auftraggeber, :nummer
|
16
|
+
|
17
|
+
def initialize(_nummer, _blz, _name, _bank, _auftraggeber = false, _kunnr = 0)
|
18
|
+
@auftraggeber = _auftraggeber
|
19
|
+
|
20
|
+
@nummer = DTAUS.convert_number(_nummer)
|
21
|
+
@blz = DTAUS.convert_number(_blz)
|
22
|
+
@kunnr = DTAUS.convert_number(_kunnr)
|
23
|
+
@name = DTAUS.convert_text(_name)
|
24
|
+
@bank = DTAUS.convert_text(_bank)
|
25
|
+
|
26
|
+
raise DTAUSException.new("Ungültige Kontonummer: #{nummer}") if nummer == 0 or nummer.to_s.size > 10
|
27
|
+
raise DTAUSException.new("Ungültige Bankleitzahl: #{blz}") if blz == 0 or blz.to_s.size > 8
|
28
|
+
end
|
29
|
+
|
30
|
+
def erweiterungen
|
31
|
+
Erweiterung.from_string(auftraggeber ? :auftraggeber : :kunde, name)
|
32
|
+
end
|
33
|
+
|
34
|
+
end
|
35
|
+
end
|
36
|
+
|
metadata
ADDED
@@ -0,0 +1,66 @@
|
|
1
|
+
--- !ruby/object:Gem::Specification
|
2
|
+
name: dtaus
|
3
|
+
version: !ruby/object:Gem::Version
|
4
|
+
prerelease: false
|
5
|
+
segments:
|
6
|
+
- 0
|
7
|
+
- 1
|
8
|
+
version: "0.1"
|
9
|
+
platform: ruby
|
10
|
+
authors:
|
11
|
+
- mikezter
|
12
|
+
autorequire:
|
13
|
+
bindir: bin
|
14
|
+
cert_chain: []
|
15
|
+
|
16
|
+
date: 2010-03-10 00:00:00 +01:00
|
17
|
+
default_executable:
|
18
|
+
dependencies: []
|
19
|
+
|
20
|
+
description: "Beim Datentr\xC3\xA4geraustausch (DTA) werden Zahlungsverkehrsdaten - also \xC3\x9Cberweisungen und Lastschriften - als Datei an ein Geldinstitut \xC3\xBCbergeben. Dieser Gem stellt Klassen bereit solche Dateien zu erzeugen."
|
21
|
+
email: mikezter@gmail.com
|
22
|
+
executables: []
|
23
|
+
|
24
|
+
extensions: []
|
25
|
+
|
26
|
+
extra_rdoc_files: []
|
27
|
+
|
28
|
+
files:
|
29
|
+
- README.markdown
|
30
|
+
- LICENSE
|
31
|
+
- lib/dtaus.rb
|
32
|
+
- lib/dtaus/erweiterung.rb
|
33
|
+
- lib/dtaus/buchung.rb
|
34
|
+
- lib/dtaus/konto.rb
|
35
|
+
has_rdoc: true
|
36
|
+
homepage: http://github.com/mikezter/dtaus
|
37
|
+
licenses: []
|
38
|
+
|
39
|
+
post_install_message:
|
40
|
+
rdoc_options: []
|
41
|
+
|
42
|
+
require_paths:
|
43
|
+
- lib
|
44
|
+
required_ruby_version: !ruby/object:Gem::Requirement
|
45
|
+
requirements:
|
46
|
+
- - ">="
|
47
|
+
- !ruby/object:Gem::Version
|
48
|
+
segments:
|
49
|
+
- 0
|
50
|
+
version: "0"
|
51
|
+
required_rubygems_version: !ruby/object:Gem::Requirement
|
52
|
+
requirements:
|
53
|
+
- - ">="
|
54
|
+
- !ruby/object:Gem::Version
|
55
|
+
segments:
|
56
|
+
- 0
|
57
|
+
version: "0"
|
58
|
+
requirements: []
|
59
|
+
|
60
|
+
rubyforge_project:
|
61
|
+
rubygems_version: 1.3.6
|
62
|
+
signing_key:
|
63
|
+
specification_version: 3
|
64
|
+
summary: DTAUS allows to easily create DTAUS files for the german banking sector
|
65
|
+
test_files: []
|
66
|
+
|