| EN field path | Type | Req | Description / enum |
|---|---|---|---|
| (root) | |||
planIdentifier | string | ✓ | The unique identifier assigned for the purpose of identifying a plan. This value is the key used to link a plan between the two systems and how we will communicate about the plan. A plan is a set of benefit of rates and should not include billing groups. |
configuration | PlanConfiguration | ✓ | |
| configuration | |||
configuration.policyNumber | string | Value assigned to the plan for the specific company | |
configuration.carrierName | string | ||
configuration.planName | string | ||
configuration.startDate | string | ✓ | Effective date representing the most recent plan year start date for the current set of benefits and rates. Our plans couple benefits and rates together. |
configuration.endDate | string | Effective date representing the plan year end date for the current set of benefits and rates. Typically plans are 12-month plan years, unless policy is Issue Age and rates do not change. | |
configuration.nextRenewalDate | string | Effective date of coverage for next annual open enrollment. | |
configuration.carrierPlanCode | string | Specifies a plan code assigned by the carrier to identify a plan. This value would be returned with the enrollment record. | |
configuration.carrierPlanTypeCode | string | Specifies a plan code assigned by the carrier to identify the plan type. This value would be returned with the enrollment record. | |
configuration.planBillOption | string | Unspecified, SelfBill, ListBill | |
configuration.isSelfFunded | boolean | ||
configuration.situsState | string | The state in which the legal, organizational entity exists or originated. Send the State Name or the 2-character ISO abbreviation. Either value will be accepted. | |
configuration.benefit | string | ✓ | Medical, Dental, Vision, Life, ADAndD, VoluntaryLife, VoluntaryADAndD, ShortTermDisability, VoluntaryShortTermDisability, LongTermDisability, VoluntaryLongTermDisability, Prescription, CriticalIllness, HospitalIndemnity, PermanentLife, Tricare, IdentityProtection, LaboratoryServices, Legal, SupplementalMedical, Accident, Cancer, Telemedicine |
configuration.originalPlanStartDate | string | Date the plan initially began between the carrier and group. | |
configuration.carrierPlanTypeDescription | string | A carrier-defined standardized description that categorizes plans based on common characteristics. For example, medical plans may be categorized as HMO, PPO, etc.; dental plans as DHMO, etc. Note that this description is limited to 150 characters. | |
| (root) | |||
planDependencies | GroupADAndD.GroupADAndDPlanDependencies | ||
| planDependencies | |||
planDependencies.benefitEnrollmentDependency | GroupADAndD.GroupADAndDPlanBenefitEnrollmentDependency | ||
planDependencies.benefitEnrollmentDependency.enrollmentBenefit | string | ✓ | The pre-defined benefit category a plan may be dependent upon. · Life |
| (root) | |||
eligibilityOptions | array of PlanEligibilityOptions | ||
| eligibilityOptions | |||
eligibilityOptions.groupStructure | PlanEligibilityGroupStructure | ||
eligibilityOptions.groupStructure.eligibilityGroups | array of PlanEligibilityGroup | A list of employee categorizations mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.groupStructure.eligibilityGroups.eligibilityGroupCode | string | A carrier-assigned, unique identifier for an employee categorization mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.eligibilityRules | PlanEligibilityRules | ||
eligibilityOptions.eligibilityRules.waitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.waitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.waitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.entryDateRule | string | Used in conjunction with Waiting Period to define when the coverage is effective after the waiting period for a new employee. Use First of the Month Coinciding With or After rule when waiting period ending on the first of the month has entry on that day. Use First of the Month After when waiting period ending on the first of the month has entry on the first of the next month. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.terminationRule | string | Used to define the last day of coverage on loss of eligibility. · Unspecified, EndOfMonthOfTermination, EmploymentTermination, FirstOfMonthAfterEmploymentTermination | |
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehirePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.rehirePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.rehirePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehireEntryDateRule | string | Used in conjunction with Rehire Period to define when coverage is effective after rehire date for employees rehired within the rehire period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.eligibilityChangeEntryDateRule | string | Used in conjunction with Eligibility Change Waiting Period to define when the coverage is effective after the employee becomes eligible after a classification change and completes waiting period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
| (root) | |||
planCommunications | PlanCommunications | ||
| planCommunications | |||
planCommunications.marketingDescription | string | Customizes the employee enrollment experience with marketing information about the benefits of the plan. | |
planCommunications.benefitSummaryUrl | string | Customizes the employee enrollment experience with a URL hosting the benefit summary. | |
| (root) | |||
options | GroupLife.OptionsType | ||
| options | |||
options.employeeOptions | EmployeePlanOptions | ||
options.employeeOptions.ageIneligible | integer | Age member is no longer eligible to be covered under plan. | |
options.employeeOptions.allowOverageContinuation | boolean | Provision enabling member to remain enrolled in plan when reaching ageIneligible. | |
options.employeeOptions.requiresAgeRestriction | boolean | Indicates whether the plan requires member level age rules to be configured placing limitations on when a member would be eligible for coverage. | |
options.supplementalOptions | GroupLife.SupplementalOptions | ||
options.supplementalOptions.captureBeneficiary | boolean | ||
| (root) | |||
benefits | array of GroupADAndD.Benefit | ||
| benefits | |||
benefits.groupStructure | PlanEligibilityGroupStructure | ||
benefits.groupStructure.eligibilityGroups | array of PlanEligibilityGroup | A list of employee categorizations mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
benefits.groupStructure.eligibilityGroups.eligibilityGroupCode | string | A carrier-assigned, unique identifier for an employee categorization mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
benefits.options | GroupLife.BenefitOptions | ||
benefits.options.salaryRedeterminationOn | string | Specifies when salary changes update benefit amount. · Unspecified, FirstOfFollowingMonth, FirstOfSpecifiedMonth, DayOfChange | |
benefits.options.salaryRedeterminationMonth | string | Identifies the month when salary changes are to be applied when salary redetermination option is specified as FirstOfSpecfiedMonth. If used in conjunction with ageBandChangesMonth, that value will drive both age and salary changes. · Unspecified, January, February, March, April, May, June, July, August, September, October, November, December | |
benefits.options.ageReductionOptions | GroupLife.AgeReductionOptions | ||
benefits.options.ageReductionOptions.ageReductionsBasedOnPreviousBenefit | boolean | Choose this when the percent of reduction is based on the latest benefit, which may have already been reduced. Do not choose this when the percent of reduction is based on the original benefit amount. | |
benefits.options.ageReductionOptions.ageReductionReduceOn | string | Specifies when to apply reduction age band changes · Unspecified, FirstOfMonthFollowing, FirstOfSpecifiedMonth, Birthday | |
benefits.options.ageReductionOptions.ageReductionChangeMonth | string | Identifies the month when to apply reductions when the AgeReductionReduceOn option is specified as FirstOfSpecifiedMonth · Unspecified, January, February, March, April, May, June, July, August, September, October, November, December | |
benefits.options.ageReductionOptions.roundingType | string | Used in conjunction with roundingIncrement, rounding method used for age-reduced benefit. · Unspecified, Up, Down, Nearest | |
benefits.options.ageReductionOptions.roundingIncrement | string | Used in conjunction with roundingType, specifies to what closest increment the reduced benefit amount should be rounded. · Unspecified, OneThousandDollars, OneHundredDollars, TenDollars, OneDollar, FiftyDollars, OneCent, FiveHundredDollars, FiveThousandDollars, TenThousandDollars | |
benefits.options.autoEnrollAllEligibleEmployees | boolean | An indicator to auto create enrollment records - sometimes referred to as census enrollment - for employees who are eligible but not yet enrolled for products that are non-contributory and do not require an employee to make an election. | |
benefits.options.requiresEmployeeEnrollment | boolean | Indicates that any employee, even those added in the future (new hires/newly eligible), must enroll into the plan when this field is set to true. For non-contributory employer paid plans, be sure and set this field to true the underwriters / actuaries set a rate based on the risk associated with both employees and dependents being enrolled. | |
benefits.employee | GroupLife.EmployeeBenefit | ||
benefits.employee.benefitClassCode | string | Carrier code assigned to the employee benefit class. Commonly used when carrier assigns different codes for employee, spouse, and child benefits. | |
benefits.employee.benefitDescription | string | Optional benefit description assigned by the carrier describing the benefit. | |
benefits.employee.flatBenefit | GroupLife.FlatBenefitType | ||
benefits.employee.flatBenefit.amount | number | Benefit amount | |
benefits.employee.multipleOfEarningsBenefit | GroupLife.MultipleEarningsType | ||
benefits.employee.multipleOfEarningsBenefit.multipleOfEarnings | number | The highest multiplier to be applied to an employee's earnings. For example, if the plan supports 1X, 2X, or 3X earnings, then set the multipleOfEarnings field value to 3. | |
benefits.employee.multipleOfEarningsBenefit.minimumBenefit | number | Minimum benefit amount | |
benefits.employee.multipleOfEarningsBenefit.maximumBenefit | number | Maximum benefit amount | |
benefits.employee.multipleOfEarningsBenefit.roundingType | string | Used in conjunction with RoundingIncrement, rounding method for multiple of earnings. · Unspecified, Up, Down, Nearest | |
benefits.employee.multipleOfEarningsBenefit.roundingIncrement | string | Used in conjunction with RoundingType to designate rounding specificity. · Unspecified, OneThousandDollars, OneHundredDollars, TenDollars, OneDollar, FiftyDollars, OneCent, FiveHundredDollars, FiveThousandDollars, TenThousandDollars | |
benefits.employee.multipleOfEarningsBenefit.benefitAmountAdjustment | number | The flat amount to be added to or subtracted from the employee’s multiple earnings benefits. For added to the amount should be a positive amount and subtracted from the amount should be a negative amount. | |
benefits.employee.ageReductions | GroupLife.AgeReductions | ||
benefits.employee.ageReductions.reductions | array of BenefitReduction | Schedule of reductions as a percent of benefit which occur upon attaining a specific age. | |
benefits.employee.ageReductions.reductions.atAge | integer | ✓ | Age benefit is reduced. |
benefits.employee.ageReductions.reductions.reducedByPercent | number | ✓ | Amount benefit is reduced by as a percent. Not an amount reduced to. |
benefits.details | GroupLife.BenefitDetails | ||
benefits.details.conditionsOrExclusions | string | Describes the details and definition of any pre-existing condition exclusions which may impose limitations on benefit payment. | |
| (root) | |||
guaranteedIssue | GroupLife.GuaranteedIssueType | ||
| guaranteedIssue | |||
guaranteedIssue.requiresEvidenceOfInsurability | boolean | Plan has a guaranteed issue benefit and offers additional coverage upon meeting evidence of insurability underwriting requirements. | |
guaranteedIssue.employee | GroupLife.GuaranteedIssueEmployeeOptions | ||
guaranteedIssue.employee.initialAmount | GroupLife.GuaranteedIssueAmountType | ||
guaranteedIssue.employee.initialAmount.amount | number | Flat amount | |
guaranteedIssue.employee.initialAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.employee.lateEntrantAmount | GroupLife.GuaranteedIssueAmountType | ||
guaranteedIssue.employee.lateEntrantAmount.amount | number | Flat amount | |
guaranteedIssue.employee.lateEntrantAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.employee.existingAmount | GroupLife.GuaranteedIssueExistingType | ||
guaranteedIssue.employee.existingAmount.flatAmount | GroupLife.GuaranteedIssueAmountType | ||
guaranteedIssue.employee.existingAmount.flatAmount.amount | number | Flat amount | |
guaranteedIssue.employee.existingAmount.flatAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.employee.existingAmount.increaseAmount | GroupLife.GuaranteedIssueIncreaseAmountType | ||
guaranteedIssue.employee.existingAmount.increaseAmount.increaseBy | number | Amount an existing benefit can be increased by without requiring additional underwriting. | |
guaranteedIssue.employee.existingAmount.increaseAmount.maximumAmount | number | Used in conjunction with IncreaseBy amount, an optional maximum flat amount serving as a guaranteed issue limit. | |
guaranteedIssue.employee.reductions | GroupLife.GuaranteedIssueReductions | ||
guaranteedIssue.employee.reductions.reductionAmounts | array of GroupLife.GuaranteedIssueReduction | ||
guaranteedIssue.employee.reductions.reductionAmounts.atAge | integer | ✓ | Age benefit is reduced. |
guaranteedIssue.employee.reductions.reductionAmounts.amount | number | ✓ | Amount guaranteed issue is reduced to. |
| (root) | |||
rates | GroupADAndD.Rating | ||
| rates | |||
rates.options | GroupLife.RateOptions | ||
rates.options.annualPolicyFee | number | An annual fee added to the total cost for each policy. Annual fee is applied to both the employee and the spouse policy. | |
rates.bandedRates | GroupLife.BandedRating | ||
rates.bandedRates.genderBasedRates | GenderBasedRates | ||
rates.bandedRates.genderBasedRates.rateMale | number | ✓ | |
rates.bandedRates.genderBasedRates.rateFemale | number | ✓ | |
rates.bandedRates.tobaccoBasedRates | TobaccoBasedRates | ||
rates.bandedRates.tobaccoBasedRates.rateNonsmoker | number | ✓ | |
rates.bandedRates.tobaccoBasedRates.rateSmoker | number | ✓ | |
rates.bandedRates.genderAndTobaccoBasedRates | GenderAndTobaccoBasedRates | ||
rates.bandedRates.genderAndTobaccoBasedRates.rateMaleNonsmoker | number | ✓ | |
rates.bandedRates.genderAndTobaccoBasedRates.rateFemaleNonsmoker | number | ✓ | |
rates.bandedRates.genderAndTobaccoBasedRates.rateMaleSmoker | number | ✓ | |
rates.bandedRates.genderAndTobaccoBasedRates.rateFemaleSmoker | number | ✓ | |
rates.compositeRate | GroupLife.CompositeRating | ||
rates.compositeRate.rate | number | ✓ | |
| (root) | |||
contributions | GroupADAndD.Contribution | ||
| contributions | |||
contributions.contributionGroupings | array of GroupADAndD.ContributionGrouping | ✓ | A list of monthly contributions by a specified contribution grouping (e.g., everyone, by class, by department). |
contributions.contributionGroupings.contributionGroupingBasedOn | string | The textual description of what the specified contribution grouping is based on. | |
contributions.contributionGroupings.monthlyContributions | GroupADAndD.MonthlyContribution | ✓ | |
contributions.contributionGroupings.monthlyContributions.contributionBasis | string | ✓ | Defines whether the contribution is based on what the employee or employer will pay to cover the cost of the plan. · Unspecified, Employer, Employee |
contributions.contributionGroupings.monthlyContributions.contributionType | string | ✓ | Defines whether the contribution is represented as a percent or a flat dollar amount. · Unspecified, Percentage, BenefitAmount |
contributions.contributionGroupings.monthlyContributions.contribution | number | ✓ | The actual amount or percent that an employee or employee will pay to cover the cost of the plan. |
| EN field path | Type | Req | Description / enum |
|---|---|---|---|
| (root) | |||
planIdentifier | string | ✓ | The unique identifier assigned for the purpose of identifying a plan. This value is the key used to link a plan between the two systems and how we will communicate about the plan. A plan is a set of benefit of rates and should not include billing groups. |
configuration | PlanConfiguration | ✓ | |
| configuration | |||
configuration.policyNumber | string | Value assigned to the plan for the specific company | |
configuration.carrierName | string | ||
configuration.planName | string | ||
configuration.startDate | string | ✓ | Effective date representing the most recent plan year start date for the current set of benefits and rates. Our plans couple benefits and rates together. |
configuration.endDate | string | Effective date representing the plan year end date for the current set of benefits and rates. Typically plans are 12-month plan years, unless policy is Issue Age and rates do not change. | |
configuration.nextRenewalDate | string | Effective date of coverage for next annual open enrollment. | |
configuration.carrierPlanCode | string | Specifies a plan code assigned by the carrier to identify a plan. This value would be returned with the enrollment record. | |
configuration.carrierPlanTypeCode | string | Specifies a plan code assigned by the carrier to identify the plan type. This value would be returned with the enrollment record. | |
configuration.planBillOption | string | Unspecified, SelfBill, ListBill | |
configuration.isSelfFunded | boolean | ||
configuration.situsState | string | The state in which the legal, organizational entity exists or originated. Send the State Name or the 2-character ISO abbreviation. Either value will be accepted. | |
configuration.benefit | string | ✓ | Medical, Dental, Vision, Life, ADAndD, VoluntaryLife, VoluntaryADAndD, ShortTermDisability, VoluntaryShortTermDisability, LongTermDisability, VoluntaryLongTermDisability, Prescription, CriticalIllness, HospitalIndemnity, PermanentLife, Tricare, IdentityProtection, LaboratoryServices, Legal, SupplementalMedical, Accident, Cancer, Telemedicine |
configuration.originalPlanStartDate | string | Date the plan initially began between the carrier and group. | |
configuration.carrierPlanTypeDescription | string | A carrier-defined standardized description that categorizes plans based on common characteristics. For example, medical plans may be categorized as HMO, PPO, etc.; dental plans as DHMO, etc. Note that this description is limited to 150 characters. | |
| (root) | |||
planDependencies | VoluntaryADandD.VoluntaryADandDPlanDependencies | ||
| planDependencies | |||
planDependencies.benefitEnrollmentDependency | VoluntaryADandD.VoluntaryADandDPlanBenefitEnrollmentDependency | ||
planDependencies.benefitEnrollmentDependency.enrollmentBenefit | string | ✓ | The pre-defined benefit category a plan may be dependent upon. · VoluntaryLife |
| (root) | |||
eligibilityOptions | array of PlanEligibilityOptions | ||
| eligibilityOptions | |||
eligibilityOptions.groupStructure | PlanEligibilityGroupStructure | ||
eligibilityOptions.groupStructure.eligibilityGroups | array of PlanEligibilityGroup | A list of employee categorizations mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.groupStructure.eligibilityGroups.eligibilityGroupCode | string | A carrier-assigned, unique identifier for an employee categorization mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.eligibilityRules | PlanEligibilityRules | ||
eligibilityOptions.eligibilityRules.waitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.waitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.waitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.entryDateRule | string | Used in conjunction with Waiting Period to define when the coverage is effective after the waiting period for a new employee. Use First of the Month Coinciding With or After rule when waiting period ending on the first of the month has entry on that day. Use First of the Month After when waiting period ending on the first of the month has entry on the first of the next month. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.terminationRule | string | Used to define the last day of coverage on loss of eligibility. · Unspecified, EndOfMonthOfTermination, EmploymentTermination, FirstOfMonthAfterEmploymentTermination | |
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehirePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.rehirePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.rehirePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehireEntryDateRule | string | Used in conjunction with Rehire Period to define when coverage is effective after rehire date for employees rehired within the rehire period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.eligibilityChangeEntryDateRule | string | Used in conjunction with Eligibility Change Waiting Period to define when the coverage is effective after the employee becomes eligible after a classification change and completes waiting period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
| (root) | |||
planCommunications | PlanCommunications | ||
| planCommunications | |||
planCommunications.marketingDescription | string | Customizes the employee enrollment experience with marketing information about the benefits of the plan. | |
planCommunications.benefitSummaryUrl | string | Customizes the employee enrollment experience with a URL hosting the benefit summary. | |
| (root) | |||
options | VoluntaryLife.OptionsType | ||
| options | |||
options.employeeOptions | VoluntaryLife.EmployeePlanOptions | ||
options.employeeOptions.ageIneligible | integer | Age member is no longer eligible to be covered under plan. | |
options.employeeOptions.allowOverageContinuation | boolean | Provision enabling member to remain enrolled in plan when reaching ageIneligible. | |
options.employeeOptions.initialEntrantGracePeriod | integer | The length of time an employee has to enroll after their eligibility date for their original eligible entry date to be honored. E.g. If an employee is eligible on 10/1 and enrolls on 10/13, a 30-day grace period would honor 10/1 as their coverage start date. If no grace period is specified, the employee’s coverage will begin on the date of enrollment, 10/13. | |
options.employeeOptions.requiresAgeRestriction | boolean | Indicates whether the plan requires member level age rules to be configured placing limitations on when a member would be eligible for coverage. | |
options.supplementalOptions | VoluntaryLife.SupplementalOptions | ||
options.supplementalOptions.captureBeneficiary | boolean | Specifies that beneficiary designation should be collected upon enrollment. | |
| (root) | |||
dependentOptions | VoluntaryLife.DependentOptionsType | ||
| dependentOptions | |||
dependentOptions.spouseOptions | VoluntaryLife.DependentSpouseOptionsType | ||
dependentOptions.spouseOptions.ageIneligible | integer | Age member is no longer eligible to be covered under plan. | |
dependentOptions.spouseOptions.allowOverageContinuation | boolean | Provision enabling member to remain enrolled in plan when reaching ageIneligible. | |
dependentOptions.spouseOptions.requiresAgeRestriction | boolean | Indicates whether the plan requires member level age rules to be configured placing limitations on when a member would be eligible for coverage. | |
dependentOptions.childOptions | VoluntaryLife.DependentChildOptionsType | ||
dependentOptions.childOptions.ageIneligible | integer | Age non-student dependent child is no longer eligible. | |
dependentOptions.childOptions.studentAgeIneligible | integer | Age student child is no longer eligible to be covered under the plan. | |
dependentOptions.childOptions.dropOverageChildOn | string | Used in conjunction with AgeIneligible and StudentAgeIneligible, specifies the last day of coverage when a child becomes ineligible due to age. · Unspecified, EndOfMonth, Birthday, EndOfPlan, EndOfCalendarYear | |
dependentOptions.childOptions.minimumAge | integer | Age dependent child is too young to be covered under benefit. | |
dependentOptions.childOptions.minimumAgeType | string | Used in conjunction with minimumAge, specifies how minimumAge is measured. · Unspecified, Days, Months, Years | |
| (root) | |||
benefits | array of VoluntaryLife.Benefit | ||
| benefits | |||
benefits.groupStructure | PlanEligibilityGroupStructure | ||
benefits.groupStructure.eligibilityGroups | array of PlanEligibilityGroup | A list of employee categorizations mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
benefits.groupStructure.eligibilityGroups.eligibilityGroupCode | string | A carrier-assigned, unique identifier for an employee categorization mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
benefits.options | VoluntaryLife.BenefitOptions | ||
benefits.options.ageReductionOptions | VoluntaryLife.AgeReductionOptions | ||
benefits.options.ageReductionOptions.ageReductionsBasedOnPreviousBenefit | boolean | Choose this when the percent of reduction is based on the latest benefit, which may have already been reduced. Do not choose this when the percent of reduction is based on the original benefit amount. | |
benefits.options.ageReductionOptions.ageReductionReduceOn | string | Specifies when to apply reduction age band changes · Unspecified, FirstOfMonthFollowing, FirstOfSpecifiedMonth, Birthday | |
benefits.options.ageReductionOptions.ageReductionChangeMonth | string | Identifies the month when to apply reductions when the AgeReductionReduceOn option is specified as FirstOfSpecifiedMonth · Unspecified, January, February, March, April, May, June, July, August, September, October, November, December | |
benefits.options.ageReductionOptions.roundingType | string | Used in conjunction with roundingIncrement, rounding method used for age-reduced benefit. · Unspecified, Up, Down, Nearest | |
benefits.options.ageReductionOptions.roundingIncrement | string | Used in conjunction with roundingType, specifies to what closest increment the reduced benefit amount should be rounded. · Unspecified, OneThousandDollars, OneHundredDollars, TenDollars, OneDollar, FiftyDollars, OneCent, FiveHundredDollars, FiveThousandDollars, TenThousandDollars | |
benefits.employee | VoluntaryLife.EmployeeBenefit | ||
benefits.employee.benefitClassCode | string | Carrier code assigned to the employee benefit class. Commonly used when carrier assigns different codes for employee, spouse, and child benefits. | |
benefits.employee.benefitDescription | string | Optional benefit description assigned by the carrier describing the benefit. | |
benefits.employee.multiplesOfEarningsBenefit | VoluntaryLife.MultiplesOfEarningsType | ||
benefits.employee.multiplesOfEarningsBenefit.multiplesOfEarnings | number | The highest multiplier to be applied to an employee's earnings. For example, if the plan supports 1X, 2X, or 3X earnings, then set the multipleOfEarnings field value to 3. | |
benefits.employee.multiplesOfEarningsBenefit.minimumBenefit | number | Minimum benefit amount | |
benefits.employee.multiplesOfEarningsBenefit.maximumBenefit | number | Maximum benefit amount | |
benefits.employee.multiplesOfEarningsBenefit.roundingType | string | Rounding method for multiple of earnings in thousands. · Unspecified, Up, Down, Nearest | |
benefits.employee.incrementsBenefit | VoluntaryLife.IncrementsMultipleEarningsMaximumType | ||
benefits.employee.incrementsBenefit.increments | array | Benefit amount as a list of available increments. Minimum and maximum benefit do not need to be provided. Minimum will be calculated to the lowest increment. Maximum benefit will be calculated to the highest increment. | |
benefits.employee.incrementsBenefit.maximumMultipleOfEarnings | number | Maximum benefit amount as a multiple of earnings | |
benefits.employee.incrementsBenefit.roundingType | string | Rounding method for maximum multiple of earnings in thousands. · Unspecified, Up, Down | |
benefits.employee.ageReductions | VoluntaryLife.AgeReductions | ||
benefits.employee.ageReductions.reductions | array of BenefitReduction | Schedule of reductions as a percent of benefit which occur upon attaining a specific age. | |
benefits.employee.ageReductions.reductions.atAge | integer | ✓ | Age benefit is reduced. |
benefits.employee.ageReductions.reductions.reducedByPercent | number | ✓ | Amount benefit is reduced by as a percent. Not an amount reduced to. |
benefits.spouse | VoluntaryLife.SpouseBenefit | ||
benefits.spouse.benefitClassCode | string | Carrier code assigned to the spouse benefit class. Commonly used when carrier assigns different codes for employee, spouse, and child benefits | |
benefits.spouse.benefitDescription | string | Optional benefit description assigned by the carrier describing the spouse benefit. | |
benefits.spouse.incrementsBenefit | VoluntaryLife.IncrementsMaxPercentEmployeeType | ||
benefits.spouse.incrementsBenefit.increments | array | Benefit amount as a list of available increments. Minimum and maximum benefit do not need to be provided. Minimum will be calculated to the lowest increment. Maximum benefit will be calculated to the highest increment. | |
benefits.spouse.incrementsBenefit.maximumPercentOfEmployeeElection | integer | Maximum benefit as a percent of employee benefit amount. | |
benefits.spouse.percentBenefit | VoluntaryLife.PercentOfEmployeeBenefitType | ||
benefits.spouse.percentBenefit.percentOfEmployeeElection | number | Benefit as a percent of employee election. | |
benefits.spouse.percentBenefit.minimumBenefit | number | Minimum benefit amount | |
benefits.spouse.percentBenefit.maximumBenefit | number | Maximum benefit amount | |
benefits.spouse.ageReductions | VoluntaryLife.AgeReductions | ||
benefits.spouse.ageReductions.reductions | array of BenefitReduction | Schedule of reductions as a percent of benefit which occur upon attaining a specific age. | |
benefits.spouse.ageReductions.reductions.atAge | integer | ✓ | Age benefit is reduced. |
benefits.spouse.ageReductions.reductions.reducedByPercent | number | ✓ | Amount benefit is reduced by as a percent. Not an amount reduced to. |
benefits.spouse.options | VoluntaryLife.SpouseBenefitOptions | ||
benefits.spouse.options.spouseReductionsBasedOnEmployeeAge | boolean | When benefits are reduced based on age, this determines when spouse benefit reductions are calculated based on the employee age. | |
benefits.child | VoluntaryLife.ChildBenefit | ||
benefits.child.benefitClassCode | string | Carrier code assigned to the child benefit class. Commonly used when carrier assigns different codes for employee, spouse, and child benefits. | |
benefits.child.benefitDescription | string | Optional benefit description assigned by the carrier describing the child benefit. | |
benefits.child.incrementsBenefit | VoluntaryLife.IncrementsMaxPercentEmployeeType | ||
benefits.child.incrementsBenefit.increments | array | Benefit amount as a list of available increments. Minimum and maximum benefit do not need to be provided. Minimum will be calculated to the lowest increment. Maximum benefit will be calculated to the highest increment. | |
benefits.child.incrementsBenefit.maximumPercentOfEmployeeElection | integer | Maximum benefit as a percent of employee benefit amount. | |
benefits.child.percentBenefit | VoluntaryLife.PercentOfEmployeeBenefitType | ||
benefits.child.percentBenefit.percentOfEmployeeElection | number | Benefit as a percent of employee election. | |
benefits.child.percentBenefit.minimumBenefit | number | Minimum benefit amount | |
benefits.child.percentBenefit.maximumBenefit | number | Maximum benefit amount | |
benefits.child.flatBenefit | VoluntaryLife.FlatAmountType | ||
benefits.child.flatBenefit.amount | number | Benefit amount | |
benefits.details | VoluntaryLife.BenefitDetails | ||
benefits.details.conditionsOrExclusions | string | Describes the details and definition of any pre-existing condition exclusions which may impose limitations on benefit payment. | |
| (root) | |||
guaranteedIssue | VoluntaryLife.GuaranteedIssueType | ||
| guaranteedIssue | |||
guaranteedIssue.employee | VoluntaryLife.GuaranteedIssueEmployeeOptions | ||
guaranteedIssue.employee.initialAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.employee.initialAmount.amount | number | Flat amount | |
guaranteedIssue.employee.initialAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.employee.lateEntrantAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.employee.lateEntrantAmount.amount | number | Flat amount | |
guaranteedIssue.employee.lateEntrantAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.employee.existingAmount | VoluntaryLife.GuaranteedIssueExistingType | ||
guaranteedIssue.employee.existingAmount.flatAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.employee.existingAmount.flatAmount.amount | number | Flat amount | |
guaranteedIssue.employee.existingAmount.flatAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.employee.existingAmount.increaseAmount | VoluntaryLife.GuaranteedIssueIncreaseAmountType | ||
guaranteedIssue.employee.existingAmount.increaseAmount.increaseBy | number | Amount an existing benefit can be increased by without requiring additional underwriting. | |
guaranteedIssue.employee.existingAmount.increaseAmount.maximumAmount | number | Used in conjunction with IncreaseBy amount, an optional maximum flat amount serving as a guaranteed issue limit. | |
guaranteedIssue.employee.reductions | VoluntaryLife.GuaranteedIssueReductions | ||
guaranteedIssue.employee.reductions.reductionAmounts | array of VoluntaryLife.GuaranteedIssueReduction | ||
guaranteedIssue.employee.reductions.reductionAmounts.atAge | integer | ✓ | Age benefit is reduced. |
guaranteedIssue.employee.reductions.reductionAmounts.amount | number | ✓ | Amount guaranteed issue is reduced to. |
guaranteedIssue.spouse | VoluntaryLife.GuaranteedIssueSpouseOptions | ||
guaranteedIssue.spouse.initialAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.spouse.initialAmount.amount | number | Flat amount | |
guaranteedIssue.spouse.initialAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.spouse.lateEntrantAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.spouse.lateEntrantAmount.amount | number | Flat amount | |
guaranteedIssue.spouse.lateEntrantAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.spouse.existingAmount | VoluntaryLife.GuaranteedIssueExistingType | ||
guaranteedIssue.spouse.existingAmount.flatAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.spouse.existingAmount.flatAmount.amount | number | Flat amount | |
guaranteedIssue.spouse.existingAmount.flatAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.spouse.existingAmount.increaseAmount | VoluntaryLife.GuaranteedIssueIncreaseAmountType | ||
guaranteedIssue.spouse.existingAmount.increaseAmount.increaseBy | number | Amount an existing benefit can be increased by without requiring additional underwriting. | |
guaranteedIssue.spouse.existingAmount.increaseAmount.maximumAmount | number | Used in conjunction with IncreaseBy amount, an optional maximum flat amount serving as a guaranteed issue limit. | |
guaranteedIssue.spouse.reductions | VoluntaryLife.GuaranteedIssueReductions | ||
guaranteedIssue.spouse.reductions.reductionAmounts | array of VoluntaryLife.GuaranteedIssueReduction | ||
guaranteedIssue.spouse.reductions.reductionAmounts.atAge | integer | ✓ | Age benefit is reduced. |
guaranteedIssue.spouse.reductions.reductionAmounts.amount | number | ✓ | Amount guaranteed issue is reduced to. |
guaranteedIssue.child | VoluntaryLife.GuaranteedIssueChildOptions | ||
guaranteedIssue.child.initialAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.child.initialAmount.amount | number | Flat amount | |
guaranteedIssue.child.initialAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.child.lateEntrantAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.child.lateEntrantAmount.amount | number | Flat amount | |
guaranteedIssue.child.lateEntrantAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.child.existingAmount | VoluntaryLife.GuaranteedIssueExistingType | ||
guaranteedIssue.child.existingAmount.flatAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.child.existingAmount.flatAmount.amount | number | Flat amount | |
guaranteedIssue.child.existingAmount.flatAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.child.existingAmount.increaseAmount | VoluntaryLife.GuaranteedIssueIncreaseAmountType | ||
guaranteedIssue.child.existingAmount.increaseAmount.increaseBy | number | Amount an existing benefit can be increased by without requiring additional underwriting. | |
guaranteedIssue.child.existingAmount.increaseAmount.maximumAmount | number | Used in conjunction with IncreaseBy amount, an optional maximum flat amount serving as a guaranteed issue limit. | |
guaranteedIssue.requiresEvidenceOfInsurability | boolean | Plan has a guaranteed issue benefit and offers additional coverage upon meeting evidence of insurability underwriting requirements. | |
| (root) | |||
rates | VoluntaryLife.VolADAndDRating | ||
| rates | |||
rates.options | VoluntaryLife.RateInitialEntrantAgeOptionsVolADAndDRateOptionsType | ||
rates.options.annualPolicyFee | number | An annual fee added to the total cost for each policy. Annual fee is applied to both the employee and the spouse policy. | |
rates.options.rateInitialEntrantAgeOn | string | Rate initial entrant according to age on selected option. · Unspecified, CalculatedEligibilityDate, PriorPolicyAnniversary | |
rates.options.ageBandChangeUpdateOn | string | Specifies when to update rate upon age band change. · Unspecified, FirstOfMonthFollowing, FirstOfSpecifiedMonth, Birthday | |
rates.options.ageBandChangesMonth | string | Identifies the month when rate changes are to be applied when the age band change option is specified as FirstOfSpecifiedMonth. · Unspecified, January, February, March, April, May, June, July, August, September, October, November, December | |
rates.employee | VoluntaryLife.VolADAndDEmployeeRating | ||
rates.employee.compositeRates | VoluntaryLife.CompositeRating | ||
rates.employee.compositeRates.tierRates | array of VoluntaryLife.CompositeRateType | ||
rates.employee.compositeRates.tierRates.tier | string | ✓ | Unspecified, Employee, EmployeePlusFamily |
rates.employee.compositeRates.tierRates.rate | number | ✓ | Monthly rate |
rates.employee.ageBasedRates | VoluntaryLife.VolADAndDAgeBasedRating | ||
rates.employee.ageBasedRates.rates | array of AgeBandedRate | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.employee.ageBasedRates.rates.fromAge | integer | ✓ | |
rates.employee.ageBasedRates.rates.toAge | integer | ✓ | |
rates.employee.ageBasedRates.rates.rate | number | ✓ | |
rates.spouse | VoluntaryLife.VolADAndDSpouseRating | ||
rates.spouse.ageBasedRates | VoluntaryLife.VolADAndDSpouseAgeBasedRating | ||
rates.spouse.ageBasedRates.options | VoluntaryLife.SpouseAgeBasedOptionsType | ||
rates.spouse.ageBasedRates.options.spouseRatedOnEmployeeAge | boolean | When rates are based on age, this determines when spouse rates are calculated based on the employee age. | |
rates.spouse.ageBasedRates.rates | array of AgeBandedRate | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.spouse.ageBasedRates.rates.fromAge | integer | ✓ | |
rates.spouse.ageBasedRates.rates.toAge | integer | ✓ | |
rates.spouse.ageBasedRates.rates.rate | number | ✓ | |
rates.child | VoluntaryLife.ChildRating | ||
rates.child.options | VoluntaryLife.ChildRateOptionsType | ||
rates.child.options.childRatesBasedOnAllChildren | boolean | This specifies when the same rate is applied regardless of the number of covered children. When each child is assessed their own rates, the plan does not use All Children rates. | |
rates.child.flatRate | VoluntaryLife.ChildFlatRating | ||
rates.child.flatRate.rate | number | ||
rates.child.benefitBasedRates | VoluntaryLife.ChildBenefitBasedRating | ||
rates.child.benefitBasedRates.rates | array of VoluntaryLife.ChildBenefitRateType | ||
rates.child.benefitBasedRates.rates.benefitIncrement | number | ✓ | |
rates.child.benefitBasedRates.rates.rate | number | ✓ | |
| (root) | |||
contributions | VoluntaryLife.Contribution | ||
| contributions | |||
contributions.contributionGroupings | array of VoluntaryLife.ContributionGrouping | ✓ | A list of monthly contributions by a specified contribution grouping (e.g., everyone, by class, by department). |
contributions.contributionGroupings.contributionGroupingBasedOn | string | The textual description of what the specified contribution grouping is based on. | |
contributions.contributionGroupings.monthlyContributions | array of VoluntaryLife.MonthlyContributions | ✓ | A list of the monthly plan contributions. |
contributions.contributionGroupings.monthlyContributions.memberType | string | ✓ | Defines the universal level of member types covered by the plan based on the selected plan benefit type. · Unspecified, Employee, Spouse, Child |
contributions.contributionGroupings.monthlyContributions.contributionBasis | string | ✓ | Defines whether the contribution is based on what the employee or employer will pay to cover the cost of the plan. · Unspecified, Employer, Employee |
contributions.contributionGroupings.monthlyContributions.contributionType | string | ✓ | Defines whether the contribution is represented as a percent or a flat dollar amount. · Unspecified, Percentage, BenefitAmount |
contributions.contributionGroupings.monthlyContributions.contribution | number | ✓ | The actual amount or percent that an employee or employee will pay to cover the cost of the plan. |
| EN field path | Type | Req | Description / enum |
|---|---|---|---|
| (root) | |||
planIdentifier | string | ✓ | The unique identifier assigned for the purpose of identifying a plan. This value is the key used to link a plan between the two systems and how we will communicate about the plan. A plan is a set of benefit of rates and should not include billing groups. |
configuration | PlanConfiguration | ✓ | |
| configuration | |||
configuration.policyNumber | string | Value assigned to the plan for the specific company | |
configuration.carrierName | string | ||
configuration.planName | string | ||
configuration.startDate | string | ✓ | Effective date representing the most recent plan year start date for the current set of benefits and rates. Our plans couple benefits and rates together. |
configuration.endDate | string | Effective date representing the plan year end date for the current set of benefits and rates. Typically plans are 12-month plan years, unless policy is Issue Age and rates do not change. | |
configuration.nextRenewalDate | string | Effective date of coverage for next annual open enrollment. | |
configuration.carrierPlanCode | string | Specifies a plan code assigned by the carrier to identify a plan. This value would be returned with the enrollment record. | |
configuration.carrierPlanTypeCode | string | Specifies a plan code assigned by the carrier to identify the plan type. This value would be returned with the enrollment record. | |
configuration.planBillOption | string | Unspecified, SelfBill, ListBill | |
configuration.isSelfFunded | boolean | ||
configuration.situsState | string | The state in which the legal, organizational entity exists or originated. Send the State Name or the 2-character ISO abbreviation. Either value will be accepted. | |
configuration.benefit | string | ✓ | Medical, Dental, Vision, Life, ADAndD, VoluntaryLife, VoluntaryADAndD, ShortTermDisability, VoluntaryShortTermDisability, LongTermDisability, VoluntaryLongTermDisability, Prescription, CriticalIllness, HospitalIndemnity, PermanentLife, Tricare, IdentityProtection, LaboratoryServices, Legal, SupplementalMedical, Accident, Cancer, Telemedicine |
configuration.originalPlanStartDate | string | Date the plan initially began between the carrier and group. | |
configuration.carrierPlanTypeDescription | string | A carrier-defined standardized description that categorizes plans based on common characteristics. For example, medical plans may be categorized as HMO, PPO, etc.; dental plans as DHMO, etc. Note that this description is limited to 150 characters. | |
| (root) | |||
eligibilityOptions | array of PlanEligibilityOptions | ||
| eligibilityOptions | |||
eligibilityOptions.groupStructure | PlanEligibilityGroupStructure | ||
eligibilityOptions.groupStructure.eligibilityGroups | array of PlanEligibilityGroup | A list of employee categorizations mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.groupStructure.eligibilityGroups.eligibilityGroupCode | string | A carrier-assigned, unique identifier for an employee categorization mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.eligibilityRules | PlanEligibilityRules | ||
eligibilityOptions.eligibilityRules.waitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.waitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.waitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.entryDateRule | string | Used in conjunction with Waiting Period to define when the coverage is effective after the waiting period for a new employee. Use First of the Month Coinciding With or After rule when waiting period ending on the first of the month has entry on that day. Use First of the Month After when waiting period ending on the first of the month has entry on the first of the next month. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.terminationRule | string | Used to define the last day of coverage on loss of eligibility. · Unspecified, EndOfMonthOfTermination, EmploymentTermination, FirstOfMonthAfterEmploymentTermination | |
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehirePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.rehirePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.rehirePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehireEntryDateRule | string | Used in conjunction with Rehire Period to define when coverage is effective after rehire date for employees rehired within the rehire period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.eligibilityChangeEntryDateRule | string | Used in conjunction with Eligibility Change Waiting Period to define when the coverage is effective after the employee becomes eligible after a classification change and completes waiting period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
| (root) | |||
planCommunications | PlanCommunications | ||
| planCommunications | |||
planCommunications.marketingDescription | string | Customizes the employee enrollment experience with marketing information about the benefits of the plan. | |
planCommunications.benefitSummaryUrl | string | Customizes the employee enrollment experience with a URL hosting the benefit summary. | |
| (root) | |||
options | VoluntaryLife.OptionsType | ||
| options | |||
options.employeeOptions | VoluntaryLife.EmployeePlanOptions | ||
options.employeeOptions.ageIneligible | integer | Age member is no longer eligible to be covered under plan. | |
options.employeeOptions.allowOverageContinuation | boolean | Provision enabling member to remain enrolled in plan when reaching ageIneligible. | |
options.employeeOptions.initialEntrantGracePeriod | integer | The length of time an employee has to enroll after their eligibility date for their original eligible entry date to be honored. E.g. If an employee is eligible on 10/1 and enrolls on 10/13, a 30-day grace period would honor 10/1 as their coverage start date. If no grace period is specified, the employee’s coverage will begin on the date of enrollment, 10/13. | |
options.employeeOptions.requiresAgeRestriction | boolean | Indicates whether the plan requires member level age rules to be configured placing limitations on when a member would be eligible for coverage. | |
options.supplementalOptions | VoluntaryLife.SupplementalOptions | ||
options.supplementalOptions.captureBeneficiary | boolean | Specifies that beneficiary designation should be collected upon enrollment. | |
| (root) | |||
dependentOptions | VoluntaryLife.DependentOptionsType | ||
| dependentOptions | |||
dependentOptions.spouseOptions | VoluntaryLife.DependentSpouseOptionsType | ||
dependentOptions.spouseOptions.ageIneligible | integer | Age member is no longer eligible to be covered under plan. | |
dependentOptions.spouseOptions.allowOverageContinuation | boolean | Provision enabling member to remain enrolled in plan when reaching ageIneligible. | |
dependentOptions.spouseOptions.requiresAgeRestriction | boolean | Indicates whether the plan requires member level age rules to be configured placing limitations on when a member would be eligible for coverage. | |
dependentOptions.childOptions | VoluntaryLife.DependentChildOptionsType | ||
dependentOptions.childOptions.ageIneligible | integer | Age non-student dependent child is no longer eligible. | |
dependentOptions.childOptions.studentAgeIneligible | integer | Age student child is no longer eligible to be covered under the plan. | |
dependentOptions.childOptions.dropOverageChildOn | string | Used in conjunction with AgeIneligible and StudentAgeIneligible, specifies the last day of coverage when a child becomes ineligible due to age. · Unspecified, EndOfMonth, Birthday, EndOfPlan, EndOfCalendarYear | |
dependentOptions.childOptions.minimumAge | integer | Age dependent child is too young to be covered under benefit. | |
dependentOptions.childOptions.minimumAgeType | string | Used in conjunction with minimumAge, specifies how minimumAge is measured. · Unspecified, Days, Months, Years | |
| (root) | |||
benefits | array of VoluntaryLife.Benefit | ||
| benefits | |||
benefits.groupStructure | PlanEligibilityGroupStructure | ||
benefits.groupStructure.eligibilityGroups | array of PlanEligibilityGroup | A list of employee categorizations mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
benefits.groupStructure.eligibilityGroups.eligibilityGroupCode | string | A carrier-assigned, unique identifier for an employee categorization mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
benefits.options | VoluntaryLife.BenefitOptions | ||
benefits.options.ageReductionOptions | VoluntaryLife.AgeReductionOptions | ||
benefits.options.ageReductionOptions.ageReductionsBasedOnPreviousBenefit | boolean | Choose this when the percent of reduction is based on the latest benefit, which may have already been reduced. Do not choose this when the percent of reduction is based on the original benefit amount. | |
benefits.options.ageReductionOptions.ageReductionReduceOn | string | Specifies when to apply reduction age band changes · Unspecified, FirstOfMonthFollowing, FirstOfSpecifiedMonth, Birthday | |
benefits.options.ageReductionOptions.ageReductionChangeMonth | string | Identifies the month when to apply reductions when the AgeReductionReduceOn option is specified as FirstOfSpecifiedMonth · Unspecified, January, February, March, April, May, June, July, August, September, October, November, December | |
benefits.options.ageReductionOptions.roundingType | string | Used in conjunction with roundingIncrement, rounding method used for age-reduced benefit. · Unspecified, Up, Down, Nearest | |
benefits.options.ageReductionOptions.roundingIncrement | string | Used in conjunction with roundingType, specifies to what closest increment the reduced benefit amount should be rounded. · Unspecified, OneThousandDollars, OneHundredDollars, TenDollars, OneDollar, FiftyDollars, OneCent, FiveHundredDollars, FiveThousandDollars, TenThousandDollars | |
benefits.employee | VoluntaryLife.EmployeeBenefit | ||
benefits.employee.benefitClassCode | string | Carrier code assigned to the employee benefit class. Commonly used when carrier assigns different codes for employee, spouse, and child benefits. | |
benefits.employee.benefitDescription | string | Optional benefit description assigned by the carrier describing the benefit. | |
benefits.employee.multiplesOfEarningsBenefit | VoluntaryLife.MultiplesOfEarningsType | ||
benefits.employee.multiplesOfEarningsBenefit.multiplesOfEarnings | number | The highest multiplier to be applied to an employee's earnings. For example, if the plan supports 1X, 2X, or 3X earnings, then set the multipleOfEarnings field value to 3. | |
benefits.employee.multiplesOfEarningsBenefit.minimumBenefit | number | Minimum benefit amount | |
benefits.employee.multiplesOfEarningsBenefit.maximumBenefit | number | Maximum benefit amount | |
benefits.employee.multiplesOfEarningsBenefit.roundingType | string | Rounding method for multiple of earnings in thousands. · Unspecified, Up, Down, Nearest | |
benefits.employee.incrementsBenefit | VoluntaryLife.IncrementsMultipleEarningsMaximumType | ||
benefits.employee.incrementsBenefit.increments | array | Benefit amount as a list of available increments. Minimum and maximum benefit do not need to be provided. Minimum will be calculated to the lowest increment. Maximum benefit will be calculated to the highest increment. | |
benefits.employee.incrementsBenefit.maximumMultipleOfEarnings | number | Maximum benefit amount as a multiple of earnings | |
benefits.employee.incrementsBenefit.roundingType | string | Rounding method for maximum multiple of earnings in thousands. · Unspecified, Up, Down | |
benefits.employee.ageReductions | VoluntaryLife.AgeReductions | ||
benefits.employee.ageReductions.reductions | array of BenefitReduction | Schedule of reductions as a percent of benefit which occur upon attaining a specific age. | |
benefits.employee.ageReductions.reductions.atAge | integer | ✓ | Age benefit is reduced. |
benefits.employee.ageReductions.reductions.reducedByPercent | number | ✓ | Amount benefit is reduced by as a percent. Not an amount reduced to. |
benefits.spouse | VoluntaryLife.SpouseBenefit | ||
benefits.spouse.benefitClassCode | string | Carrier code assigned to the spouse benefit class. Commonly used when carrier assigns different codes for employee, spouse, and child benefits | |
benefits.spouse.benefitDescription | string | Optional benefit description assigned by the carrier describing the spouse benefit. | |
benefits.spouse.incrementsBenefit | VoluntaryLife.IncrementsMaxPercentEmployeeType | ||
benefits.spouse.incrementsBenefit.increments | array | Benefit amount as a list of available increments. Minimum and maximum benefit do not need to be provided. Minimum will be calculated to the lowest increment. Maximum benefit will be calculated to the highest increment. | |
benefits.spouse.incrementsBenefit.maximumPercentOfEmployeeElection | integer | Maximum benefit as a percent of employee benefit amount. | |
benefits.spouse.percentBenefit | VoluntaryLife.PercentOfEmployeeBenefitType | ||
benefits.spouse.percentBenefit.percentOfEmployeeElection | number | Benefit as a percent of employee election. | |
benefits.spouse.percentBenefit.minimumBenefit | number | Minimum benefit amount | |
benefits.spouse.percentBenefit.maximumBenefit | number | Maximum benefit amount | |
benefits.spouse.ageReductions | VoluntaryLife.AgeReductions | ||
benefits.spouse.ageReductions.reductions | array of BenefitReduction | Schedule of reductions as a percent of benefit which occur upon attaining a specific age. | |
benefits.spouse.ageReductions.reductions.atAge | integer | ✓ | Age benefit is reduced. |
benefits.spouse.ageReductions.reductions.reducedByPercent | number | ✓ | Amount benefit is reduced by as a percent. Not an amount reduced to. |
benefits.spouse.options | VoluntaryLife.SpouseBenefitOptions | ||
benefits.spouse.options.spouseReductionsBasedOnEmployeeAge | boolean | When benefits are reduced based on age, this determines when spouse benefit reductions are calculated based on the employee age. | |
benefits.child | VoluntaryLife.ChildBenefit | ||
benefits.child.benefitClassCode | string | Carrier code assigned to the child benefit class. Commonly used when carrier assigns different codes for employee, spouse, and child benefits. | |
benefits.child.benefitDescription | string | Optional benefit description assigned by the carrier describing the child benefit. | |
benefits.child.incrementsBenefit | VoluntaryLife.IncrementsMaxPercentEmployeeType | ||
benefits.child.incrementsBenefit.increments | array | Benefit amount as a list of available increments. Minimum and maximum benefit do not need to be provided. Minimum will be calculated to the lowest increment. Maximum benefit will be calculated to the highest increment. | |
benefits.child.incrementsBenefit.maximumPercentOfEmployeeElection | integer | Maximum benefit as a percent of employee benefit amount. | |
benefits.child.percentBenefit | VoluntaryLife.PercentOfEmployeeBenefitType | ||
benefits.child.percentBenefit.percentOfEmployeeElection | number | Benefit as a percent of employee election. | |
benefits.child.percentBenefit.minimumBenefit | number | Minimum benefit amount | |
benefits.child.percentBenefit.maximumBenefit | number | Maximum benefit amount | |
benefits.child.flatBenefit | VoluntaryLife.FlatAmountType | ||
benefits.child.flatBenefit.amount | number | Benefit amount | |
benefits.details | VoluntaryLife.BenefitDetails | ||
benefits.details.conditionsOrExclusions | string | Describes the details and definition of any pre-existing condition exclusions which may impose limitations on benefit payment. | |
| (root) | |||
guaranteedIssue | VoluntaryLife.GuaranteedIssueType | ||
| guaranteedIssue | |||
guaranteedIssue.employee | VoluntaryLife.GuaranteedIssueEmployeeOptions | ||
guaranteedIssue.employee.initialAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.employee.initialAmount.amount | number | Flat amount | |
guaranteedIssue.employee.initialAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.employee.lateEntrantAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.employee.lateEntrantAmount.amount | number | Flat amount | |
guaranteedIssue.employee.lateEntrantAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.employee.existingAmount | VoluntaryLife.GuaranteedIssueExistingType | ||
guaranteedIssue.employee.existingAmount.flatAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.employee.existingAmount.flatAmount.amount | number | Flat amount | |
guaranteedIssue.employee.existingAmount.flatAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.employee.existingAmount.increaseAmount | VoluntaryLife.GuaranteedIssueIncreaseAmountType | ||
guaranteedIssue.employee.existingAmount.increaseAmount.increaseBy | number | Amount an existing benefit can be increased by without requiring additional underwriting. | |
guaranteedIssue.employee.existingAmount.increaseAmount.maximumAmount | number | Used in conjunction with IncreaseBy amount, an optional maximum flat amount serving as a guaranteed issue limit. | |
guaranteedIssue.employee.reductions | VoluntaryLife.GuaranteedIssueReductions | ||
guaranteedIssue.employee.reductions.reductionAmounts | array of VoluntaryLife.GuaranteedIssueReduction | ||
guaranteedIssue.employee.reductions.reductionAmounts.atAge | integer | ✓ | Age benefit is reduced. |
guaranteedIssue.employee.reductions.reductionAmounts.amount | number | ✓ | Amount guaranteed issue is reduced to. |
guaranteedIssue.spouse | VoluntaryLife.GuaranteedIssueSpouseOptions | ||
guaranteedIssue.spouse.initialAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.spouse.initialAmount.amount | number | Flat amount | |
guaranteedIssue.spouse.initialAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.spouse.lateEntrantAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.spouse.lateEntrantAmount.amount | number | Flat amount | |
guaranteedIssue.spouse.lateEntrantAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.spouse.existingAmount | VoluntaryLife.GuaranteedIssueExistingType | ||
guaranteedIssue.spouse.existingAmount.flatAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.spouse.existingAmount.flatAmount.amount | number | Flat amount | |
guaranteedIssue.spouse.existingAmount.flatAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.spouse.existingAmount.increaseAmount | VoluntaryLife.GuaranteedIssueIncreaseAmountType | ||
guaranteedIssue.spouse.existingAmount.increaseAmount.increaseBy | number | Amount an existing benefit can be increased by without requiring additional underwriting. | |
guaranteedIssue.spouse.existingAmount.increaseAmount.maximumAmount | number | Used in conjunction with IncreaseBy amount, an optional maximum flat amount serving as a guaranteed issue limit. | |
guaranteedIssue.spouse.reductions | VoluntaryLife.GuaranteedIssueReductions | ||
guaranteedIssue.spouse.reductions.reductionAmounts | array of VoluntaryLife.GuaranteedIssueReduction | ||
guaranteedIssue.spouse.reductions.reductionAmounts.atAge | integer | ✓ | Age benefit is reduced. |
guaranteedIssue.spouse.reductions.reductionAmounts.amount | number | ✓ | Amount guaranteed issue is reduced to. |
guaranteedIssue.child | VoluntaryLife.GuaranteedIssueChildOptions | ||
guaranteedIssue.child.initialAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.child.initialAmount.amount | number | Flat amount | |
guaranteedIssue.child.initialAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.child.lateEntrantAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.child.lateEntrantAmount.amount | number | Flat amount | |
guaranteedIssue.child.lateEntrantAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.child.existingAmount | VoluntaryLife.GuaranteedIssueExistingType | ||
guaranteedIssue.child.existingAmount.flatAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.child.existingAmount.flatAmount.amount | number | Flat amount | |
guaranteedIssue.child.existingAmount.flatAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.child.existingAmount.increaseAmount | VoluntaryLife.GuaranteedIssueIncreaseAmountType | ||
guaranteedIssue.child.existingAmount.increaseAmount.increaseBy | number | Amount an existing benefit can be increased by without requiring additional underwriting. | |
guaranteedIssue.child.existingAmount.increaseAmount.maximumAmount | number | Used in conjunction with IncreaseBy amount, an optional maximum flat amount serving as a guaranteed issue limit. | |
guaranteedIssue.requiresEvidenceOfInsurability | boolean | Plan has a guaranteed issue benefit and offers additional coverage upon meeting evidence of insurability underwriting requirements. | |
| (root) | |||
rates | VoluntaryLife.Rating | ||
| rates | |||
rates.options | VoluntaryLife.IssueAgeChangeRuleOptionsSimplifiedRateInitialEntrantAgeOptionsExpandedRateOptionsType | ||
rates.options.isIssueAge | boolean | An issue age policy is one in which premium is based on the age at the time the policy is issued and does not change as member ages unless a change in coverage occurs. | |
rates.options.issueAgeChangeRule | string | Rerated updates all coverage based on the age at the time of coverage change. Stacked retains the cost for the original coverage, and only calculates a new rate for the additional portion of the coverage based on the age at the time of the change. Original Issue Rated will always use the original issue age for original coverage and coverage changes. · Unspecified, ReRated, Stacked | |
rates.options.annualPolicyFee | number | An annual fee added to the total cost for each policy. Annual fee is applied to both the employee and the spouse policy. | |
rates.options.rateInitialEntrantAgeOn | string | Rate initial entrant according to age on selected option. When isIssueAge = true and issueAgeChangeRule = Stacked then all four enumerations are applicable; else only three enumerations are applicable for all other configurations (Unspecified, CalculatedEligibilityDate, PriorPolicyAnniversary). · Unspecified, CalculatedEligibilityDate, PriorPolicyAnniversary, FirstOfMonthFollowingEligibilityDate | |
rates.options.ageBandChangeUpdateOn | string | Specifies when to update rate upon age band change. · Unspecified, FirstOfMonthFollowing, FirstOfSpecifiedMonth, Birthday | |
rates.options.ageBandChangesMonth | string | Identifies the month when rate changes are to be applied when the age band change option is specified as FirstOfSpecifiedMonth. · Unspecified, January, February, March, April, May, June, July, August, September, October, November, December | |
rates.options.tobaccoRateBasedOn | string | When rates are based on tobacco usage, this determines how tobacco rates are applied to each covered member. CoveredMember will apply the applicable tobacco rate to each covered member based on their own designated tobacco usage status. Employee will apply the rate based on the Employee’s tobacco usage status to both Employee and Spouse. EmployeeOrSpouse will apply the tobacco rates if either Employee or Spouse are designated as a tobacco user. · Unspecified, CoveredMember, Employee, EmployeeOrSpouse | |
rates.employee | VoluntaryLife.EmployeeRating | ||
rates.employee.ageBasedRates | VoluntaryLife.AgeBasedRating | ||
rates.employee.ageBasedRates.rates | array of AgeBandedRate | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.employee.ageBasedRates.rates.fromAge | integer | ✓ | |
rates.employee.ageBasedRates.rates.toAge | integer | ✓ | |
rates.employee.ageBasedRates.rates.rate | number | ✓ | |
rates.employee.ageBasedRates.genderBasedRates | array of AgeBandedGenderBasedRates | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.employee.ageBasedRates.genderBasedRates.fromAge | integer | ✓ | The lowest age in the range. |
rates.employee.ageBasedRates.genderBasedRates.toAge | integer | ✓ | The highest age in the range. |
rates.employee.ageBasedRates.genderBasedRates.rateMale | number | ✓ | The amount of money that must be paid to receive a specific amount of insurance under this plan if a Male. |
rates.employee.ageBasedRates.genderBasedRates.rateFemale | number | ✓ | The amount of money that a must be paid to receive a specific amount of insurance under this plan if a Female. |
rates.employee.ageBasedRates.tobaccoBasedRates | array of AgeBandedTobaccoBasedRates | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.employee.ageBasedRates.tobaccoBasedRates.fromAge | integer | ✓ | |
rates.employee.ageBasedRates.tobaccoBasedRates.toAge | integer | ✓ | |
rates.employee.ageBasedRates.tobaccoBasedRates.rateNonsmoker | number | ✓ | |
rates.employee.ageBasedRates.tobaccoBasedRates.rateSmoker | number | ✓ | |
rates.spouse | VoluntaryLife.SpouseRating | ||
rates.spouse.ageBasedRates | VoluntaryLife.SpouseAgeBasedRating | ||
rates.spouse.ageBasedRates.options | VoluntaryLife.SpouseAgeBasedOptionsType | ||
rates.spouse.ageBasedRates.options.spouseRatedOnEmployeeAge | boolean | When rates are based on age, this determines when spouse rates are calculated based on the employee age. | |
rates.spouse.ageBasedRates.rates | array of AgeBandedRate | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.spouse.ageBasedRates.rates.fromAge | integer | ✓ | |
rates.spouse.ageBasedRates.rates.toAge | integer | ✓ | |
rates.spouse.ageBasedRates.rates.rate | number | ✓ | |
rates.spouse.ageBasedRates.genderBasedRates | array of AgeBandedGenderBasedRates | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.spouse.ageBasedRates.genderBasedRates.fromAge | integer | ✓ | The lowest age in the range. |
rates.spouse.ageBasedRates.genderBasedRates.toAge | integer | ✓ | The highest age in the range. |
rates.spouse.ageBasedRates.genderBasedRates.rateMale | number | ✓ | The amount of money that must be paid to receive a specific amount of insurance under this plan if a Male. |
rates.spouse.ageBasedRates.genderBasedRates.rateFemale | number | ✓ | The amount of money that a must be paid to receive a specific amount of insurance under this plan if a Female. |
rates.spouse.ageBasedRates.tobaccoBasedRates | array of AgeBandedTobaccoBasedRates | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.spouse.ageBasedRates.tobaccoBasedRates.fromAge | integer | ✓ | |
rates.spouse.ageBasedRates.tobaccoBasedRates.toAge | integer | ✓ | |
rates.spouse.ageBasedRates.tobaccoBasedRates.rateNonsmoker | number | ✓ | |
rates.spouse.ageBasedRates.tobaccoBasedRates.rateSmoker | number | ✓ | |
rates.child | VoluntaryLife.ChildRating | ||
rates.child.options | VoluntaryLife.ChildRateOptionsType | ||
rates.child.options.childRatesBasedOnAllChildren | boolean | This specifies when the same rate is applied regardless of the number of covered children. When each child is assessed their own rates, the plan does not use All Children rates. | |
rates.child.flatRate | VoluntaryLife.ChildFlatRating | ||
rates.child.flatRate.rate | number | ||
rates.child.benefitBasedRates | VoluntaryLife.ChildBenefitBasedRating | ||
rates.child.benefitBasedRates.rates | array of VoluntaryLife.ChildBenefitRateType | ||
rates.child.benefitBasedRates.rates.benefitIncrement | number | ✓ | |
rates.child.benefitBasedRates.rates.rate | number | ✓ | |
| (root) | |||
contributions | VoluntaryLife.Contribution | ||
| contributions | |||
contributions.contributionGroupings | array of VoluntaryLife.ContributionGrouping | ✓ | A list of monthly contributions by a specified contribution grouping (e.g., everyone, by class, by department). |
contributions.contributionGroupings.contributionGroupingBasedOn | string | The textual description of what the specified contribution grouping is based on. | |
contributions.contributionGroupings.monthlyContributions | array of VoluntaryLife.MonthlyContributions | ✓ | A list of the monthly plan contributions. |
contributions.contributionGroupings.monthlyContributions.memberType | string | ✓ | Defines the universal level of member types covered by the plan based on the selected plan benefit type. · Unspecified, Employee, Spouse, Child |
contributions.contributionGroupings.monthlyContributions.contributionBasis | string | ✓ | Defines whether the contribution is based on what the employee or employer will pay to cover the cost of the plan. · Unspecified, Employer, Employee |
contributions.contributionGroupings.monthlyContributions.contributionType | string | ✓ | Defines whether the contribution is represented as a percent or a flat dollar amount. · Unspecified, Percentage, BenefitAmount |
contributions.contributionGroupings.monthlyContributions.contribution | number | ✓ | The actual amount or percent that an employee or employee will pay to cover the cost of the plan. |
| EN field path | Type | Req | Description / enum |
|---|---|---|---|
| (root) | |||
planIdentifier | string | ✓ | The unique identifier assigned for the purpose of identifying a plan. This value is the key used to link a plan between the two systems and how we will communicate about the plan. A plan is a set of benefit of rates and should not include billing groups. |
configuration | PlanConfiguration | ✓ | |
| configuration | |||
configuration.policyNumber | string | Value assigned to the plan for the specific company | |
configuration.carrierName | string | ||
configuration.planName | string | ||
configuration.startDate | string | ✓ | Effective date representing the most recent plan year start date for the current set of benefits and rates. Our plans couple benefits and rates together. |
configuration.endDate | string | Effective date representing the plan year end date for the current set of benefits and rates. Typically plans are 12-month plan years, unless policy is Issue Age and rates do not change. | |
configuration.nextRenewalDate | string | Effective date of coverage for next annual open enrollment. | |
configuration.carrierPlanCode | string | Specifies a plan code assigned by the carrier to identify a plan. This value would be returned with the enrollment record. | |
configuration.carrierPlanTypeCode | string | Specifies a plan code assigned by the carrier to identify the plan type. This value would be returned with the enrollment record. | |
configuration.planBillOption | string | Unspecified, SelfBill, ListBill | |
configuration.isSelfFunded | boolean | ||
configuration.situsState | string | The state in which the legal, organizational entity exists or originated. Send the State Name or the 2-character ISO abbreviation. Either value will be accepted. | |
configuration.benefit | string | ✓ | Medical, Dental, Vision, Life, ADAndD, VoluntaryLife, VoluntaryADAndD, ShortTermDisability, VoluntaryShortTermDisability, LongTermDisability, VoluntaryLongTermDisability, Prescription, CriticalIllness, HospitalIndemnity, PermanentLife, Tricare, IdentityProtection, LaboratoryServices, Legal, SupplementalMedical, Accident, Cancer, Telemedicine |
configuration.originalPlanStartDate | string | Date the plan initially began between the carrier and group. | |
configuration.carrierPlanTypeDescription | string | A carrier-defined standardized description that categorizes plans based on common characteristics. For example, medical plans may be categorized as HMO, PPO, etc.; dental plans as DHMO, etc. Note that this description is limited to 150 characters. | |
| (root) | |||
eligibilityOptions | array of PlanEligibilityOptions | ||
| eligibilityOptions | |||
eligibilityOptions.groupStructure | PlanEligibilityGroupStructure | ||
eligibilityOptions.groupStructure.eligibilityGroups | array of PlanEligibilityGroup | A list of employee categorizations mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.groupStructure.eligibilityGroups.eligibilityGroupCode | string | A carrier-assigned, unique identifier for an employee categorization mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.eligibilityRules | PlanEligibilityRules | ||
eligibilityOptions.eligibilityRules.waitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.waitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.waitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.entryDateRule | string | Used in conjunction with Waiting Period to define when the coverage is effective after the waiting period for a new employee. Use First of the Month Coinciding With or After rule when waiting period ending on the first of the month has entry on that day. Use First of the Month After when waiting period ending on the first of the month has entry on the first of the next month. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.terminationRule | string | Used to define the last day of coverage on loss of eligibility. · Unspecified, EndOfMonthOfTermination, EmploymentTermination, FirstOfMonthAfterEmploymentTermination | |
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehirePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.rehirePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.rehirePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehireEntryDateRule | string | Used in conjunction with Rehire Period to define when coverage is effective after rehire date for employees rehired within the rehire period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.eligibilityChangeEntryDateRule | string | Used in conjunction with Eligibility Change Waiting Period to define when the coverage is effective after the employee becomes eligible after a classification change and completes waiting period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
| (root) | |||
planCommunications | PlanCommunications | ||
| planCommunications | |||
planCommunications.marketingDescription | string | Customizes the employee enrollment experience with marketing information about the benefits of the plan. | |
planCommunications.benefitSummaryUrl | string | Customizes the employee enrollment experience with a URL hosting the benefit summary. | |
| (root) | |||
options | VoluntaryShortTermDisability.OptionsType | ||
| options | |||
options.employeeOptions | EmployeePlanOptions | ||
options.employeeOptions.ageIneligible | integer | Age member is no longer eligible to be covered under plan. | |
options.employeeOptions.allowOverageContinuation | boolean | Provision enabling member to remain enrolled in plan when reaching ageIneligible. | |
options.employeeOptions.requiresAgeRestriction | boolean | Indicates whether the plan requires member level age rules to be configured placing limitations on when a member would be eligible for coverage. | |
options.supplementalOptions | VoluntaryShortTermDisability.SupplementalOptions | ||
options.supplementalOptions.captureBeneficiary | boolean | Specifies that beneficiary designation should be collected upon enrollment. | |
| (root) | |||
benefits | array of VoluntaryShortTermDisability.Benefit | ||
| benefits | |||
benefits.groupStructure | PlanEligibilityGroupStructure | ||
benefits.groupStructure.eligibilityGroups | array of PlanEligibilityGroup | A list of employee categorizations mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
benefits.groupStructure.eligibilityGroups.eligibilityGroupCode | string | A carrier-assigned, unique identifier for an employee categorization mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
benefits.options | VoluntaryShortTermDisability.BenefitOptions | ||
benefits.options.benefitBasis | string | Identifies benefit as a weekly benefit or a monthly benefit. When unspecified, benefit will be a weekly benefit. · Unspecified, WeeklyEarnings, MonthlyEarnings | |
benefits.options.salaryRedeterminationOn | string | Specifies when salary changes update benefit amount. · Unspecified, FirstOfSpecifiedMonth, FirstOfFollowingMonth, DayOfChange, FirstOfMonthCoincidingWithOrAfter | |
benefits.options.salaryRedeterminationMonth | string | Identifies the month when salary changes are to be applied when salary redetermination option is specified as FirstOfSpecfiedMonth. If used in conjunction with ageBandChangesMonth, that value will drive both age and salary changes. · Unspecified, January, February, March, April, May, June, July, August, September, October, November, December | |
benefits.benefitClassCode | string | Carrier code assigned to the employee benefit class. | |
benefits.benefitDescription | string | Optional benefit description assigned by the carrier describing the benefit. | |
benefits.incrementsBenefit | VoluntaryShortTermDisability.IncrementsType | ||
benefits.incrementsBenefit.increments | array | Benefit amount as a list of available increments. Minimum and maximum benefit do not need to be provided. Minimum will be calculated to the lowest increment. Maximum benefit will be calculated to the highest increment. | |
benefits.incrementsBenefit.benefitPercentEarnings | number | Maximum benefit limit as a percent of earnings | |
benefits.incrementsBenefit.roundingType | string | Used in conjunction with RoundingValue and RoundingIncrement, describes rounding method. · Unspecified, Up, Down, Nearest | |
benefits.incrementsBenefit.roundingIncrement | string | Used in conjunction with RoundingType to designate rounding specificity. · Unspecified, OneThousandDollars, OneHundredDollars, TenDollars, OneDollar, FiftyDollars, OneCent, FiveHundredDollars, FiveThousandDollars, TenThousandDollars | |
benefits.incrementsBenefit.maximumIncrementRoundingType | string | Describes the rounding method applied on the max increment. · Unspecified, Up, Down, Nearest | |
benefits.percentEarningsBenefit | VoluntaryShortTermDisability.PercentEarningsType | ||
benefits.percentEarningsBenefit.benefitPercentEarnings | number | Benefit amount as a percent of earnings. | |
benefits.percentEarningsBenefit.minimumBenefit | number | Minimum weekly or monthly benefit. If the plan benefit is setup as a weekly amount, then this is a weekly minimum; otherwise, it is a monthly minimum | |
benefits.percentEarningsBenefit.maximumBenefit | number | Maximum weekly or monthly benefit. If the plan benefit is setup as a weekly amount, then this is a weekly maximum; otherwise, it is a monthly maximum | |
benefits.percentEarningsBenefit.roundingValue | string | Specifies where rounding occurs when calculating the final benefit offering. Choose salary rounding when salary is rounded prior to calculating benefit. If salary is not rounded, choose Benefit. Used in conjunction with Rounding Type and Rounding Increment. · Unspecified, Salary, Benefit | |
benefits.percentEarningsBenefit.roundingType | string | Used in conjunction with RoundingValue and RoundingIncrement, describes rounding method. · Unspecified, Up, Down, Nearest | |
benefits.percentEarningsBenefit.roundingIncrement | string | Used in conjunction with RoundingType to designate rounding specificity. · Unspecified, OneThousandDollars, OneHundredDollars, TenDollars, OneDollar, FiftyDollars, OneCent, FiveHundredDollars, FiveThousandDollars, TenThousandDollars | |
benefits.details | VoluntaryShortTermDisability.BenefitDetails | ||
benefits.details.benefitDurationWeeks | integer | Identifies the length of time in weeks for which the benefit will be paid during disability. | |
benefits.details.accidentWaitingPeriodDays | integer | Identifies the length of time in days before the benefit payment begins when the cause of disability is an accidental injury. | |
benefits.details.sicknessWaitingPeriodDays | integer | Identifies the length of time in days before the benefit payment begins when the cause of disability is a physical disease, pregnancy, or sickness. | |
benefits.details.conditionsOrExclusions | string | Describes the details and definition of any pre-existing condition exclusions which may impose limitations on benefit payment. | |
| (root) | |||
guaranteedIssue | VolXtdGuaranteedIssueOptionsType | ||
| guaranteedIssue | |||
guaranteedIssue.requiresEvidenceOfInsurability | boolean | Plan has a guaranteed issue benefit and offers additional coverage upon meeting evidence of insurability underwriting requirements. | |
guaranteedIssue.employee | VolXtdGuaranteedIssueEmployeeOptions | ||
guaranteedIssue.employee.initialAmount | VolXtdGuaranteedIssueAmount | ||
guaranteedIssue.employee.initialAmount.amount | number | ||
guaranteedIssue.employee.lateEntrantAmount | VolXtdGuaranteedIssueAmount | ||
guaranteedIssue.employee.lateEntrantAmount.amount | number | ||
guaranteedIssue.employee.existingAmount | VolXtdGuaranteedIssueIncreaseAmountType | ||
guaranteedIssue.employee.existingAmount.increaseAmount | VolXtdGuaranteedIssueIncreaseAmount | ||
guaranteedIssue.employee.existingAmount.increaseAmount.increaseBy | number | Amount an existing benefit can be increased by without requiring additional underwriting. | |
| (root) | |||
rates | VoluntaryShortTermDisability.Rating | ||
| rates | |||
rates.options | VoluntaryShortTermDisability.RateOptions | ||
rates.options.annualPolicyFee | number | An annual fee added to the total cost for each policy. Annual fee is applied to both the employee and the spouse policy. | |
rates.compositeRate | VoluntaryShortTermDisability.CompositeRating | ||
rates.compositeRate.rate | number | ✓ | |
rates.ageBasedRates | VoluntaryShortTermDisability.AgeBasedRating | ||
rates.ageBasedRates.options | VoluntaryShortTermDisability.AgeBasedOptionsType | ||
rates.ageBasedRates.options.isIssueAge | boolean | An issue age policy is one in which premium is based on the age at the time the policy is issued and does not change as member ages unless a change in coverage occurs. | |
rates.ageBasedRates.options.issueAgeChangeRule | string | Rerated updates all coverage based on the age at the time of coverage change. Stacked retains the cost for the original coverage, and only calculates a new rate for the additional portion of the coverage based on the age at the time of the change. Original Issue Rated will always use the original issue age for original coverage and coverage changes. · Unspecified, ReRated, Stacked, OriginalIssueRated | |
rates.ageBasedRates.options.rateInitialEntrantAgeOn | string | Rate initial entrant according to age on selected option. · Unspecified, CalculatedEligibilityDate, PriorPolicyAnniversary | |
rates.ageBasedRates.options.ageBandChangeUpdateOn | string | Specifies when to update rate upon age band change. · Unspecified, FirstOfMonthFollowing, FirstOfSpecifiedMonth, Birthday | |
rates.ageBasedRates.options.ageBandChangesMonth | string | Identifies the month when rate changes are to be applied when the age band change option is specified as FirstOfSpecifiedMonth. · Unspecified, January, February, March, April, May, June, July, August, September, October, November, December | |
rates.ageBasedRates.rates | array of AgeBandedRate | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.ageBasedRates.rates.fromAge | integer | ✓ | |
rates.ageBasedRates.rates.toAge | integer | ✓ | |
rates.ageBasedRates.rates.rate | number | ✓ | |
| (root) | |||
contributions | VolXtdContribution | ||
| contributions | |||
contributions.contributionGroupings | array of VolXtdContributionGrouping | ✓ | A list of monthly contributions by a specified contribution grouping (e.g., everyone, by class, by department). |
contributions.contributionGroupings.contributionGroupingBasedOn | string | The textual description of what the specified contribution grouping is based on. | |
contributions.contributionGroupings.monthlyContributions | VolXtdMonthlyContribution | ✓ | |
contributions.contributionGroupings.monthlyContributions.contributionBasis | string | ✓ | Defines whether the contribution is based on what the employee or employer will pay to cover the cost of the plan. · Unspecified, Employer, Employee |
contributions.contributionGroupings.monthlyContributions.contributionType | string | ✓ | Defines whether the contribution is represented as a percent or a flat dollar amount. · Unspecified, Percentage, BenefitAmount |
contributions.contributionGroupings.monthlyContributions.contribution | number | ✓ | The actual amount or percent that an employee or employee will pay to cover the cost of the plan. |
| EN field path | Type | Req | Description / enum |
|---|---|---|---|
| (root) | |||
planIdentifier | string | ✓ | The unique identifier assigned for the purpose of identifying a plan. This value is the key used to link a plan between the two systems and how we will communicate about the plan. A plan is a set of benefit of rates and should not include billing groups. |
configuration | PlanConfiguration | ✓ | |
| configuration | |||
configuration.policyNumber | string | Value assigned to the plan for the specific company | |
configuration.carrierName | string | ||
configuration.planName | string | ||
configuration.startDate | string | ✓ | Effective date representing the most recent plan year start date for the current set of benefits and rates. Our plans couple benefits and rates together. |
configuration.endDate | string | Effective date representing the plan year end date for the current set of benefits and rates. Typically plans are 12-month plan years, unless policy is Issue Age and rates do not change. | |
configuration.nextRenewalDate | string | Effective date of coverage for next annual open enrollment. | |
configuration.carrierPlanCode | string | Specifies a plan code assigned by the carrier to identify a plan. This value would be returned with the enrollment record. | |
configuration.carrierPlanTypeCode | string | Specifies a plan code assigned by the carrier to identify the plan type. This value would be returned with the enrollment record. | |
configuration.planBillOption | string | Unspecified, SelfBill, ListBill | |
configuration.isSelfFunded | boolean | ||
configuration.situsState | string | The state in which the legal, organizational entity exists or originated. Send the State Name or the 2-character ISO abbreviation. Either value will be accepted. | |
configuration.benefit | string | ✓ | Medical, Dental, Vision, Life, ADAndD, VoluntaryLife, VoluntaryADAndD, ShortTermDisability, VoluntaryShortTermDisability, LongTermDisability, VoluntaryLongTermDisability, Prescription, CriticalIllness, HospitalIndemnity, PermanentLife, Tricare, IdentityProtection, LaboratoryServices, Legal, SupplementalMedical, Accident, Cancer, Telemedicine |
configuration.originalPlanStartDate | string | Date the plan initially began between the carrier and group. | |
configuration.carrierPlanTypeDescription | string | A carrier-defined standardized description that categorizes plans based on common characteristics. For example, medical plans may be categorized as HMO, PPO, etc.; dental plans as DHMO, etc. Note that this description is limited to 150 characters. | |
| (root) | |||
eligibilityOptions | array of PlanEligibilityOptions | ||
| eligibilityOptions | |||
eligibilityOptions.groupStructure | PlanEligibilityGroupStructure | ||
eligibilityOptions.groupStructure.eligibilityGroups | array of PlanEligibilityGroup | A list of employee categorizations mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.groupStructure.eligibilityGroups.eligibilityGroupCode | string | A carrier-assigned, unique identifier for an employee categorization mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.eligibilityRules | PlanEligibilityRules | ||
eligibilityOptions.eligibilityRules.waitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.waitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.waitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.entryDateRule | string | Used in conjunction with Waiting Period to define when the coverage is effective after the waiting period for a new employee. Use First of the Month Coinciding With or After rule when waiting period ending on the first of the month has entry on that day. Use First of the Month After when waiting period ending on the first of the month has entry on the first of the next month. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.terminationRule | string | Used to define the last day of coverage on loss of eligibility. · Unspecified, EndOfMonthOfTermination, EmploymentTermination, FirstOfMonthAfterEmploymentTermination | |
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehirePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.rehirePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.rehirePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehireEntryDateRule | string | Used in conjunction with Rehire Period to define when coverage is effective after rehire date for employees rehired within the rehire period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.eligibilityChangeEntryDateRule | string | Used in conjunction with Eligibility Change Waiting Period to define when the coverage is effective after the employee becomes eligible after a classification change and completes waiting period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
| (root) | |||
planCommunications | PlanCommunications | ||
| planCommunications | |||
planCommunications.marketingDescription | string | Customizes the employee enrollment experience with marketing information about the benefits of the plan. | |
planCommunications.benefitSummaryUrl | string | Customizes the employee enrollment experience with a URL hosting the benefit summary. | |
| (root) | |||
options | VoluntaryLongTermDisability.OptionsType | ||
| options | |||
options.employeeOptions | EmployeePlanOptions | ||
options.employeeOptions.ageIneligible | integer | Age member is no longer eligible to be covered under plan. | |
options.employeeOptions.allowOverageContinuation | boolean | Provision enabling member to remain enrolled in plan when reaching ageIneligible. | |
options.employeeOptions.requiresAgeRestriction | boolean | Indicates whether the plan requires member level age rules to be configured placing limitations on when a member would be eligible for coverage. | |
options.supplementalOptions | VoluntaryLongTermDisability.SupplementalOptions | ||
options.supplementalOptions.captureBeneficiary | boolean | Specifies that beneficiary designation should be collected upon enrollment. | |
| (root) | |||
benefits | array of VoluntaryLongTermDisability.Benefit | ||
| benefits | |||
benefits.groupStructure | PlanEligibilityGroupStructure | ||
benefits.groupStructure.eligibilityGroups | array of PlanEligibilityGroup | A list of employee categorizations mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
benefits.groupStructure.eligibilityGroups.eligibilityGroupCode | string | A carrier-assigned, unique identifier for an employee categorization mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
benefits.options | VoluntaryLongTermDisability.BenefitOptions | ||
benefits.options.salaryRedeterminationOn | string | Specifies when salary changes update benefit amount. · Unspecified, FirstOfSpecifiedMonth, FirstOfFollowingMonth, DayOfChange, FirstOfMonthCoincidingWithOrAfter | |
benefits.options.salaryRedeterminationMonth | string | Identifies the month when salary changes are to be applied when salary redetermination option is specified as FirstOfSpecfiedMonth. If used in conjunction with ageBandChangesMonth, that value will drive both age and salary changes. · Unspecified, January, February, March, April, May, June, July, August, September, October, November, December | |
benefits.benefitClassCode | string | Carrier code assigned to the employee benefit class. | |
benefits.benefitDescription | string | Optional benefit description assigned by the carrier describing the benefit. | |
benefits.incrementsBenefit | VoluntaryLongTermDisability.IncrementsType | ||
benefits.incrementsBenefit.increments | array | Benefit amount as a list of available increments. Minimum and maximum benefit do not need to be provided. Minimum will be calculated to the lowest increment. Maximum benefit will be calculated to the highest increment. | |
benefits.incrementsBenefit.benefitPercentEarnings | number | Maximum benefit limit as a percent of earnings | |
benefits.incrementsBenefit.roundingType | string | Used in conjunction with RoundingValue and RoundingIncrement, describes rounding method. · Unspecified, Up, Down, Nearest | |
benefits.incrementsBenefit.roundingIncrement | string | Used in conjunction with RoundingType to designate rounding specificity. · Unspecified, OneThousandDollars, OneHundredDollars, TenDollars, OneDollar, FiftyDollars, OneCent, FiveHundredDollars, FiveThousandDollars, TenThousandDollars | |
benefits.incrementsBenefit.maximumIncrementRoundingType | string | Describes the rounding method applied on the max increment. · Unspecified, Up, Down, Nearest | |
benefits.percentEarningsBenefit | VoluntaryLongTermDisability.PercentEarningsType | ||
benefits.percentEarningsBenefit.benefitPercentEarnings | number | Benefit amount as a percent of earnings. | |
benefits.percentEarningsBenefit.minimumBenefit | number | Minimum benefit amount | |
benefits.percentEarningsBenefit.maximumBenefit | number | Maximum benefit amount | |
benefits.percentEarningsBenefit.roundingValue | string | Specifies where rounding occurs when calculating the final benefit offering. Choose salary rounding when salary is rounded prior to calculating benefit. If salary is not rounded, choose Benefit. Used in conjunction with Rounding Type and Rounding Increment. · Unspecified, Salary, Benefit | |
benefits.percentEarningsBenefit.roundingType | string | Used in conjunction with RoundingValue and RoundingIncrement, describes rounding method. · Unspecified, Up, Down, Nearest | |
benefits.percentEarningsBenefit.roundingIncrement | string | Used in conjunction with RoundingType to designate rounding specificity. · Unspecified, OneThousandDollars, OneHundredDollars, TenDollars, OneDollar, FiftyDollars, OneCent, FiveHundredDollars, FiveThousandDollars, TenThousandDollars | |
benefits.details | VoluntaryLongTermDisability.BenefitDetails | ||
benefits.details.benefitDuration | string | Identifies the length of time for which the benefit will be paid during disability. This duration period is usually in weeks, months, or up to a specific age (e.g. Age 65). | |
benefits.details.waitingPeriodDays | integer | Identifies the length of time the employee must be disabled before benefit payment begins. | |
benefits.details.conditionsOrExclusions | string | Describes the details and definition of any pre-existing condition exclusions which may impose limitations on benefit payment. | |
benefits.details.occupationDescription | string | Identifies the occupation contingencies for which the policy will cover. Any-occupation policy provides coverage when the employee is unable to perform duties for any job within their occupation based on education, experience, and training. Own-occupation provides coverage if the employee is unable to perform the majority of the duties for their specific job. | |
| (root) | |||
guaranteedIssue | VolXtdGuaranteedIssueOptionsType | ||
| guaranteedIssue | |||
guaranteedIssue.requiresEvidenceOfInsurability | boolean | Plan has a guaranteed issue benefit and offers additional coverage upon meeting evidence of insurability underwriting requirements. | |
guaranteedIssue.employee | VolXtdGuaranteedIssueEmployeeOptions | ||
guaranteedIssue.employee.initialAmount | VolXtdGuaranteedIssueAmount | ||
guaranteedIssue.employee.initialAmount.amount | number | ||
guaranteedIssue.employee.lateEntrantAmount | VolXtdGuaranteedIssueAmount | ||
guaranteedIssue.employee.lateEntrantAmount.amount | number | ||
guaranteedIssue.employee.existingAmount | VolXtdGuaranteedIssueIncreaseAmountType | ||
guaranteedIssue.employee.existingAmount.increaseAmount | VolXtdGuaranteedIssueIncreaseAmount | ||
guaranteedIssue.employee.existingAmount.increaseAmount.increaseBy | number | Amount an existing benefit can be increased by without requiring additional underwriting. | |
| (root) | |||
rates | VoluntaryLongTermDisability.Rating | ||
| rates | |||
rates.compositeRate | VoluntaryLongTermDisability.CompositeRating | ||
rates.compositeRate.rate | number | ✓ | |
rates.ageBasedRates | VoluntaryLongTermDisability.AgeBasedRating | ||
rates.ageBasedRates.options | VoluntaryLongTermDisability.AgeBasedOptionsType | ||
rates.ageBasedRates.options.isIssueAge | boolean | An issue age policy is one in which premium is based on the age at the time the policy is issued and does not change as member ages unless a change in coverage occurs. | |
rates.ageBasedRates.options.issueAgeChangeRule | string | Rerated updates all coverage based on the age at the time of coverage change. Stacked retains the cost for the original coverage, and only calculates a new rate for the additional portion of the coverage based on the age at the time of the change. Original Issue Rated will always use the original issue age for original coverage and coverage changes. · Unspecified, ReRated, Stacked, OriginalIssueRated | |
rates.ageBasedRates.options.rateInitialEntrantAgeOn | string | Rate initial entrant according to age on selected option. · Unspecified, CalculatedEligibilityDate, PriorPolicyAnniversary | |
rates.ageBasedRates.options.ageBandChangeUpdateOn | string | Specifies when to update rate upon age band change. · Unspecified, FirstOfMonthFollowing, FirstOfSpecifiedMonth, Birthday | |
rates.ageBasedRates.options.ageBandChangesMonth | string | Identifies the month when rate changes are to be applied when the age band change option is specified as FirstOfSpecifiedMonth. · Unspecified, January, February, March, April, May, June, July, August, September, October, November, December | |
rates.ageBasedRates.rates | array of AgeBandedRate | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.ageBasedRates.rates.fromAge | integer | ✓ | |
rates.ageBasedRates.rates.toAge | integer | ✓ | |
rates.ageBasedRates.rates.rate | number | ✓ | |
| (root) | |||
contributions | VolXtdContribution | ||
| contributions | |||
contributions.contributionGroupings | array of VolXtdContributionGrouping | ✓ | A list of monthly contributions by a specified contribution grouping (e.g., everyone, by class, by department). |
contributions.contributionGroupings.contributionGroupingBasedOn | string | The textual description of what the specified contribution grouping is based on. | |
contributions.contributionGroupings.monthlyContributions | VolXtdMonthlyContribution | ✓ | |
contributions.contributionGroupings.monthlyContributions.contributionBasis | string | ✓ | Defines whether the contribution is based on what the employee or employer will pay to cover the cost of the plan. · Unspecified, Employer, Employee |
contributions.contributionGroupings.monthlyContributions.contributionType | string | ✓ | Defines whether the contribution is represented as a percent or a flat dollar amount. · Unspecified, Percentage, BenefitAmount |
contributions.contributionGroupings.monthlyContributions.contribution | number | ✓ | The actual amount or percent that an employee or employee will pay to cover the cost of the plan. |
| EN field path | Type | Req | Description / enum |
|---|---|---|---|
| (root) | |||
planIdentifier | string | ✓ | The unique identifier assigned for the purpose of identifying a plan. This value is the key used to link a plan between the two systems and how we will communicate about the plan. A plan is a set of benefit of rates and should not include billing groups. |
configuration | PlanConfiguration | ✓ | |
| configuration | |||
configuration.policyNumber | string | Value assigned to the plan for the specific company | |
configuration.carrierName | string | ||
configuration.planName | string | ||
configuration.startDate | string | ✓ | Effective date representing the most recent plan year start date for the current set of benefits and rates. Our plans couple benefits and rates together. |
configuration.endDate | string | Effective date representing the plan year end date for the current set of benefits and rates. Typically plans are 12-month plan years, unless policy is Issue Age and rates do not change. | |
configuration.nextRenewalDate | string | Effective date of coverage for next annual open enrollment. | |
configuration.carrierPlanCode | string | Specifies a plan code assigned by the carrier to identify a plan. This value would be returned with the enrollment record. | |
configuration.carrierPlanTypeCode | string | Specifies a plan code assigned by the carrier to identify the plan type. This value would be returned with the enrollment record. | |
configuration.planBillOption | string | Unspecified, SelfBill, ListBill | |
configuration.isSelfFunded | boolean | ||
configuration.situsState | string | The state in which the legal, organizational entity exists or originated. Send the State Name or the 2-character ISO abbreviation. Either value will be accepted. | |
configuration.benefit | string | ✓ | Medical, Dental, Vision, Life, ADAndD, VoluntaryLife, VoluntaryADAndD, ShortTermDisability, VoluntaryShortTermDisability, LongTermDisability, VoluntaryLongTermDisability, Prescription, CriticalIllness, HospitalIndemnity, PermanentLife, Tricare, IdentityProtection, LaboratoryServices, Legal, SupplementalMedical, Accident, Cancer, Telemedicine |
configuration.originalPlanStartDate | string | Date the plan initially began between the carrier and group. | |
configuration.carrierPlanTypeDescription | string | A carrier-defined standardized description that categorizes plans based on common characteristics. For example, medical plans may be categorized as HMO, PPO, etc.; dental plans as DHMO, etc. Note that this description is limited to 150 characters. | |
| (root) | |||
planDependencies | CriticalIllness.CriticalIllnessPlanDependencies | ||
| planDependencies | |||
planDependencies.benefitEnrollmentDependency | CriticalIllness.CriticalIllnessPlanBenefitEnrollmentDependency | ||
planDependencies.benefitEnrollmentDependency.enrollmentBenefit | string | ✓ | The pre-defined benefit category a plan may be dependent upon. · Medical, SupplementalMedical |
| (root) | |||
eligibilityOptions | array of PlanEligibilityOptions | ||
| eligibilityOptions | |||
eligibilityOptions.groupStructure | PlanEligibilityGroupStructure | ||
eligibilityOptions.groupStructure.eligibilityGroups | array of PlanEligibilityGroup | A list of employee categorizations mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.groupStructure.eligibilityGroups.eligibilityGroupCode | string | A carrier-assigned, unique identifier for an employee categorization mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.eligibilityRules | PlanEligibilityRules | ||
eligibilityOptions.eligibilityRules.waitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.waitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.waitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.entryDateRule | string | Used in conjunction with Waiting Period to define when the coverage is effective after the waiting period for a new employee. Use First of the Month Coinciding With or After rule when waiting period ending on the first of the month has entry on that day. Use First of the Month After when waiting period ending on the first of the month has entry on the first of the next month. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.terminationRule | string | Used to define the last day of coverage on loss of eligibility. · Unspecified, EndOfMonthOfTermination, EmploymentTermination, FirstOfMonthAfterEmploymentTermination | |
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehirePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.rehirePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.rehirePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehireEntryDateRule | string | Used in conjunction with Rehire Period to define when coverage is effective after rehire date for employees rehired within the rehire period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.eligibilityChangeEntryDateRule | string | Used in conjunction with Eligibility Change Waiting Period to define when the coverage is effective after the employee becomes eligible after a classification change and completes waiting period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
| (root) | |||
planCommunications | PlanCommunications | ||
| planCommunications | |||
planCommunications.marketingDescription | string | Customizes the employee enrollment experience with marketing information about the benefits of the plan. | |
planCommunications.benefitSummaryUrl | string | Customizes the employee enrollment experience with a URL hosting the benefit summary. | |
| (root) | |||
options | VoluntaryLife.OptionsType | ||
| options | |||
options.employeeOptions | VoluntaryLife.EmployeePlanOptions | ||
options.employeeOptions.ageIneligible | integer | Age member is no longer eligible to be covered under plan. | |
options.employeeOptions.allowOverageContinuation | boolean | Provision enabling member to remain enrolled in plan when reaching ageIneligible. | |
options.employeeOptions.initialEntrantGracePeriod | integer | The length of time an employee has to enroll after their eligibility date for their original eligible entry date to be honored. E.g. If an employee is eligible on 10/1 and enrolls on 10/13, a 30-day grace period would honor 10/1 as their coverage start date. If no grace period is specified, the employee’s coverage will begin on the date of enrollment, 10/13. | |
options.employeeOptions.requiresAgeRestriction | boolean | Indicates whether the plan requires member level age rules to be configured placing limitations on when a member would be eligible for coverage. | |
options.supplementalOptions | VoluntaryLife.SupplementalOptions | ||
options.supplementalOptions.captureBeneficiary | boolean | Specifies that beneficiary designation should be collected upon enrollment. | |
| (root) | |||
dependentOptions | VoluntaryLife.DependentOptionsType | ||
| dependentOptions | |||
dependentOptions.spouseOptions | VoluntaryLife.DependentSpouseOptionsType | ||
dependentOptions.spouseOptions.ageIneligible | integer | Age member is no longer eligible to be covered under plan. | |
dependentOptions.spouseOptions.allowOverageContinuation | boolean | Provision enabling member to remain enrolled in plan when reaching ageIneligible. | |
dependentOptions.spouseOptions.requiresAgeRestriction | boolean | Indicates whether the plan requires member level age rules to be configured placing limitations on when a member would be eligible for coverage. | |
dependentOptions.childOptions | VoluntaryLife.DependentChildOptionsType | ||
dependentOptions.childOptions.ageIneligible | integer | Age non-student dependent child is no longer eligible. | |
dependentOptions.childOptions.studentAgeIneligible | integer | Age student child is no longer eligible to be covered under the plan. | |
dependentOptions.childOptions.dropOverageChildOn | string | Used in conjunction with AgeIneligible and StudentAgeIneligible, specifies the last day of coverage when a child becomes ineligible due to age. · Unspecified, EndOfMonth, Birthday, EndOfPlan, EndOfCalendarYear | |
dependentOptions.childOptions.minimumAge | integer | Age dependent child is too young to be covered under benefit. | |
dependentOptions.childOptions.minimumAgeType | string | Used in conjunction with minimumAge, specifies how minimumAge is measured. · Unspecified, Days, Months, Years | |
| (root) | |||
benefits | array of VoluntaryLife.Benefit | ||
| benefits | |||
benefits.groupStructure | PlanEligibilityGroupStructure | ||
benefits.groupStructure.eligibilityGroups | array of PlanEligibilityGroup | A list of employee categorizations mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
benefits.groupStructure.eligibilityGroups.eligibilityGroupCode | string | A carrier-assigned, unique identifier for an employee categorization mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
benefits.options | VoluntaryLife.BenefitOptions | ||
benefits.options.ageReductionOptions | VoluntaryLife.AgeReductionOptions | ||
benefits.options.ageReductionOptions.ageReductionsBasedOnPreviousBenefit | boolean | Choose this when the percent of reduction is based on the latest benefit, which may have already been reduced. Do not choose this when the percent of reduction is based on the original benefit amount. | |
benefits.options.ageReductionOptions.ageReductionReduceOn | string | Specifies when to apply reduction age band changes · Unspecified, FirstOfMonthFollowing, FirstOfSpecifiedMonth, Birthday | |
benefits.options.ageReductionOptions.ageReductionChangeMonth | string | Identifies the month when to apply reductions when the AgeReductionReduceOn option is specified as FirstOfSpecifiedMonth · Unspecified, January, February, March, April, May, June, July, August, September, October, November, December | |
benefits.options.ageReductionOptions.roundingType | string | Used in conjunction with roundingIncrement, rounding method used for age-reduced benefit. · Unspecified, Up, Down, Nearest | |
benefits.options.ageReductionOptions.roundingIncrement | string | Used in conjunction with roundingType, specifies to what closest increment the reduced benefit amount should be rounded. · Unspecified, OneThousandDollars, OneHundredDollars, TenDollars, OneDollar, FiftyDollars, OneCent, FiveHundredDollars, FiveThousandDollars, TenThousandDollars | |
benefits.employee | VoluntaryLife.EmployeeBenefit | ||
benefits.employee.benefitClassCode | string | Carrier code assigned to the employee benefit class. Commonly used when carrier assigns different codes for employee, spouse, and child benefits. | |
benefits.employee.benefitDescription | string | Optional benefit description assigned by the carrier describing the benefit. | |
benefits.employee.multiplesOfEarningsBenefit | VoluntaryLife.MultiplesOfEarningsType | ||
benefits.employee.multiplesOfEarningsBenefit.multiplesOfEarnings | number | The highest multiplier to be applied to an employee's earnings. For example, if the plan supports 1X, 2X, or 3X earnings, then set the multipleOfEarnings field value to 3. | |
benefits.employee.multiplesOfEarningsBenefit.minimumBenefit | number | Minimum benefit amount | |
benefits.employee.multiplesOfEarningsBenefit.maximumBenefit | number | Maximum benefit amount | |
benefits.employee.multiplesOfEarningsBenefit.roundingType | string | Rounding method for multiple of earnings in thousands. · Unspecified, Up, Down, Nearest | |
benefits.employee.incrementsBenefit | VoluntaryLife.IncrementsMultipleEarningsMaximumType | ||
benefits.employee.incrementsBenefit.increments | array | Benefit amount as a list of available increments. Minimum and maximum benefit do not need to be provided. Minimum will be calculated to the lowest increment. Maximum benefit will be calculated to the highest increment. | |
benefits.employee.incrementsBenefit.maximumMultipleOfEarnings | number | Maximum benefit amount as a multiple of earnings | |
benefits.employee.incrementsBenefit.roundingType | string | Rounding method for maximum multiple of earnings in thousands. · Unspecified, Up, Down | |
benefits.employee.ageReductions | VoluntaryLife.AgeReductions | ||
benefits.employee.ageReductions.reductions | array of BenefitReduction | Schedule of reductions as a percent of benefit which occur upon attaining a specific age. | |
benefits.employee.ageReductions.reductions.atAge | integer | ✓ | Age benefit is reduced. |
benefits.employee.ageReductions.reductions.reducedByPercent | number | ✓ | Amount benefit is reduced by as a percent. Not an amount reduced to. |
benefits.spouse | VoluntaryLife.SpouseBenefit | ||
benefits.spouse.benefitClassCode | string | Carrier code assigned to the spouse benefit class. Commonly used when carrier assigns different codes for employee, spouse, and child benefits | |
benefits.spouse.benefitDescription | string | Optional benefit description assigned by the carrier describing the spouse benefit. | |
benefits.spouse.incrementsBenefit | VoluntaryLife.IncrementsMaxPercentEmployeeType | ||
benefits.spouse.incrementsBenefit.increments | array | Benefit amount as a list of available increments. Minimum and maximum benefit do not need to be provided. Minimum will be calculated to the lowest increment. Maximum benefit will be calculated to the highest increment. | |
benefits.spouse.incrementsBenefit.maximumPercentOfEmployeeElection | integer | Maximum benefit as a percent of employee benefit amount. | |
benefits.spouse.percentBenefit | VoluntaryLife.PercentOfEmployeeBenefitType | ||
benefits.spouse.percentBenefit.percentOfEmployeeElection | number | Benefit as a percent of employee election. | |
benefits.spouse.percentBenefit.minimumBenefit | number | Minimum benefit amount | |
benefits.spouse.percentBenefit.maximumBenefit | number | Maximum benefit amount | |
benefits.spouse.ageReductions | VoluntaryLife.AgeReductions | ||
benefits.spouse.ageReductions.reductions | array of BenefitReduction | Schedule of reductions as a percent of benefit which occur upon attaining a specific age. | |
benefits.spouse.ageReductions.reductions.atAge | integer | ✓ | Age benefit is reduced. |
benefits.spouse.ageReductions.reductions.reducedByPercent | number | ✓ | Amount benefit is reduced by as a percent. Not an amount reduced to. |
benefits.spouse.options | VoluntaryLife.SpouseBenefitOptions | ||
benefits.spouse.options.spouseReductionsBasedOnEmployeeAge | boolean | When benefits are reduced based on age, this determines when spouse benefit reductions are calculated based on the employee age. | |
benefits.child | VoluntaryLife.ChildBenefit | ||
benefits.child.benefitClassCode | string | Carrier code assigned to the child benefit class. Commonly used when carrier assigns different codes for employee, spouse, and child benefits. | |
benefits.child.benefitDescription | string | Optional benefit description assigned by the carrier describing the child benefit. | |
benefits.child.incrementsBenefit | VoluntaryLife.IncrementsMaxPercentEmployeeType | ||
benefits.child.incrementsBenefit.increments | array | Benefit amount as a list of available increments. Minimum and maximum benefit do not need to be provided. Minimum will be calculated to the lowest increment. Maximum benefit will be calculated to the highest increment. | |
benefits.child.incrementsBenefit.maximumPercentOfEmployeeElection | integer | Maximum benefit as a percent of employee benefit amount. | |
benefits.child.percentBenefit | VoluntaryLife.PercentOfEmployeeBenefitType | ||
benefits.child.percentBenefit.percentOfEmployeeElection | number | Benefit as a percent of employee election. | |
benefits.child.percentBenefit.minimumBenefit | number | Minimum benefit amount | |
benefits.child.percentBenefit.maximumBenefit | number | Maximum benefit amount | |
benefits.child.flatBenefit | VoluntaryLife.FlatAmountType | ||
benefits.child.flatBenefit.amount | number | Benefit amount | |
benefits.details | VoluntaryLife.BenefitDetails | ||
benefits.details.conditionsOrExclusions | string | Describes the details and definition of any pre-existing condition exclusions which may impose limitations on benefit payment. | |
| (root) | |||
guaranteedIssue | CriticalIllness.CriticalIllnessGuaranteedIssueType | ||
| guaranteedIssue | |||
guaranteedIssue.requiresEvidenceOfInsurability | boolean | ||
guaranteedIssue.employee | VoluntaryLife.GuaranteedIssueEmployeeOptions | ||
guaranteedIssue.employee.initialAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.employee.initialAmount.amount | number | Flat amount | |
guaranteedIssue.employee.initialAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.employee.lateEntrantAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.employee.lateEntrantAmount.amount | number | Flat amount | |
guaranteedIssue.employee.lateEntrantAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.employee.existingAmount | VoluntaryLife.GuaranteedIssueExistingType | ||
guaranteedIssue.employee.existingAmount.flatAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.employee.existingAmount.flatAmount.amount | number | Flat amount | |
guaranteedIssue.employee.existingAmount.flatAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.employee.existingAmount.increaseAmount | VoluntaryLife.GuaranteedIssueIncreaseAmountType | ||
guaranteedIssue.employee.existingAmount.increaseAmount.increaseBy | number | Amount an existing benefit can be increased by without requiring additional underwriting. | |
guaranteedIssue.employee.existingAmount.increaseAmount.maximumAmount | number | Used in conjunction with IncreaseBy amount, an optional maximum flat amount serving as a guaranteed issue limit. | |
guaranteedIssue.employee.reductions | VoluntaryLife.GuaranteedIssueReductions | ||
guaranteedIssue.employee.reductions.reductionAmounts | array of VoluntaryLife.GuaranteedIssueReduction | ||
guaranteedIssue.employee.reductions.reductionAmounts.atAge | integer | ✓ | Age benefit is reduced. |
guaranteedIssue.employee.reductions.reductionAmounts.amount | number | ✓ | Amount guaranteed issue is reduced to. |
guaranteedIssue.spouse | VoluntaryLife.GuaranteedIssueSpouseOptions | ||
guaranteedIssue.spouse.initialAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.spouse.initialAmount.amount | number | Flat amount | |
guaranteedIssue.spouse.initialAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.spouse.lateEntrantAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.spouse.lateEntrantAmount.amount | number | Flat amount | |
guaranteedIssue.spouse.lateEntrantAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.spouse.existingAmount | VoluntaryLife.GuaranteedIssueExistingType | ||
guaranteedIssue.spouse.existingAmount.flatAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.spouse.existingAmount.flatAmount.amount | number | Flat amount | |
guaranteedIssue.spouse.existingAmount.flatAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.spouse.existingAmount.increaseAmount | VoluntaryLife.GuaranteedIssueIncreaseAmountType | ||
guaranteedIssue.spouse.existingAmount.increaseAmount.increaseBy | number | Amount an existing benefit can be increased by without requiring additional underwriting. | |
guaranteedIssue.spouse.existingAmount.increaseAmount.maximumAmount | number | Used in conjunction with IncreaseBy amount, an optional maximum flat amount serving as a guaranteed issue limit. | |
guaranteedIssue.spouse.reductions | VoluntaryLife.GuaranteedIssueReductions | ||
guaranteedIssue.spouse.reductions.reductionAmounts | array of VoluntaryLife.GuaranteedIssueReduction | ||
guaranteedIssue.spouse.reductions.reductionAmounts.atAge | integer | ✓ | Age benefit is reduced. |
guaranteedIssue.spouse.reductions.reductionAmounts.amount | number | ✓ | Amount guaranteed issue is reduced to. |
guaranteedIssue.child | VoluntaryLife.GuaranteedIssueChildOptions | ||
guaranteedIssue.child.initialAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.child.initialAmount.amount | number | Flat amount | |
guaranteedIssue.child.initialAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.child.lateEntrantAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.child.lateEntrantAmount.amount | number | Flat amount | |
guaranteedIssue.child.lateEntrantAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.child.existingAmount | VoluntaryLife.GuaranteedIssueExistingType | ||
guaranteedIssue.child.existingAmount.flatAmount | VoluntaryLife.GuaranteedIssueAmountType | ||
guaranteedIssue.child.existingAmount.flatAmount.amount | number | Flat amount | |
guaranteedIssue.child.existingAmount.flatAmount.multipleOfEarningsLimit | number | Used in conjunction with Amount, an optional limit on guaranteed issue expressed as a maximum multiple of employee earnings. When specified, the guaranteed benefit amount is the lesser of Amount and MultipleOfEarningsLimit. | |
guaranteedIssue.child.existingAmount.increaseAmount | VoluntaryLife.GuaranteedIssueIncreaseAmountType | ||
guaranteedIssue.child.existingAmount.increaseAmount.increaseBy | number | Amount an existing benefit can be increased by without requiring additional underwriting. | |
guaranteedIssue.child.existingAmount.increaseAmount.maximumAmount | number | Used in conjunction with IncreaseBy amount, an optional maximum flat amount serving as a guaranteed issue limit. | |
| (root) | |||
rates | VoluntaryLife.CriticalIllnessRating | ||
| rates | |||
rates.options | VoluntaryLife.IssueAgeChangeRuleOptionsRateInitialEntrantAgeOptionsRateOptionsType | ||
rates.options.isIssueAge | boolean | An issue age policy is one in which premium is based on the age at the time the policy is issued and does not change as member ages unless a change in coverage occurs. | |
rates.options.issueAgeChangeRule | string | Rerated updates all coverage based on the age at the time of coverage change. Stacked retains the cost for the original coverage, and only calculates a new rate for the additional portion of the coverage based on the age at the time of the change. Original Issue Rated will always use the original issue age for original coverage and coverage changes. · Unspecified, ReRated, Stacked, OriginalIssueRated | |
rates.options.annualPolicyFee | number | An annual fee added to the total cost for each policy. Annual fee is applied to both the employee and the spouse policy. | |
rates.options.rateInitialEntrantAgeOn | string | Rate initial entrant according to age on selected option. When isIssueAge = true and issueAgeChangeRule = Stacked then all four enumerations are applicable; else only three enumerations are applicable for all other configurations (Unspecified, CalculatedEligibilityDate, PriorPolicyAnniversary). · Unspecified, CalculatedEligibilityDate, PriorPolicyAnniversary | |
rates.options.ageBandChangeUpdateOn | string | Specifies when to update rate upon age band change. · Unspecified, FirstOfMonthFollowing, FirstOfSpecifiedMonth, Birthday | |
rates.options.ageBandChangesMonth | string | Identifies the month when rate changes are to be applied when the age band change option is specified as FirstOfSpecifiedMonth. · Unspecified, January, February, March, April, May, June, July, August, September, October, November, December | |
rates.options.tobaccoRateBasedOn | string | When rates are based on tobacco usage, this determines how tobacco rates are applied to each covered member. CoveredMember will apply the applicable tobacco rate to each covered member based on their own designated tobacco usage status. Employee will apply the rate based on the Employee’s tobacco usage status to both Employee and Spouse. EmployeeOrSpouse will apply the tobacco rates if either Employee or Spouse are designated as a tobacco user. · Unspecified, CoveredMember, Employee, EmployeeOrSpouse | |
rates.employee | VoluntaryLife.CriticalIllnessEmployeeRating | ||
rates.employee.ageBasedRates | VoluntaryLife.AgeBasedRating | ||
rates.employee.ageBasedRates.rates | array of AgeBandedRate | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.employee.ageBasedRates.rates.fromAge | integer | ✓ | |
rates.employee.ageBasedRates.rates.toAge | integer | ✓ | |
rates.employee.ageBasedRates.rates.rate | number | ✓ | |
rates.employee.ageBasedRates.genderBasedRates | array of AgeBandedGenderBasedRates | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.employee.ageBasedRates.genderBasedRates.fromAge | integer | ✓ | The lowest age in the range. |
rates.employee.ageBasedRates.genderBasedRates.toAge | integer | ✓ | The highest age in the range. |
rates.employee.ageBasedRates.genderBasedRates.rateMale | number | ✓ | The amount of money that must be paid to receive a specific amount of insurance under this plan if a Male. |
rates.employee.ageBasedRates.genderBasedRates.rateFemale | number | ✓ | The amount of money that a must be paid to receive a specific amount of insurance under this plan if a Female. |
rates.employee.ageBasedRates.tobaccoBasedRates | array of AgeBandedTobaccoBasedRates | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.employee.ageBasedRates.tobaccoBasedRates.fromAge | integer | ✓ | |
rates.employee.ageBasedRates.tobaccoBasedRates.toAge | integer | ✓ | |
rates.employee.ageBasedRates.tobaccoBasedRates.rateNonsmoker | number | ✓ | |
rates.employee.ageBasedRates.tobaccoBasedRates.rateSmoker | number | ✓ | |
rates.employee.compositeAgeBasedRates | CriticalIllness.CompositeAgeBasedRating | ||
rates.employee.compositeAgeBasedRates.benefitBasedRates | array of CriticalIllness.BenefitBasedRates | List of rates by benefit amount (e.g., per 10,000, per 20,000). | |
rates.employee.compositeAgeBasedRates.benefitBasedRates.benefitAmount | number | The benefit amount the list of rates is based on (e.g., 10000, 20000). | |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierRates | array of CoverageTierAgeBandedTieredRate | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierRates.tier | string | ✓ | Unspecified, Employee, EmployeePlusSpouse, EmployeePlusChildren, EmployeePlusFamily |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierRates.fromAge | integer | ✓ | |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierRates.toAge | integer | ✓ | |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierRates.rate | number | ✓ | |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierGenderBasedRates | array of CoverageTierAgeBandedTieredGenderBasedRates | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierGenderBasedRates.tier | string | ✓ | Unspecified, Employee, EmployeePlusSpouse, EmployeePlusChildren, EmployeePlusFamily |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierGenderBasedRates.fromAge | integer | ✓ | |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierGenderBasedRates.toAge | integer | ✓ | |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierGenderBasedRates.rateMale | number | ✓ | |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierGenderBasedRates.rateFemale | number | ✓ | |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierTobaccoBasedRates | array of CoverageTierAgeBandedTieredTobaccoBasedRates | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierTobaccoBasedRates.tier | string | ✓ | Unspecified, Employee, EmployeePlusSpouse, EmployeePlusChildren, EmployeePlusFamily |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierTobaccoBasedRates.fromAge | integer | ✓ | |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierTobaccoBasedRates.toAge | integer | ✓ | |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierTobaccoBasedRates.rateNonsmoker | number | ✓ | |
rates.employee.compositeAgeBasedRates.benefitBasedRates.tierTobaccoBasedRates.rateSmoker | number | ✓ | |
rates.employee.compositeAgeBasedRates.perThousandBasedRates | CriticalIllness.PerThousandBasedRates | ||
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierRates | array of CoverageTierAgeBandedTieredRate | ||
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierRates.tier | string | ✓ | Unspecified, Employee, EmployeePlusSpouse, EmployeePlusChildren, EmployeePlusFamily |
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierRates.fromAge | integer | ✓ | |
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierRates.toAge | integer | ✓ | |
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierRates.rate | number | ✓ | |
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierGenderBasedRates | array of CoverageTierAgeBandedTieredGenderBasedRates | ||
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierGenderBasedRates.tier | string | ✓ | Unspecified, Employee, EmployeePlusSpouse, EmployeePlusChildren, EmployeePlusFamily |
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierGenderBasedRates.fromAge | integer | ✓ | |
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierGenderBasedRates.toAge | integer | ✓ | |
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierGenderBasedRates.rateMale | number | ✓ | |
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierGenderBasedRates.rateFemale | number | ✓ | |
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierTobaccoBasedRates | array of CoverageTierAgeBandedTieredTobaccoBasedRates | ||
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierTobaccoBasedRates.tier | string | ✓ | Unspecified, Employee, EmployeePlusSpouse, EmployeePlusChildren, EmployeePlusFamily |
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierTobaccoBasedRates.fromAge | integer | ✓ | |
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierTobaccoBasedRates.toAge | integer | ✓ | |
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierTobaccoBasedRates.rateNonsmoker | number | ✓ | |
rates.employee.compositeAgeBasedRates.perThousandBasedRates.tierTobaccoBasedRates.rateSmoker | number | ✓ | |
rates.spouse | VoluntaryLife.SpouseRating | ||
rates.spouse.ageBasedRates | VoluntaryLife.SpouseAgeBasedRating | ||
rates.spouse.ageBasedRates.options | VoluntaryLife.SpouseAgeBasedOptionsType | ||
rates.spouse.ageBasedRates.options.spouseRatedOnEmployeeAge | boolean | When rates are based on age, this determines when spouse rates are calculated based on the employee age. | |
rates.spouse.ageBasedRates.rates | array of AgeBandedRate | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.spouse.ageBasedRates.rates.fromAge | integer | ✓ | |
rates.spouse.ageBasedRates.rates.toAge | integer | ✓ | |
rates.spouse.ageBasedRates.rates.rate | number | ✓ | |
rates.spouse.ageBasedRates.genderBasedRates | array of AgeBandedGenderBasedRates | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.spouse.ageBasedRates.genderBasedRates.fromAge | integer | ✓ | The lowest age in the range. |
rates.spouse.ageBasedRates.genderBasedRates.toAge | integer | ✓ | The highest age in the range. |
rates.spouse.ageBasedRates.genderBasedRates.rateMale | number | ✓ | The amount of money that must be paid to receive a specific amount of insurance under this plan if a Male. |
rates.spouse.ageBasedRates.genderBasedRates.rateFemale | number | ✓ | The amount of money that a must be paid to receive a specific amount of insurance under this plan if a Female. |
rates.spouse.ageBasedRates.tobaccoBasedRates | array of AgeBandedTobaccoBasedRates | Provide age ranges with no overlap in ages or gaps between ages (e.g. Single year age range would be fromAge: 25 toAge: 25, fromAge: 26 toAge: 26. Multi-year range would be fromAge: 20 toAge:29 and fromAge:30 toAge: 39). | |
rates.spouse.ageBasedRates.tobaccoBasedRates.fromAge | integer | ✓ | |
rates.spouse.ageBasedRates.tobaccoBasedRates.toAge | integer | ✓ | |
rates.spouse.ageBasedRates.tobaccoBasedRates.rateNonsmoker | number | ✓ | |
rates.spouse.ageBasedRates.tobaccoBasedRates.rateSmoker | number | ✓ | |
rates.child | VoluntaryLife.ChildRating | ||
rates.child.options | VoluntaryLife.ChildRateOptionsType | ||
rates.child.options.childRatesBasedOnAllChildren | boolean | This specifies when the same rate is applied regardless of the number of covered children. When each child is assessed their own rates, the plan does not use All Children rates. | |
rates.child.flatRate | VoluntaryLife.ChildFlatRating | ||
rates.child.flatRate.rate | number | ||
rates.child.benefitBasedRates | VoluntaryLife.ChildBenefitBasedRating | ||
rates.child.benefitBasedRates.rates | array of VoluntaryLife.ChildBenefitRateType | ||
rates.child.benefitBasedRates.rates.benefitIncrement | number | ✓ | |
rates.child.benefitBasedRates.rates.rate | number | ✓ | |
| (root) | |||
contributions | VoluntaryLife.Contribution | ||
| contributions | |||
contributions.contributionGroupings | array of VoluntaryLife.ContributionGrouping | ✓ | A list of monthly contributions by a specified contribution grouping (e.g., everyone, by class, by department). |
contributions.contributionGroupings.contributionGroupingBasedOn | string | The textual description of what the specified contribution grouping is based on. | |
contributions.contributionGroupings.monthlyContributions | array of VoluntaryLife.MonthlyContributions | ✓ | A list of the monthly plan contributions. |
contributions.contributionGroupings.monthlyContributions.memberType | string | ✓ | Defines the universal level of member types covered by the plan based on the selected plan benefit type. · Unspecified, Employee, Spouse, Child |
contributions.contributionGroupings.monthlyContributions.contributionBasis | string | ✓ | Defines whether the contribution is based on what the employee or employer will pay to cover the cost of the plan. · Unspecified, Employer, Employee |
contributions.contributionGroupings.monthlyContributions.contributionType | string | ✓ | Defines whether the contribution is represented as a percent or a flat dollar amount. · Unspecified, Percentage, BenefitAmount |
contributions.contributionGroupings.monthlyContributions.contribution | number | ✓ | The actual amount or percent that an employee or employee will pay to cover the cost of the plan. |
| EN field path | Type | Req | Description / enum |
|---|---|---|---|
| (root) | |||
planIdentifier | string | ✓ | The unique identifier assigned for the purpose of identifying a plan. This value is the key used to link a plan between the two systems and how we will communicate about the plan. A plan is a set of benefit of rates and should not include billing groups. |
configuration | PlanConfiguration | ✓ | |
| configuration | |||
configuration.policyNumber | string | Value assigned to the plan for the specific company | |
configuration.carrierName | string | ||
configuration.planName | string | ||
configuration.startDate | string | ✓ | Effective date representing the most recent plan year start date for the current set of benefits and rates. Our plans couple benefits and rates together. |
configuration.endDate | string | Effective date representing the plan year end date for the current set of benefits and rates. Typically plans are 12-month plan years, unless policy is Issue Age and rates do not change. | |
configuration.nextRenewalDate | string | Effective date of coverage for next annual open enrollment. | |
configuration.carrierPlanCode | string | Specifies a plan code assigned by the carrier to identify a plan. This value would be returned with the enrollment record. | |
configuration.carrierPlanTypeCode | string | Specifies a plan code assigned by the carrier to identify the plan type. This value would be returned with the enrollment record. | |
configuration.planBillOption | string | Unspecified, SelfBill, ListBill | |
configuration.isSelfFunded | boolean | ||
configuration.situsState | string | The state in which the legal, organizational entity exists or originated. Send the State Name or the 2-character ISO abbreviation. Either value will be accepted. | |
configuration.benefit | string | ✓ | Medical, Dental, Vision, Life, ADAndD, VoluntaryLife, VoluntaryADAndD, ShortTermDisability, VoluntaryShortTermDisability, LongTermDisability, VoluntaryLongTermDisability, Prescription, CriticalIllness, HospitalIndemnity, PermanentLife, Tricare, IdentityProtection, LaboratoryServices, Legal, SupplementalMedical, Accident, Cancer, Telemedicine |
configuration.originalPlanStartDate | string | Date the plan initially began between the carrier and group. | |
configuration.carrierPlanTypeDescription | string | A carrier-defined standardized description that categorizes plans based on common characteristics. For example, medical plans may be categorized as HMO, PPO, etc.; dental plans as DHMO, etc. Note that this description is limited to 150 characters. | |
| (root) | |||
planDependencies | HospitalIndemnity.HospitalIndemnityPlanDependencies | ||
| planDependencies | |||
planDependencies.benefitEnrollmentDependency | HospitalIndemnity.HospitalIndemnityPlanBenefitEnrollmentDependency | ||
planDependencies.benefitEnrollmentDependency.enrollmentBenefit | string | ✓ | The pre-defined benefit category a plan may be dependent upon. · Medical, Dental, Vision, Prescription, Tricare, IdentityProtection, LaboratoryServices, Legal, SupplementalMedical, Accident, Cancer, Telemedicine |
| (root) | |||
eligibilityOptions | array of PlanEligibilityOptions | ||
| eligibilityOptions | |||
eligibilityOptions.groupStructure | PlanEligibilityGroupStructure | ||
eligibilityOptions.groupStructure.eligibilityGroups | array of PlanEligibilityGroup | A list of employee categorizations mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.groupStructure.eligibilityGroups.eligibilityGroupCode | string | A carrier-assigned, unique identifier for an employee categorization mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.eligibilityRules | PlanEligibilityRules | ||
eligibilityOptions.eligibilityRules.waitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.waitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.waitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.entryDateRule | string | Used in conjunction with Waiting Period to define when the coverage is effective after the waiting period for a new employee. Use First of the Month Coinciding With or After rule when waiting period ending on the first of the month has entry on that day. Use First of the Month After when waiting period ending on the first of the month has entry on the first of the next month. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.terminationRule | string | Used to define the last day of coverage on loss of eligibility. · Unspecified, EndOfMonthOfTermination, EmploymentTermination, FirstOfMonthAfterEmploymentTermination | |
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehirePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.rehirePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.rehirePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehireEntryDateRule | string | Used in conjunction with Rehire Period to define when coverage is effective after rehire date for employees rehired within the rehire period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.eligibilityChangeEntryDateRule | string | Used in conjunction with Eligibility Change Waiting Period to define when the coverage is effective after the employee becomes eligible after a classification change and completes waiting period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
| (root) | |||
planCommunications | PlanCommunications | ||
| planCommunications | |||
planCommunications.marketingDescription | string | Customizes the employee enrollment experience with marketing information about the benefits of the plan. | |
planCommunications.benefitSummaryUrl | string | Customizes the employee enrollment experience with a URL hosting the benefit summary. | |
| (root) | |||
options | SharedOptionsType | ||
| options | |||
options.employeeOptions | EmployeePlanOptions | ||
options.employeeOptions.ageIneligible | integer | Age member is no longer eligible to be covered under plan. | |
options.employeeOptions.allowOverageContinuation | boolean | Provision enabling member to remain enrolled in plan when reaching ageIneligible. | |
options.employeeOptions.requiresAgeRestriction | boolean | Indicates whether the plan requires member level age rules to be configured placing limitations on when a member would be eligible for coverage. | |
| (root) | |||
dependentOptions | Medical.MedicalDependentOptionsType | ||
| dependentOptions | |||
dependentOptions.spouseOptions | Medical.MedicalDependentSpouseOptionsType | ||
dependentOptions.spouseOptions.ageIneligible | integer | Age member is no longer eligible to be covered under plan. | |
dependentOptions.spouseOptions.allowOverageContinuation | boolean | Provision enabling member to remain enrolled in plan when reaching ageIneligible. | |
dependentOptions.spouseOptions.requiresAgeRestriction | boolean | Indicates whether the plan requires member level age rules to be configured placing limitations on when a member would be eligible for coverage. | |
dependentOptions.childOptions | Medical.MedicalDependentChildOptionsType | ||
dependentOptions.childOptions.ageIneligible | integer | Age non-student dependent child is no longer eligible. | |
dependentOptions.childOptions.studentAgeIneligible | integer | Age student child is no longer eligible to be covered under the plan. | |
dependentOptions.childOptions.dropOverageChildOn | string | Used in conjunction with AgeIneligible and StudentAgeIneligible, specifies the last day of coverage when a child becomes ineligible due to age. · Unspecified, EndOfMonth, Birthday, EndOfPlan, EndOfCalendarYear | |
| (root) | |||
benefit | HospitalIndemnity.Benefit | ||
| benefit | |||
benefit.annualBenefitAmount | number | ||
| (root) | |||
rates | Medical.WorksiteRating | ||
| rates | |||
rates.compositeRates | Medical.CompositeRating | ||
rates.compositeRates.tierRates | array of Medical.CompositeRateType | ||
rates.compositeRates.tierRates.tier | string | ✓ | Unspecified, Employee, EmployeePlusSpouse, EmployeePlusOne, EmployeePlusChild, EmployeePlusChildren, EmployeePlusFamily, EmployeePlusDomesticPartner, EmployeePlusSpousePlusChild, EmployeePlusTwo, EmployeePlusTwoChildren, EmployeePlusThreeChildren, EmployeePlusThree, EmployeePlusFour, EmployeePlusSpousePlusTwoChildren, EmployeePlusSpousePlusThreeChildren |
rates.compositeRates.tierRates.rate | number | ✓ | Monthly rate |
rates.ageBasedRates | Medical.WorksiteAgeBasedRating | ||
rates.ageBasedRates.options | Medical.WorksiteAgeBasedOptionsType | ||
rates.ageBasedRates.options.isIssueAge | boolean | An issue age policy is one in which premium is based on the age at the time the policy is issued and does not change as member ages unless a change in coverage occurs. | |
rates.ageBasedRates.options.issueAgeChangeRule | string | Rerated updates all coverage based on the age at the time of coverage change. Stacked retains the cost for the original coverage, and only calculates a new rate for the additional portion of the coverage based on the age at the time of the change. Original Issue Rated will always use the original issue age for original coverage and coverage changes. · Unspecified, ReRated, Stacked | |
rates.ageBasedRates.tierRates | array of MedicalAgeBandedTieredRate | ||
rates.ageBasedRates.tierRates.tier | string | ✓ | Unspecified, Employee, EmployeePlusSpouse, EmployeePlusOne, EmployeePlusChild, EmployeePlusChildren, EmployeePlusFamily, EmployeePlusDomesticPartner, EmployeePlusSpousePlusChild, EmployeePlusTwo, EmployeePlusTwoChildren, EmployeePlusThreeChildren, EmployeePlusThree, EmployeePlusFour, EmployeePlusSpousePlusTwoChildren, EmployeePlusSpousePlusThreeChildren |
rates.ageBasedRates.tierRates.fromAge | integer | ✓ | |
rates.ageBasedRates.tierRates.toAge | integer | ✓ | |
rates.ageBasedRates.tierRates.rate | number | ✓ | |
| (root) | |||
contributions | Medical.Contribution | ||
| contributions | |||
contributions.contributionGroupings | array of Medical.ContributionGrouping | ✓ | A list of monthly contributions by a specified contribution grouping (e.g., everyone, by class, by department). |
contributions.contributionGroupings.contributionGroupingBasedOn | string | The textual description of what the specified contribution grouping is based on. | |
contributions.contributionGroupings.tierMonthlyContributions | array of Medical.MonthlyContribution | ✓ | A list of the monthly plan contributions. |
contributions.contributionGroupings.tierMonthlyContributions.contributionTier | string | ✓ | Defines the universal level of contribution tiers by the employee (including dependents) covered by the plan based on the selected plan benefit type. · Unspecified, Employee, EmployeePlusSpouse, EmployeePlusOne, EmployeePlusChild, EmployeePlusChildren, EmployeePlusFamily, EmployeePlusDomesticPartner, EmployeePlusSpousePlusChild, EmployeePlusTwo, EmployeePlusTwoChildren, EmployeePlusThreeChildren, EmployeePlusThree, EmployeePlusFour, EmployeePlusSpousePlusTwoChildren, EmployeePlusSpousePlusThreeChildren |
contributions.contributionGroupings.tierMonthlyContributions.contributionBasis | string | ✓ | Defines whether the contribution is based on what the employee or employer will pay to cover the cost of the plan. · Unspecified, Employer, Employee |
contributions.contributionGroupings.tierMonthlyContributions.contributionType | string | ✓ | Defines whether the contribution is represented as a percent or a flat dollar amount. · Unspecified, Percentage, FlatDollarAmount |
contributions.contributionGroupings.tierMonthlyContributions.contribution | number | ✓ | The actual amount or percent that an employee or employee will pay to cover the cost of the plan. |
contributions.contributionGroupings.tierMonthlyContributions.upToContributionAmount | number | A dollar amount that limits the overall contribution when the contributionType is percent. | |
| EN field path | Type | Req | Description / enum |
|---|---|---|---|
| (root) | |||
planIdentifier | string | ✓ | The unique identifier assigned for the purpose of identifying a plan. This value is the key used to link a plan between the two systems and how we will communicate about the plan. A plan is a set of benefit of rates and should not include billing groups. |
configuration | PlanConfiguration | ✓ | |
| configuration | |||
configuration.policyNumber | string | Value assigned to the plan for the specific company | |
configuration.carrierName | string | ||
configuration.planName | string | ||
configuration.startDate | string | ✓ | Effective date representing the most recent plan year start date for the current set of benefits and rates. Our plans couple benefits and rates together. |
configuration.endDate | string | Effective date representing the plan year end date for the current set of benefits and rates. Typically plans are 12-month plan years, unless policy is Issue Age and rates do not change. | |
configuration.nextRenewalDate | string | Effective date of coverage for next annual open enrollment. | |
configuration.carrierPlanCode | string | Specifies a plan code assigned by the carrier to identify a plan. This value would be returned with the enrollment record. | |
configuration.carrierPlanTypeCode | string | Specifies a plan code assigned by the carrier to identify the plan type. This value would be returned with the enrollment record. | |
configuration.planBillOption | string | Unspecified, SelfBill, ListBill | |
configuration.isSelfFunded | boolean | ||
configuration.situsState | string | The state in which the legal, organizational entity exists or originated. Send the State Name or the 2-character ISO abbreviation. Either value will be accepted. | |
configuration.benefit | string | ✓ | Medical, Dental, Vision, Life, ADAndD, VoluntaryLife, VoluntaryADAndD, ShortTermDisability, VoluntaryShortTermDisability, LongTermDisability, VoluntaryLongTermDisability, Prescription, CriticalIllness, HospitalIndemnity, PermanentLife, Tricare, IdentityProtection, LaboratoryServices, Legal, SupplementalMedical, Accident, Cancer, Telemedicine |
configuration.originalPlanStartDate | string | Date the plan initially began between the carrier and group. | |
configuration.carrierPlanTypeDescription | string | A carrier-defined standardized description that categorizes plans based on common characteristics. For example, medical plans may be categorized as HMO, PPO, etc.; dental plans as DHMO, etc. Note that this description is limited to 150 characters. | |
| (root) | |||
planDependencies | Accident.AccidentPlanDependencies | ||
| planDependencies | |||
planDependencies.benefitEnrollmentDependency | Accident.AccidentPlanBenefitEnrollmentDependency | ||
planDependencies.benefitEnrollmentDependency.enrollmentBenefit | string | ✓ | The pre-defined benefit category a plan may be dependent upon. · Medical, Dental, Vision, Prescription, HospitalIndemnity, Tricare, IdentityProtection, LaboratoryServices, Legal, SupplementalMedical, Cancer, Telemedicine |
| (root) | |||
eligibilityOptions | array of PlanEligibilityOptions | ||
| eligibilityOptions | |||
eligibilityOptions.groupStructure | PlanEligibilityGroupStructure | ||
eligibilityOptions.groupStructure.eligibilityGroups | array of PlanEligibilityGroup | A list of employee categorizations mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.groupStructure.eligibilityGroups.eligibilityGroupCode | string | A carrier-assigned, unique identifier for an employee categorization mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.eligibilityRules | PlanEligibilityRules | ||
eligibilityOptions.eligibilityRules.waitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.waitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.waitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.entryDateRule | string | Used in conjunction with Waiting Period to define when the coverage is effective after the waiting period for a new employee. Use First of the Month Coinciding With or After rule when waiting period ending on the first of the month has entry on that day. Use First of the Month After when waiting period ending on the first of the month has entry on the first of the next month. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.terminationRule | string | Used to define the last day of coverage on loss of eligibility. · Unspecified, EndOfMonthOfTermination, EmploymentTermination, FirstOfMonthAfterEmploymentTermination | |
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehirePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.rehirePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.rehirePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehireEntryDateRule | string | Used in conjunction with Rehire Period to define when coverage is effective after rehire date for employees rehired within the rehire period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.eligibilityChangeEntryDateRule | string | Used in conjunction with Eligibility Change Waiting Period to define when the coverage is effective after the employee becomes eligible after a classification change and completes waiting period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
| (root) | |||
planCommunications | PlanCommunications | ||
| planCommunications | |||
planCommunications.marketingDescription | string | Customizes the employee enrollment experience with marketing information about the benefits of the plan. | |
planCommunications.benefitSummaryUrl | string | Customizes the employee enrollment experience with a URL hosting the benefit summary. | |
| (root) | |||
options | SharedOptionsType | ||
| options | |||
options.employeeOptions | EmployeePlanOptions | ||
options.employeeOptions.ageIneligible | integer | Age member is no longer eligible to be covered under plan. | |
options.employeeOptions.allowOverageContinuation | boolean | Provision enabling member to remain enrolled in plan when reaching ageIneligible. | |
options.employeeOptions.requiresAgeRestriction | boolean | Indicates whether the plan requires member level age rules to be configured placing limitations on when a member would be eligible for coverage. | |
| (root) | |||
dependentOptions | Medical.MedicalDependentOptionsType | ||
| dependentOptions | |||
dependentOptions.spouseOptions | Medical.MedicalDependentSpouseOptionsType | ||
dependentOptions.spouseOptions.ageIneligible | integer | Age member is no longer eligible to be covered under plan. | |
dependentOptions.spouseOptions.allowOverageContinuation | boolean | Provision enabling member to remain enrolled in plan when reaching ageIneligible. | |
dependentOptions.spouseOptions.requiresAgeRestriction | boolean | Indicates whether the plan requires member level age rules to be configured placing limitations on when a member would be eligible for coverage. | |
dependentOptions.childOptions | Medical.MedicalDependentChildOptionsType | ||
dependentOptions.childOptions.ageIneligible | integer | Age non-student dependent child is no longer eligible. | |
dependentOptions.childOptions.studentAgeIneligible | integer | Age student child is no longer eligible to be covered under the plan. | |
dependentOptions.childOptions.dropOverageChildOn | string | Used in conjunction with AgeIneligible and StudentAgeIneligible, specifies the last day of coverage when a child becomes ineligible due to age. · Unspecified, EndOfMonth, Birthday, EndOfPlan, EndOfCalendarYear | |
| (root) | |||
rates | Medical.WorksiteRating | ||
| rates | |||
rates.compositeRates | Medical.CompositeRating | ||
rates.compositeRates.tierRates | array of Medical.CompositeRateType | ||
rates.compositeRates.tierRates.tier | string | ✓ | Unspecified, Employee, EmployeePlusSpouse, EmployeePlusOne, EmployeePlusChild, EmployeePlusChildren, EmployeePlusFamily, EmployeePlusDomesticPartner, EmployeePlusSpousePlusChild, EmployeePlusTwo, EmployeePlusTwoChildren, EmployeePlusThreeChildren, EmployeePlusThree, EmployeePlusFour, EmployeePlusSpousePlusTwoChildren, EmployeePlusSpousePlusThreeChildren |
rates.compositeRates.tierRates.rate | number | ✓ | Monthly rate |
rates.ageBasedRates | Medical.WorksiteAgeBasedRating | ||
rates.ageBasedRates.options | Medical.WorksiteAgeBasedOptionsType | ||
rates.ageBasedRates.options.isIssueAge | boolean | An issue age policy is one in which premium is based on the age at the time the policy is issued and does not change as member ages unless a change in coverage occurs. | |
rates.ageBasedRates.options.issueAgeChangeRule | string | Rerated updates all coverage based on the age at the time of coverage change. Stacked retains the cost for the original coverage, and only calculates a new rate for the additional portion of the coverage based on the age at the time of the change. Original Issue Rated will always use the original issue age for original coverage and coverage changes. · Unspecified, ReRated, Stacked | |
rates.ageBasedRates.tierRates | array of MedicalAgeBandedTieredRate | ||
rates.ageBasedRates.tierRates.tier | string | ✓ | Unspecified, Employee, EmployeePlusSpouse, EmployeePlusOne, EmployeePlusChild, EmployeePlusChildren, EmployeePlusFamily, EmployeePlusDomesticPartner, EmployeePlusSpousePlusChild, EmployeePlusTwo, EmployeePlusTwoChildren, EmployeePlusThreeChildren, EmployeePlusThree, EmployeePlusFour, EmployeePlusSpousePlusTwoChildren, EmployeePlusSpousePlusThreeChildren |
rates.ageBasedRates.tierRates.fromAge | integer | ✓ | |
rates.ageBasedRates.tierRates.toAge | integer | ✓ | |
rates.ageBasedRates.tierRates.rate | number | ✓ | |
| (root) | |||
contributions | Medical.Contribution | ||
| contributions | |||
contributions.contributionGroupings | array of Medical.ContributionGrouping | ✓ | A list of monthly contributions by a specified contribution grouping (e.g., everyone, by class, by department). |
contributions.contributionGroupings.contributionGroupingBasedOn | string | The textual description of what the specified contribution grouping is based on. | |
contributions.contributionGroupings.tierMonthlyContributions | array of Medical.MonthlyContribution | ✓ | A list of the monthly plan contributions. |
contributions.contributionGroupings.tierMonthlyContributions.contributionTier | string | ✓ | Defines the universal level of contribution tiers by the employee (including dependents) covered by the plan based on the selected plan benefit type. · Unspecified, Employee, EmployeePlusSpouse, EmployeePlusOne, EmployeePlusChild, EmployeePlusChildren, EmployeePlusFamily, EmployeePlusDomesticPartner, EmployeePlusSpousePlusChild, EmployeePlusTwo, EmployeePlusTwoChildren, EmployeePlusThreeChildren, EmployeePlusThree, EmployeePlusFour, EmployeePlusSpousePlusTwoChildren, EmployeePlusSpousePlusThreeChildren |
contributions.contributionGroupings.tierMonthlyContributions.contributionBasis | string | ✓ | Defines whether the contribution is based on what the employee or employer will pay to cover the cost of the plan. · Unspecified, Employer, Employee |
contributions.contributionGroupings.tierMonthlyContributions.contributionType | string | ✓ | Defines whether the contribution is represented as a percent or a flat dollar amount. · Unspecified, Percentage, FlatDollarAmount |
contributions.contributionGroupings.tierMonthlyContributions.contribution | number | ✓ | The actual amount or percent that an employee or employee will pay to cover the cost of the plan. |
contributions.contributionGroupings.tierMonthlyContributions.upToContributionAmount | number | A dollar amount that limits the overall contribution when the contributionType is percent. | |
| EN field path | Type | Req | Description / enum |
|---|---|---|---|
| (root) | |||
planIdentifier | string | ✓ | The unique identifier assigned for the purpose of identifying a plan. This value is the key used to link a plan between the two systems and how we will communicate about the plan. A plan is a set of benefit of rates and should not include billing groups. |
configuration | PlanConfiguration | ✓ | |
| configuration | |||
configuration.policyNumber | string | Value assigned to the plan for the specific company | |
configuration.carrierName | string | ||
configuration.planName | string | ||
configuration.startDate | string | ✓ | Effective date representing the most recent plan year start date for the current set of benefits and rates. Our plans couple benefits and rates together. |
configuration.endDate | string | Effective date representing the plan year end date for the current set of benefits and rates. Typically plans are 12-month plan years, unless policy is Issue Age and rates do not change. | |
configuration.nextRenewalDate | string | Effective date of coverage for next annual open enrollment. | |
configuration.carrierPlanCode | string | Specifies a plan code assigned by the carrier to identify a plan. This value would be returned with the enrollment record. | |
configuration.carrierPlanTypeCode | string | Specifies a plan code assigned by the carrier to identify the plan type. This value would be returned with the enrollment record. | |
configuration.planBillOption | string | Unspecified, SelfBill, ListBill | |
configuration.isSelfFunded | boolean | ||
configuration.situsState | string | The state in which the legal, organizational entity exists or originated. Send the State Name or the 2-character ISO abbreviation. Either value will be accepted. | |
configuration.benefit | string | ✓ | Medical, Dental, Vision, Life, ADAndD, VoluntaryLife, VoluntaryADAndD, ShortTermDisability, VoluntaryShortTermDisability, LongTermDisability, VoluntaryLongTermDisability, Prescription, CriticalIllness, HospitalIndemnity, PermanentLife, Tricare, IdentityProtection, LaboratoryServices, Legal, SupplementalMedical, Accident, Cancer, Telemedicine |
configuration.originalPlanStartDate | string | Date the plan initially began between the carrier and group. | |
configuration.carrierPlanTypeDescription | string | A carrier-defined standardized description that categorizes plans based on common characteristics. For example, medical plans may be categorized as HMO, PPO, etc.; dental plans as DHMO, etc. Note that this description is limited to 150 characters. | |
| (root) | |||
planDependencies | Cancer.CancerPlanDependencies | ||
| planDependencies | |||
planDependencies.benefitEnrollmentDependency | Cancer.CancerPlanBenefitEnrollmentDependency | ||
planDependencies.benefitEnrollmentDependency.enrollmentBenefit | string | ✓ | The pre-defined benefit category a plan may be dependent upon. · Medical, Dental, Vision, Prescription, HospitalIndemnity, Tricare, IdentityProtection, LaboratoryServices, Legal, SupplementalMedical, Accident, Telemedicine |
| (root) | |||
eligibilityOptions | array of PlanEligibilityOptions | ||
| eligibilityOptions | |||
eligibilityOptions.groupStructure | PlanEligibilityGroupStructure | ||
eligibilityOptions.groupStructure.eligibilityGroups | array of PlanEligibilityGroup | A list of employee categorizations mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.groupStructure.eligibilityGroups.eligibilityGroupCode | string | A carrier-assigned, unique identifier for an employee categorization mutually agreed upon between the insurance carrier and the group with similar employment information that are all offered the same insurance plan benefit. | |
eligibilityOptions.eligibilityRules | PlanEligibilityRules | ||
eligibilityOptions.eligibilityRules.waitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.waitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.waitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.entryDateRule | string | Used in conjunction with Waiting Period to define when the coverage is effective after the waiting period for a new employee. Use First of the Month Coinciding With or After rule when waiting period ending on the first of the month has entry on that day. Use First of the Month After when waiting period ending on the first of the month has entry on the first of the next month. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.terminationRule | string | Used to define the last day of coverage on loss of eligibility. · Unspecified, EndOfMonthOfTermination, EmploymentTermination, FirstOfMonthAfterEmploymentTermination | |
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.reinstateCoverageGracePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehirePeriod | PlanEligibilityRehirePeriod | ||
eligibilityOptions.eligibilityRules.rehirePeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.rehirePeriod.durationType | string | Unspecified, Days, Months, Weeks | |
eligibilityOptions.eligibilityRules.rehireEntryDateRule | string | Used in conjunction with Rehire Period to define when coverage is effective after rehire date for employees rehired within the rehire period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod | PlanEligibilityCoverageWaitingPeriod | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.duration | integer | ||
eligibilityOptions.eligibilityRules.eligibilityChangeWaitingPeriod.durationType | string | Unspecified, Days, Months, Quarters | |
eligibilityOptions.eligibilityRules.eligibilityChangeEntryDateRule | string | Used in conjunction with Eligibility Change Waiting Period to define when the coverage is effective after the employee becomes eligible after a classification change and completes waiting period. · Unspecified, HireDate, FirstOfMonthAfter, FirstOfMonthCoincidingWithOrAfter, FifteenthOfMonthAfter, FifteenthOfMonthCoincidingWithOrAfter | |
| (root) | |||
planCommunications | PlanCommunications | ||
| planCommunications | |||
planCommunications.marketingDescription | string | Customizes the employee enrollment experience with marketing information about the benefits of the plan. | |
planCommunications.benefitSummaryUrl | string | Customizes the employee enrollment experience with a URL hosting the benefit summary. | |
| (root) | |||
options | SharedOptionsType | ||
| options | |||
options.employeeOptions | EmployeePlanOptions | ||
options.employeeOptions.ageIneligible | integer | Age member is no longer eligible to be covered under plan. | |
options.employeeOptions.allowOverageContinuation | boolean | Provision enabling member to remain enrolled in plan when reaching ageIneligible. | |
options.employeeOptions.requiresAgeRestriction | boolean | Indicates whether the plan requires member level age rules to be configured placing limitations on when a member would be eligible for coverage. | |
| (root) | |||
dependentOptions | Medical.MedicalDependentOptionsType | ||
| dependentOptions | |||
dependentOptions.spouseOptions | Medical.MedicalDependentSpouseOptionsType | ||
dependentOptions.spouseOptions.ageIneligible | integer | Age member is no longer eligible to be covered under plan. | |
dependentOptions.spouseOptions.allowOverageContinuation | boolean | Provision enabling member to remain enrolled in plan when reaching ageIneligible. | |
dependentOptions.spouseOptions.requiresAgeRestriction | boolean | Indicates whether the plan requires member level age rules to be configured placing limitations on when a member would be eligible for coverage. | |
dependentOptions.childOptions | Medical.MedicalDependentChildOptionsType | ||
dependentOptions.childOptions.ageIneligible | integer | Age non-student dependent child is no longer eligible. | |
dependentOptions.childOptions.studentAgeIneligible | integer | Age student child is no longer eligible to be covered under the plan. | |
dependentOptions.childOptions.dropOverageChildOn | string | Used in conjunction with AgeIneligible and StudentAgeIneligible, specifies the last day of coverage when a child becomes ineligible due to age. · Unspecified, EndOfMonth, Birthday, EndOfPlan, EndOfCalendarYear | |
| (root) | |||
rates | Medical.WorksiteRating | ||
| rates | |||
rates.compositeRates | Medical.CompositeRating | ||
rates.compositeRates.tierRates | array of Medical.CompositeRateType | ||
rates.compositeRates.tierRates.tier | string | ✓ | Unspecified, Employee, EmployeePlusSpouse, EmployeePlusOne, EmployeePlusChild, EmployeePlusChildren, EmployeePlusFamily, EmployeePlusDomesticPartner, EmployeePlusSpousePlusChild, EmployeePlusTwo, EmployeePlusTwoChildren, EmployeePlusThreeChildren, EmployeePlusThree, EmployeePlusFour, EmployeePlusSpousePlusTwoChildren, EmployeePlusSpousePlusThreeChildren |
rates.compositeRates.tierRates.rate | number | ✓ | Monthly rate |
rates.ageBasedRates | Medical.WorksiteAgeBasedRating | ||
rates.ageBasedRates.options | Medical.WorksiteAgeBasedOptionsType | ||
rates.ageBasedRates.options.isIssueAge | boolean | An issue age policy is one in which premium is based on the age at the time the policy is issued and does not change as member ages unless a change in coverage occurs. | |
rates.ageBasedRates.options.issueAgeChangeRule | string | Rerated updates all coverage based on the age at the time of coverage change. Stacked retains the cost for the original coverage, and only calculates a new rate for the additional portion of the coverage based on the age at the time of the change. Original Issue Rated will always use the original issue age for original coverage and coverage changes. · Unspecified, ReRated, Stacked | |
rates.ageBasedRates.tierRates | array of MedicalAgeBandedTieredRate | ||
rates.ageBasedRates.tierRates.tier | string | ✓ | Unspecified, Employee, EmployeePlusSpouse, EmployeePlusOne, EmployeePlusChild, EmployeePlusChildren, EmployeePlusFamily, EmployeePlusDomesticPartner, EmployeePlusSpousePlusChild, EmployeePlusTwo, EmployeePlusTwoChildren, EmployeePlusThreeChildren, EmployeePlusThree, EmployeePlusFour, EmployeePlusSpousePlusTwoChildren, EmployeePlusSpousePlusThreeChildren |
rates.ageBasedRates.tierRates.fromAge | integer | ✓ | |
rates.ageBasedRates.tierRates.toAge | integer | ✓ | |
rates.ageBasedRates.tierRates.rate | number | ✓ | |
| (root) | |||
contributions | Medical.Contribution | ||
| contributions | |||
contributions.contributionGroupings | array of Medical.ContributionGrouping | ✓ | A list of monthly contributions by a specified contribution grouping (e.g., everyone, by class, by department). |
contributions.contributionGroupings.contributionGroupingBasedOn | string | The textual description of what the specified contribution grouping is based on. | |
contributions.contributionGroupings.tierMonthlyContributions | array of Medical.MonthlyContribution | ✓ | A list of the monthly plan contributions. |
contributions.contributionGroupings.tierMonthlyContributions.contributionTier | string | ✓ | Defines the universal level of contribution tiers by the employee (including dependents) covered by the plan based on the selected plan benefit type. · Unspecified, Employee, EmployeePlusSpouse, EmployeePlusOne, EmployeePlusChild, EmployeePlusChildren, EmployeePlusFamily, EmployeePlusDomesticPartner, EmployeePlusSpousePlusChild, EmployeePlusTwo, EmployeePlusTwoChildren, EmployeePlusThreeChildren, EmployeePlusThree, EmployeePlusFour, EmployeePlusSpousePlusTwoChildren, EmployeePlusSpousePlusThreeChildren |
contributions.contributionGroupings.tierMonthlyContributions.contributionBasis | string | ✓ | Defines whether the contribution is based on what the employee or employer will pay to cover the cost of the plan. · Unspecified, Employer, Employee |
contributions.contributionGroupings.tierMonthlyContributions.contributionType | string | ✓ | Defines whether the contribution is represented as a percent or a flat dollar amount. · Unspecified, Percentage, FlatDollarAmount |
contributions.contributionGroupings.tierMonthlyContributions.contribution | number | ✓ | The actual amount or percent that an employee or employee will pay to cover the cost of the plan. |
contributions.contributionGroupings.tierMonthlyContributions.upToContributionAmount | number | A dollar amount that limits the overall contribution when the contributionType is percent. | |