Ansicht
Dokumentation

ISH_HLTHSRVCAT_ADDITEM - IS-H: API zum Anlegen von Leistungsstammdaten

TXBHW - Original Tax Base Amount in Local Currency   ROGBILLS - Synchronize billing plans  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dieser Funktionsbaustein dient dem Anlegen einer neuen Leistung.
Als Importparameter müssen die Einrichtung und der Katalog, in denen die Leistung angelegt werden soll, angegeben werden. Der Parameter SS_TESTRUN ist optional. Ist er mit einem "X" belegt, so wird der Baustein im Testmodus durchgeführt. Der Testmodus dient dem Überprüfen der dem Funktionsbaustein übergebenen Daten. Bei der Überprüfung festgestellte Fehler werden dem Benutzer in der Tabelle SS_Return zurückgegeben. Im Testmodus wird nicht auf die Datenbank geschrieben.

Dem Funktionsbaustein können die folgenden Tabellen übergeben werden:

SS_NTPK : Kopfdaten der Leistung
SS_NTSP : Spalten zur Leistung
SS_NTPT : Bezeichnung der Leistung (Leistungstext)
SS_NTPP : Planwerte für die Leistung
SS_NTPKD : Zusätze für spezielle Leistungen (v.a. FP, SE)

Die obigen Tabellen entsprechen ihrem Aufbau nach den intern von IS-H verwendeten Tabellen NTPK, NTSP usw. Sie besitzen jedoch zu jedem ihrer Felder (ausgenommen den Schlüsselfeldern) ein XFeld gleichen Namens, das mit " _X" endet. Diese XFelder haben für den AddItem-Baustein keine Funktion. Zudem besitzen sie zusätzlich ein XFeld mit dem Namen "SIGN", das für interne Zwecke benutzt wird und keinesfalls manuell belegt werden sollte.

Zum Anlegen einer Leistung muß lediglich die Struktur SS_NTPK gefüllt werden. Alle weiteren können, müssen jedoch nicht gefüllt werden. Werden sie jedoch gefüllt, so müssen alle Schlüsselfelder gefüllt werden.

Beim Ablauf des Funktionsbausteins werden zunächst alle vorhandenen Tabellen auf Fehler und Konsistenz überprüft. Wird bei einem Satz ein Fehler festgestellt, so wird dies intern protokolliert und alle mit dieser Leistung verbundenen Sätze werden nicht auf die Datenbank geschrieben.

Beispiel:

Für einen Satz der Leistung BASP wird in der Struktur SS_NTSP ein Fehler (error message) festgestellt. Damit wird keiner der Sätze zu BASP auf die Datenbank geschrieben, auch wenn für diese Leistung in den Strukturen SS_NTPK, SS_NTPT usw. keine Fehler vorliegen.

Aus diesem Grund wird empfohlen, den Baustein zunächst im Testmodus laufen zu lassen. Dies erreicht man durch Setzen des Parameters SS_TESTRUN. Im Testmodus werden alle Testroutinen durchlaufen, die aufgetretenen Fehler SS_BAPIRETURN protokolliert, jedoch nicht auf die Datenbank geschrieben.
Im Testmodus werden auch jene Sätze protokolliert, die im Echtlauf nicht auf die Datenbank geschrieben würden.

Die Berechtigungsprüfung wird mit Hilfe des Berechtigungsobjektes N_EINR_TCO durchgeführt. Als Transaktionscode für dieses Objekt wird NT01 benutzt.

Die Felder VLEIA (Verweis auf Leistungsart im CO), GRVER (Grenzverweildauer) und GVDIN (Grenzverweildauer Intensivmedizin) der Tabelle NTPK können zwar an der Schnittstelle des Funktionsbausteins mitgegeben werden, werden aber von IS-H selbst in keiner Weise mehr unterstützt.

NTPT-STTXT wird stets von dem aus NTPT-KTXT1 und NTPT-KTXT2 überschrieben; egal, ob der STTXT vom Benutzer an der Schnittstelle mitgegeben wurde.

Zu einer Leistung können beliebig viele (Spalten-)Intervalle angelegt werden. Die Angabe von NTSP-Sätzen zu einem NTPK-Satz ist optional. Wird jedoch ein Spaltensatz mitgegeben, so müssen zu jedem Zeitintervall der Struktur SS_NTSP alle in NTSI definierten Spalten angegeben werden - egal, ob SS_NTSP_TWERT gefüllt ist. Diese Vorgabe soll helfen, Inkonsistenzen auf der Datenbank zu vermeiden.

Überprüft wird, ob alle Spalten zu einem Intervall angegeben wurden und ob die einzelnen Intervalle sich überschneiden.
Solange die einzelnen Zeitintervalle sich nicht überschneiden, besteht keine Einschränkung hinsichtlich der Zeiträume.
Es bleibt in der Hand des Anwenders, ob er zwischen den einzelnen Intervallen Lücken zuläßt und ob die Obergrenze (NTSP-ENDDT) des höchsten Intervalls nicht HighDate entspricht.

Werden die Felder Ändererdaten (LOUSR, LODAT, ERDAT, ERUSR, UPDAT, UPUSR in NTPK, NTSP sowie NTPT; UPDAT, UPUSR in NTPKD) nicht angegeben, so werden sie automatisch mit SY-DATUM und SY-UNAME gefüllt (für LODAT und LOUSR gilt dies nur, wenn das Löschkennzeichen LOEKZ gesetzt ist).

NTPK-TALST und -EXTNR (wenn vorhanden) werden in UpperCase gewandelt. Es werden keine weiteren Felder in UpperCase gewandelt, auch nicht z.B. NTPT-TALST oder NTPK-UPSR!

Beispiel

Hinweise

Weiterführende Informationen

Parameter

SS_EINRI
SS_N1TPLAB
SS_N1TPLOK
SS_N1TPM
SS_N1TPP
SS_N1TPTA
SS_NCH10
SS_NCH10T
SS_NTDC
SS_NTPK
SS_NTPKAT
SS_NTPKCH
SS_NTPKCH_AGE
SS_NTPKCH_KOMB
SS_NTPKCH_KUMU
SS_NTPKCH_MAX
SS_NTPKCH_QLDI
SS_NTPKCH_QTDI
SS_NTPKCH_SPRT
SS_NTPKD
SS_NTPKDP
SS_NTPKDPREL
SS_NTPKFR
SS_NTPKFR_AK
SS_NTPKFR_AS
SS_NTPKFR_GH
SS_NTPKFR_LA
SS_NTPKFR_MC
SS_NTPKIT
SS_NTPP
SS_NTPT
SS_NTSP
SS_NWCH10
SS_RETMAXTYPE
SS_RETURN
SS_RNTPTS
SS_TARIF
SS_TESTRUN
SS_WRITE_CD

Ausnahmen

Funktionsgruppe

N_API_SERVICECATALOG

Addresses (Business Address Services)   TXBHW - Original Tax Base Amount in Local Currency  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 6506 Date: 20240523 Time: 150639     sap01-206 ( 119 ms )