Loading
Forsikring
InsPolicyService:createUpdatePolicy

breadcrumbDescription

  1. helpHomeLinkText
  2. docsHomeLinkTextShort
  3. Digital forsikring

InsPolicyService:createUpdatePolicy

Brug denne tjeneste til at oprette en ny forsikringspolice eller til at opdatere en eksisterende police med nye oplysninger.

Denne tjeneste kan bruges sammen med Salesforce Financial Services Cloud til valgfri oprettelsessupport for betalingsplan.

Kategori: InsPolicyService

Metode: createUpdatePolicy

Sådan fungerer det

  1. Tjenesten søger i input-JSON for inputKey. inputKey indeholder de oplysninger, som tjenesten har brug for for at oprette eller opdatere en politik. De oplysninger, denne tjeneste kræver, inkluderer:

    • accountId

    • term

    • productConfigurationDetail registreringer

    • insuredItems (valgfrit)

    • endDate

    • effectiveDate

  2. Opretter et policy-objekt (aktiv).

  3. Hvis der er en eksisterende betalingsplan for politikken, returnerer tjenesten en fejlmeddelelse.

  4. Hvis der er en indledende betaling, oprettes der en InsurancePolicyTransaction. I tillæg til oprettelsen af transaktionen udfyldes transaktionsopdelingsdata i transaktionsdetaljeobjektet. Dette objekt lagrer data om, hvor meget hvert aktiv, deltager eller dækning bidrager til det samlede transaktionsbeløb i forhold til præmier, moms og gebyrer. Kun aktiver, deltagere og dækninger med mindst en værdi, der er større end nul for præmie, moms eller gebyrer, vises. Du skal føje transaktionsdetaljeobjektet til den relaterede liste for transaktion.

  5. Hvis du gemmer betalingsplanen, linkes registreringerne til policens oprindelige police-id.

  6. Hvis der findes taxesAndfees-, taxAmount- og/eller feeAmount-noder i input-JSON, oprettes moms- og/eller gebyrregistreringerne.

  7. Returnerer et politik-id i output-JSON, hvis tjenesten ikke overføres en assetId.

    Hvis tjenesten overføres en assetId i input-JSON, opdateres det aktiv, der er angivet af assetId.

  8. If calculateCommission=true: tjenesten ringer InsurancePolicyService.calculateAndSaveCommission, som forbereder inputtet for InsCommissionService.calculate og InsCommissionService.saveCommissions. Når beregningstjenesten har behandlet inputtet, lagrer lagringstjenesten den beregnede værdi i TotalCommissionAmount.

    • Tjenesten ringer til InsurancePolicyService.calculateAndSaveCommission, som forbereder input for InsCommissionService.calculate og InsCommissionService.saveCommissions.

    • Kommissionstypen (f.eks. Kommission eller Bonus) overføres til InsCommissionService.saveCommissions som commissionType.

    • Provisionsstatussen (f.eks. Afvist eller Betalt) overføres til InsCommissionService.saveCommissions som commissionStatus.

    Når beregningstjenesten har behandlet inputtet, lagrer lagringstjenesten den beregnede værdi i TotalCommissionAmount.

Bemærk
Bemærk endDate og effectiveDate bestemmer policens varighed. Varigheden af den første politikversion kan være mindre end 365 dage eller mindre end 366 dage i et skudår. Se overvejelser og begrænsninger for forsikringspolicer.

Skatter og gebyrer

Sådan fungerer denne tjeneste, hvis der bruges moms og gebyrer:

  • Hvis feltet taxesAndFees er angivet på en JSON-registrering, bevares der en tilsvarende AssetPricingAdjustment__c for hvert element på taxesAndFees.

  • Hvis feltet taxAmount er angivet på en JSON-registrering, indstilles TaxAmount__c til værdien af feltet taxAmount på den oprettede AssetItem.

  • Hvis feltet feeAmount er angivet på en JSON-registrering, indstilles FeeAmount__c til værdien af feltet feeAmount på AssetItem.

Fjernindstillinger

Indstilling

Beskrivelse

assetId

Valgfrit.

Id'et for en eksisterende politik, som denne tjeneste opdaterer baseret på nye eller opdaterede oplysninger. Bruges, når tjenesten har brug for at opdatere en eksisterende politik.

createContactForParticipants

Valgfrit.

true eller false

Standard er true.

Hvis false, opretter tjenesten ikke kontaktregistreringer.

createInsuredItemsRelationships

true eller false

Hvis denne indstilling er indstillet til true, kan du angive en liste over instanceKey > parentInstanceKey relationer mellem forsikrede elementer.

Denne indstilling understøtter overordnede > underordnede og overordnede > underordnede > underunderordnede forsikrede elementrelationer.

createTransaction

Valgfrit.

true eller false

Standard er false.

Hvis true, opretter tjenesten en transaktion, der bruges af omsætningsoversigtstjenesterne.

Tjenesten udfylder også transaktionsopdelingsdata i transaktionsdetaljeobjektet. Den viser data om, hvor meget hvert aktiv, deltager og dækning bidrager til det samlede transaktionsbeløb i forhold til præmier, moms og gebyrer. Kun de aktiver, deltagere og dækninger vises, der har mindst en ikke-nul-værdi for præmie-, moms- og gebyrbeløb. Transaktionsdetaljeobjektet skal føjes til den relaterede liste over transaktioner.

coolingOffPeriod

Valgfrit

Antallet af dage, du kan udsætte den første betalingsplanpost.

Med afkølingsperiode beregnes den første betalingsplandato for policen som ikrafttrædelsesdatoen + antallet af dage.

Der er f.eks. en månedlig betalingsfrekvens, hvor ikrafttrædelsesdatoen er den 5. januar, og den første betalingsplandato er den 5. januar. Hvis vi anvender en afkølingsperiode på 14 dage, ændres den første betalingsplanpost fra den 5. januar til den 19. januar. De resterende månedlige betalingsplandatoer forbliver uændrede.

Bemærk
Bemærk Afkølingsperiode skal være i området 1 til 28 dage fra startdatoen for politikken.

effectiveDate

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

Den dato, hvor politikken (eller policeopdateringen) træder i kraft.

Hvis der ikke er nogen effectiveDate værdi på valgmulighedskortet, søger tjenesten efter den på rootAttributes. Hvis tjenesten ikke kan finde en effectiveDate der, bruger den dags dato.

Hvis du bruger pakken Udvidelse af forsikringssektorer, ignoreres tidsstempelværdien i indstillingen effectiveDate. I stedet indstilles værdien for det gældende datotidsstempel til 00.00.00 fra den valgte ikrafttrædelsesdato, og værdien for udløbsdatoen indstilles til 23:59 for den valgte udløbsdato. Tidsstemplet angives ved brug af brugerens angivne tidszone.

generatePolicyNumber

sand eller falsk

Hvis true, bruger denne indstilling UniqueIdGenerator til at oprette et entydigt policenummer. Dette nummer gemmes som Asset.SerialNumber.

includePaymentSchedule

Valgfrit.

True om betalingsplanen vil blive oprettet for policen.

Standarden er false.

includeRevenueSchedule

Valgfrit.

true eller false

Hvis true, kalder denne indstilling InsPolicyRevenueScheduleService: createRevenueSchedule-tjenesten til at oprette en omsætningsplan eller InsPolicyRevenueScheduleService: modifyRevenueSchedule, hvis politikken opdateres.

Hvis false, opretter tjenesten ikke en omsætningsplan for denne politik.

initialPaymentRule

Valgfrit.

Enten Procent, Måneder eller Dage.

initialTransactionName

Valgfrit.

Transaktionsnavnet.

Standarden er at bruge den samme værdi som initialPaymentTransactionType.

initialPaymentTransactionType

Valgfrit.

Transaktionstypen.

Standardværdien er Premium Charge.

initialPaymentValue

Krævet, hvis initialPaymentRule er angivet.

Procentværdien eller antallet af måneder eller dage.

inputKey

Påkrævet.

Et JSON, som denne tjeneste henter de nødvendige oplysninger fra for at oprette eller opdatere en politik.

isCreatingPolicyTerms

true eller false

Når den er indstillet til true, returnerer tjenesten en policyTermIds i output-JSON.

isFsc

Valgfrit.

True, om den polic, der skal oprettes, er et InsurancePolicy-objekt.

Standarden er false.

Du kan angive entenpostDataCustomClassName eller postDataDRBundleName.

Hvis du ikke angiver en af disse indstillinger, indstilles tjenesten som standard til postDataCustomClassName.

paymentCalculationMethod

Påkrævet, hvis includePaymentSchedule er true.

Tilsidesætter policens metode til beregning af præmie.

paymentFrequency

Påkrævet, hvis includePaymentSchedule er true.

Tilsidesætter policens PremiumFrequency-værdi.

paymentStartDate

Valgfrit.

Datoen for den første betalingstidsoplysning.

Standard er politikkens ikrafttrædelsesdato.

paymentType

Påkrævet, hvis includePaymentSchedule er true.

Tilsidesætter policens Præmiebetalingstypeværdi.

postDataCustomClassName

Valgfrit.

Du skal angive enten denne indstilling eller postDataDRBundleName.

Standardværdien indstilles til PostInsurancePolicy.

postDataDRBundleName

Valgfrit.

Du skal angive enten denne indstilling eller postDataCustomClassName.

Hvis du ikke angiver denne indstilling, er standarden postDataCustomClassName.

transactionType

%OmniScriptDataElement%

Bruges, hvis includeRevenueSchedule er indstillet til true.

Hvis der ikke er angivet nogen værdi, indstilles den som standard til Solgt politik.

calculateCommission

true eller false

Når den er indstillet til true, beregner tjenesten kommissioner for rodelementerne og gemmer det samlede beløb til TotalCommissionAmount.

Når den er indstillet til false (standarden), beregner tjenesten ikke kommissioner.

Bemærk
Bemærk

Hvis du indstiller denne indstilling til true, kræver tjenesten mindst en af producent- eller produktionskodeværdierne: producerId, productionCodeId eller productionCodeName.

commissionType

Valgfrit

Kommissionstype (f.eks. Bonus eller Standard).

commissionStatus

Valgfrit

Status for kommissionen (f.eks. Afventer, Betalt eller Afvist).

producerId

Valgfrit

Det behandlende producent-id, dvs. den producent, der bruges til at hente commissionScheduleId og beregne kommissionsbeløbet.

Tildelt til tildelt til InsurancePolicy.ProducerId.

productionCodeId

Valgfrit

Produktionskode-id.

Tildelt til InsurancePolicy.ProductionCodeId__c.

productionCodeName

Valgfrit

Produktionskodenavnet, der blev overført til InsCommissionService.calculate-tjenesten.

Hvis du ikke indtaster productionCodeId, bruger tjenesten productionCodeName til at slå productionCodeId op. Hvis du angiver begge værdier, men de ikke matcher, har productionCodeId forrang.

memberPlanIntegrationProcedure

Starter en tilpasset integrationsprocedure baseret på brugerkonfigurationen. Når du bruger denne indstilling, overfører den alle indstillinger for tjenesten til den tilpassede integrationsprocedure og alle police-id'er som input, der skal integreres med objektet, f.eks. objektet Forsikringspolice med medlemsplanen.

ratingDate

Den vurderingsdato, der blev brugt til at prissætte input-JSON.

Bemærk
Bemærk Du kan ikke overføre et bestemt tidspunkt for ratingField, da felttypen er Dato. Så vurderingsdatotidsstemplet sættes som standard til 12:00.

term

Vilkårene for den politik, som tjenesten vil oprette.

InsPolicyService:createUpdatePolicy understøtter kun årlige politikudtryk.
useIsPaidFlag

Valgfrit

Hvis sandt med includePaymentSchedule også angivet sandt, opretter tjenesten bidragsregistreringer af policekomponenter for hver betalingsplanpost.

Standardværdien er false.

Input JSON

Denne tjeneste søger efter værdien af inputKey.

I dette eksempel 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 i inputKey indeholder flere nøgle-/værdipar, som tjenesten har brug for for at oprette eller opdatere en politik. Det inkluderer også produkt-JSON med priser for de forsikrede elementer og den samlede police.

Nøgle

Værdi

accountId

Det genererede konto-id for aktivet.

additionalFields

Valgfrit.

Nøgle-/værdipar, herunder eventuelle politikfelter (aktiv), der ikke er del af tjenesten.

endDate

Valgfrit.

Den dato, hvor politikken udløber.

effectiveDate

Den dato, hvor politikken træder i kraft.

Hvis der ikke er nogen effectiveDate værdi på valgmulighedskortet, søger tjenesten efter den på rootAttributes. Hvis tjenesten ikke kan finde en effectiveDate der, bruger den dags dato.

insuredItems

Nøgle-/værdiparret for de forsikrede elementer, som tjenesten bruger til at oprette policen.

modificationDate

Den dato, hvor politikken blev ændret

productConfigurationDetail

En opstilling af registreringer, der følger produktets JSON-strukturmodel.

term

Vilkårene for den politik, som tjenesten vil oprette.

insuredItems for dette eksempel inkluderer de forsikrede varer og de værdier, som brugeren valgte for hver af dem.

I dette eksempel 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"

Output JSON

Tjenesten returnerer police-id'et for den netop oprettede politik.

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

Hvis isCreatingPolicyTerms-fjernanmodningen er indstillet til true, inkluderes der en policyTermIds. Her er et eksempel på en policyTermIds:

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

Eksempler

Tjenesten bruges typisk i OmniScript-tilbud-til-politik-mønsteret.

 
Indlæser
Salesforce Help | Article