Kontakt

Ansicht
Dokumentation

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

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

General Data in Customer Master   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.

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

  • 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 lokalen Zeitpunktangaben maßgeblich sind.
  • 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/Stornierung kein Wert übergeben, so wird der aktuelle Zeitpunkt der Ausführung herangezogen.
  • Beim Stornieren einer Position wird der Änderungszeitstempel als Zeitpunkt der Stornierung (Feld CANCL) gesetzt.
  • Es muss zu jedem Zeitpunkt zwischen Vertragsbeginn und Vertragsende eine gültige Hauptposition existieren.
  • 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 (Feld VTPID). Intern wird die Verlinkung zwischen Kennungen und Vertragsposition über die Gruppe von Kennungen realisiert (Feld VTTRG). Kennungen, die sich alle auf die gleiche Vertragsposition beziehen, werden in einer Gruppe zusammengefasst.
  • Rabatte werden in der Tabelle IT_VT_D_DI übergeben und es muss angegeben sein, auf welche Vertragsposition sie sich beziehen (Feld VTPID).
  • 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.

Besonderheiten beim Anlegen von Provider-Verträgen

  • Wird kein Vertragsschlüssel spezifiziert, so wird er über interne Nummernvergabe ermittelt.
  • 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

  • In der Tabelle IT_VT_I_DI wird die zum übergebenen Gültigkeitszeitpunkt (Parameter IV_VALID_TIMESTAMP oder IV_VALID_TIMESTAMP_LOCL) gültige Momentaufnahme an Provider-Vertragspositionen erwartet. Der Funktionsbaustein ermittelt basierend darauf, ob sich Änderungen an den Positionen ergeben haben.
  • Positionen, die zu einem Zeitpunkt vor dem Gültigkeitszeitpunkt bereits gültig waren und nun aber nicht mehr Bestandteil der Momentaufnahme sind, werden eine Sekunde vor dem Gültigkeitszeitpunkt beendet.

  • Positionen, die erst zu einem Zeitpunkt nach dem übergebenen Gültigkeitszeitpunkt gültig werden und nicht Bestandteil der Momentaufnahme sind, werden storniert (Wert in Feld CANCL wird gesetzt).

  • In der Tabelle IT_VT_D_DI wird die zum übergebenen Gültigkeitszeitpunkt (Parameter IV_VALID_TIMESTAMP oder IV_VALID_TIMESTAMP_LOCL) gültige Momentaufnahme an Rabatten erwartet. Der Funktionsbaustein ermittelt basierend darauf, ob sich Änderungen an den Rabatten ergeben haben.
  • Rabatte, die zu einem Zeitpunkt vor dem Gültigkeitszeitpunkt bereits gültig waren und nun aber nicht mehr Bestandteil der Momentaufnahme sind, werden eine Sekunde vor dem Gültigkeitszeitpunkt beendet.

  • Rabatte, die erst zu einem Zeitpunkt nach dem übergebenen Gültigkeitszeitpunkt gültig werden, werden gelöscht.

  • Rabatte, die sich geändert haben, werden aktualisiert.

  • In der Tabelle IT_VT_TR_DI wird die zum übergebenen Gültigkeitszeitpunkt (Parameter IV_VALID_TIMESTAMP oder IV_VALID_TIMESTAMP_LOCL) gültige Momentaufnahme an Kennungen erwartet. Der Funktionsbaustein ermittelt basierend darauf, ob sich Änderungen an den Kennungen ergeben haben.
  • Kennungen, die zu einem Zeitpunkt vor dem Gültigkeitszeitpunkt bereits gültig waren und nun aber nicht mehr Bestandteil der Momentaufnahme sind, werden eine Sekunde vor dem Gültigkeitszeitpunkt beendet.

  • Kennungen, die erst zu einem Zeitpunkt nach dem übergebenen Gültigkeitszeitpunkt gültig werden, werden gelöscht.

  • Kennungen, die sich geändert haben, werden aktualisiert.

  • Sperren, die zum Gültigkeitszeitpunkt gültig sind und nicht im Parameter IT_VT_LOCKS_DI übergeben werden, werden zum Datum des Gültigkeitszeitpunkts beendet.
  • Sperren, die erst nach dem Gültigkeitszeitpunkt gültig werden, aber nicht im Parameter IT_VT_LOCKS_DI übergeben werden, werden gelöscht.
  • Werden Vertragsbeginn oder Vertragsende angepasst, so wirkt sich das auch auf die Vertragspositionen aus, die ab Vertragsbeginn oder bis Vertragsende gültig waren. Die Vertragspositionen werden analog geändert.
  • Die Momentaufnahme der Externen Referenzen über Tabelle IT_VT_H_REF_DI, spiegelt den zu erwartenden Stand der Datenbanktabelle DFKK_VT_H_REF wider. Es kann daher zu einer Anlage oder einer Löschung führen.

Besonderheiten für inaktive Provider-Verträge und inaktive Provider-Vertragspositionen

  • Wird eine inaktive Provider-Vertragsposition geändert, so entsteht keine neue Zeitscheibe. Stattdessen werden die Daten der existierenden Position angepasst.
    Der Gültigkeitszeitpunkt der Änderung (IV_VALID_TIMESTAMP) muss dabei nicht innerhalb der Gültigkeit der inaktiven Vertragsposition liegen.
  • Wird eine inaktive Provider-Vertragsposition nicht mehr übergeben, so wird diese unabhängig vom Gültigkeitszeitpunkt der Änderung (IV_VALID_TIMESTAMP) gelöscht.
  • Der Gültigkeitszeitpunkt der Änderung (IV_VALID_TIMESTAMP) spielt für nur für die Neuanlage von inaktiven Provider-Vertragspositionen über den Funktionsbaustein CRM_ISX_CONTRACT_MAINTAIN eine Rolle, da er in diesem Fall den Gültigkeitsbeginn der neuen Position (VALFR) bestimmt.
  • Inaktive Provider-Verträge können über den Funktionsbaustein FKK_VT_INACTIVE_DELETE gelöscht werden.

Beispiel

Hinweise

Weiterführende Informationen

Weitere Informationen finden Sie in der Dokumentation der Schnittstellenparameter.





Parameter

ES_VT_H_DI
ET_MESSAGE
ET_VT_D_DI
ET_VT_H_REF_DI
ET_VT_I_DI
ET_VT_ST_DI
ET_VT_TR_DI
EV_VTKEY
EX_ERROR
EX_VALFR_CHANGED
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_CHANGE_TIMESTAMP
IV_CHANGE_TIMESTAMP_LOCL
IV_NODATA
IV_SENDER
IV_VALID_TIMESTAMP
IV_VALID_TIMESTAMP_LOCL
IV_VTKEY
IX_CHDOC
IX_CHECK_ONLY
IX_COMMIT
IX_KEEP_MEMORY
IX_LOCL
IX_TEST
IX_UPDTASK

Ausnahmen

Funktionsgruppe

FKK_VT_OBJ

Addresses (Business Address Services)   General Material Data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 12762 Date: 20240523 Time: 125955     sap01-206 ( 169 ms )