Skip to main content
Version: v0.0.2

Interface: Build278ReviewSpec

One services-review item - a patient-event (EV, Loop 2000E) or service (SS, Loop 2000F) HL. Carries the UM review information, the optional HCR decision (response only), echoed TRN traces, HI diagnoses, attached provider NM1s, and the supplemental REF / DTP / MSG. Nested reviews become child HLs (an SS service under an EV event) parented to this review. Mirrors "./types.js".X12ServiceReview.

Example​

import type { Build278ReviewSpec } from "@cosyte/x12";
const r: Build278ReviewSpec = {
  levelCode: "EV", requestCategoryCode: "HS", certificationTypeCode: "I", serviceTypeCode: "1",
  traces: [{ traceTypeCode: "1", referenceId: "AUTHREQ-202606-0001" }],
  diagnoses: [{ qualifier: "ABK", code: "E1165" }],
  dates: [{ qualifier: "472", formatQualifier: "RD8", value: "20260601-20260605" }],
};

Properties​

certificationTypeCode?​

readonly optional certificationTypeCode?: string

UM-02 - certification type code (I initial / R renewal).

dates?​

readonly optional dates?: readonly Build278DateSpec[]

Supplemental DTP dates.

decision?​

readonly optional decision?: Build278DecisionSpec

HCR decision - RESPONSE ONLY (a request review carrying one is refused).

diagnoses?​

readonly optional diagnoses?: readonly Build278DiagnosisSpec[]

HI diagnosis composites (emitted as one HI segment).

levelCode?​

readonly optional levelCode?: "EV" | "SS"

HL-03 - review level code (EV patient event / SS service). Default "EV".

levelOfServiceCode?​

readonly optional levelOfServiceCode?: string

UM-06 - level of service code.

messages?​

readonly optional messages?: readonly string[]

MSG free-form messages.

providers?​

readonly optional providers?: readonly Build278EntitySpec[]

Attached provider NM1s (rendering / attending / operating).

references?​

readonly optional references?: readonly Build278ReferenceSpec[]

Supplemental REF identifiers.

requestCategoryCode​

readonly requestCategoryCode: string

UM-01 - request category code (required; a review with none is refused).

reviews?​

readonly optional reviews?: readonly Build278ReviewSpec[]

Nested service (SS) reviews parented to this review.

serviceTypeCode?​

readonly optional serviceTypeCode?: string

UM-03 - service type code.

traces?​

readonly optional traces?: readonly Build278TraceSpec[]

Loop 2000E/2000F TRN traces.