Employment Details

Detailed mapping of the fields used in the employment details object, for a given subscriber

Here is an enumeration of the Required Fields and their use-cases:

Ideon	Usage and Mapping
start_date	This field is used to express an employment start date. This is the most recent employment start date. To express an original or historic employment start date, utilize the original_start_date field.
status	This is the current employment status of the member. Enumeration: active active_military_overseas active_military_usa full_time leave_of_absence part_time retired terminated Consult Ideon on how your system stores this data and what options are relevant to your implementation

Additionally, there are Conditionally Required elements listed within Employment Details. These might be required for specific group policies with complex structures.

Ideon	Usage and Mapping
end_date	This is the more recent employment end date for a member. Use this in conjunction with the status value of terminated This is required alongside election-level end_dates, to terminate coverage for an Employee and Covered Family.
retirement_date	This is the date on which the employee retired. This is required if using retirement status and adminstering coverage for retiree members.
annual_earnings	This is the amount a member earns at their employment. This is a base salary, or annual calculation of hourly wages. The value is expressed in cents (100000 = $1,000.00). Validation: cannot be greater than 9999999999 Required for salary-based elections.
wage_frequency	This is the payment schedule/cadence for a given employee. Required when classifications are based on wage frequency and assignments are not provided per member. Enumeration: weekly biweekly semimonthly monthly daily annually hourly quarterly semiannually unknown
hours_per_week	This is the number of weekly scheduled/worked hours for a given employee. Required when classifications are based on hours worked and assignments are not provided per member.
compensation	This is the number of weekly scheduled/worked hours for a given employee. Required when classifications are based on hours worked and assignments are not provided per member. Enumeration: hourly salary
work_state	This field is used to note the state where the member legally works, for eligiblty purposes. This could differ from their residential state.
original_start_date	To express an original or historic employment start date, utilize the original_start_date field. This information is useful for identification of re-hired employees.
title	This field can be used to express the job title for a given employee. Where required by the carrier, Ideon can use full or partial matching to these titles to assign Employment Classifications.
benefit_salary benefit_salary_effective_date base_salary base_salary_effective_date	Alongside the annual_earnings field, you can provide these more specific salary amounts. These are used when a salary-based benefit amount is elected, but that benefit is based on a different salary than the annual_earnings
employee_identifier	This is an optional field, which can store an identifier that originates at the Employer. Certain employers and carriers could request to use a non-social security number identifier for their enrollment transmission.