Update employee details
The Update Employee Details API is used to update an employee's demographic information
-
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.
-
participantId string Required
Participant Id
-
Accept-Language enum<string>
Specify the participant’s language preference. The corresponding response will then return text/string values in the language specified, defaulting to English if not specified or if an invalid value is sent. Note: If Spanish or French is requested and a particular field does not have a translated value (Spanish or French), then the English text value will be returned.
Possible values:es
en
fr
-
decrypt integer <int32>
Indicate if the URI parameters are encrypted or not. 1: encrypted, 0: decrypted, default to 0.
-
LanguagePreference string
-
CarrierName string
The name of the employee’s medical insurance carrier.
-
MedicalDed number <double>
The annual deductible for this employee’s medical insurance.
-
MedicalDedPtd number <double>
The amount the employee has paid toward his deductible in the current plan year.
-
BankAcctValStatus integer <int32>
If Direct Deposit Bank Account doesn't exist for the Employee, then 0 will be returned. If the Direct Deposit Bank Account Validation feature is Not Enabled for the TPA and a Direct Deposit Bank Account exists, then 2 will be returned. If the Direct Deposit Bank Account Validation feature is Enabled for the TPA and a Direct Deposit Bank Account exists, then a value ranging from 1 to 7 will be returned.
-
BankAcctValStatusDesc string
If Direct Deposit Bank Account doesn't exist for the Employee, then status description will be blank. If the Direct Deposit Bank Account Validation feature is Not Enabled for the TPA and a Direct Deposit Bank Account exists, then Active will be returned. If the Direct Deposit Bank Account Validation feature is Enabled for the TPA and a Direct Deposit Bank Account exists, then the status description will be returned as follows: 1 - New; 2 - Active; 3 - Temporarily Inactive; 4 - Permanently Inactive; 5 - Pending Validation; 6 - Validation Required; 7 - Validation Failed
-
Prefix string
Title for employee, such as Mr., Mrs., Ms., Dr., or Rev
-
LastName string
Employee’s last name.
-
FirstName string
Employee’s first name.
-
MiddleInitial string
Employee’s middle initial.
-
Phone string
Employee’s phone number, including area code.
-
MobileNumber string
Employee’s mobile phone number including area code.
-
AddressLine1 string
First line of the employee’s mailing address.
-
AddressLine2 string
Second line of the employee’s mailing address.
-
City string
City associated with the employee’s mailing address.
-
State string
Two-character state code associated with the employee’s mailing address.
-
Zip string
ZIP code associated with the employee’s mailing address.
-
Country string
Country associated with the employee’s mailing address, usually US.
-
ReimbursementMethod enum<string>
Reimbursement Method for reimbursing an employee or dependent.
Possible values:Undefined
None
Check
DirectDeposit
ExternalCheck
ExternalDirectDeposit
Card
Payroll
-
Email string
Employee’s email address.
-
UserDefinedField string
You can define this field. WCA does not use it.
-
EmployeeStatus enum<string>
Activity status for the employee.
Possible values:All
New
Active
TempInactive
PermInactive
Terminated
Enrollment
-
Gender enum<string>Possible values:
None
Male
Female
-
MaritalStatus enum<string>
Marital status of the employee.
Possible values:None
Single
Married
Separated
Widowed
Divorced
-
ShippingAddressLine1 string
First line of the employee’s shipping address.
-
ShippingAddressLine2 string
Second line of the employee’s shipping address.
-
ShippingAddressCity string
City associated with an employee’s shipping address.
-
ShippingAddressState string
The 2-character state code associated with the employee’s shipping address.
-
ShippingAddressZip string
ZIP code associated with the employee’s shipping address.
-
ShippingAddressCountry string
Country associated with the employee’s shipping address.
-
BirthDate string
Employee's Date of birth.
-
BankRoutingNumber string
Bank Routing number of employee direct deposit account.
-
BankAccountNumber string
Employee's bank account number for direct deposit reimbursements.
-
BankAccountTypeCode enum<string>
Employee's bank account type.
Possible values:None
Checking
Savings
GeneralLedger
-
BankName string
Bank Name of employee direct deposit account.
-
Remarks string
Any comments about the employee. Note: This is field is for information only.
-
EmployeeSSN string
Employee’s social security number.
-
HealthPlanID string
An assigned ID for the employee’s health plan. Note: You can use this field for TPS matching but cannot use it to search for an employee.
-
DentalID string
An assigned ID for the employee’s dental plan. Note: You can use this field for TPS matching but cannot use it to search for an employee.
-
VisionID string
An assigned ID for the employee’s vision plan. Note: You can use this field for TPS matching but cannot use it to search for an employee.
-
PBMID string
An assigned ID for the pharmacy benefits management (PBM) organization handling pharmaceutical benefits for employees. Note: You can use this field for TPS matching but cannot use it to search for an employee.
-
EligibilityDate string
Date when the employee was hired.
-
LastUpdated string <date-time>
Last date the employee demographic data was modified.
-
CardNumber string
Benefits Card number of the employee.
-
TerminationDate string
Employee's Date of Termination.
-
Division string
Division to which employee is assigned, if division functionality is in use.
-
EmployerName string
Name of employer for whom employee works.
-
HealthcareCoverageDefault string
Coverage ID that is associated with an employee’s primary Healthcare Coverage. The employee will be linked to all healthcare coverage types—Medical, Pharmacy, Dental, Hospital, and Vision and/or Hearing copays—associated with this Healthcare Coverage option.
-
MedicalCoverage string
Coverage ID that is associated with the Medical Coverage type and links the employee to the copays for this coverage type.
-
PharmacyCoverage string
Coverage ID that is associated with the Pharmacy Coverage type and links the employee to the copays for this coverage type.
-
DentalCoverage string
Coverage ID that is associated with the Dental Coverage type and links the employee to the copays for this coverage type. Note 1: Providing a Coverage ID for Dental Coverage takes priority over the default Healthcare Coverage for this type. Note 2: The Coverage ID is required in order for employee-level co-pay amounts to be associated with this particular coverage.
-
HospitalCoverage string
Coverage ID that is associated with the Hospital Coverage type and links the employee to the copays for this coverage type.
-
VisionCoverage string
Coverage ID that is associated with the Vision Coverage type and links the employee to the copays for this coverage type.
-
HearingCoverage string
Coverage ID that is associated with the Hearing. Coverage type and links the employee to the copays for this coverage type.
-
HighDeductableHealthPlanEligible boolean
Flag indicating whether the employee is eligible for an High Deductible Health Plan. 0 = No 1 = Yes
-
DriverLicenceNumber string
Employee Driver’s License Number.
-
MotherMaidenName string
Employee's mother’s maiden name.
-
MedicareBeneficiary enum<string>
Indicates participant as a Medicare beneficiary.
Possible values:None
PrimaryBeneficiary
SecondaryBeneficiary
-
MedicareID string
This value is the active covered individual’s/beneficiary’s health insurance claim number.
-
ProcessingNotes string
This is the processing notes entered by the administrator for the specified individual.
-
PersonCode string
This code is used to identify specific individuals on a policy for Medicare Reporting. The values are established by the insurer. May also be known as a Dependent Code.
-
EndStageRenalDisease boolean
Indicates whether the participant has ESRD for Medicare Reporting. 0 = No, this person does not have ESRD 1 = Yes, this person has ESRD
-
CardReimbAvail boolean
If the Employer is eligible for Card and has got a CRA Plan, then True, Otherwise False.
-
ReimbursementMethodList array <object>
List of available reimbursement methods for employee to choose.
-
ReimbursementMethod enum<string>Possible values:
Undefined
None
Check
DirectDeposit
ExternalCheck
ExternalDirectDeposit
Card
Payroll
-
Description string
-
-
Prefix string
-
LastName string
-
FirstName string
-
MiddleInitial string
-
Phone string
-
MobileNumber string
-
AddressLine1 string
-
AddressLine2 string
-
City string
-
State string
-
Zip string
-
Country string
-
ReimbursementMethod enum<string>Possible values:
Undefined
None
Check
DirectDeposit
ExternalCheck
ExternalDirectDeposit
Card
Payroll
-
Email string
-
UserDefinedField string
-
EmployeeStatus enum<string>Possible values:
All
New
Active
TempInactive
PermInactive
Terminated
Enrollment
-
Gender enum<string>Possible values:
None
Male
Female
-
MaritalStatus enum<string>Possible values:
None
Single
Married
Separated
Widowed
Divorced
-
ShippingAddressLine1 string
-
ShippingAddressLine2 string
-
ShippingAddressCity string
-
ShippingAddressState string
-
ShippingAddressZip string
-
ShippingAddressCountry string
-
BirthDate string
-
BankAccountTypeCode enum<string>Possible values:
None
Checking
Savings
GeneralLedger
-
BankName string
-
Remarks string
-
EmployeeSSN string
-
HealthPlanID string
-
DentalID string
-
VisionID string
-
PBMID string
-
EligibilityDate string
-
LastUpdated string <date-time>
-
CardNumber string
-
TerminationDate string
-
Division string
-
EmployerName string
-
HealthcareCoverageDefault string
-
MedicalCoverage string
-
PharmacyCoverage string
-
DentalCoverage string
-
HospitalCoverage string
-
VisionCoverage string
-
HearingCoverage string
-
HighDeductableHealthPlanEligible boolean
-
DriverLicenceNumber string
-
MotherMaidenName string
-
MedicareBeneficiary enum<string>Possible values:
None
PrimaryBeneficiary
SecondaryBeneficiary
-
MedicareID string
-
ProcessingNotes string
-
PersonCode string
-
EndStageRenalDisease boolean
-
CardReimbAvail boolean
-
ReimbursementMethodList array <object>
-
ReimbursementMethod enum<string>Possible values:
Undefined
None
Check
DirectDeposit
ExternalCheck
ExternalDirectDeposit
Card
Payroll
-
Description string
-
-
BankAcctValStatus integer <int32>
-
BankAcctValStatusDesc string
-
LanguagePreference string
-
BankAccountNumberLastDigits string
-
BankRoutingNumberLastDigits string