Kontakt

Ansicht
Dokumentation

FKK_VT_OBJ_MAINTAIN_COMPLETE - VT: Vertrag anlegen, ändern, "löschen" ohne Dialog

FKK_VT_OBJ_MAINTAIN_COMPLETE - VT: Vertrag anlegen, ändern, "löschen" ohne Dialog

PERFORM Short Reference   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Der Funktionsbaustein dient dem Anlegen und Ändern von Provider-Verträgen.

Sie übergeben den kompletten Provider-Vertrag.

Bei Änderungen am Provider-Vertrag geben Sie für die einzelnen Datensätze (Positionen, Rabatte, Kennungen, Leistungsarten, Externe referenzen) über den jeweiligen Änderungstyp an, ob der Datensatz neu angelegt ("I") oder geändert ("U") werden soll.

Unterstützte Aktivitäten:

  • 01 - Anlegen
  • 02 - Ändern
  • 04 - Modifizieren
    Wird intern angepasst zu Anlegen (wenn der Vertrag noch nicht existiert) oder Ändern (wenn der Vertrag bereits existiert)
  • 06 - Löschen
    Wird intern angepasst zu Ändern mit der Beendigung des Vertrags zum in IV_VALID_TIMESTAMP angegebenen Zeitpunkt.

Allgemeine Informationen

  • Der Änderungstyp "M" (modify) wird für die einzelnen Datensätze nicht unterstützt.
  • Für Zeitangaben können UTC-Zeitstempel oder lokale Zeitpunkte übergeben werden. Für lokale Zeitpunkte gilt die Zeitzone des Vertragskopfes als Bezugsgröße. Die Felder für lokale Zeitangaben sind namensgleich zu den Feldern der UTC-Zeitstempel mit dem Zusatz "_LOCL". Über den Parameter IX_LOCL wird mitgeteilt, ob die Zeitangaben an der Schnittstelle in den lokalen Zeitpunktfeldern übergeben werden. Da intern für die Verarbeitung die UTC-Zeitstempel verwendet werden, wird in diesem Fall sichergestellt, dass.aus den lokalen Zeitpunktangaben die UTC-Zeitpunktangaben ermittelt werden.
  • Für Gültigkeitszeitpunkte (wie Vertragsende), die "unendlich" repräsentieren, aber lediglich die Datumsangabe 31.12.9999 enthalten, wird automatisch auch die Uhrzeit 23:59:59 gesetzt.
  • Wird im Parameter für Änderungszeitpunkt kein Wert übergeben, so wird der aktuelle Zeitpunkt der Ausführung herangezogen.
  • Es muss zu jedem Zeitpunkt zwischen Vertragsbeginn und Vertragsende eine gültige Hauptposition existieren.
  • Für Provider-Vertragspositionen muss eine Identifikation in den Feldern VTPOS und VTPID angegeben sein.
  • Im Zeitpunkt 0551 können Sie Branchen- und Kundenfelder des Provider-Vertrags anreichern.
  • Die Standardkontierung der Vertragsposition wird im Buchungsbereich 0500 aus den Organisationsdaten abgeleitet.
  • Kennungen werden in der Tabelle IT_VT_TR_DI übergeben und es muss angegeben sein, auf welche Vertragsposition sie sich beziehen. Dies erfolgt über die Angabe der Gruppe von Kennungen (Feld VTTRG). Kennungen, die sich alle auf die gleiche Vertragsposition beziehen, werden in einer Gruppe zusammengefasst. Diese Gruppe von Kennungen muss dann in der Provider-Vertragsposition angegeben sein.
  • Rabatte werden in der Tabelle IT_VT_D_DI übergeben und es muss angegeben sein, auf welche Vertragsposition sie sich beziehen (Feld VTPOS).
  • Leistungsarten werden in der Tabelle IT_VT_ST_DI übergeben und es muss angegeben sein, auf welche Vertragsposition sie sich beziehen (Feld VTPOS).
  • Externe Referenzen werden in der Tabelle IT_VT_H_REF_DI übergeben. Der Referenztyp und die Referenz-ID muss angegeben sein. Externe Referenzen beziehen sich nicht auf eine Vertragsposition, sondern auf den Vertragskopf.
  • Bei Vertragsänderungen werden die Berechtigungen hinsichtlich folgender Berechtigungsobjekte überprüft:
  • F_KKVT_BUK (FI-CA: Provider-Vertrag: Buchungskreisberechtigung)

  • F_KKVT_BEG (FI-CA: Provider-Vertrag: Berechtigungsgruppe)

  • Die Pflege von Provider-Verträgen ist über das Business Data Toolset realisiert. Für den Direct Input wird die gleiche Verarbeitungslogik durchlaufen wie in der Dialogverarbeitung.
  • Eine Liste der aufgetretenen Nachrichten wird im Parameter ET_MESSAGE an den Aufrufer zurückgegeben. Ist ein Fehler aufgetreten, wird dies im Parameter EX_ERROR angezeigt. Fehler werden unterschiedlich klassifiziert; Informationen zur Kategorisierung des Fehlers liefert das Feld PARAMETER in der Tabelle ET_MESSAGE. Es werden die folgenden Kategorien verwendet: doesNotExist, invalid, prerequisiteMissing, incompatibleCinfiguration, illegalState, temporarayIllegalState.

Besonderheiten beim Anlegen von Provider-Verträgen

  • Wird kein Vertragsschlüssel spezifiziert, so wird er über interne Nummernvergabe ermittelt. Über Zeitpunkt 0555 können Sie beeinflussen welcher interne Nummernkreis verwendet werden soll.
  • Wird im Kopf des Provider-Vertrags (Parameter IS_VT_H) kein Buchungskreis (Feld BUKRS) angegeben, so wird dieser aus der Hauptposition abgeleitet.
    Hinweis
    Der Buchungskreis auf Kopfebene des Vertrags dient lediglich Berechtigungsprüfungen. Die Standardkontierung befindet sich auf Ebene der Vertragspositionen.

Besonderheiten beim Ändern von Provider-Verträgen

  • Vertragsbeginn und -ende können frei angepasst werden, wenn sie bezogen auf den Ausführungszeitpunkt in der Zukunft liegen. Liegen sie bereits in der Vergangenheit, so können sie nur insofern angepasst werden, dass sich ein früherer Vertragsbeginn, bzw. ein späteres Vertragsende ergibt.
  • Gleiches gilt für die Gültigkeiten der Vertragspositionen:
  • Gültigkeitsbeginn und -ende können frei angepasst werden, wenn diese bezogen auf den Ausführungszeitpunkt in der Zukunft liegen.

  • Liegt der Gültigkeitsbeginn in der Vergangenheit, so kann er relativ dazu in die Vergangenheit geschoben werden.

  • Liegt das Gültigkeitsende in der Vergangenheit, so kann es relativ dazu in die Zukunft verschoben werden.

  • Änderungen an existierenden Provider-Vertragspositionen sind nur für bestimmte Felder erlaubt; siehe nachfolgende Auflistung beziehungsweise Struktur FKK_VT_I_DI_CHANGEABLE. Außerdem sind alle Kundenfelder der Struktur CI_FKK_VT_I_DI änderbar. Für Änderungen an anderen Feldern ist eine zeitliche Abgrenzung und Anlage einer Folgeposition notwendig.
  • Gültigkeiten wie im vorhergehenden Punkt erläutert

  • Transaktionspreis

  • Einzelveräußerungspreis

  • Laufzeitende

  • Vertragspositionstext

  • Angaben zum Abrechnungzyklus

  • Adressnumme zum Leistungsempfängers

  • Änderungen an den Feldern CYCLE (Abrechnungszyklus) und CYCLE_DAY (Festgelegter Tag) können dazu führen, dass die Felder RATE_FIRST (Zieldatum für das Rating) und BILL_FIRST (Abrechnen ab) in bereits existierenden Verbrauchspositionen und abrechenbaren Positionen nun nicht mehr zum angegebenen Zyklus des Provider-Vertrags passen.
    Falls Sie Rating-Auftrage verwenden, so sollten keine Vertragspositionsänderungen für die Felder CYCLE und CYCLE_DAY erfolgen. Erstellen Sie in diesem Fall eine Folgeposition mit den geänderten Werten. Die Folgeposition sollte in diesem Fall einen Gültig ab-Zeitpunkt haben, der frühestens einen Tag nach dem aktuellen Zyklus beginnt.

Beispiel

Hinweise

Weiterführende Informationen

Weitere Informationen finden Sie in der Dokumentation der Schnittstellenparameter.





Parameter

ES_VT_H_DI
ET_MESSAGE
ET_VT_BIP_H_DI
ET_VT_BIP_I_DI
ET_VT_BIP_X_DI
ET_VT_CUCFG_DI
ET_VT_CUINS
ET_VT_CUPRT
ET_VT_CUREF
ET_VT_CUVAL
ET_VT_CUVK
ET_VT_D_DI
ET_VT_I_DI
ET_VT_ST_DI
ET_VT_TR_DI
EV_VTKEY
EX_ERROR
IS_VT_H_DI
IT_VT_BIPH_LOCKS_DI
IT_VT_BIPI_LOCKS_DI
IT_VT_BIP_H_DI
IT_VT_BIP_I_DI
IT_VT_BIP_X_DI
IT_VT_CUCFG_DI
IT_VT_CUINS
IT_VT_CUPRT
IT_VT_CUREF
IT_VT_CUVAL
IT_VT_CUVK
IT_VT_D_DI
IT_VT_H_REF_DI
IT_VT_I_DI
IT_VT_I_LOCKS_DI
IT_VT_LOCKS_DI
IT_VT_ST_DI
IT_VT_TR_DI
IV_AKTYP
IV_NODATA
IV_SENDER
IV_VTKEY
IX_CHDOC
IX_CHECK_ONLY
IX_COMMIT
IX_LOCL
IX_TEST
IX_UPDTASK

Ausnahmen

Funktionsgruppe

FKK_VT_OBJ

rdisp/max_wprun_time - Maximum work process run time   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 12827 Date: 20240523 Time: 130624     sap01-206 ( 160 ms )