Loading
Försäkring
InsPolicyService:createUpdatePolicy

Du är här:

  1. Salesforce-hjälp
  2. Dokument
  3. Digital försäkring

InsPolicyService:createUpdatePolicy

Använd denna tjänst för att skapa en ny försäkringspolicy eller för att uppdatera en befintlig policy med ny information.

Denna tjänst kan användas med Salesforce Financial Services Cloud för valfritt stöd för att skapa betalningsscheman.

Klass: InsPolicyService

Metod: createUpdatePolicy

Hur det fungerar

  1. Tjänsten söker JSON för indata efter inputKey. inputKey innehåller den information som tjänsten behöver för att skapa eller uppdatera en policy. Informationen som denna tjänst behöver inkluderar:

    • accountId

    • term

    • productConfigurationDetail poster

    • insuredItems poster (valfritt)

    • endDate

    • effectiveDate

  2. Skapar ett objekt för Policy (tillgång).

  3. Om det finns ett befintligt betalningsschema för policyn returnerar tjänsten ett felmeddelande.

  4. Om det finns en inledande betalning skapas en InsurancePolicyTransaction. Utöver skapandet av transaktionen fylls transaktionsfördelningsdata i i transaktionsdetaljobjektet. Detta objekt lagrar data om hur mycket varje tillgång, deltagare eller täckning bidrar till totala transaktionsbelopp i form av premier, skatter och avgifter. Endast tillgångar, deltagare och täckningar med minst ett värde större än noll för premier, skatter eller avgifter visas. Du måste lägga till transaktionsdetaljobjektet i den relaterade listan för transaktioner.

  5. Om betalningsplanen sparas länkas posterna till policyns ursprungliga policy-ID.

  6. Om taxesAndfees, taxAmount och/eller feeAmount finns i indata-JSON skapas skatte- och/eller avgiftsposter.

  7. Returnerar ett policy-ID i utdata-JSON om tjänsten inte skickas en assetId.

    Om tjänsten skickas en assetId i indata-JSON uppdaterar den tillgången som specificerats av assetId.

  8. Om calculateCommission=true: tjänsten anropar InsurancePolicyService.calculateAndSaveCommission, vilket förbereder indata för InsCommissionService.calculate och InsCommissionService.saveCommissions. Efter att tjänsten Beräkna bearbetar indata lagrar tjänsten Spara det beräknade värdet i TotalCommissionAmount.

    • Tjänsten anropar InsurancePolicyService.calculateAndSaveCommission, som förbereder indata för InsCommissionService.calculate och InsCommissionService.saveCommissions.

    • Provisionstypen (till exempel Provision eller Bonus) skickas till InsCommissionService.saveCommissions som commissionType.

    • Provisionsstatus (till exempel Avstått eller Betalt) skickas till InsCommissionService.saveCommissions som commissionStatus.

    Efter att tjänsten Beräkna bearbetar indata lagrar tjänsten Spara det beräknade värdet i TotalCommissionAmount.

Anteckning
Anteckning endDate och effectiveDate avgör policyns varaktighet. Varaktigheten för den första policyversionen kan vara mindre än 365 dagar, eller mindre än 366 dagar under ett skottår. Se Överväganden och begränsningar för försäkringspolicyer.

Skatter och avgifter

Så här fungerar denna tjänst om skatter och avgifter används:

  • Om fältet taxesAndFees anges i en JSON-post kvarstår en motsvarande AssetPricingAdjustment__c för varje objekt i taxesAndFees.

  • Om fältet taxAmount är angivet i en JSON-post sätts fältet TaxAmount__c till värdet för fältet taxAmount i den skapade AssetItem.

  • Om fältet feeAmount är angivet i en JSON-post sätts fältet FeeAmount__c till värdet för fältet feeAmount i AssetItem.

Fjärralternativ

Alternativ

Beskrivning

assetId

Valfritt.

ID för en befintlig policy som denna tjänst uppdaterar baserat på ny eller uppdaterad information. Används när tjänsten behöver uppdatera en befintlig policy.

createContactForParticipants

Valfritt.

true eller false

true som standard.

Om false skapas inga kontaktposter i tjänsten.

createInsuredItemsRelationships

true eller false

Om detta alternativ är inställt till sant kan du specificera en lista över instanceKey > parentInstanceKey mellan försäkrade objekt.

Detta alternativ har stöd för överordnad > underordnad och överordnad > underordnad > barnbarnsförsäkrade objektrelationer.

createTransaction

Valfritt.

true eller false

false som standard.

Om true skapar tjänsten en transaktion som används av intäktsschematjänsterna.

Tjänsten fyller även i transaktionsfördelningsdata i transaktionsdetaljobjektet. Den visar data om hur mycket varje tillgång, deltagare och täckning bidrar till det totala transaktionsbeloppet i form av premier, skatter och avgifter. Endast de tillgångar, deltagare och täckningar som har minst ett icke-nollvärde för premie-, skatte- och avgiftsbelopp visas. Transaktionsdetaljobjektet måste läggas till i den relaterade listan över transaktioner.

coolingOffPeriod

Valfri

Det antal dagar du kan fördröja den första inmatningen i betalningsplanen.

Med ångerperiod beräknas det första datumet för betalningsplanen för policyn som giltighetsdatumet + antalet dagar.

Det finns till exempel en månatlig betalningsfrekvens där giltighetsdatumet är 5 januari och det första datumet för betalningsplanen är 5 januari. Om vi tillämpar en ångerperiod på 14 dagar ändras den första betalningsplanen från 5 januari till 19 januari. De återstående månatliga betalningsplandatumen ändras inte.

Anteckning
Anteckning Betänketiden måste vara mellan 1 och 28 dagar från policyns startdatum.

effectiveDate

%“ÅÅÅÅ-MM-DD TT:MM:SS” eller %OmniScriptDataElement%

Datum då policyn (eller policyuppdateringen) börjar gälla.

Om det inte finns något effectiveDate i alternativkartan letar tjänsten efter det i rootAttributes. Om tjänsten inte kan hitta ett effectiveDate där använder den dagens datum.

Om du använder tilläggspaketet Försäkringsbransch ignoreras tidsstämpelvärdet i alternativet effectiveDate. Istället sätts värdet för giltighetsdatumets tidsstämpel till 12:00 för det valda giltighetsdatumet och värdet för utgångsdatumet sätts till 23:59 för det valda utgångsdatumet. Tidsstämpeln ställs in genom att använda användarens specificerade tidszon.

generatePolicyNumber

sant eller falskt

Om det är true använder detta alternativ UniqueIdGenerator för att skapa ett unikt policynummer. Detta nummer lagras som Asset.SerialNumber.

includePaymentSchedule

Valfritt.

True om betalningsplanen kommer att skapas för policyn.

Standard är false.

includeRevenueSchedule

Valfritt.

true eller false

Om true anropar detta alternativ InsPolicyRevenueScheduleService: createRevenueSchedule-tjänsten för att skapa ett intäktsschema eller InsPolicyRevenueScheduleService: modifyRevenueSchedule om policyn uppdateras.

Om false skapar inte tjänsten ett intäktsschema för denna policy.

initialPaymentRule

Valfritt.

Antingen procent, månader eller dagar.

initialTransactionName

Valfritt.

Transaktionsnamnet.

Standard är att använda samma värde som initialPaymentTransactionType.

initialPaymentTransactionType

Valfritt.

Transaktionstypen.

Standardvärdet är Premiumavgift.

initialPaymentValue

Krävs om initialPaymentRule tillhandahålls.

Värdet Procent, eller antalet månader eller dagar.

inputKey

Obligatoriskt.

En JSON som denna tjänst hämtar nödvändig information från för att skapa eller uppdatera en policy.

isCreatingPolicyTerms

true eller false

När satt till true returnerar tjänsten en policyTermIds i JSON för utdata.

isFsc

Valfritt.

True om policyn som ska skapas är ett InsurancePolicy-objekt.

Standard är false.

Du kan specificera antingenpostDataCustomClassName eller postDataDRBundleName.

Om du inte anger ett av dessa alternativ blir tjänsten som standard postDataCustomClassName.

paymentCalculationMethod

Krävs om includePaymentSchedule är true.

Åsidosätter policyns värde för Premiumberäkningsmetod.

paymentFrequency

Krävs om includePaymentSchedule är true.

Åsidosätter policyns värde PremiumFrequency.

paymentStartDate

Valfritt.

Datum för den första inmatningen i betalningsplanen.

Standard är policyns giltighetsdatum.

paymentType

Krävs om includePaymentSchedule är true.

Åsidosätter policyns värde för Premiumbetalningstyp.

postDataCustomClassName

Valfritt.

Du måste specificera antingen detta alternativ eller postDataDRBundleName.

Standardvärdet är satt till PostInsurancePolicy.

postDataDRBundleName

Valfritt.

Du måste specificera antingen detta alternativ eller postDataCustomClassName.

Om du inte specificerar detta alternativ är standarden postDataCustomClassName.

transactionType

%OmniScriptDataElement%

Använd om includeRevenueSchedule är inställd till sant.

Om inget värde anges blir Sold Policy som standard.

calculateCommission

true eller false

När satt till true beräknar tjänsten provisioner för rotobjekten och sparar det totala beloppet till TotalCommissionAmount.

När satt till false (standard) beräknar inte tjänsten provisioner.

Anteckning
Anteckning

Om du ställer in detta alternativ till sant kräver tjänsten minst ett av producent- eller produktionskodvärdena: producerId , productionCodeId eller productionCodeName.

commissionType

Valfri

Provisionstyp (till exempel Bonus eller Standard).

commissionStatus

Valfri

Provisionens status (till exempel Väntande, Betalt eller Avstått).

producerId

Valfri

ID för bearbetningsproducent, det vill säga den producent som används för att hämta commissionScheduleId och beräkna provisionsbeloppet.

Tilldelad till InsurancePolicy.ProducerId.

productionCodeId

Valfri

ID för produktionskod.

Tilldelad till InsurancePolicy.ProductionCodeId__c.

productionCodeName

Valfri

Namnet på produktionskoden som skickas till tjänsten InsCommissionService.calculate.

Om du inte anger productionCodeId använder tjänsten productionCodeName för att söka efter productionCodeId. Om du anger båda värdena men de inte matchar har productionCodeId företräde.

memberPlanIntegrationProcedure

Inleder en egen integreringsprocess baserat på användarkonfigurationen. När du använder detta alternativ skickas alla alternativ för tjänsten till den egna integreringsprocessen och alla policy-ID:n som indata för att integrera med objektet, till exempel försäkringspolicyobjektet med medlemsplanen.

ratingDate

Det värderingsdatum som användes för att prissätta indata-JSON.

Anteckning
Anteckning Det går inte att ange en specifik tidpunkt för ratingField eftersom fälttypen är Datum. Så tidsstämpeln för värderingsdatum är som standard 12:00.

term

Löptiden för den policy som tjänsten kommer att skapa.

InsPolicyService:createUpdatePolicy har endast stöd för årliga policyvillkor.
useIsPaidFlag

Valfri

Om sant med includePaymentSchedule också är sant skapar tjänsten bidragposter för policykomponenter för varje betalningsplanpost.

Standardvärdet är falskt.

Indata-JSON

Denna tjänst letar efter inputKey värde.

I detta exempel är inputKey = newPolicyJSON.

"newPolicyJSON": {
  "accountId": "001f400000OSHq2AAH",
  "term": "Annual",
  "endDate": "2019-05-14T07:00:00.000Z",
  "effectiveDate": "2018-05-15T07:00:00.000Z",
  "productConfigurationDetail": {
    ...
  },
  "insuredItems": {
    ...
  },
  "additionalFields": {
    "SerialNumber": "AUTO-123",
    "Status": "InForce",
    "vlocityins2__Type__c": "AUTO",
    "vlocityins2__PaymentMethodId__c": "a2Rf40000002NrgEAE"
  },
}

JSON inuti inputKey innehåller flera nyckel-/värdepar som tjänsten behöver för att skapa eller uppdatera en policy. Den innehåller även produktens JSON, med prissättning för de försäkrade objekten och den totala policyn.

Nyckel

Värde

accountId

ID för skapat konto för tillgången.

additionalFields

Valfritt.

Nyckel-/värdepar inklusive policyfält (tillgångsfält) som inte är en del av tjänsten.

endDate

Valfritt.

Datum då policyn går ut.

effectiveDate

Datum då policyn börjar gälla.

Om det inte finns något effectiveDate i alternativkartan letar tjänsten efter det i rootAttributes. Om tjänsten inte kan hitta ett effectiveDate där använder den dagens datum.

insuredItems

Nyckel-/värdepar för de försäkrade objekt som tjänsten använder för att skapa policyn.

modificationDate

Datum då policyn ändrades

productConfigurationDetail

En matris av poster som följer JSON-strukturmodellen för produkter.

term

Löptiden för den policy som tjänsten kommer att skapa.

insuredItems för detta exempel inkluderar de försäkrade objekten och de värden användaren valt för vart och ett av dem.

I detta exempel är inputKey = quotepolicyJSON.

"quotepolicyJson": {
  "productConfigurationDetail": {
    ...
  }
  "insuredItems": {
    "DRIVER": [{
        "GENDER": "Female",
        "FN": "Joan",
        "AGE": 20,
        "LN": "Smith",
        "instanceKey": "Joan Smith",
        "isPrimary": false
        "isParent": false
      },
      {
        "GENDER": "Male",
        "FN": "John",
        "AGE": 30,
        "LN": "Smith",
        "instanceKey": "John Smith",
        "isPrimary": false
        "isParent": false
      },
      {
        "GENDER": "Male",
        "FN": "Robert",
        "AGE": 30,
        "LN": "Henderson",
        "instanceKey": "Robert Henderson",
        "isPrimary": false
        "isParent": false
      },
      {
        "GENDER": "Female",
        "FN": "Kinsey",
        "AGE": 20,
        "LN": "Schell",
        "instanceKey": "Kinsey Schell",
        "isPrimary": false
        "isParent": false
      }
    ],
    "AUTO": [{
        "autoLicNum": "Lexus",
        "autoModel": "LX250",
        "autoYear": 2015,
        "instanceKey": "2015 Lexus LX250",
        "BodyClass": "Sedan/Saloon",
        "VehicleType": "PASSENGER CAR",
        "isPrimary": true
        "isParent": true
      },
      {
        "autoLicNum": "Honda",
        "autoModel": "Odyssey",
        "autoYear": 2006,
        "instanceKey": "2006 Honda Odyssey",
        "BodyClass": "Minivan",
        "VehicleType": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
        "isPrimary": true
        "isParent": true                                
      }
    ]
  },
  "accountId": "0011I00000QknfjQAB",
  "opportunityId": "0061I00000AV8gBQAT"
},
"quoteId": "0Q01I000000206USAQ",
"error": "OK"

JSON för utdata

Tjänsten returnerar policy-ID för den nyligen skapade policyn.

{
    "policyId": "02if4000001uCZXAA2",
    "error": "OK"
}

Om alternativet isCreatingPolicyTerms är inställt till true inkluderas en policyTermIds. Här är ett exempel på en policyTermIds:

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

Exempel

Tjänsten används vanligtvis i OmniScript-mönstret Offert-till-policy.

 
Laddar
Salesforce Help | Article