Schnittstellenbeschreibung Fibu-Stammdaten - ABACUS Research ...
Schnittstellenbeschreibung Fibu-Stammdaten - ABACUS Research ...
Schnittstellenbeschreibung Fibu-Stammdaten - ABACUS Research ...
Sie wollen auch ein ePaper? Erhöhen Sie die Reichweite Ihrer Titel.
YUMPU macht aus Druck-PDFs automatisch weboptimierte ePaper, die Google liebt.
A B A C U S<br />
SCHNITTSTELLEN-<br />
BESCHREIBUNG<br />
FÜR STAMMDATEN<br />
Version 2003 - 2005<br />
Juli 2004/mb<br />
Diese Unterlagen sind urheberrechtlich geschützt.<br />
Alle Rechte, auch die der Übersetzung, des Nachdrucks und der Vervielfältigung der Unterlagen,<br />
oder Teilen daraus, vorbehalten. Kein Teil der Unterlagen darf ohne schriftliche Genehmigung<br />
der <strong>ABACUS</strong> <strong>Research</strong> AG in irgend einer Form (Fotokopie oder ein anderes Verfahren),<br />
auch nicht für Zwecke der Unterrichtsgestaltung, reproduziert oder unter Verwendung elektronischer<br />
Systeme verarbeitet, vervielfältigt oder verbreitet werden.<br />
Copyright © 2004 by <strong>ABACUS</strong> <strong>Research</strong> AG, Kronbühl.
Inhaltsverzeichnis<br />
1 Übersicht <strong>Stammdaten</strong>schnittstelle ASCII.........................................................................1<br />
1.1 Programmübersicht ......................................................................................................1<br />
2 Aufbau des ASCII-Records ..................................................................................................3<br />
2.1 Kopfzeile Konten/Kostenstellenpläne ...........................................................................3<br />
2.2 Kopfzeile Gliederungsebenen ......................................................................................4<br />
2.3 Klassierungselemente ..................................................................................................5<br />
2.4 Für Konten/Kostenarten................................................................................................7<br />
2.5 Kostenstellen/Kostenträger...........................................................................................9<br />
2.6 Default Druckattribute ................................................................................................ 10<br />
2.7 Druckattribute Klassierungselemente........................................................................ 11<br />
<strong>Schnittstellenbeschreibung</strong> <strong>Stammdaten</strong> Seite I
Übersicht <strong>Stammdaten</strong>schnittstelle ASCII 1<br />
1 Übersicht <strong>Stammdaten</strong>schnittstelle ASCII<br />
1.1 Programmübersicht<br />
Bild 1: Kontoplan importieren/exportieren<br />
Möglichkeiten<br />
Die ASCII-Schnittstelle der Finanzbuchhaltung dient dem Import und Export von Kontenplänen.<br />
Eingelesen bzw. ausgegeben werden wahlweise die einzelnen Klassierungselemente (Bereiche,<br />
Klassen, Hauptgruppen, Gruppen, etc.) und die Konten bzw. Kostenstellen sowie die<br />
Druckattribute. Es können zudem bestehende Kontenpläne ergänzt und in beschränktem Umfang<br />
geändert werden.<br />
Die Schnittstelle der Finanzbuchhaltung kann nur Eingabedateien verarbeiten, die dem hier<br />
beschriebenen Schnittstellenformat Version 4.0 entsprechen.<br />
Die Schnittstellendefinition hat nur Gültigkeit für die Version 2003 und neuer. Zudem bedingt es,<br />
dass ein Servicepack neuer als 10. Juli 2004 installiert ist.<br />
Die ASCII-Datei muss folgende Bedingungen erfüllen:<br />
♦ Die erste Zeile der ASCII-Datei enthält folgenden obligatorischen Header-Record:<br />
<strong>ABACUS</strong>,IFKPLAN,4.0<br />
<strong>Schnittstellenbeschreibung</strong> <strong>Stammdaten</strong> Seite 1
Übersicht <strong>Stammdaten</strong>schnittstelle ASCII 1<br />
♦ Eine Zeile pro Datenbankrecord<br />
♦ Die einzelnen Datenbankfelder werden durch Kommas getrennt.<br />
♦ Die vorgegebene Reihenfolge der Felder (siehe unten) muss eingehalten werden.<br />
♦ Fakultative Felder, die am Ende der Zeile stehen, können weggelassen werden.<br />
♦ ‚Charakter’-Felder, die länger als 1 Zeichen sind, werden entweder von Anführungszeichen<br />
(“) oder von Apostrophen (‘) begrenzt. (Enthält ein Feld einen Apostroph, so muss das Feld<br />
von Anführungszeichen begrenzt sein und umgekehrt. Ein Feld darf deshalb nicht gleichzeitig<br />
sowohl Anführungszeichen als auch Apostrophe enthalten.)<br />
♦ Die letzte relevante Zeile der ASCII-Datei enthält (fakultativ, aber dringend empfohlen) folgenden<br />
Trailer-Record:<br />
<strong>ABACUS</strong>,EOF<br />
Beim Import wird zunächst überprüft, ob bereits ein Eintrag mit der angegebenen Identifikation<br />
vorhanden ist. Falls ja, wird der entsprechende Eintrag geändert (nicht verändert werden in der<br />
vorliegenden Version die Konto-Referenznummer von Kostenarten und der Konten-Typ). Andernfalls<br />
wird ein neuer Eintrag erstellt.<br />
Beim Import von alternativen Kotenplänen wird nur die Klassierung übernommen. Konten und<br />
Kostenstellen können nur via Standardkonten- bzw. Kostenstellenplan eingelesen werden.<br />
<strong>Schnittstellenbeschreibung</strong> <strong>Stammdaten</strong> Seite 2
Aufbau des ASCII-Records 2<br />
2 Aufbau des ASCII-Records<br />
2.1 Kopfzeile Konten/Kostenstellenpläne<br />
Pos Bezeichnung Inhalt/Bemerkungen<br />
1 Plan Identifikation Kontenpläne:<br />
1 Kontenplan<br />
2 Kostenstellenplan<br />
2 Variante Variante des Planes (1-9999)<br />
1 Standard<br />
3 Stufe 0 Klassierungsstufe Kopfzeilen<br />
4 Identifikation Bezeichnung Plan 0 Identifikation des Elementes<br />
5 Typ Titelzeilen, Typ des Elementes: 1<br />
6 “Bezeichnung“ Bezeichnung des Plans alphanumerisch, max. 40 Zeichen<br />
7 Ebenen Anzahl Gliederungsebenen (1 – 9)<br />
8 Staffelform Markierung Staffelform ’1’ für Kontenplan in Staffelform,<br />
sonst leer. Wird bei bestehenden Einträgen ignoriert<br />
9 Totalisatoren Belegung Totalisatoren alphanumerisch, max. 80 Zeichen<br />
’1’ an Stelle n, falls der Totalisator n im Kontenplan definiert<br />
ist, sonst leer. Wird bei bestehenden Einträgen ignoriert.<br />
<strong>Schnittstellenbeschreibung</strong> <strong>Stammdaten</strong> Seite 3
Aufbau des ASCII-Records 2<br />
2.2 Kopfzeile Gliederungsebenen<br />
Pos. Bezeichnung Inhalt/Bemerkungen<br />
1 Plan Kontenplan-Identifikation<br />
1 Kontenplan<br />
2 Kostenstellenplan<br />
2 Variante Variante des Planes (1-9999)<br />
1 Standard<br />
3 Stufe Klassierungsstufe<br />
0 Kopfzeilen<br />
4 Identifikation Gliederungsebene (1 - 9)<br />
5 Typ Typ des Elementes:<br />
Titelzeilen 1<br />
6 “Bezeichnung“ Bezeichnung der Gliederungsebene alphanumerisch, max.<br />
40 Zeichen<br />
<strong>Schnittstellenbeschreibung</strong> <strong>Stammdaten</strong> Seite 4
Aufbau des ASCII-Records 2<br />
2.3 Klassierungselemente<br />
Pos.<br />
(1)<br />
Bezeichnung (2) Inhalt/Bemerkungen<br />
1 Plan Kontenplan-Identifikation<br />
1 Kontenplan<br />
2 Kostenstellenplan<br />
2 Variante Variante des Planes (1-9999)<br />
1 Standard<br />
3 Stufe Klassierungsstufe (1 – 9)<br />
Ebene 1 (Bereich ): 1<br />
Ebene 2 (Klassen): 2<br />
Ebene 3 (Hauptgr.): 3<br />
Ebene 4 (Gruppen): 4<br />
usw.<br />
4 Identifikation Identifikation des Klassierungselements<br />
Ebene 1 (Bereich): A bis Z alternativ 1 – 26<br />
Ebene 2 (Klassen): Max. 12 Stellen<br />
Ebene 3 (Hauptgr.): Max. 12 Stellen<br />
Ebene 4 (Gruppen): Max. 12 Stellen<br />
usw.<br />
5 Typ Typ des Elements (1 – 3)<br />
1 Titel<br />
2 Total<br />
3 Totalisator<br />
6 “Bezeichnung“ Bezeichnung des Klassierungselements alphanumerisch,<br />
max. 40 Zeichen<br />
7 Referenzlevel Ebene der nächsthöheren Klassierungsstufe (0 – 8)<br />
8 Referenz Referenz auf die nächsthöhere Klassierungsstufe<br />
Ebene 1 (Bereich): 0<br />
Ebene 2 (Klassen): Bereichs-Id<br />
Ebene 3 (Hauptgr.): Klassen-Nr.<br />
Ebene 4 (Gruppen): Hauptgruppen-Nr.<br />
usw.<br />
(9) “2. Nummer“ Alternative Nummer alphanumerisch, max. 18 Zeichen<br />
(10) “2. Bezeichnung“ Alternative Bezeichnung alphanumerisch, max. 40 Zeichen<br />
(11) Seitenumbruch Entfällt<br />
(12) Sammelkonto Markierung Sammelkonto (nur Gruppen, resp. unterste<br />
Ebene der Klassierung) ’1’ für Gruppen ist Sammelkonto,<br />
sonst leer<br />
(13) Subtotal/Basis Subtotal/Prozentbasis alphanumerisch, 2 Zeichen<br />
“10“ für Element ist Subtotal<br />
“01“ für Element ist Prozentbasis<br />
“11“ für Element ist Subtotal und %-Basis<br />
sonst leer<br />
(14) Totalisator-Nr. Totalisator-Nummer numerisch, max. 2 Stellen (1 – 80)<br />
Falls das Element einen Totalisator bezeichnet:<br />
Nummer des Totalisators, sonst leer<br />
(15) Totalisator-Liste Liste der Totalisator-Mitgliedschaften alphanumerisch,<br />
max. 80 Zeichen<br />
(16) ’+’ an Stelle n, falls der Saldo des Elementes zum Totalisator<br />
n addiert werden soll, ’-’ an Stelle n, falls der Saldo subtrahiert<br />
werden soll, ’’ sonst<br />
<strong>Schnittstellenbeschreibung</strong> <strong>Stammdaten</strong> Seite 5
Aufbau des ASCII-Records 2<br />
1 In Klammern gesetzte Felder sind fakultativ<br />
2 Felder, deren Bezeichnung in Anführungszeichen stehen, müssen entweder zwischen<br />
Anführungszeichen oder Apostrophen stehen.<br />
<strong>Schnittstellenbeschreibung</strong> <strong>Stammdaten</strong> Seite 6
Aufbau des ASCII-Records 2<br />
2.4 Für Konten/Kostenarten<br />
Pos.<br />
(1)<br />
Bezeichnung (2) Inhalt/Bemerkungen<br />
1 Plan Kontenplan-Typ<br />
1 Kontenplan<br />
2 Variante Variante des Planes (1 – 9999)<br />
1 Standard<br />
3 Stufe Klassierungsstufe<br />
90 Konten/Kostenarten<br />
4 Identifikation Identifikation des Kontos/der Kostenart numerisch, Konten<br />
max. 11 Stellen<br />
5 Typ Immer 1<br />
6 Bezeichnung Bezeichnung des Kontos / der Kostenart alphanumerisch,<br />
max. 40 Zeichen<br />
7 Referenzlevel Ebene der nächsthöheren Klassierungsstufe (1 – 9)<br />
8 Referenz Referenz auf die nächsthöhere Klassierungsstufe<br />
9 Bereich Bereich des Konto: 1 – 5 / A – E<br />
(10) ISO ISO-Code alphanumerisch, 3 Zeichen Muss in der Fremdwährungstabelle<br />
(siehe Programm 571) definiert sein. Wird<br />
beim Import von bereits bestehenden Einträgen ignoriert<br />
falls fehlend, wird ISO-Code des Mandanten verwendet.<br />
(11) Einheit Mengeneinheit der Kostenart alphanumerisch, max. 4 Zeichen.<br />
Muss im Masseinheiten-Stamm (siehe Progr. 21)<br />
definiert sein. Wird beim Import von bereits bestehenden<br />
Einträgen ignoriert. Default: keine<br />
(12) <strong>Fibu</strong>-Ref Referenzkonto einer Kostenart Muss Nummer eines gültigen<br />
Kontos sein. Wird beim Import von bereits bestehenden<br />
Kostenarten ignoriert. Default: 0<br />
(13) Typ Kontentyp<br />
0 Konto<br />
1 Kostenart<br />
2 Int. Verrechnung<br />
Wird beim Import von bereits bestehenden Konti/Kostenarten<br />
ignoriert. Default: 0 = Konto<br />
(14) 2. Nummer Alternative Nummer alphanumerisch, max. 18 Zeichen<br />
(15) 2. Bezeichnung Alternative Bezeichnung alphanumerisch, max. 40 Zeichen<br />
(16) Bemerkung 1 Bemerkungsfeld 1 alphanumerisch, max. 40 Zeichen<br />
(17) Bemerkung 2 Bemerkungsfeld 2 alphanumerisch, max. 40 Zeichen<br />
(18) Konsolidierungs-<br />
Kontonummer<br />
Konsolidierungskontonummer numerisch, max. 11 Stellen<br />
wird bei bestehenden Einträgen ignoriert. Die Erfassung<br />
erfolgt in der Regel in Programm 541 ‚Konsolidierungskontonummer<br />
zuteilen’<br />
(19) MFR-Gruppe Mittelflussrechnungsgruppe numerisch, max. 4 Stellen wird<br />
bei bestehenden Einträgen ignoriert<br />
(20) Num. Zusatz 1 Numerisches Zusatzfeld 1, max. 12 Vor-, 4 Nachkommastellen<br />
(21) Num. Zusatz 2 Numerisches Zusatzfeld 2, max. 12 Vor-, 4 Nachkommastellen<br />
(22) Inaktiv Markierung ’inaktiv’ ’1’ für inaktive Konten/Kostenarten,<br />
sonst leer<br />
<strong>Schnittstellenbeschreibung</strong> <strong>Stammdaten</strong> Seite 7
Aufbau des ASCII-Records 2<br />
(23) MWST Mehrwertsteuerpflichtiges Konto ’1’ für MWST-pflichtiges<br />
Konto, sonst leer<br />
(24) MWST-Code Mehrwertsteuer-Code alphanumerisch, 3 Zeichen. Muss in<br />
der Steuercode-Datei (siehe Programm 531) definiert oder<br />
leer sein.<br />
(25) MWST fix Mehrwertsteuer fix ’1’ für fix, sonst leer<br />
(26) MWST koeffizient Mehrwertsteuer pflichtig in % numerisch, max. 3 Vor-, 2<br />
Nachkommastellen (z. B. 100 für 100 % pflichtiges Konto)<br />
(27) Kategorie Konten-Kategorie<br />
0 allgemeines Konto<br />
1 Geldkonto<br />
2 Debi/Kredi<br />
(28) Konsolidierung Für die Konsolidierung von Intercompanyverkehr kann auf<br />
dem Konto nachfolgendes definiert werden:<br />
0 Kein Intercompanyverkehr-Konto<br />
1 Intercompanyverkehr-Konto<br />
2 Gegenkonto bei IC Verkehr gleich behandeln wie IC<br />
(29) Kurspriorisierung Definition für die Kurspriorisierung (Aktivierung in Prg. S34;<br />
nur auf Fremdwährungskonto)<br />
0 = Global<br />
1 = Buchungskurs (1. Kurs)<br />
2 = Bewertungskurs (2. Kurs)<br />
3 = Gebührenkurs (3. Kurs)<br />
(30) Kostenstellenzugriff begrenzen<br />
Kostenstellenzugriff begrenzen<br />
0 = keine Begrenzung<br />
1 = Begrenzung aktiv<br />
(31) Von KST/KTR Von KST/KTR-Nummer (11 Stellen numerisch), Feldinhalt<br />
wird nicht validiert auf Existenz der Nummer<br />
(32) Bis KST/KTR Bis KST/KTR-Nummer (11 Stellen numerisch), Feldinhalt<br />
wird nicht validiert auf Existenz der Nummer<br />
(33) Vorschlag KST/KTR Vorschlags KST/KTR (11 Stellen numerisch)<br />
(34) KST/KTR 2. Ebene aktiv 2. Ebene mit bebuchen<br />
0 = inaktiv<br />
1 = aktiv<br />
(35) Von KST/KTR (2. Ebene) Von KST/KTR-Nummer (11 Stellen numerisch), Feldinhalt<br />
wird nicht validiert auf Existenz der Nummer<br />
(36) Bis KST/KTR (2. Ebene) Bis KST/KTR-Nummer (11 Stellen numerisch), Feldinhalt<br />
wird nicht validiert auf Existenz der Nummer<br />
(37) Vorschlag KST/KTR (2. Ebene)<br />
Vorschlags KST/KTR (11 Stellen numerisch) für 2. Ebene<br />
(38) Zinsdefinition Zinskonto<br />
0 = Keine Verzinsung (oder leer)<br />
K = Kontokorrentkonto<br />
D = Depositenkonto<br />
(39) Shortcut Shortcut (alphanumerisch 30 Zeichen)<br />
1 In Klammern gesetzte Felder sind fakulativ<br />
2 Felder, deren Bezeichnung in Anführungszeichen steht, müssen entweder zwischen<br />
Anführungszeichen oder Apostrophen stehen.<br />
<strong>Schnittstellenbeschreibung</strong> <strong>Stammdaten</strong> Seite 8
Aufbau des ASCII-Records 2<br />
2.5 Kostenstellen/Kostenträger<br />
Pos.<br />
(1)<br />
Bezeichnung Inhalt/Bemerkung<br />
1 Plan 2 Plan- Kostenstellenplan<br />
2 Variante<br />
3 Stufe Klassierungsstufe<br />
90 Kostenstellen/Kostenträger<br />
4 Identifikation Identifikation der Kostenstelle/des Kostenträgers numerisch,<br />
maximal 11 Stellen<br />
5 Typ Immer 1<br />
6 “Bezeichnung“ Bezeichnung der Kostenstelle /des Kostenträgers alphanumerisch,<br />
max. 40 Zeichen<br />
7 Referenzlevel Ebene der nächsthöheren Klassierungsstufe (1 – 9)<br />
8 Referenz Referenz auf die nächsthöhere Klassierungsstufe<br />
9 Typ Kostenstellen-/Kostenträgertyp<br />
0 Kostensstelle<br />
1 Kostenträger<br />
Wird beim Import von bereits bestehenden Kostenstellen/trägern<br />
ignoriert.<br />
(10) “2. Nummer“ Alternative Nummer alphanumerisch, max. 18 Zeichen<br />
(11) “2. Bezeichnung“ Alternative Bezeichnung alphanumerisch, max. 40 Zeichen<br />
(12) “Bemerkung 1“ Bemerkungsfeld 1 alphanumerisch, max. 40 Zeichen<br />
(13) “Bemerkung 2“ Bemerkungsfeld 2 alphanumerisch, max. 40 Zeichen<br />
(14) Num. Zusatz 1 Numerisches Zusatzfeld 1 max. 12 Vor-, 4 Nachkommastellen<br />
(15) Num. Zusatz 2 Numerisches Zusatzfeld 2 max. 12 Vor-, 4 Nachkommastellen<br />
(16) Sparte Sparten-Nummer numerisch, max. 4 Stellen<br />
(17) “Zuständig“ Zuständig alphanumerisch, max. 6 Zeichen<br />
(18) “Auftraggeber“ Auftraggeber alphanumerisch, max. 30 Zeichen<br />
(19) Summe Vertragssumme max. 12 Vor-, 4 Nachkommastellen<br />
(20) Nachträge Nachträge max. 12 Vor-, 4 Nachkommastellen<br />
(21) Beginn Beginn am Datum Format: TT.MM.JJ<br />
(22) Ende Beendet am Datum Format: TT.MM.JJ<br />
(23) Garantie Garantie bis Datum Format: TT.MM.JJ<br />
(24) Inaktiv Markierung ’inaktiv’ ’1’ für inaktive Kostenstellen/-träger,<br />
sonst leer<br />
(25) GK-Zuschläge Markierung ’GK-Zuschläge aktiviert’ ’1’ für aktivierte GK-<br />
Zuschläge, sonst leer<br />
(26) Shortcut Shortcut (alphanumerisch 30 Zeichen)<br />
1 In Klammern gesetzte Felder sind fakultativ<br />
2 Felder, deren Bezeichnung in Anführungszeichen steht, müssen entweder zwischen<br />
Anführungszeichen oder Apostrophen stehen.<br />
<strong>Schnittstellenbeschreibung</strong> <strong>Stammdaten</strong> Seite 9
Aufbau des ASCII-Records 2<br />
2.6 Default Druckattribute<br />
Pos. Bezeichnung Inhalt / Bemerkungen<br />
1 Plan Kontenplan-Identifikation<br />
1 Kontenpläne<br />
2 Kostenstellenpläne<br />
2 Variante Variante des Planes (1 – 9999)<br />
1 Standard<br />
3 Stufe Klassierungsstufe<br />
0 Kopfzeile<br />
4 Identifikation Gliederungsebene (1 – 9)<br />
5 Typ Typ des Elementes:<br />
1 Titelzeilen<br />
2 Totalzeilen<br />
6 Fett Zeile fett drucken (0/1)<br />
7 Unterstrichen Zeile unterstreichen (0/1)<br />
8 Kursiv Zeile kursiv drucken (0/1)<br />
9 Unterdrücken Zeile im Ausdruck unterdrücken (0/1)<br />
10 Ohne Nummer Nummer im Ausdruck unterdrücken (0/1)<br />
11 Seitenwechsel Seitenwechsel oberhalb (0/1)<br />
12 Abstand vor Abstand vor Druck (Anzahl Zeilen)<br />
13 Abstand nach Abstand nach Druck (Anzahl Zeilen)<br />
14 Nachkommastellen Nachkommastellen Klassierungsnummer (0 – 2)<br />
15 Einzug Horizontaler Einzug (Anzahl Zeichen)<br />
16 Schriftart Windows Schriftnummer (0 – 9)<br />
<strong>Schnittstellenbeschreibung</strong> <strong>Stammdaten</strong> Seite 10
Aufbau des ASCII-Records 2<br />
2.7 Druckattribute Klassierungselemente<br />
Pos. Bezeichnung Inhalt / Bemerkungen<br />
1 Plan Wie zugehöriges Klassierungselement<br />
2 Variante Dito.<br />
3 Stufe Dito.<br />
4 Identifikation Dito.<br />
5 Typ 11 Attribute Titel<br />
12 Attribute Totalzeilen<br />
13 Attribute Totalisatoren<br />
6 Fett Zeile fett drucken (0/1)<br />
7 Unterstrichen Zeile unterstreichen (0/1)<br />
8 Kursiv Zeile kursiv drucken (0/1)<br />
9 Unterdrücken Zeile im Ausdruck unterdrücken (0/1)<br />
10 Ohne Nummer Nummer im Ausdruck unterdrücken (0/1)<br />
11 Seitenwechsel Seitenwechsel oberhalb (0/1)<br />
12 Abstand vor Abstand vor Druck (Anzahl Zeilen)<br />
13 Abstand nach Abstand nach Druck (Anzahl Zeilen)<br />
14 Nachkommastelle Nachkommastellen Klassierungsnummer (0 – 2)<br />
15 Einzug Horizontaler Einzug (Anzahl Zeichen)<br />
16 Schriftart Windows Schriftnummer (0 – 9)<br />
<strong>Schnittstellenbeschreibung</strong> <strong>Stammdaten</strong> Seite 11