File: dtaus.5

package info (click to toggle)
dtaus 0.7-1
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 164 kB
  • ctags: 131
  • sloc: ansic: 1,408; makefile: 78; sh: 10
file content (173 lines) | stat: -rw-r--r-- 5,623 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
.\" dtaus - Converter for DTAUS files
.\" Copyright (c) 2000,1,3  Martin Schulze <joey@infodrom.org>
.\"
.\" This program is free software; you can redistribute it and/ormodify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
.\"
.TH DTAUS 5 "17 November 2001" "" ""
.SH NAME
dtaus \- Converter for DTAUS files
.SH DESCRIPTION
The
.BR dtaus (1)
program reads and writes German DTAUS files.  DTAUS is an semi-acronym for
.BR D aten T r�ger AUS tausch.
It is used by German credit institutes in order to implement money
exchanges between accounts and credit institutes.  These files are
always called
.IR DTAUS0.TXT .

Since they are shipped in a weird ascii format that is not quite
readable and writable for human beings a special control format was
invented.  The
.BR dtaus (1)
program reads and writes such a control file and generates a proper
DTAUS file if requested or decodes one.
.SH "CONTROL FILE"
The control file implements a very simple format which was invented
only for use with the
.BR dtaus (1)
program.  Like with many *nix configuration files empty lines and
those beginning with a hash mark (``#'') are ignored.  The remaining
file is splitted into three major parts: one BEGIN record
(representing the A record), several regular records (representing C
records) and one optional END record (representing the E record),
which is ignored when the control file is read but is extracted from
the bank file if one is decoded.

Here's a short sample for a control file:

  BEGIN {
    Art   \fItype\fR
    Name  Martin Schulze
    Konto 123545
    BLZ   2004002
    Ausfuehrung 23.12.2001
    Euro
  }

  {
    Transaktion \fItransaction\fR
    Name   Martha Schulze
    Konto  98832
    BLZ    2004003
    Betrag 20.00
    Zweck  Geb�hr Wohnheimnetz
    Text   Anschlu� u. 11+12.97
  }

  ...

Please note that several field names are used in both the BEGIN and
the regular record.  When used in the BEGIN record they denote your
name and your bank account.  When used in a regular record they are
affiliated with your customers data.

You may use up to 15 fields entitled as
.BR Text .
They will be recorded one by one and stored into additional data
records using the same order.  This way you could add a detailed
description of the type of money transfer if you like.  The contents
of the field
.B Zweck
are most probably what the customer will see on their bank statements.

The field
.B Ausfuehrung
is optional and denotes the day when the entire transaction should be
processed.  The date has to be given as DD.MM.YYYY and will be
translated into the resulting bank file literally.  It may not be
younger than the creation date of the file which will automatically be
inserted by
.BR dtaus (1).
The processing date also may not be more than 15 years later than the
creation date.
.SS Explanation of type
One of the following:
.TP
.I LK
Lastschrift Kundenseitig
.TP
.I GK
Gutschrift Kundenseitig
.TP
.I LB
Lastschrift Bankseitig
.TP
.I GB
Gutschrift Bankseitig
.SS Explanation of transaction
One of the following:
.TP
.I Einzug
Bankeinzug
.TP
.I Gutschrift
�berweisung
.TP
.IR Verm�gen " [JJJJ]"
Verm�genswirksame Leistung mit Sparzulage.  Als Argument kann das Jahr
angegeben werden, f�r das diese Leistung gilt.  Wenn es weggelassen,
wird, verwendet
.B dtaus
das aktuelle Jahr.  Vom Jahr wird nur die letzte Ziffer verwendet, es
mu� daher auch nicht vollst�ndig angegeben werden.
.TP
.IR Vermoegen " [JJJJ]"
Wie
.IR Verm�gen ,
jedoch ohne Umlaut.
.TP
.I E-Cash
Lastschrift aus Verf�gung im elecctronic Cash-System
.TP
.I E-Cash-A
Lastschrift aus Verf�gung im elecctronic Cash-System mit ausl�ndischer Karte.
.PP
You may only use one of these for the entire file.  You are not
allowed to switch between Einzug and Gutschrift within the same file.
If you require the credit institute to process both types, you'll have
to provide two separate diskettes.
.SS "Support for Euro"
From January 1st 2002 the currency in many European countries, Germany
is among these, changes to Euro.  Hence, money transfer changes from DM
(formerly known as ``Deutsche Mark'') to Euro.  The format
specification of DTAUS was meant for DM but was modified in 2001 to
support Euro as well.  The current version of
.BR dtaus (1)
supports both currencies.  It defaults to using Euro, however.  To
switch to DM, simply add the keyword
.B DM
(or
.B Euro
respectively if this version was compiled without Euro support as default)
to the BEGIN record.  If no currency keyword is given, the compiled in
decides (upstream source defaults to Euro).
.SS "Character Encoding"
German Umlauts are converted into two 7-bit characters on the fly so you
don't need to care about them.  Since the
.I DTAUS0.TXT
file only uses uppercase letters every text is also converted to
uppercase.

Except for the way records are delimited the format should be self
explanatory.
.SH "SEE ALSO"
.BR dtaus (1).

DTAUS files use a special but simple and publically documented format.
It is included in the distribution of
.BR dtaus (1)
as
.IR dtaus.txt .