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 modificado/aprobado: Cambio total en la prima para el año de póliza como resultado de la aprobación. En caso de que se vean afectadas las políticas de varios términos, se crea la transacción para cada término.
-
Aprobación fuera de secuencia: El ajuste de prima para la programación de pagos cuando se realiza la aprobación. Es solo para el término actual. La fecha de entrada de la programación de pagos es la fecha actual o la fecha de operación cuando la fuera de secuencia es efectiva 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 política de referencia debe rellenarse en todas las versiones de política entre términos.
Funcionamiento
-
El servicio toma el
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 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 las versiones de política canceladas a nuevas versiones 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 términos 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",
},
}Estas son las opciones de muestra JSON:
{
"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"
}