The table below summarizes the most essential elements of a Selerix Transmittal XML involved with a BenSelect enrollment integration as described in Web Services Basic Instructions. Information in the table reflects the structure of the transmittal XML.
|
Root Element Name |
Child Element Name |
Child Element Name |
Child Element Name |
Type |
Examples/Notes |
|
SenderID |
GUID |
New ID generated at runtime. |
|||
|
PortfolioID |
GUID |
ID from Portfolio Report that identifies the enrollment group. |
|||
|
Type |
TransmittalType |
Defines how BenSelect will interpret the transmittal; the purpose. See reference. |
|||
|
Group |
Class |
Note that a Group container must exist in the output XML even if none of the members of the Group are populated. If absent, BenSelect returns an error. |
|||
|
Applicants |
Collection |
Employee(s) and dependent(s) applicants. |
|||
|
Applicant |
|
Class |
Serialized representation of a single applicant. |
||
|
Relationship |
Enumeration |
Employee, Spouse, Child, etc.. See reference. |
|||
|
ID |
GUID |
Value used to relate employee with dependents. Set to same value for all applicants in the family. |
|||
|
EmployeeIdent |
String |
Option 1 identifies the employee to enroll. Same as EID in the Employees page of the BenSelect administration site. |
|||
|
SSN |
String |
Option 2 identifies the employee to enroll. |
|||
|
FirstName |
String |
Option 3 identifies the employee to enroll. All members of option 3 must be included. |
|||
|
LastName |
String |
Option 3 identifies the employee to enroll. |
|||
|
BirthDate |
DateTime |
Option 3 identifies the employee to enroll. Employee's date of birth. |
|||
|
Employment |
|
Class |
Structure representing a class. Only applies when applicant Relationship is employee. |
||
|
Department |
String |
Employee's department (required). |
|||
|
HireDate |
DateTime |
Employee's date of hire (required). |
|||
|
JobClass |
String |
Employee's job class (required). |
|||
|
Location |
String |
Employee's location (required). |
|||
|
DeductionFrequency |
Int32 |
Any of these values may be required by enrollment rules. Check with your group administrator or Selerix to see if required.
This list is just a sample of commonly required fields. |
|||
|
EligibilityDate |
DateTime |
||||
|
HoursPerWeek |
Int32 |
||||
|
PayGroup |
String |
||||
|
PayrollFrequency |
Int32 |
||||
|
Salary |
Double |
||||
|
Address |
|
Class |
Applicant address. Refer to Address class reference for complete member list. |
||
|
Line1 . . . |
String |
Line1, Line2, City, State, Zip etc.. |
|||
|
Applicant |
|
Class |
Sample applicant showing required dependent fields (Spouse, Child, etc.). |
||
|
Relationship |
Enumeration |
Employee, Spouse, Child, etc. |
|||
|
DependentNumber |
Int32 |
Uniquely identifies the dependent in the family. Typically spouse is set to '1', first child set to '2', and so forth. |
|||
|
EmployeeID |
String |
Required. Must match value assigned to the employee's 'ID'. |
|||
|
EmployeeIdent |
String |
If assigned, must match value assigned to the employee's 'EmployeeIdent'. |
|||
|
FirstName . . . |
String |
Other members such as FirstName, LastName, BirthDate, etc. Refer to Applicant class reference for complete member list. |
|||
|
Agents |
|
|
Collection |
List of Agents. Usually not required on cases that are built for enrollment integrations in other applications. |
|
|
Agent |
|
Class |
Serialized representation of a single Agent. |
||
|
FirstName . . . |
String |
Other members such as FirstName, LastName, Address, StateLicenses, Organization, Split, etc. Refer to Agent class reference for complete member list. |
|||
|
etc. . . . |
Refer to the Transmittal reference for a complete list of members. Serialized XML structure mirrors class structure. |
||||