Kontakt

Ansicht
Dokumentation

/PM0/ABT_APIF_REL_FB - Neugeschäftsantrag anlegen und verarbeiten (Antragsschnittstelle)

/PM0/ABT_APIF_REL_FB - Neugeschäftsantrag anlegen und verarbeiten (Antragsschnittstelle)

PERFORM Short Reference   ABAP Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Funktionalität

Mit der Antragsschnittstelle APIF (Application Interface) stellt FS-PM eine RFC-fähige Schnittstelle zur Anlage von Anträgen bis hin zur Freigabe bereit.

Die Antragsschnittstelle kann die Daten zu einem bestehenden Antrag nicht aktualisieren.

Über die Antragsschnittstelle können Sie innerhalb des Geschäftsprozesses Neugeschäft allgemeine Geschäftsvorfallgebühren für die folgenden Geschäftsvorfälle erheben:

  • Vertrag anlegen und bearbeiten
  • Vertragsteil anlegen und bearbeiten
  • Vertragsteilbündel anlegen und bearbeiten
  • Deckung anlegen und bearbeiten
  • Police bearbeiten
  • Vertragsbündel anlegen

Über die Antragsschnittstelle können Sie auch eine Prämiengebühr für den Geschäftsvorfall Vertrag anlegen oder ändern sowie eine Drittrechtsgläubigergebühr oder eine Korrespondenzgebühr erheben.

Diese Gebühren werden gemäß der Systemeinstellungen automatisch festlegt und erhoben. Die Gebühren können manuell nicht geändert werden.

Die Funktionalität der Schnittstelle umfasst im Einzelnen:

  • Zusätzlicher Schlüssel bei Vertragssperre - IV_LOCKKEY_ID

Zur Abbildung unterschiedlicher Anwendungsszenarien sind die beschriebenen Funktionen zum Teil optional ausführbar (z.B. Provisionsabrechnung simulieren), zum Teil jedoch gegenseitig Voraussetzung (z.B. keine Freigabe ohne vorherige Berechnung). Dies ist in den nachfolgend beschriebenen Anwendungsszenarien sowie der Dokumentation der verfügbaren Kennzeichen im Abschnitt 'Abhängigkeiten' weiter erläutert.

Zu den vorangehend beschriebenen fachlichen Funktionen ist das Verhalten der Antragsschnittstelle auf der technischen Ebene steuerbar:

Aufruf

Die Antragsschnittstelle APIF wurde insbesondere unter Laufzeitgesichtspunkten entwickelt und verwendet das Konzept der Datencontainer, welche in Hintergrundverarbeitung performanter verabeitet werden (-> Kennzeichen IF_MASS_BO). Die übergebenen Antragsdaten sind daher in der Regel in zwei Strukturen/Tabellen pro Entitität zu übergeben - einer Tabelle für die Antragsdaten, sowie einer Tabelle für die Feldmodifikatoren. Die Feldmodifikatoren markieren, welche der in der Tabelle übergebenen Daten in die Verarbeitung übernommen werden sollen.

Bei erfolgreicher Verarbeitung werden die aus der Neuanlage resultierende Policen-Antragsnummer an den Aufrufer übergeben bzw. im Fehlerfall Protokollmeldungen für die Fehlerbehandlung.

Erweiterbarkeit

Die Antragsschnittstelle APIF basiert auf Strukturen des UBOI (Unified Business Object Interface), die generell mit einem Customer-Include versehen sind und auf diesem Weg erweiterbar sind. Zusätzlich können Daten als ExtensionIn-Parameter übergeben werden, die im /PM0/ABT_APIF_CHECK_BADI zur Prüfung stehen. Mit dem BADI /PM0/ABT_CHK_EXISTING_POL kann die Idempotenz-Prüfung kundenspezifisch angepasst werden.

Beispiel

Anwendungsszenarien ohne gesetzten Idempotenz-Kennzeichen

Szenario 1: Neuanlage inkl. Berechnen ohne Freigabe

  • Antragsdaten sind fehlerfrei
  • Parameter:
  • IF_BO = 'X'

  • IF_CALC = 'X'

  • Antrag wird berechnet und gespeichert.

Szenario 2 Neuanlage inkl. Freigabe

  • Antragsdaten sind fehlerfrei
  • Parameter:
  • IF_BO = 'X'

  • IF_CALC = 'X'

  • IF_APPROVE = 'X'

  • => Antrag wird angelegt, berechnet, gespeichert und freigegeben

Szenario 3: Neuanlage im Fehlerfall ohne Speichern bei Fehlerfall

  • Antragsdaten sind fehlerhaft
  • Parameter:
  • IF_BO = 'X'

  • IF_CALC = 'X'

  • IF_APPROVE = 'X'

  • IF_SAVE_ON_ERRORS = nicht gesetzt

  • => Fehlermeldung: fehlerhafter Antrag wird nicht gespeichert
  • => Antrag muss neu gesendet werden mit korrigierten Daten

Szenario 4: Neuanlage im Fehlerfall mit Speichern bei Fehlerfall

  • Antragsdaten sind fehlerhaft
  • Parameter:
  • IF_BO = 'X'

  • IF_CALC = 'X'

  • IF_APPROVE = 'X'

  • IF_SAVE_ON_ERRORS = 'X'

  • => Fehlermeldung: fehlerhafter Antrag wird gespeichert
  • => Antrag kann erneut gesendet werden (mit korrigierten Daten), dabei wird ein neuer Antrag angelegt, der bestehende Antrag kann nicht aktualisiert werden.
  • => Bestehender Antrag kann im Zentralen Einsteig (/PM0/ABC_FSPM) wiederaufgenommen werden

Anwendungsszenarien mit gesetztem Idempotenz-Kennzeichen

Szenario 1: Neuanlage mit neuer externer Antragsnummer mit Freigabe

  • Antragsdaten sind fehlerfrei
  • Parameter:
  • IF_IDEMPOTENCE = 'X'

  • IF_BO = 'X'

  • IF_CALC = 'X'

  • IF_APPROVE = 'X'

  • => Antrag wird angelegt und freigegeben

Szenario 2: Neuanlage mit bestehender externer Antragsnummer mit Freigabe

  • Antragsdaten sind fehlerfrei
  • Parameter:
  • IF_IDEMPOTENCE = 'X'

  • IF_BO = 'X'

  • IF_CALC = 'X'

  • IF_APPROVE = 'X'

  • => Hinweismeldung: Police bzw. Antrag existiert bereits
  • => Bestehender Antrag kann im Zentralen Einsteig (/PM0/ABC_FSPM) wiederaufgenommen werden

Szenario 3: Neuanlage ohne externe Antragsnummer ohne Freigabe

  • Antragsdaten sind fehlerfrei
  • Parameter:
  • IF_IDEMPOTENCE = 'X',

  • IF_BO = 'X'

  • IF_CALC = 'X'

  • => Fehlermeldung: Antrag wird nicht angelegt, da die Antragsnummer nicht angegeben wurde

Szenario 4: Neuanlage mit bestehender externer Antragsnummer ohne Freigabe

  • Antragsdaten sind fehlerfrei
  • Parameter:
  • IF_IDEMPOTENCE = 'X',

  • IF_BO = 'X'

  • IF_CALC = 'X'

  • => Hinweismeldung: Police bzw. Antrag existiert bereits
  • => Der Antrag wird nicht gespeichert.
  • => Bestehender Antrag kann im Zentralen Einsteig (/PM0/ABC_FSPM) wiederaufgenommen werden

Szenario 5: Neuanlage im Fehlerfall ohne Speichern bei Fehlerfall

  • Antragsdaten sind fehlerhaft
  • Parameter:
  • IF_IDEMPOTENCE = 'X'

  • IF_BO = 'X'

  • IF_CALC = 'X'

  • IF_APPROVE = 'X'

  • IF_SAVE_ON_ERRORS = nicht gesetzt

  • => Fehlermeldung: fehlerhafter Antrag wird nicht gespeichert
  • => Antrag kann (ggfs. mit der gleichen externen Antragsnummer) neu gesendet werden

Szenario 6: Neuanlage im Fehlerfall mit Speichern bei Fehlerfall

  • Antragsdaten sind fehlerhaft
  • Parameter:
  • IF_IDEMPOTENCE = 'X'

  • IF_BO = 'X'

  • IF_CALC = 'X'

  • IF_APPROVE = 'X'

  • IF_SAVE_ON_ERRORS = 'X'

  • => Fehlermeldung: fehlerhafter Antrag wird nicht gespeichert
  • => Antrag kann (ggfs. mit der gleichen externen Antragsnummer) neu gesendet werden

Hinweise

Weiterführende Informationen





Parameter

APPLNR
ERRORCODE
EXTENSIONIN
IF_APPROVE
IF_BO
IF_CALC
IF_CHECK
IF_CHECK_ADVANCED
IF_COMM
IF_CREATE_APPL_DFS
IF_IDEMPOTENCE
IF_MASS_BO
IF_REQ_CBC
IF_SAVE
IF_SAVE_ON_ERROR
IT_AAWACOV
IT_AAWAPOLPR
IT_AAWFCOV
IT_AAWFPOLPR
IT_ABEACS
IT_ABUTTRANS
IT_ABWAAGENT
IT_ABWAANSWER
IT_ABWAAPPLPOL
IT_ABWABNFCRY
IT_ABWACBCPAYR
IT_ABWACLAUSE
IT_ABWACOMDIFF
IT_ABWACOMMIS
IT_ABWACOMROLE
IT_ABWACOVCPCO
IT_ABWACOVPAC
IT_ABWACRDITOR
IT_ABWADEDCTBL
IT_ABWADEDSRCL
IT_ABWADIACODE
IT_ABWAEDISTREL
IT_ABWAEXREF
IT_ABWAEXTPCL
IT_ABWAEXTPOL
IT_ABWAINFRD
IT_ABWALIMIT
IT_ABWAPOLHLDR
IT_ABWAPOLICY
IT_ABWAPPDPAC
IT_ABWAPRMPAYR
IT_ABWAREPVAL
IT_ABWARESDEPC
IT_ABWASBADR
IT_ABWASUBJCT
IT_ABWASUPDC
IT_ABWDCOINCO
IT_ABWDCOINHS
IT_ABWDCOINSS
IT_ABWFAGENT
IT_ABWFANSWER
IT_ABWFBNFCRY
IT_ABWFCBCPAYR
IT_ABWFCLAUSE
IT_ABWFCOINCO
IT_ABWFCOINHS
IT_ABWFCOINSS
IT_ABWFCOMDIFF
IT_ABWFCOMMIS
IT_ABWFCOMROLE
IT_ABWFCOVCPCO
IT_ABWFCOVPAC
IT_ABWFCRDITOR
IT_ABWFDEDCTBL
IT_ABWFDEDSRCL
IT_ABWFDIACODE
IT_ABWFEDISTREL
IT_ABWFEXREF
IT_ABWFEXTPCL
IT_ABWFEXTPOL
IT_ABWFINFRD
IT_ABWFLIMIT
IT_ABWFPOLHLDR
IT_ABWFPOLICY
IT_ABWFPPDPAC
IT_ABWFPRMPAYR
IT_ABWFREPVAL
IT_ABWFRESDEPC
IT_ABWFSBADR
IT_ABWFSUBJCT
IT_ABWFSUPDC
IT_ALWAADDPRPY
IT_ALWAASFUND
IT_ALWABNF
IT_ALWAINDINC
IT_ALWAPPDSTL
IT_ALWAPREM
IT_ALWASUBSAG
IT_ALWAVALID
IT_ALWFADDPRPY
IT_ALWFASFUND
IT_ALWFBNF
IT_ALWFINDINC
IT_ALWFPPDSTL
IT_ALWFPREM
IT_ALWFSUBSAG
IT_ALWFVALID
IT_ANSWERS
IT_NOTES_APIF
IV_LOCKKEY_ID
KEY_MAPPING
MESSAGES
POLICYNR

Ausnahmen

/PM0/CX_3FT_EXCEPTION

Funktionsgruppe

/SAPLABT_APIF

CPI1466 during Backup   rdisp/max_wprun_time - Maximum work process run time  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 24703 Date: 20240510 Time: 183112     sap01-206 ( 173 ms )