Usted está aquí:
InsPolicyService:createOutOfSequencePolicyVersion
Utilice este servicio para iniciar una aprobación fuera de secuencia para una política concreta.
Clase: InsPolicyService
Método: createOutOfSequencePolicyVersion
El servicio crea estas transacciones para una aprobación fuera de secuencia:
-
Fuera de secuencia cambiada/aprobada: Cambio total en la prima para el año de póliza como resultado de la aprobación. En caso de que las políticas de varios plazos se vean afectadas, la transacción se crea para cada plazo.
-
Aprobación fuera de secuencia: El ajuste de prima para la programación de pagos cuando se realiza la aprobación. Solo es para el plazo actual. La fecha de entrada de la programación de pagos es la fecha actual o la fecha de funcionamiento cuando la fuera de secuencia entra en vigor entre una fecha pasada y la fecha actual. Para una fecha futura, la fecha de entrada de la programación de pagos es la fecha efectiva de aprobación fuera de secuencia.
Importante El Número de póliza de referencia debe rellenarse en todas las versiones de póliza entre términos.
Funcionamiento
-
El servicio toma la
policyIdde la política actual, la fecha efectiva para la aprobación fuera de secuencia y el JSON especificado por elinputKey. -
Si
createTransactionestrue, el servicio crea una transacción fuera de secuencia del tipoOut-of-Sequence Changed/Endorsedy los detalles de la transacción. -
Si
includePaymentScheduleestrue, el servicio genera o actualiza programaciones de pago y detalles de entrada de programación de pago. El cálculo se realiza basándose en valores seleccionados para las opciones depaymentCalculationMethodypaymentFrequencycorrespondientes. La programación de pagos sigue las reglas de programación de pagos existentes:-
Solo se actualizan las programaciones de pagos impagadas con fecha futura.
-
Las programaciones de pagos pasadas, pagadas o no pagadas, nunca se actualizan.
-
Cualquier ajuste para el pago con fecha pasada y la programación de pago se incluye en la transacción Aprobación de fuera de secuencia.
-
-
El servicio actualiza el valor del campo
IsPolicyEditLockedatrueen las versiones de pólizas de seguros relacionadas. Todas las versiones de política están bloqueadas hasta que se complete la transacción de aprobación fuera de secuencia.
El servicio también admite aprobaciones fuera de secuencia donde la versión de política original tiene una duración de menos de 365 días o menos de 366 días en un año bisiesto. Consulte Consideraciones y limitaciones para pólizas de seguros.
Compatibilidad con campos personalizados
-
Almacene los campos personalizados del objeto Póliza de seguros en el conjunto de campos OutOfSequenceEndorsementCustomFields.
-
Rellene los campos personalizados como pares clave/valor en la sección
additionalFields. Consulte JSON de entrada. -
Utilice este conjunto de campos OutOfSequenceEndorsementCustomFields para copiar datos personalizados desde la versión de política cancelada a nueva durante una aprobación fuera de secuencia.
Opciones remotas
Opción |
Descripción |
|---|---|
policyId
|
Obligatorio. El Id. de una política existente que el servicio actualiza basándose en información nueva o actualizada. |
createContactForParticipants
|
Opcional. |
createInsuredItemsRelationships
|
Opcional.
Si esta opción es Esta opción admite relaciones de elemento asegurado principal > secundario y principal > secundario > nieto. |
createTransaction
|
Opcional.
Toma como valor predeterminado Si es |
effectiveDate
|
Obligatorio.
La fecha desde la que se aplican los cambios de aprobación fuera de secuencia. |
includePaymentSchedule
|
Opcional.
El valor predeterminado es |
inputKey
|
Obligatorio.
Un JSON con entradas necesarias para crear o actualizar una política. Puede especificar cualquiera de estos valores:
|
paymentCalculationMethod
|
Obligatorio si la includePaymentSchedule es verdadera. Esta opción sustituye el valor del método de cálculo de primas de la póliza. |
paymentFrequency
|
Obligatorio si la includePaymentSchedule es verdadera. Esta opción sustituye el valor de frecuencia de prima de la póliza. |
paymentType
|
Obligatorio si la includePaymentSchedule es verdadera. Esta opción sustituye el valor del tipo de pago de prima de la póliza. |
postDataCustomClassName
|
Opcional. El nombre de la clase personalizada que el servicio utiliza para guardar la nueva versión de política. Debe especificar esta opción o El valor predeterminado es PostInsurancePolicy. |
postDataDRBundleName
|
Opcional. El nombre del Asignador de datos de OmniStudio que el servicio utiliza para guardar la nueva versión de política. Debe especificar esta opción o
|
transactionType
|
Opcional. Si no se proporciona ningún valor para |
term
|
El término de la política que crea el servicio. InsPolicyService:createOutOfSequencePolicyVersion solo admite condiciones de póliza anuales. |
JSON de entrada
El servicio busca los inputKey especificados en el JSON del producto. Este es el JSON de entrada de muestra:
"newPolicyJSON": {
"accountId": "001f400000RrQSrAAN",
"term": "Annual",
"productConfigurationDetail": {
...
},
"insuredItems": {
...
},
"additionalFields": {
"vlocity_ins__Type__c": "AUTO",
},
}Este es el JSON de opciones de muestra:
{
"effectiveDate": "2023-03-01",
"inputKey": "quotepolicyJson",
"policyId": "0YT3t000000uUz6GAE",
"includePaymentSchedule": true,
"createTransaction": true,
"paymentFrequency": "Monthly",
"paymentCalculationMethod": "Modal"
}JSON de salida
Este es el JSON de salida de muestra cuando el servicio inicia una aprobación fuera de secuencia y genera correctamente el Id. de trabajo:
{
"jobId": "7073t0000BNGivxAQD",
"errorCode": "INVOKE-200",
"error": "OK"
}Este es el JSON de salida de muestra cuando el servicio devuelve un error:
{
"errorCode": "ERROR-CODE",
"error": "error message"
}