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

InsPolicyService:prepareToCancelPolicy

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

Эту службу нужно вызвать перед службой InsPolicyService:cancelPolicy.

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

Класс: InsPolicyService

Метод: prepareToCancelPolicy

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

  1. Выполняет assetId или policyId и обнаруживает, что политика отменена.

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

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

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

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

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

  3. Сервис учитывает, подлежат ли платежи или налоги возмещению.

  4. Возвращает разницу в цене между исходным общим вознаграждением за полис и отмененным полисом в выводном JSON.

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

  5. Если налоги и платежи включены в эту политику, Total Tax For Term, Total Fee For Term, refundedTax и/или refundedFee также включены в выводной JSON.

    Если политика, которую отменяет служба, не содержит налогов или платежей, эти поля пропускаются в выводе JSON.

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

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

  • priceDiff по сути является суммой возмещения и использует формулу = (старый GrossWrittenPremium - обновленный GrossWrittenPremium) + refundedTax + refundedFee.

  • Обновленный GrossWrittenPremium - это PremiumAmount, пропорционально распределенный по дате вступления в силу и дате отмены полиса.

  • Новая общая сумма равна PremiumAmount целевой политики плюс StandardTaxAmount плюс StandardFeeAmount, все пропорционально дате отмены.

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

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

  • Если целевая политика содержит записи возмещаемого InsurancePolicySurcharge или AssetPricingAdjustment__c, пропорционально распределенные суммы возмещения возвращаются посредством полей refundedTax и refundedFee в выводе. InsurancePolicySurcharge или AssetPricingAdjustment__c подлежат возмещению, если связанная PriceListEntry__c подлежит возмещению. Пропорциональные суммы возмещения рассчитываются между датой отмены и исходной датой истечения срока действия.

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

Параметр

Описание

assetId

или

policyId

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

%theIdYouAreLookingFor%

Код страхового полиса для отмены.

effectiveDate

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

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

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

getDataDRBundleName

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

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

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

getDataCustomClassName

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

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

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

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

useIsPaidFlag

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

true или false

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

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

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

JSON ввода

Эта служба принимает JSON ввода, содержащий effectiveDate (дата отмены).

{
    "Id": "02i6g000002f07VAAQ",
    "effectiveDate": "08/12/2019"
}

Вывод JSON

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

{
  "Id": "02i6g000002f07VAAQ",
  "output": {
    "refundedFee": -3.68,
    "totalFeeForTerm": 14.06,
    "refundedTax": -37.93,
    "totalTaxForTerm": 144.84,
    "aggregateTotalPremiumForTerms": 4002.28,
    "priceDiff": -420.97,
    "totalPremiumForTerm": 1448.44,
    "errorCode": "INVOKE-200",
    "error": "OK"
  }
}

Ключи вывода и значения

Вывод

Описание

Id

Код обновленного полиса (актива) или InsurancePolicy.

output

  • totalPremiumForTerm: пропорционально распределенная общая сумма вознаграждения за срок

  • totalFeeForTerm: пропорциональное распределение общего платежа за срок

  • totalTaxForTerm: пропорциональное распределение общей суммы налога

  • aggregateTotalPremiumForTerms: сумма общего вознаграждения за срок всех версий полиса и пропорциональное общее вознаграждение за срок текущей отменяемой версии

  • refundedFee: сумма возмещаемых платежей

  • refundedTax: сумма налогов к возмещению

  • priceDiff: общая сумма страховых взносов, сборов и налогов для возмещения

 
Загрузка
Salesforce Help | Article