Note: Product enrollment business rules defined on the BenSelect case may dictate additional data field requirements. Check with the person who configures the BenSelect enrollment to see if any additional data is required.
Developers must supply the following bare minimum information to successfully establish a BenSelect enrollment session:
- Employee Identification Fields. Your transmittal XML must contain at least one of the following to identify the employee:
- SSN - Although the employee's social security number may be used, the options below are preferred for privacy reasons
- EmployeeIdent - this is the same as the Employee ID field under the Employment tab on the BenSelect administration site
- FirstName or LastName and BirthDate - A combination of these employee data elements may be used if preferred
- Employment Fields. The architecture of BenSelect dictates all of the following fields must be included in the transmittal XML. These are free form text fields and differ depending on how the enrollment case is setup. This case specific information is included in the Portfolio Summary Report.
- Department - The employee's work site department
- HireDate - The employee's date of hire
- JobClass - The job class associated with the employee
- Location - The employee's work site location
* Orange text in the sample XML below highlights values that differ by case and applicant. These are the values you supply.
<?xml version="1.0" encoding="utf-8"?>
<Transmittal xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" SenderID="b35fe33c-3365-4d22-8ab1-18a3ca76f06b" Type="UploadApplicants" PortfolioID="87902a63-3ef7-43fa-ada2-d9c9c9b4e0fe">
<Group />
<Applicants>
<Applicant ID="13579BD" UniqueID="b0a947fd-87bb-4996-a702-7c95f8b496b9">
<SSN />
<FirstName>Douglas</FirstName>
<LastName>Fir</LastName>
<Sex>Unknown</Sex>
<LegalStatus>Employee</LegalStatus>
<Relationship>Employee</Relationship>
<BirthDate>1980-01-15T00:00:00</BirthDate>
<Employment>
<HireDate>2012-01-01T00:00:00</HireDate>
<Title>Integration Engineer</Title>
<Department>Product Development</Department>
<Location>JAX</Location>
<JobClass>Salary</JobClass>
</Employment>
</Applicant>
</Applicants>
</Transmittal>
See Also