InsCensusServiceStd:addPlanSelections

運作方式

服務使用 censusId 和 contractId 插入成員的選取計畫。

1. 針對每個其 ContractGroupPlan 識別碼,服務會根據下列因素評估計畫是否對成員有效:

   • contractId 對 censusId 有效。

   • ContractGroupPlan 識別碼對 contractId​ 有效。

   • IsOptOutAllPlans 為 false。

   • 當 ContractGroupPlan 的記錄類型為「產品」(父系的「ContractGroupPlan」):

     • 主要成員的 ContractGroupPlan 產品類型不能等於主要成員的 OptOutPlanTypes 中所列的產品類型。

     • 相依者的「ContractGroupPlan​​」產品類型不能等於在相依者 OptOutPlanTypes 中列出的產品類型,且 ContractGroupPlan 的產品類型不能等於在相依者主要成員的「OptOutPlanTypes」中列出的產品類型。

   • 當 ContractGroupPlan 的記錄類型為 CoverageSpec (子系的 ContractGroupPlan) 時:

     • 主要成員其子系 ContractGroupPlan 的產品類型不能等於主要成員其 OptOutPlanTypes 中所列的產品類型。

     • 親屬的子系 ContractGroupPlan​​ 產品類型不得等於在「親屬」OptOutPlanTypes 中列出的產品類型,且 ContractGroupPlan 的產品類型不得等於在「親屬」主要成員的「OptOutPlanTypes」中列出的產品類型。

2. 系統會針對有效的計畫傳回成功建立之 GroupCensusMemberPlan 項目的識別碼。

3. 服務會針對指定的契約,針對符合資格的群組類別,取用有效的計畫。註冊根計畫及其涵蓋範圍取決於成員的類別是否符合計畫的資格,以及計畫是否接受與任何類別無關聯的成員。

   如果服務判定普查成員可以註冊計畫,則計畫會新增至該 GroupCensusMemberPlan。

   • 在下列情況下,計畫會新增至 GroupCensusMemberPlan:

     • 普查成員與有效的群組類別相關聯,且具有群組類別與計畫的 ContractGroupPlanGroupClass 記錄存在。

     • 普查成員與有效的群組類別相關聯,該群組類別不存在任何 ContractGroupPlanGroupClass記錄,且計畫不存在於任何其他群組類別。

     • 普查成員未與有效的群組類別相關聯,且計畫中不存在任何 ContractGroupPlanGroupClass 記錄。

   • 在下列情況下,不會將計畫新增至 GroupCensusMemberPlan:

     • 普查成員與有效的群組類別相關聯,該群組類別不存在任何 ContractGroupPlanGroupClass 記錄,但計畫存在於其他群組類別。

     • 普查成員未與有效的群組類別相關聯,且計畫和群組類別存在一個 ContractGroupPlanGroupClass 記錄。

4. 傳遞無效的 groupCensusMember contractGroupPlanIds (標記 isNewMember 為 true) 時,服務會刪除 groupCensusMember 記錄,且不會為 groupCensusMember 建立任何新的 GroupCensusMemberPlan 記錄。只有在 JSON 物件中的標記 onlySaveMembersWithValidProducts 設定為 true 時,才預期此輸出。

遠端選項

服務行為

瞭解不同的輸入如何影響服務輸出。

輸入 JSON

以下是輸入 JSON 的格式:

{ 
   "censusId":"ID",
   "contractId":"ID",
   "census":{ 
      "headers":[ 
         { 
            "name":"GroupCensusMemberPlan.fieldAPI1"
         },
         { 
            "name":"GroupCensusMemberPlan.fieldAPI2"
         }
      ],
      "members":[ 
         { 
            "Id":"Census Member ID",
            "isNewMember":true,
            "GroupCensusMemberPlan.fieldAPI1":"value1",
            "GroupCensusMemberPlan.fieldAPI2":"value2",
            "ContractGroupPlanId": "ContractGroupPlan.Id;ChildContractGroupPlan.Id"
         },
         { 
            "Id":"Census Member ID",
            "isNewMember":true,
            "GroupCensusMemberPlan.fieldAPI1":"value1",
            "GroupCensusMemberPlan.fieldAPI2":"value2",
            "ContractGroupPlanId": "ContractGroupPlan.Id;ChildContractGroupPlan.Id"
         }
      ]
   },
   "onlySaveMembersWithValidProducts" : true
}

以下是輸入 JSON 的範例:

{ 
   "censusId":"a4D4P000000hbjSUAQ",
   "contractId":"8004P000000zF2dQAE",
   "census":{ 
      "members":[ 
         { 
            "ContractGroupPlanId":"a4D4P000000hbjSUAQ;a4D4P000000hbjSUAQ",
            "Id":"a4C4P000000d7POUAY"
         }
      ],
      "headers":[ 
         { 
            "name":"ContractGroupPlanId"
         }
      ]
   }
}

輸出 JSON

服務會傳回成功插入之 GroupCensusMemberPlan 識別碼的清單。它也會提供所遇到錯誤的清單。這些錯誤會依成員分組。

以下是輸出 JSON 的格式:

{ 
   "memberPlanIds":[ 
      "GroupCensusMemberPlan.Id"
   ],
   "errors":[ 
      { 
         "error":"error"
      }
   ]
}

服務會傳回輸出 JSON,格式如下:

{ 
   "memberPlanIds":[ 
      "a4B4P000006jKsMUAU",
      "a4B4P000006jKsNUAU",
      "a4B4P000006jKsOUAU",
      "a4B4P000006jKsPUAU"
   ],
   "errors":[ 
      { 
         "numPlansError":2,
         "error":"ContractGroupPlan value is not valid:8004P000000zJKjQAM; Medical",
         "numPlans":2,
         "Id":"a4C4P000000ed6dUAA",
         "isNewMember":true,
         "ContractGroupPlan":"8004P000000zJKjQAM;Medical"
      }
   ]
}