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

InsPolicyService:cancelPolicy

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

Эта служба сотрудничает со службой InsPolicyService:prepareToCancelPolicy и службой InsPolicyRevenueScheduleService:cancelRevenueSchedule для выполнения всех изменений, необходимых для отмены полиса, предоставления суммы возмещения и завершения расписания доходов (при необходимости).

Класс: InsPolicyService

Метод: cancelPolicy

Данная служба работает с Salesforce Financial Services Cloud.

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

  1. Принимает assetId или policyId полиса для отмены и effectiveDate, с которого отмена вступает в силу.

    Примечание
    Примечание Дата вступления в силу отмены не может превышать сегодняшнюю.
  2. Обновляет статус полиса на Canceled, исходную дату истечения срока действия на текущее значение даты истечения срока действия и дату истечения срока действия на день до даты отмены (с отметкой времени 23:59).

  3. Изменяет дату истечения срока действия на effectiveDate, переданный службе, с отметкой времени 23:59.

  4. Использует соответствующий процесс расчета на основе значения useIsPaidFlag.

    Если useIsPaidFlag установлено на false (снят флажок), служба пропорционально распределяет общую премию полиса за срок, общую плату за срок и общий налог за срок и рассчитывает возмещенные суммы на основе даты отмены и оплаченного полиса на сегодняшний день. Если поле «Полис, оплаченный на сегодняшний день» содержит значение «Нулевое», то служба учитывает полис, оплаченный полностью, и использует поле «Дата истечения срока действия».

    Если useIsPaidFlag установлено на true (выбрано), служба:

    1. Использует расписание оплаты для расчета общей суммы, уже оплаченной за полис. Общая сумма, оплаченная за полис, равна сумме сумм в расписаниях оплаты с параметром «Оплачено», установленным на true (выбрано). Данная сумма используется в расчетах возмещения.

    2. Пропорционирует общую премию полиса за срок, общую плату за срок и общий налог за срок и рассчитывает суммы возмещения на основе даты отмены и общей суммы, уже оплаченной за полис.

    3. Корректировка расписаний оплаты на основе текущей даты или даты отмены, в зависимости от того, что наступит позже. Если расписания оплаты на эту дату или позже установлены на значение «Оплачено» «ложь» (снят флажок), служба удаляет их.

    4. Обновляет статус всех неоплаченных графиков оплаты (которые ранее были в cancellationDate) на Invalid. Неоплаченная сумма добавляется в новый график оплаты.

    5. Создает новое расписание оплаты на текущую дату со стоимостью, равной уже вычисленной сумме возмещения, и отмечает статус Valid. Если createTransaction истинна, служба создает транзакцию отмены.

    6. Обновляет все будущие версии полисов со сведениями об отмене:

      • Статус: Отменено

      • Дата отмены: effectiveDate, переданные службе

      • Премия за срок, срочный налог и срочный платеж: 0

      • Дата истечения срока действия: За день до передачи effectiveDate службе с отметкой времени 23:59

  5. Обязывает пропорционально распределенный TotalPremiumForTerm к базе данных.

  6. Если createTransaction=true, а переданный код является assetId, создает AssetTransaction_c (Amount_c=refund, postDate_c и transactionDate_c=effectiveDate, type=transactionType (по умолчанию — «Отменено»). Если createTransaction=true, а переданный код является policyId, служба создает InsurancePolicyTransaction_c или InsurancePolicyTransaction (Amount_c=refund, postDate_c и transactionDate_c=effectiveDate, type=transactionType (по умолчанию — «Отменено»).

    Служба также заполняет данные разбивки транзакций в объекте сведений о транзакции. Она отображает данные о том, сколько каждый актив, участник и покрытие вносят в общую сумму транзакций в виде вознаграждения, налога и платежей. Отображаются только активы, участники и покрытия, имеющие как минимум одно ненулевое значение для вознаграждения, налога и платежей.
  7. Вызовы InsPolicyRevenueScheduleService:отмена с помощью assetId и недавно созданного transactionId.

  8. InsPolicyRevenueScheduleService: служба отмены рассчитывает конец расписания доходов и публикует результаты в разделе расписания доходов политики. Суммы возмещения относятся к страховой компании. Отрицательная сумма приводит к возмещению страхователю, а положительная сумма представляет собой неоплаченную сумму страхователя.

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

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

Дополнительные платежи (налоги и сборы)

Эта служба (вместе со службой prepareToCancel) облегчает пропорциональное распределение и возмещение налогов и платежей при отмене полиса. Вот как это работает:

  • Если у целевой политики есть TotalTaxAmount__c, это значение пропорционально определяется датой отмены и устанавливается в поле TotalTaxForTerm__c.

  • Если у целевой политики есть TotalFeeAmount__c, это значение пропорционально оценивается по дате отмены и устанавливается в поле TotalFeeForTerm__c.

  • Если параметру createTransaction (см. ниже) задано значение true, а целевая политика содержит записи AssetPricingAdjustment__c, подлежащие возмещению, то пропорционально распределенные суммы возмещения устанавливаются в полях TaxAmount__c и FeeAmount__c транзакции.

Если вы используете модель объекта «Страховой полис» (вместо модели объекта «Актив»), имена полей будут другими:

  • TotalTaxAmount__c = StandardTaxAmount

  • TotalTaxForTerm__c = TermTaxAmount

  • TotalFeeAmount__c = StandardFeeAmount

  • TotalFeeForTerm__c = TermFeeAmount

  • AssetPricingAdjustment__c = InsurancePolicySurcharge

  • TaxAmount__c = TransactionTaxAmount

  • FeeAmount__c = TransactionFeeAmount

Совет
Совет

Хотите узнать о переходе с модели объекта «Актив» на модель объекта «Страховой полис»? Прочитайте «Гармонизация страховых полисов».

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

Параметр

Описание

additionalFees

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

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

Отформатируйте каждый платеж как "<fee type>": <amount>.

Например, чтобы добавить административный сбор $10 и сбор за отмену брони $20, введите:

  "additionalFees": {
    "Cancellation Fee": 20,
    "Admin Fee": 10
  }

Если возмещение отмены составляет $120 брутто платежей, эти additionalFees уменьшают его на $30. Таким образом, чистая сумма возмещения отмены составляет $90.

assetId или policyId

Обязательно.

%theIdYouAreLookingFor%

Код отменяемого полиса (актива) или InsurancePolice.

cancelRevenueScheduleCustomeClassName

Дополнительно (только FSC).

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

createTransaction

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

true или false

По умолчанию — false.

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

effectiveDate

Обязательно.

“YYYY-MM-DD HH:MM:SS” или %OmniScriptDataElement%

Дата отмены полиса.

Если вы используете пакет «Расширение Insurance Industries», значение отметки времени в параметре даты вступления в силу игнорируется. Вместо этого, значение отметки времени вступления в силу отмены установлено на 00:00 выбранной даты вступления в силу. Значение даты истечения срока действия установлено на 23:59 дня, предшествующего выбранной дате вступления в силу. Отметка времени устанавливается посредством указанного часового пояса пользователя.

getDataCustomClassName

Дополнительно (только FSC).

Имя настраиваемого класса, используемого службой для извлечения сведений о политике (активе).

Если вы используете Salesforce FSC, укажите этот параметр или getDataDRBundleName.

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

getDataDRBundleName

Дополнительно (только FSC).

Имя Omnistudio Data Mapper, используемое службой для извлечения сведений о политике (активе).

Если вы используете Salesforce FSC, укажите этот параметр или getDataCustomClassName.

  • Если вы укажете оба параметра, служба использует значение getDataDRBundleName.

  • Если вы не укажете ни то, ни другое, служба использует стандартное значение для getDataCustomClassName (GetInsurancePolicy).

includeRevenueSchedule

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

true или false

Если true, этот параметр сообщает службе о необходимости вызова службы InsPolicyRevenueScheduleService: cancel для отмены расписания дохода.

Если false, служба ничего не делает с планированием доходов.

По умолчанию: false.

updateDataCustomClassName

Дополнительно (только FSC).

Если вы используете Salesforce FSC, укажите этот параметр или updateDataDRBundleName.

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

updateDataDRBundleName

Дополнительно (только FSC).

Если вы используете Salesforce FSC, укажите этот параметр или updateDataCustomClassName.

  • Если вы укажете оба параметра, служба использует значение updateDataDRBundleName.

  • Если вы не укажете ни то, ни другое, служба использует стандартное значение для updateDataCustomClassName (PostInsurancePolicy).

useIsPaidFlag

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

true или false

Если значение true, используется новая логика пропорционального распределения (учитывающая графики оплаты).

Если значение false, используется существующая логика пропорционального распределения (которая использует дату отмены и payToDate).

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

JSON ввода

Данная служба не использует JSON ввода.

Вывод JSON

Если вы используете модель объекта «Актив», эта служба возвращает узел output JSON. См. пример ниже:

{
  "output": {
    "records": [
      {
        "instest10__TotalAmount__c": 420.97,
        "instest10__TaxAmount__c": 37.93,
        "instest10__FeeAmount__c": 3.68,
        "instest10__Amount__c": 379.36,
        "Id": "a416g0000002CZpAAM"
      }
    ],
    "totalSize": 1
  }
}

Если вы используете модель объекта «Страховой полис», эта служба возвращает узел results JSON. См. пример ниже:

{
    "result": {
        "type": "Cancelled",
        "transactionNumber": null,
        "transactionDate": 
        "totalAmount": null,
        "taxAmount": null,
        "postDate": "2021-09-01T07:00:00.000Z",
        "name": "Cancelled"
        "Id": null,
        "feeAmount": null,
        "amount": -133.4,
        "additionalInfo": null
    },
    "error": "OK"
}
 
Загрузка
Salesforce Help | Article