Loading
Assicurazioni
Procedure di integrazione personalizzate per i calcoli delle rettifiche

Procedure di integrazione personalizzate per i calcoli delle rettifiche

L'insieme di espressioni standard è progettato per gestire le obbligazioni nel contesto Limite polizza assicurativa. Esistono casi in cui sono necessari calcoli più specializzati. Quando è necessario calcolare Deducibili, Copay, Coassicurazione o Massimo fuori tasca (OOPM) con una logica personalizzata, è possibile estendere il flusso di calcolo utilizzando una procedura di integrazione (IP) personalizzata.

Versioni (Edition) richieste

Visualizzare le versioni supportate.

Un IP personalizzato è particolarmente utile in queste situazioni:

  • Dati esterni: I dati necessari per i calcoli non sono sempre limitati alle serie di dati standard. Ad esempio, è possibile incorporare dati di richiedenti o account come età, regione o gruppo di datori di lavoro. Questi dati esterni possono influire in modo significativo sul calcolo di detrazioni, copay, coassicurazione o OOPM.
  • Logica avanzata: In alcuni scenari, la logica standard potrebbe non essere sufficiente. Ad esempio, è necessario applicare sconti di coassicurazione basati sulla durata o altre regole complesse.
  • Valori di consumo in tempo reale: In alcuni casi, i valori richiesti per i calcoli sono dinamici e recuperati in tempo reale. Ciò implica API esterne per accedere alle informazioni più recenti.

Utilizzando un IP personalizzato, è possibile assicurarsi che i calcoli siano precisi e personalizzati in base alle proprie esigenze specifiche, sfruttando dati e logica che vanno oltre le funzionalità standard dell'insieme di espressioni. Questa flessibilità è fondamentale per gestire scenari assicurativi complessi e fornire risultati accurati.

Prima di creare la procedura di integrazione personalizzata, assicurarsi di abilitare il Supporto API metadati OmniStudio.

Flusso di lavoro IP personalizzato

Passaggi per creare un IP personalizzato per il calcolo delle rettifiche:

  1. Creare una procedura di integrazione. Ad esempio, IP_CustomAdjustments.

    L'IP riceve una mappa di input simile a questo esempio.

    {
      "claimId": "801xx0000004Cc7GAE",
      "claimCoverageId": "1cxx0000004Cc7GAE",
      "claimedAmount": 1000,
      "benefitName": "Medical",
      "paymentDetailId": "0Rvxx0000004Cc7GAE",
      "PolicyLimitStandings": [
        {
          "insurancePolicyLimitId": "1TDxx0000004Cc7GAE",
          "category": "Deductible",
          "scope": "ClaimCoverage",
          "calcInitialAmount": 1000,
          "remainingAmount": 200
        },
        {
          "insurancePolicyLimitId": "1TDxx0000004Cc6GAE",
          "category": "Coinsurance",
          "scope": "ClaimCoverage",
          "calcInitialValue": 10
        },
        {
          "insurancePolicyLimitId": "1TDxx0000004Cc8GAE",
          "category": "OutOfPocketMax",
          "scope": "Policy",
          "calcInitialAmount": 6000,
          "remainingAmount": 300
        }
      ],
      "additionalFields": {
        "networkType": "InNetwork",
        "treatmentCategory": "Preventive"
      }
    }

    L'IP riceve additionalFields solo quando si configura un campo impostato sull'oggetto Dettaglio pagamento copertura della richiesta e lo si mappa a un prodotto copertura. Per ulteriori dettagli sull'inclusione di dati contestuali in campi aggiuntivi, vedere Dati contestuali nei calcoli personalizzati.

  2. Recupera i dati di riferimento:

    • DOB dell'oggetto Referente per calcolare la durata.
    • L'indirizzo dell'oggetto Account per determinare la regione.
  3. Se si desidera, invoca l'API Get Current Standings per recuperare l'utilizzo più recente di deducibilità, copay, coassicurazione e OOPM.

    • Utilizzare questa API all'interno del proprio IP se si desidera recuperare la detrazione corrente, l'OOPM e altri saldi di obbligazioni.
    • Ciò garantisce che il calcolo degli obblighi rifletta il consumo più recente al momento del calcolo.
    • Se non si invoca questa API, l'IP utilizza i valori passati tramite la richiesta o la configurazione statica.
    • È possibile utilizzare altri strumenti di estrazione dati all'interno dell'IP se l'API Ottieni posizioni correnti non è ideale per il caso d'uso.
  4. Implementa le regole di obbligo:

    • Detraibile: Deduce l'importo deducibile rimanente.
    • Coassicurazione: Applica la base o un tasso rettificato. Ad esempio, applicare un tasso di coassicurazione ridotto per i richiedenti di età superiore a 75 anni.
    • OOPM: Rettificare gli obblighi se il richiedente ha già raggiunto il limite massimo di disponibilità.
    • Instradamento contestuale: Ramifica i valori della mappa del additionalFields. Ad esempio, applicare uno sconto in rete quando additionalFields.networkType è InNetwork o rinunciare al pagamento per i servizi preventivi quando additionalFields.treatmentCategory è preventivo.
  5. Produce una risposta JSON consolidata che include:

    • insurancePolicyLimitTrackings: Dettagli del tracciamento dei limiti.
    • claimCovPaymentAdjustments: Suddivisione delle rettifiche di pagamento.
    • Garantisce che il adjustedAmount rifletta l'importo finale da pagare dopo tutti gli obblighi.

Riepilogo

Assicurarsi che il formato JSON di output sia esattamente quello indicato di seguito.

{
  "result": {
    "adjustedAmount": 800,
    "adjustmentReason": "Deductible, Copay, Coinsurance, OutOfPocketMax",
    "insurancePolicyLimitTrackings": [
      {
        "insurancePolicyLimitId": "1TDxx0000004Cc7GAE",
        "category": "Deductible",
        "scope": "ClaimCoverage",
        "calcInitialAmount": 1000,
        "postedAmount": 200,
        "remainingAmount": 0,
        "totalUsedAmount": 500
      },
      {
        "insurancePolicyLimitId": "1TDxx0000004Cc6GAE",
        "category": "Coinsurance",
        "scope": "ClaimCoverage",
        "calcInitialValue": 1000,
        "postedAmount": 54.60,
        "totalUsedAmount": 300
      },
      {
        "insurancePolicyLimitId": "1TDxx0000004Cc8GAE",
        "category": "OutOfPocketMax",
        "scope": "Policy",
        "calcInitialAmount": 1000,
        "postedAmount": 200,
        "remainingAmount": 0,
        "totalUsedAmount": 6000
      }
    ],
    "claimCovPaymentAdjustments": [
      { "adjustedAmount": 200,   "adjustmentReason": "Deductible"    },
      { "adjustedAmount": 20,    "adjustmentReason": "Copay"         },
      { "adjustedAmount": 54.60, "adjustmentReason": "Coinsurance"   },
      { "adjustedAmount": 200,   "adjustmentReason": "OutOfPocketMax" }
    ]
  }
}

Compilare calcInitialValue (Intero) anziché calcInitialAmount per gli elementi di tracciamento Coinsurance, come mostrato nell'output di esempio.

Caso d'uso: Obblighi con posizioni correnti facoltative

Scenario

  • Ammontare richiesto: $1,000

  • Detraibile rimanente: 200 $ (recuperati dall'API Get Current Standings)

  • Coassicurazione: 7% (sconto applicato, normalmente 10%)

  • Massimo di tasca (OOPM): Il richiedente ha già utilizzato 5.700 $ del limite di 6.000 $.

Fasi di calcolo

  1. Domanda deducibile:

    • La franchigia rimanente di $ 200 viene applicata all'importo richiesto.
    • Ammontare richiesto dopo la detrazione: $1,000 - $200 = $800
  2. Domanda di coassicurazione:

    • Applicare la coassicurazione del 7% all'importo rimanente.
    • Ammontare coassicurazione: $800 * 7% = $56
  3. Considerazione sul valore massimo out-of-pocket (OOPM):

    • L'importo rimanente dopo la detrazione e la coassicurazione viene considerato per OOPM è $44.
    • Ammontare rettificato dopo la coassicurazione: $800 - $56 = $744
  4. Ammontare finale:

    • Poiché il richiedente non ha raggiunto il limite OOPM, i $ 744 rimanenti vengono coperti e inviati per il pagamento.

Esempio JSON di output:

{
  "result": {
    "adjustedAmount": 744,
    "adjustmentReason": "Deductible, Coinsurance",
    "insurancePolicyLimitTrackings": [
      {
        "insurancePolicyLimitId": "1TDxx0000004Cc7GAE",
        "category": "Deductible",
        "scope": "ClaimCoverage",
        "calcInitialAmount": 200,
        "postedAmount": 1000,
        "remainingAmount": 0,
        "totalUsedAmount": 200
      },
      {
        "insurancePolicyLimitId": "1TDxx0000004Cc6GAE",
        "category": "Coinsurance",
        "scope": "ClaimCoverage",
        "calcInitialValue": 7,
        "postedAmount": 1000,
        "totalUsedAmount": 56
      },
      {
        "insurancePolicyLimitId": "1TDxx0000004Cc8GAE",
        "category": "OutOfPocketMax",
        "scope": "Policy",
        "calcInitialAmount": 300,
        "postedAmount": 1000,
        "remainingAmount": 44,
        "totalUsedAmount": 5956
      }
    ],
    "claimCovPaymentAdjustments": [
      { "adjustedAmount": 200, "adjustmentReason": "Deductible"  },
      { "adjustedAmount": 56,  "adjustmentReason": "Coinsurance" }
    ]
  }
}

Considerazioni

  • API facoltativa: Per una maggiore precisione, è possibile chiamare l'API Ottieni posizioni correnti dall'IP. Utilizzare questa API se sono necessari dati in tempo reale sul consumo limite.

  • Associazione: Durante l'impostazione, associare il proprio IP alle coperture delle polizze pertinenti in cui deve essere applicata la logica degli obblighi.

 
Caricamento
Salesforce Help | Article