Administrative APIs | REST

Version:
Download Open API Specification

Update Account

https://api.wealthcare.com/system/Services/Employee/Account/{tpaId}/{employerId}/{employeeId}

This operation is used to update information for a specified benefit account.

  • tpaId string Required

    A unique identifier used to identify your admin instance. This value was system generated with the admin instance was created.

  • employerId string Required

    Unique identifier for the employer. Note: When the employer was created, WealthCare Admin assigned the 3-character prefix; you assigned the remaining characters.

  • employeeId string Required

    Unique identifier for the employee.

  • api-version string Required

    The requested API version

  • OverridePrefundedAmount string

    This field sets the prefunded amount on the account directly, and regardless of the values of any other field in this request. Note: This field is only for prefunded plan types and is ignored on payroll, HSA, and HRX/DTR plan types.

  • GracePeriodDeductibleStatus integer <int32>

    Update the deductible status for the grace period.  0 - No deductible 1 - Deductible not met 2 - Deductible met 4 - No deductible limited Note: Flagging the deductible as met during the prior year’s grace period also updates the deductible met status for the current year.

  • GracePeriodDeductibleMetDate string <date-time>

    Must be populated when grace period deductible status is ‘2’ (deductible met) Date entered must be within the plan grace period dates Note: Flagging the deductible as met during the prior year’s grace period also updates the deductible met status for the current year.

  • CardholderAccountStatus enum<string>

    Activity status of the account. 1 = New 2 = Active 3 = Temporarily Inactive 4 = Permanently Inactive 5 = Terminated

    Possible values: All New Active TempInactive PermInactive Terminated Enrollment
  • AccountTypeCode string

    Three character abbreviation that indicates the type of account (FSA, DCA, TRN, HRA, etc.)

  • EmployeeElection number <double>

    Amount to be contributed by the employee automatically via the auto-deposit cycle. 0.00 is a valid amount.

  • EmployeeSocialSecurityNumber string

    Employee’s social security number. This field is used to identify the employee and is not changed within this method.

    Min Length: 0
    Max Length: 9
  • EmployerElection number <double>

    Amount to be contributed by the employer automatically via the auto-deposit cycle. 0.00 is a valid amount.

  • PlanId string

    Unique identifier that distinguishes this plan from all others you administer.

    Min Length: 0
    Max Length: 18
  • PlanYearEndDate string <date-time>

    (YYYMMDD)Date after which services are not eligible for payment, unless there is an extension in the field.

  • PlanYearStartDate string <date-time>

    (YYYMMDD)Date that funds are available for services.

  • StartAutoDepositDate string <date-time>

    The auto deposit start date for this plan. Can be set for future start dates but not past. Note: If the flex account is setup for Auto Deposit, than this field is required. Otherwise, if a date is supplied then the user receives a warning.

  • EffectiveDate string <date-time>

    YYYYMMDD. Date upon which the employee is eligible to elect benefits.

  • TerminationDate string <date-time>

    YYYYMMDD. Date upon which the employee's account is no longer eligible for benefits. Date must be after employee Account Effective date.

  • ESignatureDate string <date-time>

    Date the E-signature was received by the Administrator.

  • ESignatureCode string

    Esignature code.

  • CoverageTierId string

    For Plans with Coverage Tiers enabled: If you do not provide a value for this field or if this field is not included on your template, then the Coverage Tier ID will default to the Coverage Tier specified as the default at the plan level. If a value is provided and it is a valid Coverage Tier ID within the Coverage Tier Type set for the plan, then the coverage tier is set for the participant’s account

  • IndividualBalanceMax number <double>

    This amount indicates the maximum balance that is allowed for the Individual Amount within the participant’s account after funds have been rolled from another account into this account. The Fund Rollover amount will be limited such that the Individual amount balance after funds have rolled into this account does not exceed the Fund Rollover Individual Balance Max specified. Only set for individual amount in an Individual/Family HRA account.

  • RolloverBalanceMax number <double>

    This amount indicates the maximum balance that is allowed in a Participant’s account after funds have been rolled from another account into this account. The Fund Rollover amount will be limited such that the balance after funds have rolled into this account does not exceed the Fund Rollover Balance Max specified. For example, a participant's balance is $600 in the target account and the Fund Rollover Balance Max is set to $1000. If the source fund has $750 of eligible funds to roll into this account, the rollover amount will be limited to $400 rather than rolling the full $750 so that the balance in the participant's account to which funds are being rolled is $1000. This amount is also used for the family amount in an Individual/Family HRA account.

  • AutoDepositCalendarId string

    If the value provided is: 0= No calendar. This participant will not be assigned to a payroll calendar and no corresponding auto-deposits are made. A valid Calendar ID = WCA assigns specified Calendar ID to the participant. Note: Calendar must be one allowed by the Employer as setup in the User Interface (UI) calendar employer filter section. Blank = Participant inherits the default calendar as specified for the plan. If the plan’s Default Calendar ID is changed then this participant's Calendar ID is updated. Note: To have the employee account always use the plan default calendar, leave this field blank.

    Min Length: 0
    Max Length: 50
  • StartFixedEmployerFundingDate string <date-time>

    Date to begin fixed employer funding for the employee account. Only used if Fixed Employer Funding enabled for the plan and the funding is periodic (rather than upon account creation). If blank, and a funding calendar is setup, it will default to the greater of current date or plan year start date. If you need to allow for a catch up deposit set the date equal to the first deposit you wish to occur. WCA will update the date following each auto deposit to the deposit date + 1. If blank and a calendar is not setup, WCA defaults the value to funding the single deposit to the night of the account.

  • ClaimsCrossoverOptIn integer <int32>

    If plan is setup to allow claims cross over auto pay, this field specifies the default opt in value when assigning employees to benefit accounts.0 = Opt Out (Default) 1 = Opt In Note 1: If not specified, then the employee will be assigned the plan default setting for Claims Crossover Opt-In Note 2: If the 'bypass the values sent in IC record file/employee account SOAP for new enrollments and updates' option is enabled on the admin options page in WCA, values for auto-reimbursement and autopay preferences are always ignored for new enrollment and updates.

  • Deductible integer <int32>

    0 = No Deductible 1 = Deductible Not Met (Default) 2 = Deductible Met Note: “No Deductible” can be used in conjunction with the WCA Deductible Manager feature. Use this to indicate the employee's deductible shouldn't be tracked by WCA. This will wipe out any deductible accumulations calculated by the participant and cannot be undone. Note 2: If using Deductible Manager, then only values of “0” or “1” can be specified. “1” would indicate to continue to allow WCA to track the deductible, while “0” would remove deductible accumulation.

  • FlexAcctId string

    A unique identifier for the employee's account, generated by WCA when the account was first set up.

  • Reenroll boolean

    This field is used when you want the employee to reenroll into a new account of the same Account Type Code, Plan ID, and Plan Start and End dates. The values to use are:False = (Default) Not to reenroll True = To Reenroll A new employee account will be created for the employee with a unique Account ID. The account effective dates must not overlap with the existing account.

  • AutoReimbursementSetting integer <int32>

    Use this field to indicate the auto pay provider reimbursement setting on the employee account If not specified, and enrolling the participant into a plan using Auto Provider Pay, the employee will automatically inherit the default setting specified on the Benefit Plan. 0 = Pay Me (Default) 1 = Pay Provider

  • EmployeeAnnualElection number <double>

    Employee annual election

  • EmployerAnnualElection number <double>

    Employer annual election

  • ProductId string

    The Product ID can only be specified for the employee account if the Product Partner allows Product IDs to be setup at the account level. If a Product ID is provided and the Product Partner does not allow product IDs to be set at account level, then an error should be provided “Cannot set Product ID at account level for this account type.”

  • SuspendDebitCardActivity boolean

    Suspends debit card activity when there are ineligible/pending transactions 0 = False (Do not suspend debit card activity)

  • AccountSegmentID string

    The account segment ID you wish to assign to the account.

  • DeductibleMetDte string <date-time>

    The date the deductible was met.

  • ExtensionData object
  • TpaId string

    A unique identifier for your administrator instance, generated by WCA when the instance was first set up. If a value is not sent, the TPA ID from the user making the request with be used.

  • EmployerId string

    Unique identifier for the employer. Note: When the employer was created, WealthCare Admin assigned the 3-character prefix; you assigned the remaining characters.

  • EmployeeId string

    Unique identifier for the employee.

    Min Length: 0
    Max Length: 30