X12 CMS-0057-F Compliance

Overview

InteropSuite CMS-0057-F transforms 7 X12 5010 transaction types into FHIR R4 bundles that comply with the CMS Interoperability and Prior Authorization Final Rule using Da Vinci PAS, CARIN Blue Button, and PDex Provenance profiles.

CMS Rule Requirements

• Patient Access API - 42 CFR 438.242(b)(5) - Members access claims via FHIR
• Provider Access API - 42 CFR 438.242(b)(6) - Clinical data exchange
• Prior Authorization API - 42 CFR 438.242(b)(7) - Real-time PA via Da Vinci PAS
• Payer-to-Payer API - 42 CFR 438.242(b)(8) - PDex clinical data exchange

Supported Transactions

CMS-0057-F mode supports 7 X12 5010 transaction types:

Profile Mapping

Each X12 transaction type maps to a specific CMS-required FHIR profile:

Usage

Basic Transformation

// Activate license (once at startup)
Interop.ActivateLicense(licenseKey);

// Transform X12 to CMS-0057-F compliant FHIR
var result = await Interop.X12ToFhirAsync(
    x12Message,
    OutputFormat.Cms0057F
);

if (result.Success)
{
    string fhirJson = result.FhirBundle;
    // CARIN Blue Button, Da Vinci PAS profiles
    // PDex Provenance automatically included
}
else
{
    foreach (var error in result.Errors)
        Console.WriteLine(error);
}

Batch Processing

Process multiple X12 files with CMS-0057-F compliance. For mixed workloads, use unified batch processing (recommended).

Unified Processing Recommended

using InteropSuite.Fhir.Engine.Batch;

// Process all formats with RoundRobin interleaving
var options = new BatchOptions
{
    Sources = new[]
    {
        new BatchSource("./input/hl7", "HL7", OutputFormat.UsCore),
        new BatchSource("./input/x12", "X12", OutputFormat.UsCore),
        new BatchSource("./input/cda", "CDA", OutputFormat.UsCore),
        new BatchSource("./input/cms", "CMS-0057-F", OutputFormat.Cms0057F),
    }
};

var result = await Interop.ProcessBatchAsync(options);

Sequential Processing

// Process CMS-0057-F files only
var options = new BatchOptions
{
    Domain = "CMS-0057-F",
    OutputFormat = OutputFormat.Cms0057F
};

var result = await Interop.ProcessBatchAsync("./input/x12", options);

Console.WriteLine($"Processed: {result.TotalFiles} files");
Console.WriteLine($"Succeeded: {result.Succeeded}");

See User Guide: Batch Processing for complete documentation.

PDex Provenance

CMS-0057-F bundles automatically include PDex Provenance resources that track the source format of the data. This is required for payer-to-payer data exchange.

Source Format Codes

Provenance Example

{
  "resourceType": "Provenance",
  "meta": {
    "profile": ["http://hl7.org/fhir/us/davinci-pdex/StructureDefinition/pdex-provenance"]
  },
  "target": [{"reference": "Claim/claim-001"}],
  "recorded": "2024-01-15T12:00:00Z",
  "agent": [{
    "type": {
      "coding": [{
        "system": "http://hl7.org/fhir/us/davinci-pdex/CodeSystem/ProvenancePayerDataSource",
        "code": "x12837",
        "display": "X12 837 Claims"
      }]
    }
  }]
}

Validation

All CMS-0057-F bundles are validated offline using the Firely SDK with embedded profile packages. No internet connection required.

Embedded Profile Packages

• FHIR R4 4.0.1
• US Core 6.1.0
• HL7 Terminology 5.5.0
• CARIN Blue Button 2.1.0
• Da Vinci PAS 2.0.1
• Da Vinci PDex 2.1.0

Examples

278 Prior Authorization Request

// Transform 278 to Da Vinci PAS compliant bundle
var x278 = File.ReadAllText("prior_auth_request.edi");
var result = await Interop.X12ToFhirAsync(x278, OutputFormat.Cms0057F);

// Result includes:
// - Claim (use: preauthorization)
// - Patient
// - Coverage
// - Organization (insurer)
// - Practitioner (requesting provider)
// - PDex Provenance (source: x12278)

837P Professional Claim

// Transform 837P to CARIN Blue Button compliant bundle
var x837 = File.ReadAllText("professional_claim.edi");
var result = await Interop.X12ToFhirAsync(x837, OutputFormat.Cms0057F);

// Result includes:
// - Claim (CARIN C4BB profile)
// - Patient
// - Coverage
// - Organization (billing provider, payer)
// - Practitioner (rendering, referring)
// - PDex Provenance (source: x12837)

835 Remittance Advice

// Transform 835 to CARIN Blue Button EOB
var x835 = File.ReadAllText("remittance_advice.edi");
var result = await Interop.X12ToFhirAsync(x835, OutputFormat.Cms0057F);

// Result includes:
// - ExplanationOfBenefit (CARIN C4BB profile)
// - Patient
// - Coverage
// - Organization (payer)
// - PDex Provenance (source: x12other)