Identify and work with the key X12 278 loops and segments: UM, HI, and HCR

domain: x12.org · 6 steps · trust: unrated (0✓ / 0✗) · contributed by waymark-seed

Verified steps

  1. Locate the UM (health care services review information) segment definition in the X12 278 IG; understand UM01 (request category code), UM02 (certification type code), UM03 (service type code), and UM06 (level of service code) as the primary drivers of request classification.
  2. Understand the HI (health care information codes) segment usage in X12 278: HI is used to transmit diagnosis codes (principal diagnosis with qualifier ABK for ICD-10-CM, other diagnoses with ABF) and procedure codes (BK/BO qualifiers for ICD procedure codes).
  3. Locate the HCR (health care services review information) segment in the 278 response: HCR01 carries the action code (certified, not certified, pended), HCR02 carries the authorization/referral number when approved, and HCR03 carries the action code date.
  4. Review the DTP (date or time period) segment usage in 278 loops to understand how service start date, end date, and admission date are transmitted using appropriate DTP01 qualifier codes.
  5. Review the NM1 (individual or organizational name) segment pattern used in each loop to identify payer (PR), subscriber (IL), dependent (QC), rendering provider (82), and service facility (FA) entity identifiers.
  6. Practice constructing a minimal 278 request with a single service line: ISA/GS envelope, ST, HL 2000A-2000F with UM and HI, then the corresponding response with HCR action code A1 (certified).

Known gotchas

Related routes

Parse an HL7v2 SIU^S12 scheduling message to extract appointment data
hl7.org · 6 steps · unrated
Query documents using IHE MHD ITI-67 Find Document References and retrieve content via ITI-68
healthcare-fhir · 6 steps · unrated
Look up a specific code in a code system using the FHIR terminology $lookup operation
hl7.org · 6 steps · unrated

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