patchInsuranceUpdateCensus(updateCensusInputParam, contractId)

Update a group census from policy enrollments and endorsements on an existing group benefits contract.

68.0

No

public static ConnectApi.InsuranceRefreshCensusRepresentation patchInsuranceUpdateCensus(ConnectApi.InsuranceRefreshCensusInputRepresentation updateCensusInputParam, String contractId)

updateCensusInputParam

contractId

  • Type: String
  • ID of the insurance contract whose policy enrollments and endorsements are used to update the group census.

Type: ConnectApi.InsuranceRefreshCensusRepresentation

Use this method to update a group census from policy enrollments and endorsements on an existing group benefits contract. Specify the contract in contractId and the census in groupCensusId. Set startDate and endDate in yyyy-MM-dd format to define the enrollment and endorsement window. Set policyEffectiveDate in the same format to select the policy version. The date must fall between the version’s effectiveFromDate and effectiveToDate.

This method runs asynchronously and returns a requestId that you can use to track the job. To retry a failed run, pass that requestId with the same groupCensusId.

Use filter to limit the update to root contract group plans, contacts, or person accounts. Set shouldGenerateCSV to create a CSV file of the updated census details. Set shouldIncludeMemberPlans to include insurance plan details for each member. To stamp additional field values on group census members, add items to groupCensusAdditionalFields.

Check isSuccess, groupCensusId, and requestId on the response. Errors are in the errors property.

This example starts updating a group census from a contract for a date range, filters by person account, stamps an additional census field, and includes member plan details and a CSV file.