An official website of the United States government

Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock () or https:// means you've safely connected to the .gov website. Share sensitive information only on official, secure websites.

TMSIS Dataguide Medicaid.gov

Version:

CMS Technical Instructions

CMS Technical Instruction: Populating T-MSIS Claims File Data Elements on Void/Reversal/Cancel Records

Technical Instruction History

Date Description of Change

10/23/2020

Original technical instructions issued

06/24/2022

Technical instructions updated in correspondence with the V3.0.0 data dictionary update:

  • The TOT-COPAY-AMT data element was deprecated.
  • The following data elements were added: TOT-BENEFICIARY-COPAYMENT-LIABLE-AMOUNT, TOT-BENEFICIARY-COINSURANCE-LIABLE-AMOUNT, TOT-BENEFICIARY-DEDUCTIBLE-LIABLE-AMOUNT, and COMBINED-BENE-COST-SHARING-PAID-AMOUNT.
  • The following data elements were renamed: TOT-BENEFICIARY-COINSURANCE-PAID-AMOUNT (formerly known as BENEFICIARY-COINSURANCE-AMOUNT), TOT-BENEFICIARY-COPAYMENT-PAID-AMOUNT (formerly known as BENEFICIARY-COPAYMENT-AMOUNT), TOT-BENEFICIARY-DEDUCTIBLE-PAID-AMOUNT (formerly known as BENEFICIARY-DEDUCTIBLE-AMOUNT), and BENEFICIARY-COPAYMENT-PAID-AMOUNT (formerly known as COPAY-AMT).

11/19/2024

Technical instructions updated in correspondence with V4.0.0 data dictionary update:

  • Updated tables to include data elements in the new FTX file type.

12/2025

Incorporating guidance on submission of adjustment claims to T-MSIS previously found in the T-MSIS Data Guide Appendices.

Brief Issue Description

In T-MSIS, original claims may be adjusted to nullify, replace, or correct information included on the original claim. The reporting of these records that are voids/reversals/cancellations of previously submitted FFS claims and encounters is important for the accurate interpretation of records and identification of Medicaid utilization and expenditures in T-MSIS. Furthermore, completely and accurately populating data elements on void/reversal/cancel records allows for the records to be appropriately linked to the most recently submitted original/adjustment record[1] . Consistent reporting across states is necessary for accurate interpretation of the data. The following technical instruction document describes how the progression of adjudication should be reflected in T-MSIS submissions and addresses how to appropriately populate data elements on these adjudicated records.

Challenges

Some states do not currently follow the requirements for reporting void/reversal/cancel records as specified in the T-MSIS data dictionary. This is particularly an issue for the reporting of expenditures. States take various approaches for populating data elements in void/reversal/cancel records, leading to inconsistency in interstate comparisons, questions regarding the accuracy of the reporting, and potential inaccurate interpretations of the state’s data. Some states have raised questions about how to populate the dollar amount and quantity data elements on void/reversal/cancel records. While state Medicaid programs and MMIS may differ, it is important that states utilize uniform T-MSIS reporting methods where those opportunities exist.

CMS Technical Instruction

Claim Family Reporting: Progression of submitting adjustment claims

A claim family (also known as an adjustment set) is defined as a set of post-adjudication claim transactions in paid or denied status that relate to the same provider/enrollee/services/dates of service. This grouping of the original claim and all its subsequent adjustment and/or void claims shows the progression of changes that have occurred since it was first submitted. Every “final” adjudicated version of the claim/encounter should be submitted to T-MSIS. A “final” adjudicated version of the claim/encounter is a claim that has completed the adjudication process and the paid/denied process. The claim and each claim line will have one of the finalized claim status categories listed in T-MSIS Data Dictionary. The actual position of the claim can be either “paid” or “denied”.

Both original claims (or encounters) and adjusted claims (or encounters) can be a “final adjudicated version of the claim/encounter.” Whenever a claim/encounter flows through the adjudication and payment process (if applicable) and falls into one of the claim status categories listed in the T-MSIS Data Dictionary., the state should send the claim/encounter to T-MSIS. If a claim flows through the adjudication and payment processes and flows into one of the finalized claim status categories multiple times within a single T-MSIS reporting period, CMS expects each of these final adjudicated versions of the claim/encounter to be submitted to T-MSIS, not just the one effective on the last day of the reporting period. If the claim has not been through the final adjudication process or is “pending” (or in “suspense”), the claim should not be sent to T-MSIS until disposition has been settled to one of the finalized claim status categories. Table 1 provides examples of CMS’ expectations.

Table 1 – Scenarios for When to Submit Original and Adjusted Claims

Claim Submission Scenario CMS’ Expectation
Adjudicated and paid in the same reporting month CMS expects the claim to be sent to T-MSIS in the reporting month.
Adjudicated in one reporting period, but paid in another reporting month CMS expects the claim to be sent to T-MSIS in the month that the claim was paid.
Adjudicated and paid in one reporting month, and then re-adjudicated and paid in a subsequent month The claim should be reported in the month it is paid, regardless of whether it is an original claim or an adjustment. Therefore, in this scenario, CMS expects the original to be reported in month one and the adjustment to be reported in the subsequent month.
Adjudicated and paid, and then re-adjudicated and paid in the same reporting period In this scenario, if a claim flows through the adjudication and payment processes and falls into one of the claim status categories in Table 1 multiple times within a single T-MSIS reporting period, CMS expects each of these final adjudicated versions of the claim/encounter to be submitted to T-MSIS, not just the one effective on the last day of the reporting period.
Re-adjudicated and paid multiple times in the same reporting period In this scenario, if a claim flows through the adjudication and payment processes and falls into one of the claim categories in Table 1 multiple times within a single T-MSIS reporting period, CMS expects each of these final adjudicated versions of the claim/encounter to be submitted to T-MSIS, not just the one effective on the last day of the reporting period.

Approaches to tying the members of a claim family together

There are two ways original claims, and their subsequent adjustments can be linked into a claim family – either through all adjustments linking back to the original claim or each subsequent adjustment linking back to the prior claim (i.e., daisy chain). Identifying the members of a claim family is necessary to support accurate evaluation of claim lifecycle changes.

The Original ICN Approach - Under this approach, the state assigns an ICN to the initial final adjudicated version of the claim/encounter and records this identifier in the ICN-ORIG field. If adjustment claim subsequently are created, the ICN assigned to the initial final adjudicated version of the claim/encounter is carried forward on every subsequent adjustment claim.

The Daisy-Chain ICN Approach - Under this approach, the state records the ICN of the previous final adjudicated version of the claim/encounter in the ICN-ORIG field of the adjustment claim record. If additional adjustment claims are subsequently created, the ICN-ORIG on the new adjustment claim only points back one generation.

Table 2 provides examples of void claims linked to previous records using both the original ICN approach (rows 1 – 3) as well as the daisy chain ICN approach (rows 4 - 6). Both examples represent a claim family where the original claim is first followed by an adjustment that corrects the value reported in the TOT-BILLED-AMT and then followed by a void/reversal/cancel record. In addition to states ensuring that the ICN-ORIG and ICN-ADJ are correctly populated, states using the original ICN approach should ensure that the ADJUDICATION-DATE on claims and PAYMENT-OR-RECOUPMENT-DATEE[a] and/or PAYMENT-DATE[a] on financial transactions is populated accurately. The record in the claim family with the most recent ADJUDICATION-DATE, PAYMENT-OR-RECOUPMENT-DATE or PAYMENT-DATE will be identified as the most recent submission of the claim[3].

Table 2 – Using record keys to link void claims to prior submissions

[a] This is a new data element as of T-MSIS Data Dictionary V4.0.0.

Row Number SUBMITTING-STATE ICN-ORIG ICN-ADJ ADJUSTMENT-IND ADJUDICATION-DATE TOT-BILLED-AMT

Original ICN Method

1

XX

0897100

0

12/4/2019

$1000

2

XX

0897100

0897101

4

1/18/2020

$100

3

XX

0897100

0897102

1

3/7/2020

$100

Daisy Chain ICN Method

4

XX

1235674

0

12/4/2019

$1000

5

XX

1235674

7654987

4

1/18/2020

$100

6

XX

7654987

0129384

1

3/7/2020

$100

If a state uses a process to record adjustments whereby, they void the previous version of the claim and then follow-up with the creation of a new original transaction, and the state can identify that the void and the new original claim are from the same adjudication set, the state should link them together into one claims family using the ICN-ORIG. CMS recognizes that some states may not be able to link a resubmitted claim after a void to the original claim. Table 3 illustrates how CMS is expecting the states to populate the ICN-ORIG/ICN-ADJ fields when the state processes a void/new original when adjusting claims. CMS expects a void transaction to have a $0.00 dollar amount.

Table 3 – Void/New Original Scenario

SUBMITTING-STATE ICN-ORIG ICN-ADJ ADJUSTMENT-IND ADJUDICATION-DATE Dollar Fields Quantity Fields
XX 234567 - 0 06/01/2019 $100.00 5
XX 234567 - 1 08/15/2019 $0.00 0
XX 234567 - 0 08/15/2019 $80.00 5
XX 234567 - 1 09/20/2019 $0.00 0
XX 234567 - 0 09/20/2019 $60.00 5

Transactions impacting the cost of care that are not FFS claims or encounters: Financial Transactions (FTX)

In previous iterations of T-MSIS prior to v4, claim files were also used to capture expenditures that impacted the cost of care, but which were not technically claims or encounter records. These were referred to as “gross adjustments” and created challenges for states building T-MSIS Claims Files and for downstream users trying to interpret T-MSIS data. To address these challenges, these transactions were removed from the claims files and placed into their own file type. There are currently nine distinct types of financial transactions included in the FTX file. CMS does not expect any denied FTX claims to be reported to T-MSIS. The FTX file segments do not contain data or valid values to indicate a financial transaction is denied. Financial transactions can be reported as original, void, or (credit/debit) adjustments.

States may use the claims family algorithm in the same manner as claims or encounters for financial transactions. When states report financial transaction adjustments using related ICN values (through ICN-ORIG or ICN-ADJ) apply ADJUSTMENT-IND values of ‘1’ (Void) or ‘4’ (Replacement), T-MSIS processing will apply claim family logic to identify related transactions. In these cases, the most recent transaction completely voids or replaces the prior transaction, consistent with standard adjustment processing.

If a state does not employ the claims family algorithm, then each financial transaction stands on its own and remains active in the T-MSIS database, with multiple transactions of the same type being additive rather than superseding prior records. For example, states whose systems do not adjust transactions in sequence and do not completely void or replace prior transactions through ICN linkage, a beneficiary- or enrollee-specific recoupments with an ADJUSTMENT-IND value ‘0’ (Original) may be the only applicable value with a negative payment amount. While negative payment amounts are not typically expected on original transactions, they are appropriate when a financial transaction reflects a credit or recoupment and is not directly linked to a prior transaction that is fully voids or replaces.

For instance, a state pays a managed care entity a monthly capitation for 1,000 enrollees for the month of May 2024. In June 2024, it is determined that 5 of the enrollees included in the May 2024 capitation were, in fact, not enrolled in the MCO. Table 4 illustrates how a state may recoup the overpayment.

Table 4 – Capitation Recoupment Scenario

SUBMITTING-STATE ICN-ORIG ICN-ADJ ADJUSTMENT-IND ADJUDICATION-DATE Dollar Fields
Approach using claims family logic (original ICN method)
XX 0897100 0 05/02/2024 $1,000.00
XX 0897100 0897256 1 06/01/2024 $0.00
XX 0897100 0897256 4 06/01/2024 $995.00
Approach using a separate original financial transaction
XX 0897104 0 05/02/2024 $1,000.00
XX 0958523 0 06/01/2024 -$5.00

Populating Data Elements on Adjudicated Claims

The following section provides further information on how to populate data elements on void/reversal/cancel records in T-MSIS. While this primarily addresses reporting void/reversal/cancel records for FFS claims and encounters, it also applies to financial transactions like capitation payments that are adjusted using claim-based replace and void/reversal/cancel processes. Again, financial transactions reported in the FTX file may or may not follow claim family logic.

For the purposes of these technical instructions, the data elements reported on void/reversal/cancel records are grouped into four categories based upon how the data elements are populated by the state.

  • Record Key data elements should be reported with values that uniquely identify the claim and link the void claim to the previously submitted original or adjustment claim or encounter. These data elements are identified in Table 5.
  • X-12 transaction data elements should be reported with values related to the processing of the void claim. These data elements are identified in Table 6.
  • Adjudicated quantity data elements should all be reported with a value of “0”. These data elements are identified in Table 7.
  • Carry Over data elements should be reported with values reported on the previous original or adjustment claim or encounter. These represent all data elements not identified Table 5, Table 6 or Table 7.

Record key data elements are populated with information that uniquely identifies a record and links it to all other records in a claim family[2]. The record keys are also used to link the information reported on the claim header to the claim line record. These data elements are reported in Table 5a/5b. All void/reversal/cancel records should be reported with ADJUSTMENT-IND and LINE-ADJUSTMENT-IND values of “1”. The other primary key data elements should be populated consistent with T-MSIS Data Dictionary. The adjudication date, payment date, or recoupment date should be populated with the date on which payment status of the claim was finally adjudicated by the state, as per the T-MSIS data dictionary. As previously discussed, the ICN-ORIG and ICN-ADJ data elements should be populated with values that link the void to the most recently submitted original/adjustment record in the claim family

Table 5a – Record Key Data Elements

Data Element Name Data Element Number
Claim Header Detail IP LT OT RX
SUBMITTING-STATE CIP017 CLT017 COT017 CRX017
ICN-ORIG CIP019 CLT019 COT019 CRX019
ICN-ADJ CIP020 CLT020 COT020 CRX020
ADJUSTMENT-IND CIP026 CLT025 COT025 CRX025
ADJUDICATION-DATE CIP098 CLT050 COT035 CRX027
Claim Line Detail IP LT OT RX
SUBMITTING-STATE CIP232 CLT185 COT155 CRX109
ICN-ORIG CIP235 CLT188 COT158 CRX112
ICN-ADJ CIP236 CLT189 COT159 CRX113
LINE-ADJUSTMENT-IND CIP239 CLT192 COT162 CRX116
ADJUDICATION-DATE CIP286 CLT233 COT221 CRX157

Table 5b – Record Key Data Elements in the Financial Transactions File (FTX)

Record Segment Detail (FTX) FTX Data Element Number [a]

SUBMITTING-STATE

FTX018, FTX065, FTX106, FTX150, FTX193, FTX237, FTX280, FTX319, or FTX358

ICN-ORIG

FTX020, FTX067, FTX108, FTX152, FTX195, FTX239, FTX282, FTX321, or FTX360

ICN-ADJ

FTX021, FTX068, FTX109, FTX153, FTX196, FTX240, FTX283, FTX322, or FTX361

ADJUSTMENT-IND

FTX023, FTX020, FTX111, FTX155, FTX198, FTX242, FTX285, FTX324, or FTX363

RECORD-ID

FTX017, FTX064, FTX105, FTX149, FTX192, FTX236, FTX279, FTX318, or FTX357

PAYMENT-OR-RECOUPMENT-DATE[a]

FTX024, FTX071, FTX156, FTX199, FTX243, FTX286, FTX325, or FTX364

PAYMENT-DATE[a] (FTX00004 only)

FTX112

MSIS-IDENTIFICATION-NUM (FTX00004 only)

FTX127

SSN (FTX00004 only)

FTX128

[a] The Data Element Number will depend on the type of financial transaction and the corresponding FTX segment.

[b] This is a new data element as of T-MSIS Data Dictionary V4.0.0.

“X-12 transaction” data elements are populated with information on how the void/reversal/cancel record was processed. These data elements are identified in Table 6 below. If the X-12 transaction values are not applicable to the void/reversal/cancel claim or encounter, then the data element should be reported with a null value. For example, if a void only has one Remittance Advice Remark Code (RARC), then the CLAIM-PYMT-REM-CODE-2 through CLAIM-PYMT-REM-CODE-4 would be populated with a null value.

Table 6 – X-12 Transaction Data Elements

Data Element Name Data Element Number Data Element Number Data Element Number Data Element Number

Claim Header Detail

IP

LT

OT

RX

ADJUSTMENT-REASON-CODE

CIP027

CLT026

COT026

CRX026

CLAIM-STATUS

CIP102

CLT054

COT039

CRX030

CLAIM-STATUS-CATEGORY

CIP103

CLT055

COT040

CRX031

CLAIM-PYMT-REM-CODE-1

CIP108

CLT059

COT044

CRX035

CLAIM-PYMT-REM-CODE-2

CIP109

CLT060

COT045

CRX036

CLAIM-PYMT-REM-CODE-3

CIP110

CLT061

COT046

CRX037

CLAIM-PYMT-REM-CODE-4

CIP111

CLT062

COT047

CRX038

Claim Line Detail

IP

LT

OT

RX

LINE-ADJUSTMENT-REASON-CODE

CIP240

CLT193

COT163

CRX117

CLAIM-LINE-STATUS

CIP242

CLT195

COT165

CRX119

“Adjudicated quantity” data elements are populated with values that are derived through the adjudication of the FFS claim or encounter. All “adjudicated quantity” data elements should be populated with a value of “0” on a void record. The specific data elements that should be reported with a value of “0” on void/reversal/cancel records are identified in Table 7. These are values that would include the allowed amounts, the payment amounts, and the quantities of service allowed. These data elements should be populated with “0” because the void/reversal/cancel in T-MSIS is supposed to represent the final net liability for the services on the FFS claim or encounter. The adjudicated dollar amounts and quantities on the FFS claim or encounter should not reflect the marginal change in dollar amounts or quantities before and after the void/reversal/cancel occurred. Reporting positive or negative values in these fields raises question regarding how the void/reversal/cancel records should be interpreted and whether the ADJUSTMENT-IND value is accurate.

Table 7 - Adjudicated Quantity Data Elements (Claims Files)

Data Element Name Data Element Number Data Element Number Data Element Number Data Element Number

Claim Header Detail

IP

LT

OT

RX

TOT-ALLOWED-AMT

CIP113

CLT064

COT049

CRX040

TOT-MEDICAID-PAID-AMT

CIP114

CLT065

COT050

CRX041

TOT-MEDICARE-DEDUCTIBLE-AMT

CIP116

CLT067

COT052

CRX043

TOT-MEDICARE-COINS-AMT

CIP117

CLT068

COT053

CRX044

NON-COV-DAYS

CIP134

CLT084

NON-COV-CHARGES

CIP135

CLT085

MEDICAID-COV-INPATIENT-DAYS

CIP136

CLT086

ICF-IID-DAYS

CLT147

NURSING-FACILITY-DAYS

CLT149

LTC-RCP-LIAB-AMT

CIP297[b]

CLT145

COT235[b]

CRX173[b]

MEDICAID-AMOUNT-PAID-DSH

CIP220

DRG-OUTLIER-AMT

CIP194

TOT-BENEFICIARY-COPAYMENT-LIABLE-AMOUNT[c]

CIP292

CLT239

COT230

CRX163

TOT-BENEFICIARY-COINSURANCE-LIABLE-AMOUNT[d]

CIP293

CLT240

COT231

CRX164

TOT-BENEFICIARY-DEDUCTIBLE-LIABLE-AMOUNT[c]

CIP294

CLT241

COT232

CRX165

COMBINED-BENE-COST-SHARING-PAID-AMOUNT[c]

CIP295

CLT242

COT233

CRX166

TOT-BENEFICIARY-COINSURANCE-PAID-AMOUNT[d]

CIP206

CLT153

COT130

CRX087

TOT-BENEFICIARY-COPAYMENT-PAID-AMOUNT[e]

CIP208

CLT155

COT132

CRX089

TOT-BENEFICIARY-DEDUCTIBLE-PAID-AMOUNT[f]

CIP210

CLT157

COT134

CRX092

Claim Line Detail

IP

LT

OT

RX

ALLOWED-AMT

CIP252

CLT205

COT175

CRX122

BENEFICIARY-COPAYMENT-PAID-AMOUNT[g]

COT176

CRX123

MEDICAID-PAID-AMT

CIP254

CLT208

COT178

CRX125

MEDICARE-DEDUCTIBLE-AMT

CRX127

MEDICARE-COINS-AMT

CRX128

SERVICE-QUANTITY-ALLOWED

COT184

REVENUE-CENTER-QUANTITY-ALLOWED

CIP250

CLT203

MEDICAID-FFS-EQUIVALENT-AMT

CIP255

CLT209

COT179

CRX126

[c] This is a new data element as of T-MSIS Data Dictionary V3.0.0.

[d] This data element was formerly known as BENEFICIARY-COINSURANCE-AMOUNT before T-MSIS Data Dictionary V3.0.0.

[e] This data element was formerly known as BENEFICIARY-COPAYMENT-AMOUNT before T-MSIS Data Dictionary V3.0.0.

[f] This data element was formerly known as BENEFICIARY-DEDUCTIBLE-AMOUNT before T-MSIS Data Dictionary V3.0.0.

[g] This data element was formerly known as COPAY-AMT before T-MSIS Data Dictionary V3.0.0.

Note: States should populate MBESCBES-FORM-GROUP (CIP.003.340, CLT.003.28, COT.003.290, CRX.003.209) on voided or replacement claims (when Medicaid Paid Amount is $0 or less than $0).

Table 7b - Adjudicated Quantity Data Elements (FTX File)

Data Element Name Data Element Number

PAYMENT-OR-RECOUPMENT-AMOUNT

FTX025, FTX157, FTX200, FTX244, FTX287, FTX326, FTX365

PAYMENT-AMOUNT

FTX072, FTX113

Endnotes

All other data elements should be populated with the values from the most recent parent record that is being voided/reversed/cancelled. An example of this is presented in Table 2 in rows 2 and 3. The TOT-BILLED-AMT reported on the void record in row 3 is the same value that is reported in the TOT-BILLED-AMT reported on the adjustment record in row 2.

How Adjustment Records will be Applied by CMS

There is an inherent limitation in the way that CMS can interpret what to do with two claim transactions having the same ICN-ORIG and ADJUDICATION-DATE when both transactions are received in a single submission file. The processing rules that T-MSIS will follow are outlined below. It is up to each state to ensure that claim transactions are processed in the appropriate sequence. If the rules below do not result in the sequence of transactions that the state desires, it is up to the state to submit transactions in separate files so that the desired sequence is attained.

The following provides guidance on inserting claim transactions into the T-MSIS database. The five data elements below identify a particular claim transaction (i.e., this is the claim key)

  • submitting_state
  • icn_orig
  • icn_adj
  • adjudication_date
  • adjustment_ind

Within the T-MSIS system, claim family IDs are composed of the hash of the ANSI submitting state id, file type, reporting period, sequence number, and byte offset of the claim in the family from the earliest (by date received) file and with the lowest byte offset within that file. Inactive versions of claims in the claims family (that is inactive records with the same record key as any of the active claims that compose the claims family) are included in the set of claims considered for generation of the claims family id. This ensures that even if the claim that is used to generate a claims family’s ID is subsequently updated, the claims family’s ID will remain stable. If two claims transactions have the same key, the active instance is determined by evaluating these data elements:

  1. claim_header_reporting_period
  2. claim_header_byte_offset
  3. submitting_state
  4. tmsis_run_id

Ties based on the above fields are broken by sorting on (a) reporting period of the file containing the claim, (b) sequence number of the file, and (c) byte offset of the claim within the file

[1] In T-MSIS, voids, reversals, and cancels are identified when ADJUSTMENT-IND and LINE-ADJUSTMENT-IND are reported with a value of “1”.

[2] A claim family is comprised of the original FFS claim or encounter and each subsequent adjustment and, void/cancel/reversal of that original FFS claim or encounter.

[3] If two records in the same claim family are submitted with the same ADJUDICATION-DATE on the same T-MSIS claim file submission using the original ICN method, then a tiebreaker methodology will select the adjustment/replace record over the void/reversal/cancel record.  Two void/reversal/cancel records will generate an error under this scenario.