SAP-Schnittstellen Anwenderhandbuch

Inhaltsverzeichnis

• 1 Bedienungsanleitung
• 1.1 Funktion Auslesen Kontenstamm
• 1.2 Funktion Auslesen der Positionen
• 1.3 Funktion Auslesen Positions--Konten--Zuordnung
• 1.4 Funktion Auslesen Kontensalden
• 1.5 Funktion Auslesen IC--Kontensalden
• 1.6 Funktion Auslesen aus dem UKV-Ledger
• 1.7 Funktion Auslesen Kostenstellenstamm
• 1.8 Funktion Auslesen Kostenstellensalden
• 1.9 Funktion Auslesen Anlagenbewegungen
• 1.10 Langlaufende Transaktionen
• 2 Fehlermeldungen
• 2.1 Funktion Auslesen Kontenplan
• 2.2 Funktion Auslesen Positionsplan
• 2.3 Funktion Auslesen Positions-Konten-Zuordnung
• 2.4 Funktionen Auslesen (IC--) Kontensalden
• 2.5 Zusätzliche Meldungen Auslesen IC-Kontensalden
• 2.6 Zusätzliche Meldungen Auslesen aus dem UKV-Ledger
• 2.7 Funktion Auslesen Kostenstellenstamm
• 2.8 Funktion Auslesen Kostenstellensalden
• 2.9 Funktion Auslesen Anlagenbewegungen

Das Programm kcusap.exe stellt Funktionen bereit, die das Auslesen von Daten aus einem SAP-R/3-System ermöglichen, und zwar aus den Modulen FI, CO und FI-AA (AM}. Im einzelnen handelt es sich dabei um folgende Daten:

• Kontenstamm (Modul FI)
• Positionsstamm (Modul FI)
• Positions-Konten-Zuordnung (Modul FI)
• Kontensalden (Modul FI)
• IC-Kontensalden (Modul FI)
• Saldenwerte aus dem UKV-Ledger (Modul FI)
• Kostenstellenstamm (Modul CO)
• Kostenstellensalden (Modul CO)
• Anlagenbewegungen (Modul FI-AA (AM))

Grundsätzlich verläuft der Auslesevorgang so, daß die Daten entweder via Anmeldung am Fremdsystem oder aus einer vom Fremdsystem erzeugten Datei erhalten werden. Das Ergebnis ist immer eine entsprechende Text-Datei im Batch-Verzeichnis des IDL-Pfads auf dem Client. Die Anmeldung am Fremdsystem erfolgt standardmäßig mit dem in der kcusap.ini-Datei angegebenen Eintrag unter Client. Es besteht die Möglichkeit einen anderen Mandanten auszuwählen, indem man in IDL Konsis in der Anwendung IMPORT im Feld 'SAP-Mandant' einen anderen Mandanten einträgt.

Für das Auslesen des Kontenplans aus dem SAP--System müssen in der Anwendung IMPORT folgende Parameter angegeben werden:

• Kontenplan
• Sprache

Haben der Kontenplan in IDL Konsis und SAP eine unterschiedliche Bezeichnung, so muß eine Umsetzgruppe definiert werden, die dafür sorgt, daß IDL Konsis die IDL Konsis-Bezeichnung des Kontenplans der SAP-Bezeichnung des Kontenplans zuordnet, die dann von der Schnittstelle für das Auslesen verwendet wird.

Die Sprache muß eines der Kürzel BEL, CZE, DEU, ENG, FLA, FRA, HOL, HUN, ITA, POL, SLO, SPA, SWE oder USA sein. Wird ein anderes Sprachkürzel angegeben, wird der deutschsprachige Kontenplan ausgelesen.

Folgende optionale Parameter können in der kcusap.ini-Datei im Bereich

[Settings]

eingestellt werden:

LoeschKnzKto=yes

Ist dieses Kennzeichen gesetzt, werden Konten, die im SAP-R/3-System zum Löschen vorgemerkt sind, nicht in die KPKONTEN.TXT-Datei geschrieben.

Alternativ kann diese Einstellung als zusätzlicher Parameter /D auch im Eintrag für den externen Aufruf für UNLKTO in der Anwendung KON/MEN vorgenommen werden. Dieser Eintrag hat Vorrang gegenüber dem Eintrag in der kcusap.ini-Datei.

Für das Auslesen der Positionen aus dem SAP-System müssen folgende Parameter angegeben werden:

• Positionsplan
• Kontenplan
• Sprache

Die Angabe des Positionsplans entspricht der Bilanz/GuV-Struktur im SAP-System

Haben der Kontenplan in IDL Konsis und SAP eine unterschiedliche Bezeichnung, so muß eine Umsetzgruppe definiert werden, die dafür sorgt, daß IDL Konsis die IDL Konsis-Bezeichnung des Kontenplans der SAP-Bezeichnung des Kontenplans zuordnet, die dann von der Schnittstelle für das Auslesen verwendet wird.

Die Sprache muß eines der Kürzel DEU, ENG, FRA, HOL, ITA oder SPA ein. Wird ein anderes Sprachkürzel angegeben, wird der deutschsprachige Positionsplan ausgelesen.

Für das Auslesen der Position-Konten-Zuordnung aus dem SAP-System müssen folgende Parameter angegeben werden:

• Positionsplan
• Kontenplan
• Sprache

Die Angabe des Positionsplans entspricht der Versions-Nr. (Bilanz/GuV-Struktur) im SAP-System

Haben der Kontenplan in IDL Konsis und SAP eine unterschiedliche Bezeichnung, so muß eine Umsetzgruppe definiert werden, die dafür sorgt, daß IDL Konsis die IDL Konsis-Bezeichnung des Kontenplans der SAP-Bezeichnung des Kontenplans zuordnet, die dann von der Schnittstelle für das Auslesen verwendet wird.

Die Sprache muß eines der Kürzel DEU, ENG, FRA, HOL, ITA oder SPA ein. Wird ein anderes Sprachkürzel angegeben, wird der deutschsprachige Positionsplan ausgelesen.

Für das Auslesen der Kontensalden aus dem SAP-System müssen folgende Parameter angegeben werden:

• Periode
• Datenart

Die Periode gibt an, bis zu welchem Zeitpunkt die - kumulierten - Salden ausgelesen werden sollen.

Die Datenart wird von der Batch-Übernahme von IDL Konsis benötigt und muß deshalb in die erzeugte .TXT-Datei geschrieben werden.

Es können weitere Parameter angegeben werden:

• Gesellschaft
• Geschäftsjahresvariante
• Monat > 12
• Geschäftsbereich

Die Gesellschaft entspricht dem Buchungskreis im SAP--System

Durch diese Angabe können die Werte für alle Gesellschaften resp. Buchungskreise ausgelesen werden, die dieselbe Geschäftsjahresvariante besitzen,

Wenn im SAP-System die Anzahl der Buchungsperioden größer als zwölf ist. M.a.W.: Auslesen inklusive Sonderbuchungsperioden (13, 14, 15 oder 16).

Ein * im diesem Feld steuert, daß die Salden nicht auf Geschäftsbereichsebene detailliert ermittelt werden, sondern je Konto aggregiert werden.

Für das Auslesen können in Kombination drei Fälle auftreten:

1. Ist nur eine Gesellschaft angegeben und die Geschäftsjahresvariante ist leer, dann werden nur Salden zum zugehörigen Buchungskreis ausgelesen.
2. Ist eine Geschäftsjahresvariante angegeben, aber keine Gesellschaft, dann werden die Salden für alle Buchungskreise ausgelesen, welche die angegebene Geschäftsjahresvariante haben.
3. Wird weder eine Gesellschaft noch ein Buchungskreis angegeben, wird versucht, die Salden zu allen Buchungskreisen auszulesen. Das gelingt aber nur dann, wenn die Buchungskreise keine abweichenden Geschäftsjahresvarianten haben.

Folgende optionale Parameter können im Feld externer Aufruf} in der Anwendung KON/MEN/ für UNLSALD eingestellt werden:

• /V=xxx

wobei xxx für die dreistellige Identifikation der General-Ledger-Version steht

Die Steuerung des Auslesens bzgl. IFRS/Local GAAP wird in der kcusap.ini im Abschnitt Settings beispielsweise wie folgt eingestellt

IFRSFact=C1
LocalGAAPFact=L1
IFRSPrefix=1
LocalGAAPPrefix=9
PrefixPos=2

• Bei IFRSFact wird die Datenart für IFRS festgelegt.
• Bei LocalGAAPFact wird die Datenart für Local GAAP festgelegt.
• IFRSPrefix gibt das Unterscheidungsmerkmal in der Kontonummer zu den common/Local GAAP-Konten an
• LocalGAAPPrefix gibt das Unterscheidungsmerkmal in der Kontonummer zu den common/IFRS-Konten an
• PrefixPos gib an, an welcher Stelle in der Kontonummer das Unterscheidungsmerkmal anzutreffen ist.

Für das Auslesen der IC-Kontensalden aus dem SAP-System müssen folgende Parameter angegeben werden:

• Periode
• Datenart

Die Periode gibt an, bis zu welchem Zeitpunkt die - kumulierten - Salden ausgelesen werden sollen. Sollte im SAP-System erst während des Geschäftsjahres die erforderlichen Einstellungen in den entsprechenden SAP-Tabellen (z.B. GLT3 oder die Partnergesellschaft) vorgenommen worden sein, kann der Funktinsbaustein auf die Werte, die vor diesem Zeitpunkt liegen, nicht zugreifen und man müsste sich für diese Perioden mit einem manuellen Workaround behelfen.

Die Datenart wird von der Batch-Übernahme von IDL Konsis benötigt und muß deshalb in die erzeugte .TXT-Datei geschrieben werden.

Es können weitere Parameter angegeben werden:

• Gesellschaft
• Geschäftsjahresvariante
• Monat größer zwölf (> 12)

Für das Auslesen können in Kombination drei Fälle auftreten:

1. Ist nur eine Gesellschaft angegeben und die Geschäftsjahresvariante ist leer, dann werden nur Salden zum zugehörigen Buchungskreis ausgelesen.
2. Ist eine Geschäftsjahresvariante angegeben, aber keine Gesellschaft, dann werden die Salden für alle Buchungskreise ausgelesen, welche die angegebene Geschäftsjahresvariante haben.
3. Wird weder eine Gesellschaft noch ein Buchungskreis angegeben, wird versucht, die Salden zu allen Buchungskreisen auszulesen. Das gelingt aber nur dann, wenn die Buchungskreise keine abweichenden Geschäftsjahresvarianten haben.

Wird konsisseitig mit Geschäftsbereichen gearbeitet - d.h. im Feld 'G-Bereich' ist kein Stern (*) angegeben, wird im BATCH-Verzeichnis im IDL-Pfad nur eine Datei KPICKONV.TXT erstellt.

Wenn ohne Geschäftsbereiche gearbeitet wird, dann wird zusätzlich noch eine Datei KPICSALD.TXT erstellt. In der Datei KPICSALD.TXT stehen die IC-Salden für die Bilanzkonten, in der Datei KPICKONV.TXT befinden sich die IC-Salden für die GuV-Konten.

Folgende optionale Parameter können im Feld 'externer Aufruf' in der Anwendung KON/MEN für UNLICSAL eingestellt werden:

• Der Parameter /Z sorgt dafür, daß immer nur eine Datei KPICSALD.TXT erstellt wird, in der auch die IC-Salden (GuV) enthalten sind.
• Der Parameter /T sorgt dafür, daß zusätzlich Salden in Transaktionswährung mit ausgelesen werden. Es wird immer nur eine Datei KPICSALD.TXT erstellt.
• Der Parameter /A sorgt dafür, daß zu den IC-Salden neben der Transaktionswährung noch diversen Beleginformationen (Nummer, Datum, Referenznummer und Art) mit geliefert werden. Es wird immer nur eine Datei KPICSALD.TXT erstellt.

Sonderhauptbuchvorgänge - das sind IC-Salden aus den SAP-Tabellen KNC3 und LFC3 - können durch den Eintrag

[Settings]

SonderHBV=yes

aktiviert werden. Dabei ist zu berücksichtigen, daß die Werte in den beiden SAP-Tabellen nicht unterjährig gespeichert werden, sondern immer kumuliert für das Geschäftsjahr.

Für das Auslesen von Salden aus dem UKV-Ledger des SAP-Systems müssen folgende Parameter angegeben werden:

• Periode
• Datenart

Es können weitere Parameter angegeben werden:

• Gesellschaft
• Geschäftsjahresvariante
• Monat größer 12
• Geschäftsbereich

Für das Auslesen können in Kombination drei Fälle auftreten:

1. Ist nur eine Gesellschaft angegeben und die Geschäftsjahresvariante ist leer, dann werden nur Salden zum zugehörigen Buchungskreis ausgelesen.
2. Ist eine Geschäftsjahresvariante angegeben, aber keine Gesellschaft, dann werden die Salden für alle Buchungskreise ausgelesen, welche die angegebene Geschäftsjahresvariante haben.
3. Wird weder eine Gesellschaft noch ein Buchungskreis angegeben, wird versucht, die Salden zu allen Buchungskreisen auszulesen. Das gelingt aber nur dann, wenn die Buchungskreise keine abweichenden Geschäftsjahresvarianten haben.

Folgende optionale Parameter können im Feld 'externer Aufruf' in der Anwendung KON/MEN für UNLICKONVeingestellt werden:

• Der Parameter /T sorgt dafür, daß bei IC-Kontensalden mit Kostenstellenbezug zusätzlich die Salden in Transaktionswährung mit ausgelesen werden.

Für die Steuerung der einzelnen Funktionen ist der Parameter UkvMitIC in der kcusap.ini}-Datei im Bereich

[Settings]

UkvMitIC=x

wie folgt einzustellen:

Für x=0:

Auslesen aller Salden ohne Partnergesellschaft und Erstellen einer Datei KPKSTSAL.TXT

Für x=1:

Auslesen aller Salden mit Partnergesellschaft und Erstellen einer Datei KPICSALD.TXT

Für x=2:

Auslesen aller Salden und Erstellen beider Dateien KPKSTSAL.TXT und KPICSALD.TXT

Für das Auslesen des Kontenstellenstamms aus dem SAP-System müssen in der Anwendung IMPORT folgende Parameter angegeben werden:

• Geschäftsbereich
• Kostenstellenplan
• Sprache

Über den Parameter Geschäftsbereich wird gesteuert, ob über das Auslesen der im Kostenstellenstamm in SAP eingestellte Geschäftsbereich übernommen werden soll oder nicht. Es wird kein Wert übernommen, wenn im Parameter für Geschäftsbereich ein Stern (*) steht.

Haben der Kostenstellenplan in IDL Konsis und SAP eine unterschiedliche Bezeichnung, so ist eine Umsetzgruppe zu definieren, die dafür sorgt, daß IDL Konsis die IDL Konsis-Bezeichnung des Kostenstellenplans der SAP-Bezeichnung des Kostenstellenplans zuordnet, die dann von der Schnittstelle für das Auslesen verwendet wird.

Die Sprache muß eines der Kürzel DEU, ENG, FRA, HOL, ITA, SPA, USA, HUN, BEL, CZE, FLA, POL, SLO oder SWE sein. Wird ein anderes Sprachkürzel angegeben, wird der deutschsprachige Kostenstellenplan ausgelesen.

Für das Auslesen der Kostenstellensalden aus dem SAP--System müssen folgende Parameter angegeben werden:

• Periode
• Datenart

Die Periode gibt an, bis zu welchem Zeitpunkt die - kumulierten - Salden ausgelesen werden sollen.

Die Datenart wird von der Batch-Übernahme benötigt und muß deshalb in die erzeugte .TXT geschrieben werden.

Es können weitere Parameter angegeben werden:

• Gesellschaft
• Geschäftsjahresvariante
• Monat > 12
• Geschäftsbereich

Die Gesellschaft entspricht dem Buchungskreis im SAP-System.

Durch diese Angabe können die Werte für alle Gesellschaften resp. Buchungskreise ausgelesen werden, die dieselbe Geschäftsjahresvariante besitzen.

In 'Monat > 12' können die Werte 13, 14, 15 oder 16 angegeben werden, je nachdem bis zu welcher Sonderbuchungsperioden Salden ausgelesen werden sollen.

Ein * im Feld 'Gs-Bereich'steuert, daß die Salden nicht auf Geschäftsbereichsebene detailliert ermittelt werden, sondern je Konto aggregiert werden.

Für das Auslesen können in Kombination drei Fälle auftreten:

1. Ist nur eine Gesellschaft angegeben und die Geschäftsjahresvariante ist leer, dann werden nur Salden zum zugehörigen Buchungskreis ausgelesen.
2. Ist eine Geschäftsjahresvariante angegeben, aber keine Gesellschaft, dann werden die Salden für alle Buchungskreise ausgelesen, welche die angegebene Geschäftsjahresvariante haben.
3. Wird weder eine Gesellschaft noch ein Buchungskreis angegeben, wird versucht, die Salden zu allen Buchungskreisen auszulesen. Das gelingt aber nur dann, wenn die Buchungskreise keine abweichenden Geschäftsjahresvarianten haben.

Besonderheit

Zu einem angegebenen Buchungskreis wird der zugehörige Kostenrechnungskreis aus der SAP-Tabelle CSKS ermittelt. Diesem Kostenrechnungskreis wird in der SAP-Tabelle TKA01 ein Kontenplan zugeordnet.

Für das Auslesen der Anlagenbewegungen aus dem SAP-System müssen folgende Parameter angegeben werden:

• Periode
• Datenart

Die Periode gibt an, bis zu welchem Zeitpunkt die - kumulierten - Anlagenbewegungen ausgelesen werden. sollen.

Die Datenart wird von der Batch-Übernahme benötigt und muß deshalb in die erzeugte .TXT geschrieben werden.

Es können weitere Parameter angegeben werden:

• Gesellschaft
• Geschäftsjahresvariante
• Monat größer 12
• Geschäftsbereich

Die Gesellschaft entspricht dem Buchungskreis im SAP-System.

Durch diese Angabe können die Werte für alle Gesellschaften resp. Buchungskreise ausgelesen werden, die dieselbe Geschäftsjahresvariante besitzen.

Im Feld 'Monat größer 12' können die Werte 13, 14, 15 oder 16 angegeben werden, wenn im Sonderbuchungsperioden mit ausgelesen werden sollen.

Für das Auslesen können in Kombination drei Fälle auftreten:

1. Ist nur eine Gesellschaft angegeben und die Geschäftsjahresvariante ist leer, dann werden nur Salden zum zugehörigen Buchungskreis ausgelesen.
2. Ist eine Geschäftsjahresvariante angegeben, aber keine Gesellschaft, dann werden die Salden für alle Buchungskreise ausgelesen, welche die angegebene Geschäftsjahresvariante haben.
3. Wird weder eine Gesellschaft noch ein Buchungskreis angegeben, wird versucht, die Salden zu allen Buchungskreisen auszulesen. Das gelingt aber nur dann, wenn die Buchungskreise keine abweichenden Geschäftsjahresvarianten haben.

Werden die Wertberichtigungskonten in SAP separat geführt (T095B), so ist der externe Aufruf im MEN-Satz für UNLANLBEW um den Parameter /W zu ergänzen.

Alternativ kann auch auf Client-Seite in der kcusap.ini im Abschnitt Settings der Parameter

UseT095B=yes

ergänzt werden.

Um Werte für verschiedene Bewertungsbereiche auszulesen, kann im externen Aufruf im MEN-Satz für UNLANLBEW beim ersten /K-Parameter der Bewertungsbereich (zweistellig) angegeben werden. Wenn der Parameter leergelassen wurde, ist die Voreinstellung HGB (= 01 als AFABE).

Alternativ kann auch auf Client-Seite in der kcusap.ini im Abschnitt Settings der Parameter

Bewertungsbereich=nn

gesetzt werden, wobei nn als Platzhalter für den tatsächlichen Bewertungsbereich zu verstehen ist.

Für die Analyse von evtl. auftretenden Abweichungen kann der mitgelieferte Report im SAP-System hilfreich sein:

Aufruf via SA38

Die Zuordnung von Bewegungsartengruppen (SAP R/3) zu Buchungsschlüsseln wird von dem Programm kcusap.exe wie folgt vorgenommen:

Die Zuordnung von Vortragswerten (SAP R/3) zu Buchungsschlüsseln wird von dem Programm kcusap.exe wie folgt vorgenommen:

Die Zuordnung von Anlagen-Wertfeldern und anteiligen Werten (SAP R/3) zu Buchungsschlüsseln wird von dem Programm kcusap.exe wie folgt vorgenommen:

Folgende Kennzeichen für Werte aus SAP R/3 werden bewußt nicht übernommen:

Damit Langläufer nicht die Antwortzeiten des Systems im interaktiven Betrieb beeinträchtigen, unterliegt die Ausführung von Reports und Funktionsbausteinen einer bestimmten Höchstdauer. Wenn ein einzelner Report oder Funktionsbaustein länger als eine maximal zulässige festgelegte Laufzeit für einen Dialogprozeß überschreitet, bricht das SAP--System dessen Ausführung automatisch ab. Der Maximalwert für die Laufzeit wird im Profileparameter rdisp/max_wprun_time eingestellt.

Sollte es beim Auslesen der IC-Kontensalden SAP-seitig zu einer Zeitüberschreitung (Time-Out) kommen, sind SAP-seitig folgende Schritte einzuleiten.

• Melden Sie sich am SAP--System über das SAPGUI an
• Rufen Sie bitte die Transaktion SA38 auf
• Wählen Sie den Report YFB_ACCOUNTS und führen ihn aus
• Geben Sie bitte die erforderlichen Parameter an
• Wählen Sie die gewünschte Funktion via Radiobutton
• Lassen Sie schließlich den Report im Hintergrund ausführen

Report YFB_ACCOUNTS:

Als Ergebnis erstellt der Report eine Datei, die mit der Datei mit dem logischen Dateinamen Z_KONSIS_TEMP_STAMM_DATEI verbunden ist.

Diese Datei muß dann auf ein Laufwerk kopiert werden, auf welches vom IDL Konsis-Client aus zugegriffen werden kann (z.B. das WORK-Verzeichnis im IDL-Pfad).

Außerdem sind folgende Erweiterungen in der Datei KCUSAP.INI auf Client-Seite vorzunehmen:

[FileLocation]

FileIcktosal=Pfad und Dateiname der physischen Z_KONSIS_TEMP_STAMM_DATEI

FileIckonv=Pfad und Dateiname der physischen Z_KONSIS_TEMP_STAMM_DATEI

z.B. wenn K das Laufwerk auf dem Programmserver ist:

[FileLocation]

FileIcktosal=K:\IDL\WORK\ICSALD.txt

FileIckonv=K:\IDL\WORK\ICKONV.txt

Es ist zu beachten, daß die für das Auslesen im SAP-System angegebenen Schlüssel (Buchungskreis, Jahr usw.) dann auch mit den in IDL Konsis angebenenen Schlüsseln zum Auslesen via Datei übereinstimmen.

Die Exceptions, die von dem Funktionsbaustein hier geworfen werden sind unschön, weil NO_RECORD_T001 für vier verschiedene Sachverhalte verwendet wird:

1. Die Kombination aus Geschäftsjahresvariante und Buchungskreis gibt es nicht.
2. Es gibt keine Zuordnung vom Buchungskreis zur Gesellschaft, wenn weder Geschäftsjahresvariante noch Buchungskreis vorgegeben wurden.
3. Bei vorgegebenem Buchungskreis wurde dem Buchungskreis keine Gesellschaft zugeordnet oder der Buchungskreis existiert nicht.
4. Bei vorgegebener Geschäftsjahresvariante wurde den zugehörigen Buchungskreisen keine Gesellschaft zugeordnet oder der Buchungskreis existiert nicht.

Diese Differenzierung ist im Prolog zu den Salden-Funktionsbausteinen beim FI-Modul besser gelöst.

Die Exception NO_RECORD_CSKS wir zur Zeit für zwei unterschiedliche Fehlersituationen verwendet:

1. Der angegebene Buchungskreis konnte nicht in der Tabelle CSKS gefunden werden (Tabelle mit den Kostenstellenstammsätzen).
2. Die Berechtigungsprüfung ergab, daß der angemeldete Benutzer keine Berechtigung zur Anzeige der Werte zum angegebenen Kostenrechnungskreis hat.