Loading
Страхование
InsPolicyService:createRenewalQuote

InsPolicyService:createRenewalQuote

Используйте эту службу для создания сметы продления для существующей политики.

Класс: InsPolicyService

Метод: createRenewalQuote

Принцип работы

  1. Служба принимает policyId полиса для продления.

    Примечание
    Примечание

    Служба передает userInputs для определения дополнительных рейтинговых факторов для пересчета цены. Кроме того, служба использует узел additionalFields для заполнения дополнительных полей в объекте сметы, которые в противном случае не являются частью этой службы.

  2. Служба проверяет дату вступления в силу и дату истечения срока действия продленного полиса. Если функция не предоставлена, служба рассчитывает эти даты с помощью следующей логики:

    • Дата вступления в силу = Дата истечения срока действия исходного полиса + 1 день

    • Дата истечения срока действия = Дата вступления в силу новой политики + Срок действия новой политики

  3. Изменение цены продукта политики посредством параметров aggByKey и includeInputKey.

  4. Служба создает запись возможности посредством узла OpportunityDetails JSON из ввода. См. образец ввода JSON. Этот узел принимает только следующие три обязательных поля:

    • Имя

    • StageName

    • CloseDate

    Примечание
    Примечание Дополнительные поля возможности не могут быть добавлены в этот узел. Однако, запись возможности можно обновить дополнительными сведениями после создания сметы продления.
  5. Служба создает смету типа «Продление» и связывает ее с записью возможности, созданной на предыдущем этапе.

Вводные данные

Ввод

Описание

policyId

Обязательно

Код полиса, который должен быть продлен.

userInputs

Дополнительно

Сведения о продуктах, связанных с политикой. Для любого продукта целевой формат объекта userInputs извлекается из списка услуг во вкладке API представления продукта. Ключи объекта находятся в ProductCode.AttributeCode формата, где ProductCode - это код продукта, связанные характеристики покрытия, характеристики застрахованного элемента или факты рейтинга.

additionalFields

Дополнительно

Пары ключ-значение дополнительных полей, не являющихся частью этой службы. Данные поля заполняются в объекте сметы.

opportunityDetails

Сведения о возможности продления, которая связана со сметой продления. Если этот узел отсутствует, служба получает сведения о возможности из возможности, связанной с исходной сметой исходной политики.

Удаленные параметры

Удаленный параметр

Описание

renewalEffectiveDate

Дополнительно

Дата вступления в силу продленного полиса. При отсутствии, значение рассчитывается по следующей логике:

Дата истечения срока действия существующего полиса + 1 день

renewalExpirationDate

Дополнительно

Дата истечения срока действия продленного полиса. Если параметр не указан, значение устанавливается с помощью следующей логики:

Дата вступления в силу новой политики + Срок действия новой политики

term

Дополнительно

Условие полиса. Он помогает вычислить renewalExpirationDate, если они не предусмотрены в параметрах удаленного доступа. InsPolicyService:createRenewalQuote поддерживает только годовые условия политики.

pricebook

Дополнительно

Имя записи PriceBook2, назначенной Quote.Pricebook2Id. Стандартный параметр.

aggByKey

Обязательно

PRODUCT.instanceKey

Служба отправляет этот параметр в качестве ввода в процедуру расчета, которая использует его для выполнения расчета с агрегацией.

Например, полис автострахования содержит несколько водителей, прикрепленных к каждому застрахованному транспортному средству. Застрахованное транспортное средство имеет отдельный экземплярКлюча для каждого экземпляра в полисе. aggByKey берет все ключи экземпляра для транспортных средств и создает массив вознаграждений за покрытие в instanceKey. Этот массив передается в процедуру расчета, чтобы вознаграждения рассчитывались корректно.

Служба использует этот параметр для повторной цены полиса.

includeInputKeys

Обязательно

Строка пар ключ-значение, разделенных запятыми, которую служба передает в процедуру расчета и из нее.

Эти пары ключ-значение добавлены в объект выводного продукта в объекте CalculatedPriceData. Они помогут вам проанализировать результаты расчета.

Только ключи, используемые процедурой вычисления, имеют значение в результатах.

Служба использует этот параметр для повторной цены полиса.

failOnRatingFailure

Дополнительно

Указывает, должна ли служба не выполниться, если рейтинг не возвращает результат во время продления.

Если значение true, служба останавливается и возвращает ошибку. Если значение false, служба продолжает работу и создает смету продления без результата рейтинга.

JSON ввода

Ниже указан пример ввода JSON:

{
   "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

quoteId и opportunityId сметы продления.

Ниже указан пример вывода JSON:

{
  "quoteId": "0Q0B0000000A0YEKA0",
  "opportunityId": "006B0000006zdiAIAQ",
}
 
Загрузка
Salesforce Help | Article