The Member Change Workflow
What's happening behind the scenes when you send a snapshot
This section walks you through the complete member change workflow: creating the snapshot, getting snapshots, processing, and checking status.
Step 1: Create and send a member snapshot
Submit a snapshot for an employee and their family using POST /api/v1/groups/:group_id/member_snapshots
.
Populate the Employee section with your custom_individual_id
and the employee’s classifications. Set the Employment information and Employment Dates. Send as much demographic information as possible in the Person and Dependent sections.
Populate the Coverages list by adding a block for each plan or coverage the member and their dependent(s) should be enrolled in:
- Set the
line_of_coverage
andplan_id
to the linked Noyo plan - Set the
carrier_config
block to the member’s chosen account structure option(s) (this section may be blank, or be populated according to individual carrier requirements) - Set the
individual_type
andcustom_individual_id
to match your employee record - Set the
effective_start_date
andeffective_end_date
(if applicable) of the coverage
Populate the Events section with the event_id
, reason, and date for the relevant event.
With this data, a member snapshot should be ready to send. If successful, you should get a response with a new unique ID for the snapshot, the original contents of the snapshot, and an initial status of processing
. Your system should record the new snapshot ID to check on the status (see below).
A more specific breakdown of the snapshot format can be found in the API Reference.
Steps 2-3: Noyo sends changes to the carrier
Noyo validates the request for content and to be sure it has a chance to be processed by the carrier. For full detail on possible responses, see Snapshot Responses.
Noyo will process the snapshot contents, break the snapshot into transactions, generate the correct payload to each target carrier, and check for a response that the transmission was successful. We’ll immediately try to read back from the carrier to see that their data has been updated to match our request. This is the first step of our round-trip confirmation process to ensure that member data is accurate across systems.
4-5: Noyo continuously pulls information from the carrier to confirm success
For each transaction sent via Noyo, we confirm that every detail is completed as expected. Noyo's round-trip confirmation functionality validates changes when they’re sent and then automatically checks the carrier’s system to confirm success on the change's effective date.
6: Check the status of submitted snapshots
At any time after a snapshot has been accepted, you can poll Noyo's snapshot endpoints for the status of each request. See Snapshot Statusfor full details.
7-9: Get the most up-to-date member details
As soon as the carrier has made the requested changes, Noyo updates our system to reflect the new data. This will happen at the same time the snapshot status reaches complete
. At this point, it's possible to use our member data endpoints to pull back the latest info into your own system. If desired, you can use this data for reconciliation, or to support your own internal tooling.
Updated about 2 months ago