Loading
メールアドレスがデフォルトのログイン方式となります 続きを読む
Insurance
InsQuoteService:getQuoteDetail

InsQuoteService:getQuoteDetail

このサービスを使用して、すべての見積の詳細を JSON として取得します。

このサービスは、保存した見積を取得し、そこから保険契約または医療保険を作成するフローに適しています。

クラス: InsQuoteService

方法: getQuoteDetail

操作手順

  1. サービスはquoteIdを実行して見積を見つけます。

  2. サービスは、次のキーの値を含む JSON を返します。

    • quoteDetails: 見積フィールド値

      属性を含む見積項目値が含まれます。

    • insuredItems: 被保険者および被保険者

      InsuredItemSpec および InsuredPartySpec 見積品目の詳細が含まれます。(Vlocity Health には適用されません)。

    • productConfigurationDetail: 製品構成

      商品 JSON 構造モデル

税金と手数料

このサービスのしくみを次に示します。

  • taxAmount、TaxAmount__c、feeAmount、FeeAmount__c、および TotalAmount__c フィールドが null でない場合、各QuoteLineItemでフィールドが返されます。

  • 見積の TotalTaxAmount__c、TotalFeeAmount__c、および TotalAmount__c 項目は、null でない場合に返されます。

  • totalTaxFeeAmount= TaxAmount__c + FeeAmount__c

入力:

isForExternal remote オプションが true に設定されている場合、サービスでは次の入力が必要です。isForExternal が空白の場合、または false に設定されている場合は、これらの入力を省略します。

オプション

説明

action

isForExternal=true の場合は必須です。

サービスはこの値を使用して、外部価格設定 API に必要なアクションノードを作成します。

可能な値:

  • submit
  • reprice
quoteId

isForExternal=true の場合は必須です。

詳細を取得する見積の ID。

リモートオプション

オプション

説明

action

isForExternal=true の場合は必須です。

見積に対して外部サーバーが実行するアクションを示します。

可能な値:

  • submit
  • reprice

submit の場合、QuoteのsourceSystemIdentiferが渡されます。再価格設定の場合、再価格設定または評価の対象となるRoot QuoteLineItemのSourceSystemIdentiferが渡されます。

disableAttributeCategories

省略可能。

出力 JSON にattributeCategoriesを表示します。

このフラグを true に設定すると、getQuoteDetail サービスは応答からattributeCategoryノードを省略し、createPolicyVersion サービスはポリシー規約の作成に失敗します。createPolicyVersion サービスでポリシー規約が作成されるように、このフラグを false に設定します。

disableChildProducts

省略可能。

出力 JSON でchildProduct中のレコードを表示します。

disableOptionalCoverages

省略可能。

true に設定した場合、省略可能な補償は OmniScript の見積の一部として表示されません。

includeOriginalPlan

[true] に設定されている場合、更新に元の商品が含まれる。

それ以外の場合は、代替商品のみが表示されます。

includeOpportunity

[true] に設定されている場合、見積の商談の詳細を個別の JSON ノードで返します。返されるフィールドは、フィールド セットによって決まります OpportunityDetail。

デフォルト値は false です。

instanceKey

商品のインスタンスを識別するために使用される見積品目に関連付けられた一意の識別子。instanceKey は手動またはシステム生成で指定されます。

isMultiRoot

true または false

複数の保険商品 (プラン) を含む見積の場合は true に設定します。

たとえば、医療保険、歯科プラン、およびビジョンプランを含む見積でプランの詳細を返すには、このオプションを [true] に設定する必要があります。

isForExternal

[true] に設定すると、外部ポリシー管理システムへの対応付けを容易にするために簡略化された JSON が返されます。

productCode

見積品目に関連付けられた商品のコード。

productSpecId

見積品目に関連付けられた商品の ID。

quoteId

必須。

QuoteId。要求が顧客向けの場合は暗号化QuoteId。

quoteLineItemId

見積品目名の ID。ID が完全に一致する 1 つの見積品目のみを返します。返された項目の詳細を満たさない他の検索条件が要求に含まれている場合、項目は返されません。

Input JSON

入力 JSON の形式は次のとおりです。

{
  "quoteId": "...",
  "action":  "..."
}

入力 JSON の例を次に示します。

{
  "quoteId":"0Q06g0000009YA3CAM"
  "action": "submit"
}

出力 JSON (保険)

このサービスは、次のノードを含む JSON を返します。

  • 被保険者および被保険者項目

  • 見積の詳細項目セット

  • 商品設定の詳細

ヒント
ヒント

quoteDetail 項目セットは複数のオブジェクトに存在しますが、InsQuoteService:getQuoteDetail サービスは、JSON 応答で productConfigurationDetail ノードを作成するときに見積品目オブジェクトの項目セットのみを参照します。このサービスでは、Product2 オブジェクトの項目セットは無視されます。

ペイロードサイズを減らして OmniScript のパフォーマンスを向上させるには、quoteDetail 項目セットで項目を追加または削除します。[商品名]、[商品コード]、[商品 ID] など、いくつかの見積品目項目がデフォルトで含まれています。これらのセットは見積に不可欠であるため、変更しないことをお勧めします。

{
  "productConfigurationDetail": {
    "records": [...]
    "totalSize": 1
  },
  "insuredItems": {
    "Driver": [{
        "instanceKey": "Joan Smith",
        "isPrimary": false,
        "isParent": false,
        "LN": "Smith",
        "AGE": 20,
        "FN": "Joan",
        "GENDER": "Female",
        "FirstName": "Joan",
        "LastName": "Smith"
      },
      {
        ...
      }
    ],
    "Auto": [{
        "instanceKey": "2015 Lexus LX250",
        "autoAntiTheft": true,
        "est_annual_mileage": "1-10000",
        "autoLicNum": "Lexus",
        "autoModel": "LX250",
        "autoYear": 2015,
        "BodyClass": "Sedan/Saloon",
        "VehicleType": "PASSENGER CAR",
        "isPrimary": true
        "isParent": false,
      },
      {
        ...
      }
    ]
  },
  "quoteDetail": {
    "attributes": {
      "type": "Quote",
      "url": "/services/data/v43.0/sobjects/Quote/0Q01I000000qeWLSAY"
    },
    "ins_daily4__EffectiveDate__c": "2018-07-27",
    "ins_daily4__TotalSumInsured__c": 0,
    "AccountId": "0011I00000QknfjQAB",
    "ins_daily4__RootItemTotal__c": 0,
    "Id": "0Q01I000000qeWLSAY"
  },
  "error": "OK"
}

出力 JSON (正常性)

このサービスは、次のノードを含む JSON を返します。

  • 見積の詳細項目セット

  • 商品設定の詳細

{
  "productConfigurationDetail": {
    "records": [...]
    "totalSize": 1
  },
  "quoteDetail": {
    "attributes": {
      "type": "Quote",
      "url": "/services/data/v43.0/sobjects/Quote/0Q01I000000qeWLSAY"
    },
    "ins_daily4__EffectiveDate__c": "2018-07-27",
    "ins_daily4__TotalSumInsured__c": 0,
    "AccountId": "0011I00000QknfjQAB",
    "ins_daily4__RootItemTotal__c": 0,
    "Id": "0Q01I000000qeWLSAY"
  },
  "error": "OK"
}
 
読み込み中
Salesforce Help | Article