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

InsPolicyService:createRenewalPolicy

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

Класс: InsPolicyService

Метод: createRenewalPolicy

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

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

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

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

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

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

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

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

  4. Служба использует includePaymentSchedule и includeRevenueSchedule для определения необходимости создания расписания оплаты и расписания дохода на основе продленного полиса. Если параметры не указаны, эти же параметры наследуются от предыдущей политики.

  5. Служба создает политику и отмечает ее как возобновленную.

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

Служба дополнительно поддерживает продление полисов, где исходная версия полиса имеет продолжительность менее 365 дней или менее 366 дней в високосном году. Однако, при продлении продолжительность полиса составляет 365 дней или 366 дней для високосного года. См. Рекомендации и ограничения для страховых полисов.

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

Ввод

Описание

policyId

Обязательно

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

userInputs

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

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

Если userInputs не предоставлен, служба продления извлекает сведения о существующей политике и воспроизводит их в продленной политике.

additionalFields

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

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

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

Примечание
Примечание Все удаленные параметры, используемые в InsProductService:repriceProduct, также могут использоваться в этой службе.

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

Описание

renewalExpirationDate

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

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

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

renewalEffectiveDate

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

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

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

Если вы используете пакет Insurance Industries Extension, значение отметки времени в параметре renewalEffectiveDate игнорируется. Вместо этого, значение отметки времени вступления в силу установлено на 00:00 выбранной даты вступления в силу, а значение даты истечения срока действия установлено на 23:59 выбранной даты истечения срока действия. Отметка времени устанавливается посредством указанного часового пояса пользователя.

aggByKey

Обязательно

PRODUCT.instanceKey

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

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

Служба использует это значение для переоценки полиса.

calculateTaxesAndFees

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

Значение по умолчанию - true.

Установите true для расчета налогов и сборов.

createTransaction

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

Истина или ложь

По умолчанию используется значение «Ложь».

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

includeInputKeys

Обязательно

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

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

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

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

includePaymentSchedule

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

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

includeRevenueSchedule

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

Если значение true, служба создает расписание дохода по продленному полису. Если значение не предоставлено, службы создают расписание оплаты по продленному полису, только если оно присутствует для исходного полиса.

paymentCalculationMethod

Обязательно, если значение includePaymentSchedule является истинным.

Переопределяет значение Premium Calculation Method политики.

paymentFrequency

Обязательно, если значение includePaymentSchedule является истинным.

Переопределяет значение PremiumFrequency политики.

paymentType

Обязательно, если значение includePaymentSchedule является истинным.

Переопределяет значение Premium Payment Type политики.

ratingDate

Определяет процедуру рейтинга для ценообразования продленного полиса. Если не предоставлено, ценообразование производится на основе даты вступления в силу продленного полиса.

Примечание
Примечание Невозможно передать определенное время для ratingField, так как тип поля — «Дата». Таким образом, отметка времени даты рейтинга по умолчанию составляет 00:00.

term

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

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

useLocalTimezone

Истина или ложь

Значение по умолчанию является истинным.

Если значение установлено как 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"
    }
}    

Вывод JSON

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

{
  "snapshotId": [
    "00P5w00001fKlqEEAS"
  ],
  "InsurancePolicy": [
    "0YT5w000000Y8tTGAS"
  ]
  "error": "OK"
}
 
Загрузка
Salesforce Help | Article