InsPolicyService:calculateTaxesAndFees

クラス: InsPolicyService

方法: calculateTaxesAndFees

税金および手数料情報は、納入商品 (ポリシー) オブジェクト、および [AssetCoverage__c]、[AssetInsuredItem__c]、[AssetPartyRelationship__c] 項目に保存されます。

このサービスでは、以下のステップ 3 で説明されているように、項目ごとの税金も節約されます。

メモ

このサービスでは、Salesforce Financial Services Cloud がサポートされます。

操作手順

1. サービスは、assetId、effectiveDate (または対象ポリシーEffectiveDate_c 、値が null の場合は今日の日付) を使用します。

2. 保険契約、補償範囲、および/または被保険者項目に関連付けられた税金および手数料項目に基づいて、指定された単純な計算を実行するか、税金および手数料の計算に必要な計算手順またはインテグレーション手順をコールします。

   

   メモ

   このサービスでは、外部システムをコールして税金と手数料を計算することもできます。税金と料金を設定するときに、次のシステムを指定します。

3. saveChanges が true に設定 (またはデフォルト) されている場合、計算された税金と手数料を 3 つの方法のいずれかで保存します。

   • AssetItemが税金と手数料を計算している場合、サービスはその税金/手数料を表すAssetPricingAdjustment__cレコードを保存します。

     AssetPricingAdjustment__cレコードには、 計算済み金額 （Amount__c）、 関連付けられたAssetItem （AssetCoverageId__c/AssetInsuredItemId__c/AssetPartyRelationshipId__c） およびAsset （AssetId__c） 、 種別 （税金または手数料、 AdjustmentType__c）、 関連付けられた税金/ 手数料 （PriceListEntryId__c） が保持されます 。

     AssetPricingAdjustment__c には関連付けられたAssetItemがあるため、ApplicableItemType__c フィールドも設定されます。この設定は、適用される項目種別 ([補償範囲]、[被保険者項目]、[関係者リレーション]) を示します。

     transactionId オプションが指定されている場合、AssetTransactionId__c フィールドは transactionId 値に設定されます。

   • AssetItem または その子に計算済み税金がある場合、自分とその子の計算済み税金の合計はTaxAmount__c項目に保存されます。

   • AssetItem または その子に計算済み料金がある場合、自分自身とその子の計算済み料金の合計が [FeeAmount__c] フィールドに保存されます。

   

   メモ

   [saveItemizedTaxesAndFees] を [false] に設定した場合、AssetPricingAdjustment__cレコードは保存されません。納入商品 (ポリシー) のTotalTaxAmount__c金額とTotalFeeAmount__c金額が 0 に設定されます。 その他の値はすべて保存されます。

4. 資産レベルでは、すべての税額と手数料の合計が、それぞれ [TotalTaxAmount__c] 項目と [TotalFeeAmount__c] 項目に保存されます。

5. 対象納入商品 (ポリシー) がポリシーの元のバージョンでない場合、税金と手数料の金額は納入商品のEffectiveDate__cとExpirationDate__cに基づいて按分されます。AssetItemの按分の税額と手数料の金額は、[ProratedTaxAmount__c] 項目と [ProratedFeeAmount__c] 項目に保存されます。納入商品の按分の税額と手数料の金額は、[TotalTaxForTerm__c] 項目と [TotalFeeForTerm__c] 項目に保存されます。

6. transactionIdオプションを指定した場合、現在の納入商品バージョンと以前の納入商品バージョン間の按分された税額と手数料の合計 (対象納入商品バージョンと以前のすべての納入商品バージョンでの按分された税額と手数料の合計) の変化は、それぞれ対象トランザクションのTaxAmount__c項目とFeeAmount__c項目に保存されます。

リモートオプション

Input JSON

このサービスは入力 JSON を取りません。

出力 JSON

このサービスは、商品/子商品階層の項目化された税金と手数料を返します。次に例を示します。

{
  "productId": 1,
  "productName": "Product",
  "ProductCode": "P",
  "taxesAndFees": [{
    "Id": 1,
    "Amount__c": 10,
    "PriceListEntryId__c": 11,
    "AdjustmentType__c": "Tax"
  }, {
    "Id": 2,
    "Amount__c": 15,
    "PriceListEntryId__c": 12,
    "AdjustmentType__c": "Fee"
  }],
  "taxAmount": 25
  "feeAmount": 30
  "childProducts": [{
    "productId": 2,
    "productName": "Insured Item",
    "ProductCode": "II",
    "instanceKey": "My Insured Item",
    "taxesAndFees": [{
      "Id": 3,
      "Amount__c": 15,
      "PriceListEntryId__c": 16,
      "AdjustmentType__c": "Tax"
    }],
    "taxAmount": 15
  }, {
    "productId": 3,
    "productName": "Coverage",
    "ProductCode": "C",
    "taxesAndFees": [{
      "Id": 4,
      "Amount__c": 15,
      "PriceListEntryId__c": 21
      "AdjustmentType__c": "Fee"
    }],
    "feeAmount": 15
  }]
}