Update Employee

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

This is used to update an employee's information

Path parameters

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.

Request body

ValidateEmployeeAccount boolean

If a direct deposit account is being added, use this field to indicate if you want micro-deposit validation to trigger. The micro-deposit validation will only occur if your administrator has this feature enabled. If the feature is not enabled or if this is not sent/sent as false, the employee bank account will be available immediately for use. 0 – False, do not validate (default). 1 – True, validate.
CarrierName string

The name of the employee’s medical insurance carrier.
MedicalDeductible number <double>

The annual deductible for this employee’s medical insurance
MedicalDeductiblePTD number <double>

The amount the employee has paid toward his deductible in the current plan year.

Address1 string

First line of the employee’s mailing address.

Min Length:	0
Max Length:	55

Address2 string

Second line of the employee’s mailing address

Min Length:	0
Max Length:	55

BankAccount string

Employee bank account number for direct deposit reimbursements. This field can be included in a direct deposit file exported from the system. Due to NACHA requirements, if using direct deposit do not enter a value greater than 17 characters. If ReimbursementCode is set to DirectDeposit than this field is required.

Min Length:	0
Max Length:	17

BankAccountTypeCode enum<string>

Indicates what type of account BankAccount is. Cannot be None if ReimbursementCode is set to Direct Deposit.

Possible values: None Checking Savings GeneralLedger

BankRoutingNumber string

Employee's bank account routing number for direct deposit reimbursements. This field can be included in a direct deposit file exported from the system. If ReimbursementCode is set to DirectDeposit than this field is required.

Min Length:	0
Max Length:	9

BirthDate string <date-time>

Date of birth for the employee. Birth Date is not required for creating new employees, but is required prior to an employee enrolling in an HSA.

City string

City associated with employee’s mailing address.

Min Length:	0
Max Length:	30

Country string

US is the only valid option. Please contact us if you intend to send to any international address.

Min Length:	0
Max Length:	3

CurrentEmployeeSocialSecurityNumber string

This field is not currently used by this operation.

Min Length:	0
Max Length:	9

EmployeeId string

This field is not currently used by this operation. The employee ID sent in the request path will be used for processing.

Min Length:	0
Max Length:	30

EmailAddress string

Employee’s email address. Email addresses are automatically converted by WCA to all lowercase.

Min Length:	0
Max Length:	75

EmployeeMaritalStatus enum<string>

The employee's marital status.

Possible values: None Single Married Separated Widowed Divorced
EmployeeStatus enum<string>

Status of the employee.

Possible values: New Active TempInactive PermInactive Terminated Enrollment

EmployerId string

this field is not currently used. The employer ID on the request path will be used for processing.

Min Length:	0
Max Length:	18

FirstName string

Employee’s first name. Allowable characters are alphanumeric (a-z, A-Z, 0-9), Special characters - comma (,), period (.), dash (-), ampersand (&), single apostrophe ('), and space ( ).

Min Length:	0
Max Length:	50

Gender enum<string>

Employee's gender

Possible values: None Male Female

LastName string

Employee’s last name. Allowable characters are alphanumeric (a-z, A-Z, 0-9), Special characters - comma (,), period (.), dash (-), ampersand (&), single apostrophe ('), and space ( ).

Min Length:	0
Max Length:	50

MiddleInitial string

Employee’s middle initial. Allowable characters are alphanumeric (a-z, A-Z, 0-9), Special characters - comma (,), period (.), dash (-), ampersand (&), single apostrophe ('), and space ( ).

Min Length:	0
Max Length:	1

NamePrefix string

Title for the employee, such as Mr., Mrs., Dr., Rev, etc

Min Length:	0
Max Length:	5

NewEmployeeId string

Employee’s new employee ID, used as a unique identifier for the employee

Min Length:	0
Max Length:	30

NewEmployeeSocialSecurityNumber string

Employee’s new social security number. Leave empty unless the employee’s SSN needs to be replaced.

Min Length:	0
Max Length:	9

Phone string

Employee’s phone number including area code.

Min Length:	0
Max Length:	30

ReimbursementCode enum<string>

Sets the employee's default reimbursement method. Note 1: Check printing normally occurs in the administrator's application and not in WCA. This typically should be set to None. Note 2: If no value is passed (blank/null), or this field is not supplied in the request; the employee's reimbursement method is not changed.

Possible values: None Check DirectDeposit ExternalCheck ExternalDirectDeposit Card

Remarks string

Any comments about the employee. This is field is for information only and is not used in any WCA processing.

Min Length:	0
Max Length:	1400

ShippingAddress1 string

Employee’s card shipping address line 1 if different from the mailing address

Min Length:	0
Max Length:	55

ShippingAddress2 string

Employee’s card shipping address line 2 if different from the mailing address

Min Length:	0
Max Length:	55

ShippingCity string

Employee’s card shipping address city if different from the mailing address

Min Length:	0
Max Length:	30

ShippingCountry string

Employee’s card shipping address country if different from the mailing address

Min Length:	0
Max Length:	3

ShippingState string

Employee’s card shipping address state if different from the mailing address
ShippingZipCode string

Employee’s card shipping address zip code if different from the mailing address
State string

State code for the employee's mailing address.
TpaId string

This field is not used. The TpaId sent on the request path will be used for processing.

UserDefinedField string

Field defined by administrator user. Not used by WCA

Min Length:	0
Max Length:	50

ZipCode string

Zip code of the employee's mailing address
CardDesignId string

For future use. Card design will currently always be payment.
EligibilityDate 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 dependent Account Effective date
DriverLicense string

The employee’s drivers license number.
MaidenName string

The employee's mother’s maiden name.
EmailCommunicationOptions enum<string>

An enum indicating what email communications the employee is opted into. A 0 indicates an opt-out of all messages.

Possible values: Manual Claim Entered Participant Shipping Address Change Participant Email Address Change Participant Direct Deposit Change Participant Portal Password Change Participant Billing Address Change Card Mailed Card Lost/Stolen Card Transaction Denied Account Balance Alert Account Deductible Met Run Out Date Reminder Year-End Reminder Grace Period Reminder Balance Statement Alert User ID Change Participant Claim Entry Deposit Received HSA Online Statement Enrollee Welcome Email Email Communication Template Completed HSA Payment Failed HSAPayment Card Transaction Approved Reimbursement Processed Partner Welcome Email Partner Billing Address Change Partner Shipping Address Change Partner Employee Email Address Change Partner Password Change Partner User ID Change Partner HSA Online Statement Partner Deposit Received Partner External Account Updated Partner Email Communication Template Partner IRS Contribution Limit Partner Account Closed Partner Account Re-Associated Partner Online Enrollment All Communications

ProcessingNotes string

Notes entered for the employee to be used by claims processors

Min Length:	0
Max Length:	500

MobileNum string

Employee's mobile phone number, including area code

Min Length:	0
Max Length:	19

SMSCommunicationOptions enum<string>

An enum indicating what mobile communications the employee is opted into. A 0 indicates an opt-out of all messages.

Possible values: Manual Claim Entered Participant Shipping Address Change Participant Email Address Change Participant Direct Deposit Change Participant Portal Password Change Participant Billing Address Change Card Mailed Card Lost/Stolen Card Transaction Denied Account Balance Alert Account Deductible Met Run Out Date Reminder Year-End Reminder Grace Period Reminder Balance Statement Alert User ID Change Participant Claim Entry Deposit Received HSA Online Statement Enrollee Welcome Email Email Communication Template Completed HSA Payment Failed HSAPayment Card Transaction Approved Reimbursement Processed Partner Welcome Email Partner Billing Address Change Partner Shipping Address Change Partner Employee Email Address Change Partner Password Change Partner User ID Change Partner HSA Online Statement Partner Deposit Received Partner External Account Updated Partner Email Communication Template Partner IRS Contribution Limit Partner Account Closed Partner Account Re-Associated Partner Online Enrollment All Communications

BankAcctName string

Direct Deposit Bank Account Name

Min Length:	0
Max Length:	50

EmployeeMarketplaceGUID string

Used to identify the participant on the WealthCare Marketplace platform.

HealthPlanId string

An assigned ID for the employee’s health plan. You can use this field for TPS matching but cannot use it to search for an employee.

Min Length:	0
Max Length:	30

PbmId string

An assigned ID for the pharmacy benefits management (PBM) organization handling pharmaceutical benefits for employees. You can use this field for TPS matching but cannot use it to search for an employee.

Min Length:	0
Max Length:	30

AlternateId string

The employee’s Alternate ID

Min Length:	0
Max Length:	20

UserDefinedField2 string