X-Git-Url: https://git.infodrom.org/?p=infodrom%2Fdtaus;a=blobdiff_plain;f=dtaus.5;h=64f7f29e31b2f7ed4641d6bb2e0c55a29ad9bee5;hp=7b593ceccecc2f5fdb0dc47f5540e11b97e90592;hb=b7a6e2e9ff11d283557781ba38f44ab64c7ae1fa;hpb=9ddd1b74d3c117dae88a2ef298655723cda1f641 diff --git a/dtaus.5 b/dtaus.5 index 7b593ce..64f7f29 100644 --- a/dtaus.5 +++ b/dtaus.5 @@ -1,5 +1,5 @@ .\" dtaus - Converter for DTAUS files -.\" Copyright (c) 2000,1 Martin Schulze +.\" Copyright (c) 2000,1,3 Martin Schulze .\" .\" This program is free software; you can redistribute it and/ormodify .\" it under the terms of the GNU General Public License as published by @@ -15,46 +15,50 @@ .\" 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 "11 November 2001" "" "" +.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 acronym for +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 . +.IR DTAUS0.TXT . Since they are shipped in a weird ascii format that is not quite -readable and writable for humans a special control format was -implemented. The +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. - +DTAUS file if requested or decodes one. .SH "CONTROL FILE" -The control file implements a very simple format. Empty lines and -those beginning with a hash (`#') mark are ignored. The remaining -file is splitted into three major parts: one BEGIN record, several -regular records and one optional END record, which is ignored when the -file is read but is extracted from the -.I dtaus0.txt -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 \fI\fR + Art \fItype\fR Name Martin Schulze Konto 123545 BLZ 2004002 + Ausfuehrung 23.12.2001 + Euro } { - Transaktion \fI\fR + Transaktion \fItransaction\fR Name Martha Schulze Konto 98832 BLZ 2004003 @@ -65,13 +69,31 @@ Here's a short sample for a control file: ... -You may use up to 61 fields entitle +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. This way you could add a detailed description of the type of -money transfer if you like. +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. -.SS +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 @@ -84,28 +106,68 @@ Gutschrift Kundenseitig Lastschrift Bankseitig .TP .I GB -Gutschrift Bangseitig - -.SS +Gutschrift Bankseitig +.SS Explanation of transaction One of the following: .TP -.I Lastschrift +.I Einzug Bankeinzug .TP .I Gutschrift Überweisung - -.SS Character Encoding -German Umlauts are converted to 7-bit on the fly so you don't need to -care about them. Since the -.I dtaus0.txt +.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" -DTAUS files use a special but simple and freely documented format. -It is included in the distribution of dtaus as +.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 .