Loading
시스템 관리자에 대한 피싱 방지 MFA 및 전 직원사용자 MFA 적용 안내 더 많이 읽기
보험
InsQuoteService:getQuoteDetail

InsQuoteService:getQuoteDetail

이 서비스를 사용하여 모든 견적서 세부 사항을 JSON으로 가져옵니다.

이 서비스는 저장된 견적서를 가져와 보험 증권 또는 건강 계획을 생성하는 플로에 적합합니다.

클래스: InsQuoteService

방법: getQuoteDetail

작동 방법

  1. 서비스는 quoteId하고 견적서를 찾습니다.

  2. 서비스는 다음 키를 포함하는 JSON을 반환합니다.

    • quoteDetails: 견적서 필드 값

      특성이 있는 견적서 필드 값을 포함합니다.

    • insuredItems: 보장 항목 및 보험 당사자

      InsuredItemSpec 및 InsuredPartySpec 견적서 행 세부 사항을 포함합니다. (Vlocity Health에는 적용할 수 없습니다.)

    • productConfigurationDetail: 제품 구성

      제품 JSON 구조 모델

세금 및 수수료

다음은 이 서비스의 작동 방식입니다.

  • 필드가 null이 아닌 경우 각 QuoteLineItem에 대해 taxAmount, TaxAmount__c, feeAmount, FeeAmount__c 및 TotalAmount__c 필드가 반환됩니다.

  • 필드가 null이 아닌 경우 견적서에 대한 TotalTaxAmount__c, TotalFeeAmount__c 및 TotalAmount__c 필드가 반환됩니다.

  • totalTaxFeeAmount= TaxAmount__c + FeeAmount__c

입력

isForExternal 원격 옵션이 true로 설정된 경우 서비스에서 이러한 입력을 요구합니다. isForExternal가 비어 있거나 false로 설정된 경우 이러한 입력을 생략합니다.

옵션

설명

action

isForExternal=true인 경우 필요합니다.

서비스는 이 값을 사용하여 외부 가격 책정 API에 필요한 작업 노드를 만듭니다.

가능한 값:

  • submit
  • reprice
quoteId

isForExternal=true인 경우 필요합니다.

세부 사항을 검색할 견적서의 ID입니다.

원격 옵션

옵션

설명

action

isForExternal=true인 경우 필요합니다.

견적서와 관련된 외부 서버의 작업을 나타냅니다.

가능한 값:

  • submit
  • reprice

제출 시, 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가 있는 견적서 행 항목을 하나만 반환합니다. 반품된 항목의 세부 사항을 충족하지 않는 기타 필터가 요청에 포함된 경우 항목이 반환되지 않습니다.

입력 JSON

다음은 입력 JSON 형식입니다.

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

다음은 입력 JSON의 예입니다.

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

출력 JSON(보험)

서비스에서 다음 노드를 포함하는 JSON을 반환합니다.

  • 보험 당사자 및 보험 항목

  • 견적서 세부 사항 필드 집합

  • 제품 구성 세부 사항

팁
팁

여러 개체에 quoteDetail 필드 집합이 존재하지만, InsQuoteService:getQuoteDetail 서비스는 JSON 응답에서 productConfigurationDetail 노드를 구축할 때 Quote Line Item 개체에 설정된 필드만 읽습니다. 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(Health)

서비스에서 다음 노드를 포함하는 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