Loading
Seguro
InsPolicyService:createRenewalPolicy

InsPolicyService:createRenewalPolicy

Utilice este servicio para crear una política de renovación desde una política existente.

Clase: InsPolicyService

Método: createRenewalPolicy

Funcionamiento

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

    Nota
    Nota

    El servicio pasa userInputs para determinar factores de valoración adicionales para volver a calcular el precio. Además, el servicio utiliza el nodo additionalFields para rellenar campos adicionales en el objeto de póliza, que de lo contrario no forman parte de este servicio.

  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. El servicio utiliza includePaymentSchedule y includeRevenueSchedule para determinar si la programación de pagos y la programación de ingresos deben crearse en una póliza renovada. Si no se especifica ninguna opción, los mismos parámetros se heredan de la política anterior.

  5. El servicio crea una política y la marca como renovada.

Nota
Nota

El servicio también admite la renovación de pólizas donde la versión de póliza original tiene una duración de menos de 365 días o menos de 366 días en un año bisiesto. Sin embargo, en la renovación, la duración de la póliza es de 365 días, o 366 días para un año bisiesto. Consulte Consideraciones y limitaciones para pólizas de seguros.

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 ProductCode es código de producto, especificaciones de cobertura asociadas, especificaciones de artículos asegurados o hechos de valoración.

Si no se proporciona userInputs, el servicio de renovación toma la información de la política existente y la reproduce en la política renovada.

additionalFields

Opcional

Los pares clave-valor de los campos adicionales que no forman parte de este servicio. Estos campos se rellenan en el objeto de póliza.

Opciones remotas

Nota
Nota Todas las opciones remotas utilizadas en InsProductService:repriceProduct también se pueden utilizar con este servicio.

Opción remota

Descripción

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

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

Si está utilizando el paquete Extensión de Insurance Industries, el valor de marca de tiempo en la opción renewalEffectiveDate se ignora. En su lugar, el valor de marca de tiempo de fecha de vigencia se establece en 12:00 a.m. de la fecha de vigencia seleccionada, y el valor de fecha de caducidad se establece en 11:59 p.m. para la fecha de caducidad seleccionada. La marca de tiempo se establece utilizando la zona horaria especificada del usuario.

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. La 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 este valor para cambiar el precio de la póliza.

calculateTaxesAndFees

Opcional.

El valor predeterminado es true.

Establezca true para calcular impuestos y comisiones.

createTransaction

Opcional.

Verdadero o Falso

Toma como valor predeterminado Falso.

Si es verdadero, el servicio crea una transacción que se utiliza por los servicios de programación de ingresos.

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.

Solo las claves utilizadas por el procedimiento de cálculo tienen un valor en los resultados.

El servicio utiliza includeInputKeys para cambiar el precio de la póliza.

includePaymentSchedule

Opcional

Si es verdadero, el servicio crea una programación de pagos en la política renovada. Si no se proporciona ningún valor, el servicio crea una programación de pagos en póliza renovada solo si está presente para la póliza original.

includeRevenueSchedule

Opcional

Si es verdadero, el servicio crea una programación de ingresos en póliza renovada. Si no se proporciona ningún valor, los servicios crean una programación de pagos en póliza renovada solo si está presente para la póliza original.

paymentCalculationMethod

Obligatorio, si el valor de includePaymentSchedule es verdadero.

Sustituye el valor de Premium Calculation Method de la política.

paymentFrequency

Obligatorio si el valor de includePaymentSchedule es verdadero.

Sustituye el valor de PremiumFrequency de la política.

paymentType

Obligatorio si el valor de includePaymentSchedule es verdadero.

Sustituye el valor de Premium Payment Type de la política.

ratingDate

Determina el procedimiento de valoración para los precios de la póliza renovada. Si no se proporciona, los precios se realizan en base a la fecha de vigencia de la póliza renovada.

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.

term

Opcional

La condición de la política. Ayuda a calcular la renewalExpirationDate, si no se proporciona en las opciones remotas. InsPolicyService:createRenewalPolicy 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
      }
    ],
   "additionalFields": {
      "BillingName": "John Smith",
      "Description": "This is a renewal quote",
      "Phone": "123456789"
    }
}    

JSON de salida

Este es un ejemplo del JSON de salida:

{
  "snapshotId": [
    "00P5w00001fKlqEEAS"
  ],
  "InsurancePolicy": [
    "0YT5w000000Y8tTGAS"
  ]
  "error": "OK"
}
 
Cargando
Salesforce Help | Article