Assemble the ISA/GS envelope for transaction set 834 (Benefit Enrollment and Maintenance) with your sender ID (the employer or benefits administrator) and the receiver ID (the health plan or TPA)
Construct the BGN segment to indicate whether this is an initial enrollment file, a change file, or a full replacement file; replacement files replace all existing enrollment data for the group, so use them only when intended
For each member, build an INS segment specifying the member's relationship to the subscriber (self, spouse, child) and the maintenance type code indicating whether this is an addition, change, or termination of coverage
Add REF segments for member IDs (SSN, member ID), DTP segments for coverage effective and termination dates, and NM1/PER segments for member demographics and contact information
Include HD segments to specify the health coverage plan code, coverage type, and insurance line for each plan the member is enrolling in; attach COB segments if the member has other insurance
Close with SE, GE, and IEA trailers and transmit to the health plan via the agreed channel (SFTP or API with YOUR_TOKEN); confirm receipt of a 999 functional acknowledgment before considering the enrollment submitted
Known gotchas
The BGN-02 reference number must be unique per file submission; health plans use this to track file versions, and duplicate reference numbers may cause the file to be treated as a resend rather than a new submission
An 834 with maintenance type 001 (addition) for a member who is already enrolled may create a duplicate enrollment or an error depending on the health plan's system behavior; always send 002 (change) for updates to existing enrollments
Open enrollment season produces extremely high file volumes; confirm with the health plan their file processing windows and whether they impose file size limits or require split files for large employer groups
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp