Loading
Insurance
Procédures d'intégration personnalisées pour les calculs d'ajustement

Procédures d'intégration personnalisées pour les calculs d'ajustement

L'ensemble d'expressions standard est conçu pour gérer les obligations dans le contexte Limite de la police d'assurance. Dans certains cas, vous avez besoin de calculs plus spécialisés. Lorsque vous devez calculer des Franchises, des Copays, une Coassurance ou un Maximum prêt à l'emploi (OOPM) avec une logique personnalisée, vous pouvez étendre le flux de calcul en utilisant une Procédure d'intégration (IP) personnalisée.

Éditions requises

Afficher les éditions prises en charge.

Une adresse IP personnalisée est particulièrement utile dans les situations suivantes :

  • Données externes : Les données requises pour vos calculs ne sont pas toujours limitées à des jeux de données standard. Par exemple, vous pouvez incorporer des données de demandeur ou de compte telles que l'âge, la région ou le groupe d'employeurs. Ces données externes peuvent impacter significativement le calcul des franchises, des copays, de la coassurance ou de l'OOPM.
  • Logique avancée : Dans certains cas, la logique standard peut ne pas être suffisante. Par exemple, vous devez appliquer des remises de coassurance basées sur l'âge ou d'autres règles complexes.
  • Valeurs de consommation en temps réel : Dans certains cas, les valeurs requises pour les calculs sont dynamiques et récupérées en temps réel. Cela implique des API externes pour accéder aux toutes dernières informations.

En utilisant une adresse IP personnalisée, vous pouvez vous assurer que vos calculs sont précis et adaptés à vos besoins spécifiques, en exploitant des données et une logique qui dépassent les capacités standard de l'ensemble d'expressions. Cette flexibilité est cruciale pour gérer des scénarios d'assurance complexes et fournir des résultats précis.

Avant de créer votre procédure d'intégration personnalisée, assurez-vous d'activer la prise en charge de l'API de métadonnées Omnistudio.

Workflow IP personnalisé

Étapes de création d'une adresse IP personnalisée pour le calcul des ajustements :

  1. Créez une procédure d'intégration. Par exemple, IP_CustomAdjustments.

    Votre adresse IP reçoit une carte d'entrée semblable à cet exemple.

    {
      "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"
      }
    }

    Votre adresse IP reçoit l'additionalFields uniquement lorsque vous configurez un ensemble de champs dans l'objet Détail de paiement de la couverture de réclamation et le mappez avec un produit de couverture. Pour plus d'informations sur l'insertion de données contextuelles dans des champs supplémentaires, consultez Données contextuelles dans des calculs personnalisés.

  2. Il récupère les données de référence :

    • Le DOB de l'objet Contact pour calculer l'ancienneté.
    • L'adresse de l'objet Compte pour déterminer la région.
  3. Il peut également invoquer l'API Get Current Standings pour récupérer la dernière utilisation de franchise, de copay, de coassurance et de OOPM.

    • Utilisez cette API dans votre adresse IP si vous souhaitez récupérer les soldes actuels de la franchise, de l'OPM et d'autres obligations.
    • Votre calcul d'obligation reflète ainsi la consommation la plus récente au moment du calcul.
    • Si vous n'invoquez pas cette API, votre adresse IP utilise les valeurs transmises via la requête ou la configuration statique.
    • Vous pouvez utiliser d'autres outils d'extraction de données dans l'adresse IP si l'API Get Current Standings n'est pas idéale pour le cas d'utilisation.
  4. Implémente des règles d'obligation :

    • Déductible : Déduit le montant restant de la franchise.
    • Coassurance : Applique le taux de base ou ajusté. Par exemple, appliquez un taux de coassurance réduit aux demandeurs âgés de plus de 75 ans.
    • OOPM : Ajuster les obligations si le demandeur a déjà atteint le maximum de sa poche.
    • Acheminement contextuel : Branches sur les valeurs de la carte additionalFields. Par exemple, appliquez une remise dans le réseau lorsque additionalFields.networkType est InNetwork, ou renoncez à la participation au coût des services préventifs lorsque additionalFields.treatmentCategory est Préventive.
  5. Produit une réponse JSON consolidée qui comprend :

    • insurancePolicyLimitTrackings : Détails du suivi des limites.
    • claimCovPaymentAdjustments : Répartition des ajustements de paiement.
    • Garantit que l’ajustement Montant reflète le montant final payable après toutes les obligations.

Résumé

Assurez-vous que le format JSON de sortie est exactement comme indiqué ci-dessous.

{
  "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" }
    ]
  }
}

Remplissez calcInitialValue (entier) au lieu de calcInitialAmount pour les éléments de suivi Coinsurance, comme indiqué dans l'exemple de sortie.

Cas d'utilisation : Obligations avec le classement actuel facultatif

Scénario

  • Montant demandé : $1,000

  • Reliquat de franchise : 200 € (récupéré depuis l'API Get Current Standings)

  • Coassurance : 7 % (remise appliquée, normalement 10 %)

  • Out-of-Pocket Maximum (OOPM) : Le requérant a déjà utilisé 5 700 $ sur le plafond de 6 000 $.

Étapes de calcul

  1. Demande de franchise :

    • La franchise restante de 200 $ est appliquée au montant demandé.
    • Montant demandé après franchise : $1,000 - $200 = $800
  2. Demande de coassurance :

    • Appliquez la coassurance de 7 % au montant restant.
    • Montant de la coassurance : $800 * 7% = $56
  3. Considérations relatives au maximum de prêts consentis :

    • Le montant restant après la franchise et la coassurance est pris en compte pour le PMSO est de 44 $.
    • Montant ajusté après la coassurance : $800 - $56 = $744
  4. Montant final :

    • Comme le demandeur n'a pas atteint le plafond de la PMNO, les 744 $ restants sont couverts et envoyés pour paiement.

Exemple de JSON de sortie :

{
  "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" }
    ]
  }
}

Considérations

  • API facultative : Pour plus de précision, vous pouvez appeler l'API Get Current Standings depuis l'adresse IP. Utilisez cette API si vous avez besoin de données en temps réel sur la consommation limite.

  • Association : Pendant la configuration, associez votre adresse IP aux couvertures de police appropriées dans lesquelles la logique d'obligation doit être appliquée.

 
Chargement
Salesforce Help | Article