Capability · X12 as a service

EDI as a service, not per-customer plumbing.

Legacy stacks treat EDI as per-customer plumbing — a trading-partner project per customer, a stored procedure per payer, a script per recovery. The new platform centralises EDI behind canonical events and surfaces every operation as a configuration action.

Transactions

Every X12 transaction the platform speaks.

Twelve transactions cover the eligibility / authorization / claim / remittance lifecycle plus the acknowledgments. Each is implemented end-to-end — not deferred to a future release.

Service Bus event flow

Canonical events in, X12 envelopes out.

The application never builds X12. It publishes canonical events to rcm.* Service Bus topics; consumers in the EDI gateway translate to 837 / 270 / 276 / 278 and dispatch by routing rule. Inbound X12 is parsed back into canonical events and re-published.

Rendering diagram…
Service Bus event flow — rcm-core ↔ edi-gateway ↔ trading partners.
Routing

Declarative routing, not buried T-SQL.

A new payer's EDI capability is enforced at config time, not discovered in production. Routing rules match against state, payer, payer-type, service-line, claim-type, transaction-type, dispatch-mode, and effective dates.

Each routing rule has a precedence score and an effective date. The /routing simulator returns the winning rule and the losing rules for any given inbound claim — so "why did this claim go to clearinghouse A instead of B?" is a click, not an investigation.

Transport modes are first-class: SFTP, REST, AS2, MFT, and a manual fall-back for trading partners that still require an email attachment. Credentials never traverse the application surface — they live in Azure Key Vault and only the edi-gateway worker sees them at dispatch time.

Transport modes supported

  • SFTP Per-partner credentials in Key Vault
  • REST OAuth2 / bearer / mTLS
  • AS2 Trading-partner AS2 IDs + signing certs
  • MFT Managed file transfer hand-off
  • Manual Operator-driven for legacy partners

Routing dimensions

  • state
  • payer
  • payer type
  • service line
  • claim type
  • txn type
  • dispatch mode
  • effective dates
This makes 'we lost a batch' a UI click instead of an incident.
EDI Gateway Features
Replay + companion guides

The two features that change EDI operations.

Replay as a UI button

Dead-letter queue visibility per consumer + exponential backoff + idempotent re-submit. "We lost a batch" used to be an incident with a war-room call and a SQL recovery script. Now it's a row in the replay surface with a button.

  • DLQ visibility per consumer
  • Audit log per replay
  • Idempotent re-submit (won't duplicate)
  • Per-row failure reason + retry count

Companion guides, live-previewable

The companion-guide editor pairs a Monaco YAML pane with a live preview that re-assembles a sample 837 or 270 as you type. Rules are scoped per partner + transaction type; a bad edit fails the validator before production.

  • Monaco editor with YAML schema
  • Sample 837 / 270 preview pane
  • Per-partner + per-transaction scope
  • Draft / approve / publish lifecycle