Sie befinden sich hier:
InsClaimItemService:calculateCoverages
Verwenden Sie diesen Service, um den Deckungsbetrag und den angepassten Betrag für einen Anspruchsbelegposten zu berechnen. Diese Beträge werden als Zahlungsbetrag verwendet, wenn der Anspruchsbearbeiter den Anspruchsbelegposten bezahlt.
Beim Erstellen von Anpassungen berücksichtigt der Service geltende Selbstbehalte, Copays, Coinsurance und Out-of-Pocket-Maxima.
Dieser Service wertet die Abdeckungsberechnungsformel aus, wenn eine in der Abdeckungsspezifikation definiert ist.
Methode: calculateCoverages
Funktionsweise
Der Service verwendet Objektoberflächenfeldnamen als Standardeingabe und -ausgabe für allgemeine Felder in Vlocity- (ClaimLineItem__c) und Salesforce FSC-Datenmodellen (ClaimCoveragePaymentDetail).
Dieser Service funktioniert unterschiedlich, je nachdem, ob in der Abdeckungsspezifikation eine Abdeckungsberechnungsformel vorhanden ist.
Wenn keine Formel für die Abdeckungsberechnung vorhanden ist, bietet dieser Service Folgendes:
-
Verwendet die folgenden Informationen, um den Anspruchsdatensatz, den zugehörigen Policendatensatz und Attributwerte für den Anspruch und die Richtlinie abzurufen.
-
claimId -
claimCoverageId -
claimItemId(sofern verfügbar) -
claimAmount
-
-
Ruft den InsPolicyTermsService auf: Prozessservice.
Dieser Service berechnet alle versicherten Pflichtbeträge (Copay/Coinsurance, max. abzugsfähig und out-of-pocket) und gibt diese Daten zurück.
-
Subtrahiert die Beträge der versicherten Verpflichtungen vom Anspruchsbetrag, wenn ein oder mehrere Beträge der versicherten Verpflichtungen vorhanden sind.
-
Gibt die Ausgabe einschließlich des endgültig angepassten Betrags und der untergeordneten Anspruchsposten (falls vorhanden) zurück.
Wenn in der Abdeckungsspezifikation eine Abdeckungsberechnungsformel vorhanden ist, hat dieser Service Folgendes:
-
Verwendet die folgenden Informationen, um den Anspruchsdatensatz, den zugehörigen Policendatensatz und Attributwerte für den Anspruch und die Richtlinie abzurufen.
-
claimId -
claimCoverageId -
claimItemId(sofern verfügbar) -
claimAmount
-
-
Kompiliert die folgenden Objekte (einschließlich "AttributSelectedValues <productcode.key>"), um sie der Abdeckungsberechnungsformel in der Abdeckungsspezifikation zur Verfügung zu stellen:
-
Anspruch
-
Policy
-
PolicyCoverage
-
InsuredParty
-
InsuredItem
-
InvolvedInjury
-
InvolvedProperty
-
-
Führt die Formel für die Abdeckungsberechnung aus.
-
Ruft den InsPolicyTermsService auf: Prozessservice.
Dieser Service berechnet alle versicherten Pflichtbeträge (Copay/Coinsurance, max. abzugsfähig und out-of-pocket) und gibt diese Daten zurück.
-
Subtrahiert die Beträge der versicherten Verpflichtungen vom Anspruchsbetrag, wenn ein oder mehrere Beträge der versicherten Verpflichtungen vorhanden sind.
-
Gibt die Ausgabe einschließlich des endgültig angepassten Betrags und der untergeordneten Anspruchsposten (falls vorhanden) zurück.
Remote-Optionen
Option |
Beschreibung |
|---|---|
|
Pflichtangabe. Die ID des Anspruchs, für den der Service den Deckungsbetrag berechnet. |
|
Optional. Verwenden Sie diese Option, wenn Sie einen vorhandenen Anspruchsbelegposten mit neu berechneter Abdeckung und angepassten Beträgen aktualisieren. |
|
Pflichtangabe. Die ID der Abdeckung, für die der Service einen Betrag berechnet. |
|
Pflichtangabe. JSON der möglichen zusätzlichen Eingabe zur Verwendung in den Abdeckungsformeln, die im Anspruchsbelegposten-Datensatz gespeichert werden soll (wenn saveLineItem wahr ist). Sie muss über die folgenden Eingaben verfügen:
|
Diese Option verwendet die in dieser Tabelle beschriebenen Schnittstellenfeldnamen in der Eingabe und Ausgabe für allgemeine Felder in Vlocity-ClaimLineItem__c und Salesforce FSC-ClaimCoveragePaymentDetail:
Benutzeroberflächenfeldname |
Allgemeine Felder in Vlocity- |
|---|---|
|
Für |
|
Verwenden für |
|
Für |
|
Für |
|
Für |
|
Verwenden für |
|
Für |
|
Für |
|
Für |
|
Für |
|
Verwenden für |
Verwenden Sie für Felder, die hier nicht aufgeführt sind, den vollständig qualifizierten Namen des Felds.
Attribute mit dem Präfix "ClaimLineItem", die über die API des Anspruchsbelegpostens verfügen, werden im erstellten Anspruchsbelegposten gespeichert.
Eingabe-JSON und Ausgabe-JSON
Wenn vorkonfigurierte Methoden zur Bestimmung des angepassten Betrags für ein Zahlungsdetail Ihren Geschäftsanforderungen entsprechen, können Sie diesen Abschnitt überspringen. Wenn Sie jedoch Zahlungsdetails auf eine Weise anpassen möchten, die nicht vorkonfiguriert unterstützt wird, ist dieser Abschnitt genau das Richtige für Sie.
In der Regel sind diese vorkonfigurierten Anwendungsfälle für Szenarien vorgesehen, die nicht durch Leistungsattributklassen abgedeckt werden, beispielsweise:
-
Bedingte Selbstbehalte, wobei zwei Selbstbehalte für dieselbe Abdeckungsspezifikation vorhanden sind. Beispielsweise gilt "Abzug A" für einen Brandschadensverlust und "Abzug B" für einen Hochwasserschadensverlust. Sie möchten, dass das System bestimmt, welcher Selbstbehalt zur Laufzeit auf das Zahlungsdetail angewendet wird.
-
Copay/Coinsurance-Reihenfolge der Vorgänge. Beispielsweise sind "Coinsurance" und "Copay" in derselben Abdeckungsspezifikation vorhanden und Sie möchten die Coinsurance anwenden, bevor Sie die Copay auf ein Zahlungsdetail anwenden.
-
Berechnung eines Auszahlungsbetrags für einen Vorteilstyp. Bei einem Vorteilstyp "Gesundheitsbesuch" soll das System beispielsweise einen Betrag von 50 EUR für das Zahlungsdetail berechnen.
Nachdem Sie das JSON-Format für die InsClaimItemService: calculateCoverages-Ausgabe verstanden haben, können Sie ein Verhalten implementieren, das dem Leistungsattribut ähnelt, um Auszahlungsbeträge und Anpassungen zu berechnen, ohne über eine zugrunde liegende Leistungsattributklasse zu verfügen.
Bevor wir uns selbst einen Schritt voraus sind, wird anhand eines einfachen Beispiels die JSON-Ausgabe veranschaulicht, die von InsClaimItemService:
calculateCoverages zurückgegeben werden soll. Stellen Sie sich einen einfachen Anwendungsfall vor, der von der vorkonfigurierten Attributklasse "Absetzbare Leistung" unterstützt wird.
Beispiel: 5.000 EUR beanspruchter Betrag für eine Police mit einem Selbstbehalt von 1.000 EUR
Hier ist die Eingabe-JSON für InsClaimItemService:
calculateCoverages.
{
"claimId": "01t000000000000001",
"claimCoverageId": "01t000000000000002",
"claimItemId": "01t000000000000003",
"additionalInput": {
"ClaimLineItem.claimAmount": 5000
"ClaimLineItem.description": "first party claim payment"
"ClaimLineItem.recipientId": "01t000000000000004"
}
}Hier sehen Sie die von InsClaimItemService:
calculateCoverages zurückgegebene Ausgabe-JSON.
{
"claimItem": {
"adjustedAmount": 4000 // loss item adjusted amount
},
"claimLineItemAdjustment": {
"attributeClass": "Deductible", // policy terms attribute class
"adjustedAmount": 1000, // policy terms tracking entry postedAmount
"assetTermId": "a6ERN00000000dg2AA", // policy terms id
"remainingAmount": 0 // policy terms tracking entry remainingAmount
}
}Im Folgenden erfahren Sie, wie Benutzerinteraktionen auf der Registerkarte "Finanzen" Services aufrufen, wie InsClaimItemService: calculateCoverages Daten abruft und was danach mit den Daten geschieht.
-
(1) Auf der Registerkarte "Finanzen" eines Anspruchs klickt ein Benutzer auf Neuer Verlustposten und gibt einen Anspruchsbetrag von 5.000 EUR ein. Durch Drücken der Tabulatortaste wird
InsClaimItemService: calculateCoveragesvom Anspruchsbetrag zum nächsten Feld aufgerufen. In diesem Beispiel enthält die vonInsClaimItemService: calculateCoverageszurückgegebene JSON-Ausgabe die folgenden Werte.-
claimLineItem: adjustedAmountDer an den Empfänger gezahlte Betrag, nachdem der Selbstbehalt vom Anspruchsbetrag abgezogen wurde: 5.000 – 1.000 €=4.000 €. Dieser Wert wird dem Benutzer im Formular "Neuer Verlustposten" im Feld "Angepasster Betrag" angezeigt. -
claimLineItemAdjustment:adjustedAmountDer Betrag der Anpassung des Details zur Anspruchsabdeckungszahlung, in diesem Fall die vom Anspruchsbetrag abgezogenen 1.000 EUR. -
claimLineItemAdjustment:attributeClassDer Grund, warum der Betrag, der dem Empfänger ausgestellt werden soll, vom beanspruchten Betrag abweicht. In diesem Beispiel wird der beanspruchte Betrag um 1.000 EUR reduziert, da ein Selbstbehalt von 1.000 EUR gilt (attributeClass = Selbstbehalt). -
claimLineItemAdjustment:assetTermIdDie Policenlaufzeit, für die ein Eintrag zur Verfolgung der Policenlaufzeit erstellt wird. In diesem Beispiel ist es die ID der Policenlaufzeit "Abzugsfähig". -
claimLineItemAdjustment:remainingAmountDer Betrag, der im Eintrag für die Verfolgung der Policenlaufzeit festgelegt werden soll, in diesem Fall 0 EUR, da nach dieser Transaktion kein Selbstbehalt verbleibt.
-
-
(2) Durch Klicken auf Hinzufügen zum Speichern des neuen Verlustpostens wird
InsClaimItemService: addaufgerufen, das die vonInsClaimItemService: calculateCoverageszurückgegebene JSON-Ausgabe verwendet, um Daten in den Datensätzen "ClaimCoveragePaymentDetail", "ClaimCoveragePaymentAdjustment" und "InsurancePolicyTermTrackingEntry" beizubehalten. (DerInsClaimItemService: updatefunktioniert ähnlich.) Jeder Datensatz enthält Werte, die sich auf unser Beispiel beziehen:-
Der Datensatz "ClaimCoveragePaymentDetail" weist einen ClaimCoveragePaymentDetail.ClaimedAmount von 5.000 $ und einen ClaimCoveragePaymentDetail.AdjustedAmount von 4.000 $ auf.
-
Der Datensatz "ClaimCoveragePaymentAdjustment" verfügt über "ClaimCoveragePaymentAdjustment.AdjustedReason of Deductible" und "ClaimCoveragePaymentAdjustment.AdjustedAmount" von 1.000 $.
-
Der Datensatz "InsurancePolicyTermTrackingEntry" weist einen InsurancePolicyTermTrackingEntry.PostedAmount von 1.000 $ und einen InsurancePolicyTermTrackingEntry.RemainingAmount von 0 $ auf.
-
Wenn Sie sich mit der grundlegenden Struktur der Ausgabe-JSON vertraut machen, können Sie einen erweiterten Anwendungsfall einrichten, indem Sie Logik in die Abdeckungsberechnungsformel in einer Abdeckungsspezifikation einfügen.
Beispiel: Auf der Registerkarte "Details" einer Abdeckungsspezifikation geben Sie eine Formel für die Abdeckungsberechnung wie diese ein und verwenden dabei dieselbe ClaimLineItem-Syntax, die für die additionalInput verwendet wird.
InvokeIP('ClaimCoverage_ClaimCoverageFormula', , INPUT('claimId', ClaimLineItem.claimId) INPUT('benefitType', ClaimLineItem.benefitType), INPUT('quantityCount', ClaimLineItem.unitCount), 'result')
Zur Laufzeit ruft diese Formel ein Integrationsverfahren namens ClaimCoverage_ClaimCoverageFormula auf. Dieses Integrationsverfahren erwartet Eingaben für "claimId", "profitType" und "quantityCount", wie in dieser Beispiel-Eingabe-JSON zum Testen des Integrationsverfahrens gezeigt:
{
"claimId": "a2b4W000007W2pQQAS",
"benefitType": "Ambulance - Air",
"quantityCount": "1",
}Die Formel für die Abdeckungsberechnung gibt an, dass sich die Ausgabe-JSON für das Integrationsverfahren "ClaimCoverage_ClaimCoverageFormula" in einem Knoten namens "result" befindet. Solange die JSON-Struktur in diesem result-Knoten dem erwarteten JSON-Format für die InsClaimItemService: calculateCoverages entspricht, verhält sich das System genau so, als würde es eine zugrunde liegende power-Attributklasse verwenden: Anzeigen des angepassten Betrags für den Benutzer und beibehaltender Daten in den Datensätzen "ClaimCoveragePaymentDetail", "ClaimCoveragePaymentAdjustment" und "InsurancePolicyTermTrackingEntry", nachdem auf die Schaltfläche Hinzufügen geklickt wurde.
In diesem Ausgabe-JSON-Beispiel einer Auszahlung von 50 EUR für einen Gesundheitsbesuch veranlasst der result-Knoten InsClaimItemService: add, eine Einfügung von 50 in ClaimCoveragePaymentDetail.AdjustedAmount auszuführen.
{
"result": {
"claimLineItem": {
"adjustedAmount": "50"
}
},
}Im Folgenden finden Sie einige Tipps zum Konfigurieren Ihrer Berechnung.
-
Wenn Ihr Anwendungsfall vorhandene Leistungsattributklassen umfasst, können Sie anhand von
InsurancePolicyTerms: getCurrentStandingsbestimmen, wie viel für eine Policenlaufzeit verbleibt, bevor Sie eine Anpassung vornehmen. Mit diesem Schritt können Sie die richtige Anpassung anwenden und die entsprechende assetTermId zurückgeben. Konfigurieren Sie in diesen Anwendungsfällen die von Ihrem Integrationsverfahren zurückgegebene JSON-Struktur so, dass sie die Knoten claimLineItem und claimLineItemAdjustment enthält.Stellen Sie im Knoten claimLineItemAdjustment Folgendes sicher:
-
Include assetTermId.
-
Include attributeClass.
Der
InsClaimItemService: add-Service benötigt beide Werte, um zu bestimmen, wie der Datensatz für die Verfolgung des Eintritts in die Versicherungspolice für dieses spezifische Leistungsattribut in der Police erstellt wird. Beispielsweise weist eine Abdeckungsspezifikation mit einem bedingten Selbstbehalt zwei Attribute vom Typ "Abzugsfähige Leistung" auf: Abzug A für Feuer und Abzug B für Hochwasser. Das Integrationsverfahren in der Formel "Abdeckungsberechnung" kannInsurancePolicyTerms: getCurrentStandingsverwenden, um zu bestimmen, dass "Abzugswert A" für diese Police 1.000 $ und "Abzugswert B" 500 $ beträgt. Anschließend kann das Integrationsverfahren anhand der Schadensursache für diesen Anspruch herausfinden, welcher Abzug angewendet werden soll. Stellen Sie beim Zurückgeben der Ausgabe-JSON sicher, dass Sie die richtige AssetTermId zurückgeben, je nachdem, welcher Selbstbehalt angewendet wurde. -
-
In einigen Anwendungsfällen sind die vorkonfigurierten Leistungsattributklassen nicht enthalten, es muss jedoch noch eine Anpassung am Zahlungsdetail vorgenommen werden. Wenn ein Anbieter beispielsweise mehr als einen ausgehandelten Tarif in Rechnung stellt, benötigen Sie einen Datensatz vom Typ "ClaimCoveragePaymentAdjustment", um zu erläutern, warum der angepasste Zahlungsbetrag kleiner als der beanspruchte Betrag ist. Konfigurieren Sie in diesen Anwendungsfällen die von Ihrem Integrationsverfahren zurückgegebene JSON-Struktur so, dass sie die Knoten claimLineItem und claimLineItemAdjustment enthält.
Im Knoten claimLineItemAdjustment:
-
Lassen Sie assetTermId aus, da diese Anpassung nicht durch eine Leistungsattributklasse definiert ist.
-
Fügen Sie attributeClass als Anpassungsgrund hinzu (z. B. "Überabrechnungsanpassung").
Der
InsClaimItemService: addverwendet die Zeichenfolge attributeClass, um das Feld ClaimCoveragePaymentDetail.AdjustedReason auszufüllen, auch wenn keine zugehörige attributeClass vorhanden ist. -
-
Wenn ein Anwendungsfall einen Auszahlungsbetrag für einen Vorteilstyp umfasst, besteht keine Diskrepanz zwischen beanspruchten und angepassten Beträgen. Beispielsweise gilt für Krankenhausaufenthalte eine Pauschale von 100 EUR/Tag. Lassen Sie in diesen Fällen den gesamten Knoten claimLineItemAdjustment aus Ihrer JSON heraus.
