EDI Manual
This is the operations and reference manual for EDI staff working with the MedSuite RCM gateway — clearinghouse coordinators, payer-relationship managers, and EDI analysts. Unlike the Tenant Manual (which hides X12 internals from billing clerks), this one assumes X12 fluency: segments, loops, qualifiers, and ack codes are first-class citizens.
How this manual is organized
Page template
Every chapter follows the same shape so you can scan it quickly:
- Outcome — what you'll have done after this procedure.
- Prerequisites — scopes, prior chapters, environmental state.
- Diagram — sequence or flow chart, where it helps.
- Anatomy — for transaction-type chapters, the loop / segment shape.
- Steps — operator UI flow first, with deeper internals in disclosure panels.
- Validation — how to confirm success.
- Troubleshooting — common failures and fixes.
- Next — pointer to the related next chapter.
Audience
- EDI operators — daily monitoring, replay, partner support.
- EDI analysts — companion guide authoring, routing rules, partner onboarding.
- EDI / partner-relationship leads — capacity planning, escalations, capability negotiation.
If a chapter requires a specific scope, the Prerequisites section calls it out.
Other manuals
- Tenant Manual — for clinical, billing, and operations staff at tenant organizations. The audience that consumes the outcome of EDI workflows (paid claims, posted remittances) without seeing the X12.
- Platform Admin Manual — for MedSuite engineers operating the multi-tenant infrastructure.
Where to start
If you are new to the platform, read 1.1 — Welcome & X12 envelope refresher first; it grounds you in the dialect the rest of the manual speaks.
If you are coming back to look something specific up:
| Doing | Start at |
|---|---|
| Onboarding a new partner | 2.1 — Onboard a new trading partner |
| Authoring a companion guide | 7.1 — The companion guide editor |
| Daily ops triage | 8.1 — Daily monitoring |
| Reading an unfamiliar segment | 9.2 — Segment cheat-sheet |
| Decoding an ack code | 9.3 — Acknowledgment codes |
| Submitting an outbound 837 | 3.1 — 837P outbound |
| Posting an inbound 835 | 6.1 — 835 inbound |
| Replaying a stuck transaction | 8.2 — Replay & retry |