InsQuoteService:updateQuotePlans

類別:InsQuoteService

方法:updateQuotePlans

運作方式

例如,如果涵蓋範圍具有具有屬性代碼 cat1_copay_inn 的屬性,且輸入資料對應包含部分屬性代碼 copay,則會發生比對,因為 cat1_copay_inn 包含字串 copay,且此涵蓋範圍上的屬性會更新。

1. 服務需要花quoteId來尋找目標報價。

2. 使用 inputKey 尋找輸入資料 (涵蓋範圍、屬性)。

3. 根據 operationScope (涵蓋範圍或屬性) 和 operationType (插入、更新、更新插入),修改報價中的涵蓋範圍或屬性。

• 如果 operationScope 是 涵蓋範圍,則會根據目標計畫的 operationType,在目標報價中插入、更新或更新輸入範圍。

• 如果 operationScope 是 屬性,則會更新目標報價中的涵蓋屬性,根據這些涵蓋範圍包含其程式碼包含輸入資料對應中所列其中一個部分屬性代碼的屬性。

備註

注意:如果提供 planIds,則僅當涵蓋範圍屬於清單中的其中一個 planId 時,才會更新,即使有相符項目也是如此。

備註

注意:若要插入新的根產品涵蓋範圍,您需要根產品下至少一個子系報價條列項目。

遠端選項

選項地圖

以下是在卡片中使用的範例選項對應變數,當 operationScope 為 涵蓋範圍時:

{
  'quoteId': '0Q0000000000000000',
  'inputKey': 'inputJson',
  'operationScope': 'coverages',
  'operationType': 'insert',
  'identifiers': planId1, planId2'
}

以下是在卡片中使用的範例選項對應變數 (當 operationScope 為 屬性時):

{
  'quoteId': '0Q0000000000000000',
  'inputKey': 'inputJson',
  'operationScope': 'attributes',
  'identifiers': '0QLf4000000SX3tGAG, 0QLf4000000SX3rGAG'
}

輸入 JSON

如果 operationScope 是 涵蓋,則輸入資料必須包含 JSONResult 物件 (或可剖析為 JSONResult 物件的地圖),其中包含要插入或更新的涵蓋 (涵蓋範圍 1、涵蓋範圍 2 等):

{
  'inputJson': {
    'records': [{
      'productName': 'Coverage 1',
      'attributeCategories': [...],
      ...
    }, {
      'productName': 'Coverage 2',
      'attributeCategories': [...],
      ...
    }]
  }
}

如果 operationScope 是 屬性,則輸入資料必須包含部分屬性代碼的對應及其更新的值,如此範例中所示:

{
  'inputJson': {
    'copay': 20,
    'covered': '90%'
  }
}

使用範例

假設您想要變更屬性種類 ChirOffiProf 之間的 copay 屬性值。

假設標準命名慣例為:

attributeCategory_attributeCode_inNetwork/outOfNetwork

具有下列網路內和網路外同步屬性:

• ChirOffiProf_copay_inn

• ChirOffiProf_copay_oon

您會使用下列輸入和選項來設定 updateQuotePlans 服務:

輸入

部分代碼與其值的對應 (亦即 copay 會傳回字串中具有 copay 的任何屬性名稱。)在此個案中,部分程式碼將是範本的 attributeCode 部分:

{
    'copay': 20,
    'covered': 75
}

選項

• quoteId

• planId (QuoteLineItem Id)

服務會搜尋指定 planIds 內的所有涵蓋範圍,其屬性包含部分屬性代碼 (在此個案中為 copay),並以新值 (在此個案中為 20) 更新這些屬性。

如果未指定 planId,則會更新具有屬性包含所傳送部分 attributeCode 的所有涵蓋範圍。