Loading
Seguro
InsPolicyService:prepareToRenewPolicy

InsPolicyService:prepareToRenewPolicy

Utilice este servicio para calcular el importe requerido para renovar una póliza existente. Este servicio devuelve primas de renovación, impuestos y comisiones, o el JSON de política de renovación sin crear una política.

Clase: InsPolicyService

Método: prepareToRenewPolicy

Funcionamiento

  1. El servicio acepta la policyId de la política que se renovará.

  2. El servicio comprueba la fecha de entrada en vigor y la fecha de caducidad de la póliza renovada. Si no se proporciona, el servicio calcula estas fechas utilizando la siguiente lógica:

    • Fecha de vigencia = Fecha de vencimiento de la póliza original + 1 día

    • Fecha de caducidad = Fecha de vigencia de la nueva póliza + Plazo de la nueva póliza

  3. Aplica un nuevo precio al producto de póliza utilizando opciones de aggByKey y includeInputKey.

  4. Utiliza getPolicyJson para determinar si solo deben devolverse componentes de importe de renovación o si se envía un JSON de política completo en la respuesta.

Entradas

Ingreso

Descripción

policyId

Obligatorio

El Id. de la póliza que se va a renovar.

userInputs

Opcional

Los detalles de los productos asociados con la política. Para cualquier producto, el formato de destino para el objeto userInputs se obtiene desde el listado de servicio en la ficha API de la vista de producto. Las claves de objeto tienen el formato ProductCode.AttributeCode donde el ProductCode es el código del producto, las especificaciones de cobertura asociadas, las especificaciones de artículos asegurados o los hechos de valoración.

Opciones remotas

Opción remota

Descripción

aggByKey

Obligatorio

PRODUCT.instanceKey

El servicio envía esta opción como una entrada al procedimiento de cálculo, que la utiliza para completar el cálculo con agregación.

Por ejemplo, una póliza de seguros de auto tiene varios conductores adjuntos a cada vehículo asegurado. El vehículo asegurado tiene una instanceKey separada para cada instancia en la póliza. El aggByKey toma todas las claves de instancia para los vehículos y crea una matriz de primas de cobertura por instanceKey. Esta matriz se pasa al procedimiento de cálculo de modo que las primas se calculan correctamente.

El servicio utiliza esta opción para cambiar el precio de la póliza.

calculateTaxesAndFees

Opcional

true o false

Establezca en true para calcular impuestos y comisiones en la póliza renovada.

includeInputKeys

Obligatorio

Cadena de pares clave-valor separados por comas que el servicio pasa dentro y fuera del procedimiento de cálculo.

Estos pares clave-valor se incluyen en el objeto de producto de salida dentro del objeto CalculatedPriceData. Están ahí para ayudarle a analizar los resultados del cálculo.

El servicio utiliza esta opción para cambiar el precio de la póliza.

getPolicyJson

Opcional

Un indicador booleano para determinar si solo los componentes de importe de renovación deben devolverse en respuesta o el JSON de política completo debe devolverse.

ratingDate

Determina el procedimiento de valoración para volver a aplicar precios a la política. Si no se proporciona, el precio se realiza en base a la fecha de entrada en vigor de la política modificada.

Nota
Nota No puede pasar una hora específica para ratingField ya que el tipo de campo es Fecha. Por lo tanto, la marca de tiempo de fecha de valoración toma como valor predeterminado 12:00 am.

renewalEffectiveDate

Opcional

La fecha de vigencia de la póliza renovada. Si no se proporciona, el valor se calcula utilizando la siguiente lógica:

Fecha de caducidad de póliza existente + 1 día

renewalExpirationDate

Opcional

La fecha de caducidad de la póliza renovada. Si no se proporciona, el valor se establece utilizando la siguiente lógica:

Fecha de vigencia de la nueva póliza + Plazo de la nueva póliza

term

Opcional

La condición de la política. Ayuda a calcular la renewalExpirationDate, si no se proporciona en las opciones remotas. InsPolicyService:prepareToRenewPolicy solo admite condiciones de póliza anuales.

useLocalTimezone

Verdadero o Falso

El valor predeterminado es true.

Cuando el valor se establece como verdadero, el servicio utiliza la zona horaria local en la que se crea la política.

Cuando el valor se establece como falso, los servicios utilizan GMT como zona horaria.

JSON de entrada

Este es un ejemplo del JSON de entrada:

{
   "policyId": "0YT5w000000Y8MNGA0",
   "userInputs": [
      {
        "DRIVER.instanceKey": "Bob Jones",
        "DRIVER.LN": "Jones",
        "DRIVER.GENDER": "Male",
        "DRIVER.FN": "Bobby",
        "DRIVER.AGE": 30,
        "AUTO.instanceKey": "2018 Audi A3",
        "AUTO.autoYear": 2018,
        "AUTO.autoModel": "A4",
        "perAccident": 500
      }
    ]
}  

JSON de salida

Este es un ejemplo del JSON de salida:

{
  "totalFeeForTermDiff": -0.07,
  "totalTaxForTermDiff": 0,
  "totalPremiumForTermDiff": -2.73,
  "newFeeForTerm": 24.93,
  "newTaxForTerm": 0,
  "newPremiumForTerm": 997.27,
  "newFee": 25,
  "newTax": 0,
  "newStandardPremium": 1000
}
 
Cargando
Salesforce Help | Article