Loading
Seguro
InsPolicyService:createRenewalQuote

InsPolicyService:createRenewalQuote

Utilice este servicio para crear un presupuesto de renovación para una póliza existente.

Clase: InsPolicyService

Método: createRenewalQuote

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 presupuesto, 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 crea un registro Oportunidad utilizando el nodo OpportunityDetails JSON desde la entrada. Consulte el JSON de entrada de muestra. Este nodo solo acepta estos tres campos obligatorios:

    • Nombre

    • StageName

    • CloseDate

    Nota
    Nota Los campos de oportunidad adicionales no se pueden incluir en este nodo. Sin embargo, puede actualizar el registro de oportunidad con detalles adicionales después de generar el presupuesto de renovación.
  5. El servicio crea un presupuesto del tipo 'Renovación' y lo vincula al registro de oportunidad creado en el paso anterior.

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.

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

opportunityDetails

Los detalles de la oportunidad de renovación, que está vinculada al presupuesto de renovación. Si este nodo no está presente, el servicio toma los detalles de la oportunidad desde la oportunidad vinculada al presupuesto de origen de la política original.

Opciones remotas

Opción remota

Descripción

renewalEffectiveDate

Opcional

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

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:createRenewalQuote solo admite condiciones de póliza anuales.

pricebook

Opcional

El nombre del registro de PriceBook2 asignado a Quote.Pricebook2Id. El valor predeterminado es estándar.

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.

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 esta opción para cambiar el precio de la póliza.

failOnRatingFailure

Opcional

Especifica si el servicio debe fallar si la valoración no devuelve un resultado durante la renovación.

Cuando true, el servicio se detiene y devuelve un error. Cuando es falso, el servicio continúa y crea el presupuesto de renovación sin un resultado de valoración.

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"
    },
    "OpportunityDetails": {
      "Name": "Renewal Opportunity",
      "StageName": "Qualification",
      "CloseDate": "2023-04-04"
    }
}

JSON de salida

El quoteId y el opportunityId del presupuesto de renovación.

Este es un ejemplo del JSON de salida:

{
  "quoteId": "0Q0B0000000A0YEKA0",
  "opportunityId": "006B0000006zdiAIAQ",
}
 
Cargando
Salesforce Help | Article