git.infodrom.org Git - infodrom/dtaus/blob - dtaus.5

   1 .\" dtaus - Converter for DTAUS files
   2 .\" Copyright (c) 2000,1  Martin Schulze <joey@infodrom.org>
   3 .\"
   4 .\" This program is free software; you can redistribute it and/ormodify
   5 .\" it under the terms of the GNU General Public License as published by
   6 .\" the Free Software Foundation; either version 2 of the License, or
   7 .\" (at your option) any later version.
   8 .\"
   9 .\" This program is distributed in the hope that it will be useful,
  10 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 .\" GNU General Public License for more details.
  13 .\"
  14 .\" You should have received a copy of the GNU General Public License
  15 .\" along with this program; if not, write to the Free Software
  16 .\" Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
  17 .\"
  18 .TH DTAUS 5 "17 November 2001" "" ""
  19 .SH NAME
  20 dtaus \- Converter for DTAUS files
  21 .SH DESCRIPTION
  22 The
  23 .BR dtaus (1)
  24 program reads and writes German DTAUS files.  DTAUS is an semi-acronym for
  25 .BR D aten T räger AUS tausch.
  26 It is used by German credit institutes in order to implement money
  27 exchanges between accounts and credit institutes.  These files are
  28 always called
  29 .IR DTAUS0.TXT .
  30
  31 Since they are shipped in a weird ascii format that is not quite
  32 readable and writable for human beings a special control format was
  33 invented.  The
  34 .BR dtaus (1)
  35 program reads and writes such a control file and generates a proper
  36 DTAUS file if requested or decodes one.
  37 .SH "CONTROL FILE"
  38 The control file implements a very simple format which was invented
  39 only for use with the
  40 .BR dtaus (1)
  41 program.  Like with many *nix configuration files empty lines and
  42 those beginning with a hash mark (``#'') are ignored.  The remaining
  43 file is splitted into three major parts: one BEGIN record
  44 (representing the A record), several regular records (representing C
  45 records) and one optional END record (representing the E record),
  46 which is ignored when the control file is read but is extracted from
  47 the bank file if one is decoded.
  48
  49 Here's a short sample for a control file:
  50
  51   BEGIN {
  52     Art   \fItype\fR
  53     Name  Martin Schulze
  54     Konto 123545
  55     BLZ   2004002
  56     Ausfuehrung 23.12.2001
  57     Euro
  58   }
  59
  60   {
  61     Transaktion \fItransaction\fR
  62     Name   Martha Schulze
  63     Konto  98832
  64     BLZ    2004003
  65     Betrag 20.00
  66     Zweck  Gebühr Wohnheimnetz
  67     Text   Anschluß u. 11+12.97
  68   }
  69
  70   ...
  71
  72 Please note that several field names are used in both the BEGIN and
  73 the regular record.  When used in the BEGIN record they denote your
  74 name and your bank account.  When used in a regular record they are
  75 affiliated with your customers data.
  76
  77 You may use up to 15 fields entitled as
  78 .BR Text .
  79 They will be recorded one by one and stored into additional data
  80 records using the same order.  This way you could add a detailed
  81 description of the type of money transfer if you like.  The contents
  82 of the field
  83 .B Zweck
  84 are most probably what the customer will see on their bank statements.
  85
  86 The field
  87 .B Ausfuehrung
  88 is optional and denotes the day when the entire transaction should be
  89 processed.  The date has to be given as DD.MM.YYYY and will be
  90 translated into the resulting bank file literally.  It may not be
  91 younger than the creation date of the file which will automatically be
  92 inserted by
  93 .BR dtaus (1).
  94 The processing date also may not be more than 15 years later than the
  95 creation date.
  96 .SS Explanation of type
  97 One of the following:
  98 .TP
  99 .I LK
 100 Lastschrift Kundenseitig
 101 .TP
 102 .I GK
 103 Gutschrift Kundenseitig
 104 .TP
 105 .I LB
 106 Lastschrift Bankseitig
 107 .TP
 108 .I GB
 109 Gutschrift Bangseitig
 110 .SS Explanation of transaction
 111 One of the following:
 112 .TP
 113 .I Einzug
 114 Bankeinzug
 115 .TP
 116 .I Gutschrift
 117 Überweisung
 118 .PP
 119 You may only use one of these for the entire file.  You are not
 120 allowed to switch between Einzug and Gutschrift within the same file.
 121 If you require the credit institute to process both types, you'll have
 122 to provide two separate diskettes.
 123 .SS "Support for Euro"
 124 From January 1st 2002 the currency in many European countries, Germany
 125 is among these, changes to Euro.  Hence, money transfer changes from DM
 126 (formerly known as ``Deutsche Mark'') to Euro.  The format
 127 specification of DTAUS was meant for DM but was modified in 2001 to
 128 support Euro as well.  The current version of
 129 .BR dtaus (1)
 130 supports both currencies.  It defaults to using DM, however.  To
 131 switch to Euro, simply add the keyword
 132 .B Euro
 133 to the BEGIN record.
 134 .SS "Character Encoding"
 135 German Umlauts are converted into two 7-bit characters on the fly so you
 136 don't need to care about them.  Since the
 137 .I DTAUS0.TXT
 138 file only uses uppercase letters every text is also converted to
 139 uppercase.
 140
 141 Except for the way records are delimited the format should be self
 142 explanatory.
 143 .SH "SEE ALSO"
 144 .BR dtaus (1).
 145
 146 DTAUS files use a special but simple and publically documented format.
 147 It is included in the distribution of
 148 .BR dtaus (1)
 149 as
 150 .IR dtaus.txt .