Loading
Seguro
InsPolicyService:createOutOfSequencePolicyVersion

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
    Importante El Número de política de referencia debe rellenarse en todas las versiones de política entre términos.

Funcionamiento

  1. El servicio toma el policyId de la política actual, la fecha efectiva para la aprobación fuera de secuencia y el JSON especificado por el inputKey.

  2. Si createTransaction es true, el servicio crea una transacción fuera de secuencia del tipo Out-of-Sequence Changed/Endorsed y los detalles de la transacción.

  3. Si includePaymentSchedule es true, 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 de paymentCalculationMethod y paymentFrequency correspondientes. 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.

  4. El servicio actualiza el valor del campo IsPolicyEditLocked a true en 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.

Nota
Nota

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

true o false

Toma como valor predeterminado true.

Si es false, el servicio no crea registros de contacto.

createInsuredItemsRelationships

Opcional

true o false

Si esta opción es true, especifique una lista de relaciones instanceKey > parentInstanceKey entre elementos asegurados.

Esta opción admite relaciones de elemento asegurado principal > secundario y principal > secundario > nieto.

createTransaction

Opcional

true o false

Toma como valor predeterminado false.

Si es true, el servicio crea una transacción.

effectiveDate

Obligatorio.

"YYYY-MM-DD HH:MM:SS" o %OmniScriptDataElement%

La fecha desde la que se aplican los cambios de aprobación fuera de secuencia.

includePaymentSchedule

Opcional

true si se crea o se actualiza la programación de pagos para la póliza.

El valor predeterminado es false.

inputKey

Obligatorio.

%theJSONyouneed%

Un JSON con entradas necesarias para crear o actualizar una política. Puede especificar cualquiera de estos valores:

  • postDataCustomClassName

  • postDataDRBundleName

    Si no especifica una de estas opciones, el valor toma como valor predeterminado postDataCustomClassName.
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 postDataDRBundleName.

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 postDataCustomClassName.

  • Si no especifica ninguno de los dos, el servicio utiliza el valor predeterminado para postDataCustomClassName.

transactionType

Opcional

Si no se proporciona ningún valor para transactionType, toma como valor predeterminado Out-of-Sequence Changed/Endorsed.

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"
}
 
Cargando
Salesforce Help | Article