Loading
Forsikring
InsPolicyService:createUpdatePolicy

Du er her:

  1. Salesforce Hjelp
  2. Dokumenter
  3. Digital forsikring

InsPolicyService:createUpdatePolicy

Bruk denne tjenesten til å opprette en ny forsikringspolise eller oppdatere en eksisterende polis med ny informasjon.

Denne tjenesten kan brukes sammen med Salesforce Financial Services Cloud for valgfri støtte for opprettelse av betalingsplan.

Klasse: InsPolicyService

Metode: createUpdatePolicy

Slik fungerer den

  1. Tjenesten søker i inndata-JSON-koden for inputKey. inputKey-noden inneholder informasjonen tjenesten trenger for å opprette eller oppdatere en policy. Informasjonen denne tjenesten trenger, inkluderer følgende:

    • accountId

    • term

    • productConfigurationDetail poster

    • insuredItems poster (valgfritt)

    • endDate

    • effectiveDate

  2. Oppretter et Policy (aktiva)-objekt.

  3. Hvis det finnes en eksisterende betalingsplan for policyen, returnerer tjenesten en feilmelding.

  4. Hvis det er en første betaling, opprettes det en InsurancePolicyTransaction. I tillegg til å opprette transaksjonen fylles transaksjonsdetaljdata ut i transaksjonsdetaljobjektet. Dette objektet lagrer data om hvor mye hvert aktivum, deltaker eller dekning bidrar til totalt transaksjonsbeløp når det gjelder premiebeløp, avgifter og gebyrer. Bare aktiva, deltagere og dekninger med minst én verdi større enn null for premiebeløp, avgifter eller gebyrer vises. Du må legge til transaksjonsdetaljobjektet i Relatert liste for transaksjon.

  5. Hvis du lagrer betalingsplanen, kobles postene til polisens opprinnelige polise-ID.

  6. Hvis taxesAndfees-, taxAmount- og/eller feeAmount-noder finnes i inndata-JSON-filen, opprettes avgifts- og/eller godtgjørelsespostene.

  7. Returnerer en policy-ID i JSON-koden for utdata hvis tjenesten ikke overføres en assetId.

    Hvis tjenesten overføres en assetId i inndata-JSON-filen, oppdateres aktivumet som er angitt av assetId.

  8. If calculateCommission=true: tjenesten ringer InsurancePolicyService.calculateAndSaveCommission, som klargjør inndata for InsCommissionService.calculate og InsCommissionService.saveCommissions. Når beregningstjenesten har behandlet inndataene, lagrer lagringstjenesten den beregnede verdien i TotalCommissionAmount.

    • Tjenesten ringer InsurancePolicyService.calculateAndSaveCommission, som klargjør inndata for InsCommissionService.calculate og InsCommissionService.saveCommissions.

    • Kommisjonstypen (for eksempel Kommisjon eller Bonus) overføres til InsCommissionService.saveCommissions som commissionType.

    • Kommisjonsstatusen (for eksempel Fjernet eller Betalt) overføres til InsCommissionService.saveCommissions som commissionStatus.

    Når beregningstjenesten har behandlet inndataene, lagrer lagringstjenesten den beregnede verdien i TotalCommissionAmount.

Merk
Merk endDate og effectiveDate bestemmer polisens varighet. Varigheten av den første policyversjonen kan være mindre enn 365 dager eller mindre enn 366 dager i et skuddår. Se Vurderinger og begrensninger for forsikringspoliser.

Skatt og gebyrer

Slik fungerer denne tjenesten hvis avgifter og gebyrer brukes:

  • Hvis taxesAndFees-feltet er angitt i en JSON-post, beholdes en tilhørende AssetPricingAdjustment__c-post for hvert element i taxesAndFees-listen.

  • Hvis taxAmount-feltet angis i en JSON-post, angis TaxAmount__c-feltet til verdien i taxAmount-feltet i den opprettede AssetItem.

  • Hvis feeAmount-feltet angis i en JSON-post, angis FeeAmount__c-feltet til verdien i feeAmount-feltet i AssetItem.

Eksterne alternativer

Alternativ

Beskrivelse

assetId

Valgfritt.

ID-en til en eksisterende policy som denne tjenesten oppdaterer basert på ny eller oppdatert informasjon. Brukes når tjenesten må oppdatere en eksisterende policy.

createContactForParticipants

Valgfritt.

true eller false

Standardverdien er true.

Hvis false, oppretter ikke tjenesten kontaktposter.

createInsuredItemsRelationships

true eller false

Hvis dette alternativet angis til true, kan du angi en liste over instanceKey > parentInstanceKey-relasjoner mellom forsikrede artikler.

Dette alternativet støtter overordnet > underordnet og overordnet > underordnet > barnebarnforsikrede elementrelasjoner.

createTransaction

Valgfritt.

true eller false

Standardverdien er false.

Hvis true, oppretter tjenesten en transaksjon som brukes av omsetningsplantjenestene.

Tjenesten fyller også ut transaksjonsdetaljdata i transaksjonsdetaljobjektet. Den viser data om hvor mye hvert aktivum, deltaker og dekning bidrar til totalt transaksjonsbeløp når det gjelder premiebeløp, avgifter og gebyrer. Bare de aktivaene, deltakerne og dekningene som har minst én ikke-nullverdi for premiebeløp, avgiftsbeløp og godtgjørelsesbeløp, vises. Transaksjonsdetaljobjektet må legges til i den relaterte listen over transaksjoner.

coolingOffPeriod

Valgfritt

Antall dager du kan utsette den første betalingsplanoppføringen.

Med avkjølingsperiode beregnes den første betalingsplandatoen for policyen som gyldighetsdatoen + antall dager.

Det er for eksempel en månedlig betalingsfrekvens der gyldighetsdatoen er 5. januar og første betalingsplandato er 5. januar. Hvis vi bruker en avkjølingsperiode på 14 dager, endres den første betalingsplanoppføringen fra 5. januar til 19. januar. De gjenværende månedlige betalingsplandatoene forblir uendret.

Merk
Merk Avkjølingsperioden må være i området 1 til 28 dager fra startdatoen for policyen.

effectiveDate

%"ÅÅÅÅ-MM-DD HH:MM:SS" eller %OmniScriptDataElement%

Datoen da policyen (eller policyoppdateringen) trer i kraft.

Hvis det ikke er noen effectiveDate-verdi på alternativkartet, ser tjenesten etter den på rootAttributes-kartet. Hvis tjenesten ikke finner en effectiveDate der, bruker den dagens dato.

Hvis du bruker Forsikringsbransjeutvidelse-pakken, ignoreres tidsstempelverdien i effectiveDate-alternativet. I stedet settes verdien for gyldighetstidsstempel til 12:00 kl.m. for den valgte gyldighetsdatoen, og verdien for utløpsdatoen settes til 23:59 kl.m. for den valgte utløpsdatoen. Tidsstempelet angis ved å bruke brukerens angitte tidssone.

generatePolicyNumber

true or false

Hvis true, bruker dette alternativet UniqueIdGenerator til å opprette et unikt polisenummer. Dette nummeret lagres som Asset.SerialNumber.

includePaymentSchedule

Valgfritt.

True om betalingsplanen skal opprettes for polisen.

Standard er false.

includeRevenueSchedule

Valgfritt.

true eller false

Hvis true, kaller dette alternativet opp InsPolicyRevenueScheduleService: createRevenueSchedule-tjeneste for å opprette en omsetningsplan eller InsPolicyRevenueScheduleService: modifyRevenueSchedule hvis policyen oppdateres.

Hvis false, oppretter ikke tjenesten en omsetningsplan for denne policyen.

initialPaymentRule

Valgfritt.

Enten prosent, måneder eller dager.

initialTransactionName

Valgfritt.

Transaksjonsnavnet.

Standardinnstillingen er å bruke samme verdi som initialPaymentTransactionType.

initialPaymentTransactionType

Valgfritt.

Transaksjonstypen.

Standardverdien er Premium Charge.

initialPaymentValue

Kreves hvis initialPaymentRule er oppgitt.

Prosentverdien, eller antall måneder eller dager.

inputKey

Obligatorisk.

En JSON-fil som tjenesten trekker ut nødvendig informasjon fra for å opprette eller oppdatere en policy.

isCreatingPolicyTerms

true eller false

Når det angis til true, returnerer tjenesten en policyTermIds-node i utdata-JSON-koden.

isFsc

Valgfritt.

True om policyen som skal opprettes, er et InsurancePolicy-objekt.

Standard er false.

Du kan angi entenpostDataCustomClassName eller postDataDRBundleName.

Hvis du ikke angir ett av disse alternativene, bruker tjenesten postDataCustomClassName som standard.

paymentCalculationMethod

Obligatorisk hvis includePaymentSchedule er true.

Overstyrer policyens verdi for Premiumberegningsmetode.

paymentFrequency

Obligatorisk hvis includePaymentSchedule er true.

Overstyrer policyens PremiumFrequency-verdi.

paymentStartDate

Valgfritt.

Datoen for første betalingsplanoppføring.

Standard er policyens gyldighetsdato.

paymentType

Obligatorisk hvis includePaymentSchedule er true.

Overstyrer policyens verdi for premiebeløpstype.

postDataCustomClassName

Valgfritt.

Du må angi dette alternativet eller postDataDRBundleName.

Standardverdien er satt til PostInsurancePolicy.

postDataDRBundleName

Valgfritt.

Du må angi dette alternativet eller postDataCustomClassName.

Hvis du ikke angir dette alternativet, er standardverdien postDataCustomClassName.

transactionType

%OmniScriptDataElement%

Brukes hvis includeRevenueSchedule er satt til sann.

Hvis ingen verdi angis, brukes som standard Sold Policy.

calculateCommission

true eller false

Når det angis til true, beregner tjenesten provisjoner for rotelementene og lagrer det totale beløpet til TotalCommissionAmount.

Når det angis til false (standard), beregner ikke tjenesten provisjoner.

Merk
Merk

Hvis du angir dette alternativet til sann, krever tjenesten minst én av produsent- eller produksjonskodeverdiene: producerId, productionCodeId eller productionCodeName.

commissionType

Valgfritt

Type kommisjon (for eksempel Bonus eller Standard).

commissionStatus

Valgfritt

Status for kommisjonen (for eksempel Venter, Betalt eller Fjernet).

producerId

Valgfritt

Den behandlende produsent-IDen, det vil si produsenten som ble brukt til å hente commissionScheduleId og beregne kommisjonsbeløpet.

Tildelt til tildelt til InsurancePolicy.ProducerId.

productionCodeId

Valgfritt

Produktionskode-id'et.

Tildelt til InsurancePolicy.ProductionCodeId__c.

productionCodeName

Valgfritt

Produksjonskodenavnet som er overført til InsCommissionService.calculate-tjenesten.

Hvis du ikke skriver inn productionCodeId, bruker tjenesten productionCodeName til å slå opp på productionCodeId. Hvis du skriver inn begge verdiene, men de ikke samsvarer, prioriteres productionCodeId.

memberPlanIntegrationProcedure

Starter en tilpasset integreringsprosedyre basert på brukerkonfigurasjonen. Når du bruker dette alternativet, overføres alle alternativer for tjenesten til den tilpassede integrasjonsprosedyren og alle polise-ID-er som inndata for å integreres med objektet, for eksempel forsikringspoliseobjektet med medlemsplanen.

ratingDate

Rangeringsdatoen som ble brukt til å sette pris på inndata-JSON-filen.

Merk
Merk Du kan ikke overføre et bestemt klokkeslett for ratingField fordi felttypen er Date. Så tidsstempelet for rangeringsdatoen er som standard 12:00.

term

Betingelsen for policyen som tjenesten skal opprette.

InsPolicyService:createUpdatePolicy støtter bare årlige poliseperioder.
useIsPaidFlag

Valgfritt

Hvis true med includePaymentSchedule også satt true, oppretter tjenesten bidragsposter for polisekomponenter for hver betalingsplanoppføring.

Standardverdien er false.

Inndata-JSON

Denne tjenesten ser etter verdien av inputKey.

I dette eksemplet er 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-koden i inputKey inneholder flere nøkkel/verdi-par som tjenesten trenger for å opprette eller oppdatere en policy. Den inkluderer også produkt-JSON-koden med prisene for de forsikrede artiklene og den totale polisen.

Nøkkel

Verdi

accountId

Den genererte konto-IDen for aktivumet.

additionalFields

Valgfritt.

Nøkkel/verdi-par, inkludert eventuelle policyfelt (aktivumfelt) som ikke er en del av tjenesten.

endDate

Valgfritt.

Datoen da policyen utløper.

effectiveDate

Datoen da policyen trer i kraft.

Hvis det ikke er noen effectiveDate-verdi på alternativkartet, ser tjenesten etter den på rootAttributes-kartet. Hvis tjenesten ikke finner en effectiveDate der, bruker den dagens dato.

insuredItems

Nøkkel/verdi-parene for de forsikrede artiklene som tjenesten bruker til å opprette policyen.

modificationDate

Datoen da policyen ble endret

productConfigurationDetail

En matrise med poster som følger produktets JSON-strukturmodell.

term

Betingelsen for policyen som tjenesten skal opprette.

insuredItems for dette eksemplet inkluderer de forsikrede artiklene og verdiene brukeren valgte for hver av dem.

I dette eksemplet er 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"

Utdata-JSON

Tjenesten returnerer policy-ID-en til den nylig opprettede policyen.

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

Hvis alternativet for ekstern isCreatingPolicyTerms er satt til true, inkluderes en policyTermIds-node. Her er et eksempel på en policyTermIds-node:

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

Eksempler

Tjenesten brukes vanligvis i OmniScript-tilbud-til-policy-mønsteret.

 
Laster
Salesforce Help | Article