InsPolicyService:createPolicyVersion

Deze service schakelt versiebeheer van beleid in. Alle wijzigingen aan een beleid worden bijgehouden in verschillende versies van dat beleid. U kunt deze gebruiken in OmniScripts en integratieprocedures voor beleid wijzigen en beleid annuleren. U kunt deze service ook gebruiken om vervallen en geannuleerde polissen opnieuw in te stellen.

Deze service werkt met de Salesforce Financial Services Cloud voor optionele ondersteuning voor het maken van betalingsschema's.

Klasse: InsPolicyService

Methode: createPolicyVersion

De manier waarop het werkt...

1. Neemt de assetId of policyId van het huidige beleid en de JSON die door de inputKey wordt aangegeven.

2. Maakt een kloon van het oorspronkelijke beleid.

3. Als er een bestaande betalingsplanning is, werkt de service de betalingsplanning bij en maakt een ingang van de betalingsplanning op de ingangsdatum van de bevestiging. Als useIsPaidFlag true (waar) is, worden alle toekomstige betalingsplanningsgegevens (vanaf ingangsdatum) zonder transacties (waarvoor het statusveld Valid is en het veld isPaid is uitgeschakeld) bijgewerkt op basis van nieuwere waarden zoals premie, belasting en kosten. Het nieuwe betalingsschema-item bevat de aangepaste waarden van premie, belasting en kosten op basis van nieuwe premies, belastingen en kosten en bijgewerkte betalingsschema-items. Ook worden de bijdragerecords van poliscomponenten in elke ingang van de betalingsplanning bijgewerkt.

4. De service gebruikt de Berekeningswijze van premie, het Betalingstype en de Premiefrequentie van de vorige polis, en de Totaalpremie voor looptijd, Totaalkosten voor looptijd en Totaalbelasting voor looptijd van de nieuwe polis om de gewijzigde betalingsplanning te genereren. Naast het maken van de transactie worden transactiesplitsingsgegevens ingevuld in het transactiedetailobject. Dit object slaat gegevens op over hoeveel elk activum, elke deelnemer of elke dekking bijdraagt aan de totale transactiebedragen in termen van premie, belasting en kosten. Alleen activa, deelnemers en dekkingen met minstens één waarde groter dan nul voor premie, belasting of kosten worden weergegeven.

   

   Opmerking Premieberekeningswijze, Betalingstype en Premiefrequentie worden niet overgenomen van het vorige beleid en moeten worden doorgegeven als invoer voor de service via de JSON.

5. Als includeRevenueSchedule is ingesteld op true (waar), wordt de service voor omzetplanning aangeroepen om de omzetplanning te wijzigen.

6. Als het de eerste wijziging van dit beleid is, stempelt de service de originalVersionId__c en previousVersionId__c met hetzelfde assetId. Als dit niet de eerste wijziging van dit beleid is, draagt de service de OriginalVersionId__c over naar de nieuwe versie en stempelt de vorige assetId af naar PreviousVersionId__c in het nieuwe beleid.

7. Als de knooppunten taxesAndFees, taxAmount en/of feeAmount zijn opgenomen in de invoer-JSON, worden de overeenkomende velden voor belasting/kosten en/of records gemaakt en pro rata berekend voor de nieuwe versie van het beleid.

8. Indien van toepassing, wordt er een InsurancePolicyTransaction gemaakt voor de aanpassing van de betaling.

9. Als calculateCommission true is, roept de service InsurancePolicyService.calculateAndSaveCommission aan, die de invoer voorbereidt voor de InsCommissionService.calculate en InsCommissionService.saveCommissions. Nadat de berekeningsservice de invoer heeft verwerkt, slaat de opslagservice de berekende waarde op in TotalCommissionAmount, totaliseert de waarde en voegt deze toe aan de TotalCommissionAmount van de oorspronkelijke Polis.

10. Als de vlag disableAttributeCategories in de getquotedetail is ingesteld op true (waar), laat de service het knooppunt attributeCategory weg uit de respons en kan de createPolicyVersion geen beleidstermen maken. Als u er zeker van wilt zijn dat de createPolicyVersion beleidsvoorwaarden maakt, stelt u de vlag disableAttributeCategories in de in de getQuoteDetail service in op false (onwaar).

Opmerking De service ondersteunt ook bevestigingen van polissen waarbij de duur van de oorspronkelijke polisversie minder dan 365 dagen of minder dan 366 dagen in een schrikkeljaar is. Zie Overwegingen en beperkingen bij verzekeringspolissen.

Belastingen en toeslagen

Deze service werkt als volgt voor belastingen en kosten:

• Als het veld taxesAndFees is opgegeven voor een JSON-record, blijft er een overeenkomende AssetPricingAdjustment__c bestaan voor elk item in de taxesAndFees.

• Als het veld taxAmount is opgegeven voor een JSON-record, wordt het veld TaxAmount__c ingesteld op de waarde van het veld taxAmount voor het gemaakte AssetItem.

• Als het veld feeAmount is opgegeven voor een JSON-record, wordt het veld FeeAmount__c ingesteld op de waarde van het veld feeAmount voor de gemaakte AssetItem.

Wat het huidige (nieuw gecreëerde beleid) betreft:

• Als het huidige beleid een TotalTaxAmount__c heeft, wordt die waarde pro rata berekend over de ingangs- en einddatum en ingesteld op het veld TotalTaxForTerm__c.

• Als het huidige beleid een TotalFeeAmount__c heeft, wordt die waarde pro rata berekend over de ingangs- en einddatum en ingesteld op het veld TotalFeeForTerm__c.

• Als de AssetItem voor de huidige polis een TaxAmount__c heeft dat de waarde pro rata is over de ingangs- en einddatum en is ingesteld op het veld ProratedTaxAmount__c.

• Als de AssetItem voor de huidige polis een FeeAmount__c heeft dat de waarde pro rata is over de ingangs- en einddatum en is ingesteld op het veld ProratedFeeAmount__c.

Voor polissen die al zijn gemaakt, worden de belastingen en kosten als volgt doorgegeven:

• Als het vorige beleid een TotalTaxAmount__c heeft, wordt die waarde pro rata berekend over de nieuwe ingangs- en einddatum, en wordt deze ingesteld voor het veld TotalTaxForTerm__c.

• Als het vorige beleid een TotalFeeAmount__c heeft, wordt die waarde pro rata berekend over de nieuwe ingangs- en einddatum, en wordt deze ingesteld voor het veld TotalFeeForTerm__c.

• Als de AssetItem-velden een TaxAmount__c hebben, wordt die waarde pro rata berekend over de nieuwe ingangs- en einddatum, en wordt deze ingesteld voor het veld ProratedTaxAmount__c.

• Als de AssetItem voor het vorige beleid een FeeAmount__c hebben, wordt die waarde pro rata berekend over de nieuwe ingangs- en einddatum en wordt deze ingesteld voor het veld ProratedFeeAmount__c.

Als de optie createTransaction (zie hieronder) is ingesteld op true (waar) en de nieuwe polisversie gekoppelde belastingen en kosten heeft, worden de TaxAmount__c en FeeAmount__c voor de gemaakte transactie ingesteld op het verschil tussen de nieuwe (huidige) polis en de TotalTaxForTerm__c en TotalFeeForTerm__c van de vorige polis.

Externe opties

Optie	Beschrijving
assetId of policyId	Verplicht. De ID van de huidige polis.
createContactForParticipants	Optioneel. true of false De standaardwaarde is true. In false maakt de service geen contactpersoonsrecords.
createInsuredItemsRelationships	true of false Als deze optie is ingesteld op true (waar), kunt u een lijst van instanceKey > parentInstanceKey tussen verzekerde items opgeven. Deze optie ondersteunt relaties tussen bovenliggend > onderliggend en bovenliggend > onderliggend > kleinkind verzekerd item.
createTransaction	Optioneel. true of false De standaardwaarde is false. Indien true, maakt de service een transactie die zal worden gebruikt door de omzetplanningsservices.
effectiveDate	“YYYY-MM-DD HH:MM:SS” of %OmniScriptDataElement% De datum waarop de polis van kracht wordt. Als er geen effectiveDate in de optiekaart staat, zoekt de service ernaar in de rootAttributes. Als de service daar geen effectiveDate kan vinden, wordt de datum van vandaag gebruikt. Als u het pakket Insurance Industries Extension gebruikt, wordt de tijdstempelwaarde in de optie effectiveDate genegeerd. In plaats daarvan wordt de tijdstempelwaarde van de ingangsdatum ingesteld op 12:00 uur van de geselecteerde ingangsdatum en wordt de waarde van de vervaldatum ingesteld op 23:59 uur voor de geselecteerde vervaldatum. Het tijdstempel wordt ingesteld met behulp van de opgegeven tijdzone van de gebruiker.
getDataCustomClassName	Optioneel. De naam van de aangepaste klasse die deze service gebruikt voor het ophalen van polisgegevens (activa). Als u Salesforce FSC gebruikt, moet u deze optie of postDataDRBundleName opgeven. De standaardwaarde is ingesteld op GetInsurancePolicy.
getDataDRBundleName	Optioneel, De naam van de Data Mapper die deze service gebruikt voor het ophalen van polisgegevens (activa). Als u Salesforce FSC gebruikt, moet u deze optie of getDataCustomClassName opgeven. Als u beide opgeeft, gebruikt de service de getDataDRBundleName. Als u geen van beide opgeeft, gebruikt de service de standaardwaarde voor getDataCustomClassName (GetInsurancePolicy).
includePaymentSchedule	Optioneel. True of de betalingsplanning voor de polis wordt bijgewerkt. Standaard is false.
includeRevenueSchedule	Optioneel. Wordt alleen gebruikt als createTransaction is ingesteld op true. true of false Indien true roept deze optie InsPolicyRevenueScheduleService aan: wijzigen
inputKey	Verplicht. %theJSONyouneed%
isCreatingPolicyTerms	true of false Indien ingesteld op true, retourneert de service een policyTermIds in de uitvoer-JSON.
postDataCustomClassName	Optioneel. De naam van de aangepaste klasse die deze service gebruikt om de nieuwe beleidsversie op te slaan. Als u Salesforce FSC gebruikt, moet u deze optie of postDataDRBundleName opgeven. De standaardwaarde is ingesteld op PostInsurancePolicy.
postDataDRBundleName	Optioneel. De naam van de gegevenstoewijzing die deze service gebruikt om de nieuwe beleidsversie op te slaan. Als u SalesForce FSC gebruikt, moet u deze optie of postDataCustomClassName opgeven. Als u beide opgeeft, gebruikt de service de postDataDRBundleName. Als u geen van beide opgeeft, gebruikt de service de standaardwaarde voor postDataCustomClassName (PostInsurancePolicy).
transactionType	Optioneel. Wordt alleen gebruikt als createTransaction is ingesteld op true. Als er geen waarde is opgegeven voor transactionType, wordt deze standaard Changed/Endorsed.
updateDataCustomClassName	Optioneel. Werkt het huidige beleid bij. Als u Salesforce FSC gebruikt, moet u deze optie of updateDataDRBundleName opgeven. De standaardwaarde is ingesteld op PostInsurancePolicy.
updateDataDRBundleName	Optioneel. De naam van de gegevenstoewijzing die deze service gebruikt om het huidige beleid bij te werken. Als u Salesforce FSC gebruikt, moet u deze optie of updateDataCustomClassName opgeven. Als u beide opgeeft, gebruikt de service de updateDataDRBundleName. Als u geen van beide opgeeft, gebruikt de service de standaardwaarde voor updateDataCustomClassName (PostInsurancePolicy).
useLocalTimezone	true of false De standaardwaarde is true. Indien ingesteld op true, gebruikt deze service de lokale tijdzone waarin de beleidsversie is gemaakt. Indien ingesteld op false, gebruikt deze service GMT als tijdzone.
calculateCommission	true of false Indien ingesteld op true, berekent de service commissies voor de rootitems en wordt het totaalbedrag opgeslagen in TotalCommissionAmount. Indien ingesteld op false (standaard), berekent de service geen commissies. Opmerking Als u deze optie instelt op true (waar), moet u ook minstens één van de waarden van de producent- of productiecode invoeren: producerId , productionCodeId of productionCodeName.
commissionType	Optioneel. Type commissie (bijvoorbeeld Bonus of Standaard).
commissionStatus	Optioneel. Status van de commissie (bijvoorbeeld In behandeling, Betaald of Ontheffing).
producerId	Optioneel. De ID van de verwerkende producent, dat wil zeggen de producent die is gebruikt om de commissionScheduleId op te halen en het commissiebedrag te berekenen. Toegewezen aan InsurancePolicy.ProducerId.
productionCodeId	Optioneel. De ID van de productiecode. Toegewezen aan InsurancePolicy.ProductionCodeId__c.
productionCodeName	Optioneel. De naam van de productiecode doorgegeven aan de service InsCommissionService.calculate. Als u geen productionCodeId invoert, gebruikt de service productionCodeName om de productionCodeId op te zoeken. Als u beide waarden invoert, maar ze niet overeenkomen, heeft productionCodeId prioriteit.
memberPlanIntegrationProcedure	Initieert een aangepaste integratieprocedure op basis van de gebruikersconfiguratie. Wanneer u deze optie gebruikt, geeft deze alle opties van de service door aan de aangepaste integratieprocedure en alle polis-ID's als invoer voor integratie met het object, bijvoorbeeld het verzekeringspolisobject met het ledenplan.
ratingDate	De beoordelingsdatum die is gebruikt voor de prijsstelling van de invoer-JSON. Opmerking U kunt geen specifieke tijd doorgeven voor ratingField, aangezien het veldtype Datum is. Het tijdstempel van de beoordelingsdatum wordt dus standaard ingesteld op 12:00 uur.
term	De voorwaarde van het beleid dat de service maakt. InsPolicyService:createPolicyVersion ondersteunt alleen jaarlijkse beleidsvoorwaarden.
useIsPaidFlag	Optioneel Geeft aan of IsPaid moet worden ingeschakeld of niet. Indien true (waar), wordt het veld isPaid voor het item Betalingsplanning in aanmerking genomen tijdens de berekening van premie, belasting en kosten. De standaardwaarde is false (onwaar).

Invoer-JSON

Deze service zoekt naar de inputKey die zijn opgegeven in de product-JSON.

"policyJson": {
  "productConfigurationDetail": {
    "insuredItems": {
      "Auto": [{
          "instanceKey": "2015 Lexus LX250",
          "autoLicNum": "Lexus",
          "autoModel": "LX150",
          "autoYear": 2015,
          "BodyClass": "Sedan/Saloon",
          "VehicleType": "PASSENGER CAR",
          "isPrimary": true
                                        "isParent": true
        },
        {
          "instanceKey": "2006 Honda Odyssey",
          "autoLicNum": "Honda",
          "autoModel": "Odyssey",
          "autoYear": 2006,
          "BodyClass": "Minivan",
          "VehicleType": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
          "isPrimary": true
                                        "isParent": true
        },
        {
          "instanceKey": "2018 530 BMW",
          "autoLicNum": "530",
          "autoModel": "BMW",
          "autoYear": 2018,
          "BodyClass": "Sedan/Saloon",
          "VehicleType": "PASSENGER CAR",
          "isPrimary": true
                                        "isParent": true
        },
        {
          "instanceKey": "2016 Camry Toyota",
          "autoLicNum": "Camry",
          "autoModel": "Toyota",
          "autoYear": 2016,
          "BodyClass": "Sedan/Saloon",
          "VehicleType": "PASSENGER CAR",
          "isPrimary": true
                                        "isParent": true
        }
      ],
      "Driver": [{
          "AGE": 20,
          "instanceKey": "Joan Smith",
          "FN": "Joan",
          "GENDER": "Female",
          "LN": "Smith",
          "isPrimary": false
                                        "isParent": false
        },
        {
          "AGE": 30,
          "instanceKey": "John Smith",
          "FN": "John",
          "GENDER": "Male",
          "LN": "Smith",
          "isPrimary": false
                                        "isParent": false
        },
        {
          "AGE": 30,
          "instanceKey": "Robert Henderson",
          "FN": "Robert",
          "GENDER": "Male",
          "LN": "Henderson",
          "isPrimary": false
                                        "isParent": false    
        },
        {
          "AGE": 20,
          "instanceKey": "Kinsey Schell",
          "FN": "Kinsey",
          "GENDER": "Female",
          "LN": "Schell",
          "isPrimary": false
                                        "isParent": false
        }
      ]
    },
    "accountId": "001f400000RrQSrAAN"
  }

Als de externe optie isCreatingPolicyTerms is ingesteld op true, wordt er een policyTermIds opgenomen. Hier is een voorbeeld van een policyTermIds:

{  
   "policyId": "02i6g000000h110AAA",
   "policyTermIds": [
    "a5X6g000001LeUUEA0",
    "a5X6g000001LeUVEA0",
    "a5X6g000001LeUWEA0",
    "a5X6g000001LeUXEA0",
    "a5X6g000001LeUYEA0",
    "a5X6g000001LeUZEA0",
    "a5X6g000001LeUaEAK",
    "a5X6g000001LeUbEAK",
    "a5X6g000001LeUcEAK",
    "a5X6g000001LeUdEAK",
    "a5X6g000001LeUeEAK",
    "a5X6g000001LeUfEAK"
  ]
}

Uitvoer-JSON

De service retourneert het nieuwe beleidsversienummer in de uitvoer-JSON.

{
    "policyId": "02i0b00000uRwhVAAS"
    "error": "ok"
}