​
Explicit Config

In previous versions of Noyo, member snapshots required explicit carrier configuration to be defined on every incoming snapshot as detailed in Mapping plans and account structures. This is a multi-step process that involves:

  1. Pulling down the carrier’s view of the group

  2. Mapping your system’s stored information to the carrier’s group structure (benefit classes, subgroups, bill groups, divisions, locations, etc.) along with plans

  3. Sending the correct values on every snapshot

Using explicit carrier configurations will avoid any mapping tasks when connecting a group, but the structures and required fields differ by carrier and often require carrier-by-carrier engineering work.

Sample snapshot carrier configuration blocks:

{
    "benefit_class_identifier": "0001",
    "benefit_subclass_identifier": "0001-01",
    "bill_group_identifier": "0000",
    "bill_subgroup_identifier": "0000",
    "work_location_text": "ABCD1234"
}

For a fully enumerated list of per-carrier fields, see the Carriers page in the Command Center.

​
Dynamic Config (AutoMap)

Dynamic config is recommended for all new Noyo integrations and makes carrier-specific config values no longer required.

Dynamic configuration is a new Noyo feature where the Noyo system automatically maps most values and surfaces any remaining unknown logic to you in the UI for your input. While this may present an extra step when connecting some groups to new carriers, it allows the initial integration to member snapshot to support all carriers and removes the need for carrier-specific fields to be passed in snapshots.

Noyo recommends that you capture as much demographic information about employees and dependents as possible to ensure compatibility with potential future carriers, as different carriers can require different information about employees in order to process enrollments.

Recommended fields include any of the following:

  • Division, branch, team, department, etc.
  • Company location/office name
  • Leveling info (management, supervision, director, executive, key person, etc.)
  • Subsidiary

If there are any subgrouping that determine the benefits a given employee is eligible for, make sure that information is supplied on your snapshots.

This information can be provided via the employee.classificationsobject in the snapshot body.

​
Pre-release Caveats

  • When using sandbox/test groups, explicit configuration may be required. Your implementation team will provide guidance on how to structure snapshots for testing.