UDS Data Mapper Validation Rules

This page outlines the validation rules used during record processing by the UDS Data Mapper to ensure data quality. Some of these rules are already implemented, while others are slated for an upcoming release. Each rule is designed to verify specific attributes or relationships within the data.

Implemented Rules: These rules are active in the system and are automatically applied to validate records as they are processed by the UDS Data Mapper.For .txt files (or UDS files), specific formats are expected for certain fields:

  • Dates: Must adhere to a predefined format (e.g., YYYYMMDD).
  • Currency: Must follow strict guidelines for formatting according to the UDS Manual, such as including implied decimals or positive/negative indicators.
  • Agent Commission Rate: Must be formatted as XXXXX to ensure proper ingestion and validation with the implied decimal leaving 2 digits after the decimal.

For .csv files, the system offers more flexibility:

  • Dates: Can be provided in various common formats (e.g., MM/DD/YYYY, YYYY-MM-DD).
  • Currency: Accepts values in any of the formats specified in UDM16 below.

By enforcing these rules, the system ensures compatibility with both legacy .txt UDS files and modern .csv files while maintaining accurate data validation.

In-Development Rules: These rules are being actively developed and will be included in a future release. They cover additional business logic, complex data relationships, and more advanced validation scenarios.

If you have ideas for new validation rules that could improve the system, please feel free to email us at support@guarantysupport.com. We welcome your suggestions and feedback to help improve the UDS data validation process.

This page will be updated as new validation rules are added or existing ones are modified to reflect the latest changes in the system.

 

Implemented Rules

 

Duplicate Entries

UDM1 – Duplicate Entries for A

  • Description: Duplicate detected for record type A.
  • Unique Fields:
    • NAIC Number
    • Insolvent Company Claim Number
    • Coverage Code
    • Claimant Number

UDM2 – Duplicate Entries for B

  • Description: Duplicate detected for record type B.
  • Unique Fields:
    • Policy Number
    • Receiver Claim Number
    • Coverage Code
    • Claimant Number
    • Policy Effective Date
    • Transaction Code

UDM3 – Duplicate Entries for E

  • Description: Duplicate detected for record type E.
  • Unique Fields:
    • Insolvent Company Claim Number
    • Claimant Number
    • Coverage Code

UDM4 – Duplicate Entries for F

  • Description: Duplicate detected for record type F.
  • Unique Fields:
    • Insolvent Company Claim Number
    • Claimant Number
    • Note ID Number
    • Note Line Sequence Number
    • Entry Date

UDM5 – Duplicate Entries for G

  • Description: Duplicate detected for record type G.
  • Unique Fields:
    • Insolvent Company Claim Number
    • Claimant Number
    • Coverage Code
    • Transaction Code
    • Check Amount
    • Check Number

UDM6 – Duplicate Entries for I

  • Description: Duplicate detected for record type I.
  • Unique Fields:
    • Insolvent Company Claim Number
    • Claimant Number
    • Document Path
    • Document File Name

UDM7 – Duplicate Entries for M

  • Description: Duplicate detected for record type M.
  • Unique Fields:
    • Insolvent Company Claim Number
    • Claimant Number
    • CMS

 

Date and Time Errors

UDM8 – Date Error

  • Description: The date is not converting correctly. Acceptable formats are as follows:
Date Format Example Corresponding Format Code
30 Nov 00 %d %b %y
30 November 00 %d %B %y
30 November 2000 %d %B %Y
11/30/00 %m/%d/%y
11/30/2000 %m/%d/%Y
20001130 %Y%m%d
2024-09-25 %Y-%m-%d
25-09-2024 %d-%m-%Y
09/25/2024 %m/%d/%Y
25/09/2024 %d/%m/%Y
25 Sep 2024 %d %b %Y
Sep 25, 2024 %b %d, %Y
September 25, 2024 %B %d, %Y
Wednesday, 25 September 2024 %A, %d %B %Y
  • Affected Fields:
    • A Record – Date of Loss, Policy Effective Date, Policy Expiration Date, Claim Report Date, Claimant Birthday
    • B Record – Date of Loss, Policy Effective Date, Policy Expiration Date, Cancellation Date
    • E Record – Date of Loss, Policy Effective Date, Policy Expiration Date, Claim Report Date, Claimant Birthday
    • F Record – Entry Date
    • G Record – Check Date, Service or Benefit from Date, Service or Benefit to Date
    • I Record – Capture Date

UDM9 – Non Leap Year

  • Description: The date provided is not valid. It may be a leap year day but not within a valid leap year.
  • Affected Fields:
    • A Record – Date of Loss, Policy Effective Date, Policy Expiration Date, Claim Report Date, Claimant Birthday
    • B Record – Date of Loss, Policy Effective Date, Policy Expiration Date, Cancellation Date
    • E Record – Date of Loss, Policy Effective Date, Policy Expiration Date, Claim Report Date, Claimant Birthday
    • F Record – Entry Date
    • G Record – Check Date, Service or Benefit from Date, Service or Benefit to Date
    • I Record – Capture Date

UDM10 – UDS Time Error

  • Description: The time entered is not in UDS time format (HHMMSS).
  • Affected Fields:
    • I Record – Capture Time

UDM11 – Cancellation Date Error

  • Description: The Cancellation Date must be between the Policy Effective Date and Policy Expiration Date, inclusively.
  • Affected Fields:
    • B Record – Cancellation Date

UDM12 – Date of Loss Error

  • Description: Date of Loss must be later than the Policy Effective Date.
  • Affected Fields:
    • A Record – Date of Loss, Policy Effective Date, Policy Expiration Date
    • B Record – Date of Loss, Policy Effective Date, Policy Expiration Date
    • E Record – Date of Loss, Policy Effective Date, Policy Expiration Date

UDM13 – Policy Expiration Date Error

  • Description: Policy Expiration Date must be greater than or equal to the Policy Effective Date.
  • Affected Fields:
    • A Record – Policy Expiration Date
    • B Record – Policy Expiration Date
    • E Record – Policy Expiration Date

UDM14 – Policy Effective Date Missing

  • Description: A Policy Expiration Date was provided without a Policy Effective Date.
  • Affected Fields:
    • A Record – Policy Effective Date
    • B Record – Policy Effective Date
    • E Record – Policy Effective Date

UDM15 – Service or Benefit To Date before Start Date

  • Description: The Service or Benefit To Date must be after the Service or Benefit Start Date.
  • Affected Fields:
    • G Record – Service or Benefit from Date, Service or Benefit to Date

 

Currency and Numeric Errors

UDM16 – Currency Error

Note: Although not specified in the UDS Manual, + characters are allowed in the rightmost positions of the fields Total Written Premium Policy and Total Inforce Policy Premium for the UDS B record .txt ingestion process to accommodate certain legacy systems.

  • Description: The currency are not converting correctly. Acceptable formats are as follows:
Currency Format Example Description
123456789012+ UDS format: 12-character right-justified with a plus or minus sign at the end.
$1,234,567.89 Standard format with dollar sign and commas.
1234567.89 Standard format without dollar sign or commas.
(1,234,567.89) Negative number in parentheses.
-1234567.89 Negative number with minus sign.
1234567 Positive whole number without decimals.
-1234567 Negative whole number without decimals.
1234567.8 Positive number with at most 2 decimal places.
-1234567.8 Negative number with at most decimal places.
  • Affected Fields:
    • A Record – Transaction Amount
    • B Record – Total Written Premium Policy, Total Inforce Policy Premium, Return Premium Amount, Unpaid Premium Amount
    • E Record – Transaction Amount
    • G Record – Check Amount

UDM20 – Parentheses Where Minus

  • Description: A parentheses was found in the transaction amount. Transaction amount cannot be negative. Please update the data.
  • Affected Fields:
    • A Record – Transaction Amount
    • E Record – Transaction Amount

UDM21 – Minus Where Parentheses

  • Description: A minus sign was found in the transaction amount. Transaction amount cannot be negative. Please update the data.
  • Affected Fields:
    • A Record – Transaction Amount
    • E Record – Transaction Amount

UDM24 – Claimant Number Zero

  • Description: Claimant Numbers cannot be 0.
  • Affected Fields:
    • A Record – Claimant Number
    • B Record – Claimant Number
    • E Record – Claimant Number
    • G Record – Claimant Number

UDM25 – Claim Number Not Numeric

  • Description: The claim number is not a number. If this value appears in scientific notation, it is likely due to conversion by a spreadsheet program such as MS Excel.
  • Affected Fields
    • All Record Types – Insolvent Company Claim Number

UDM26 – Integer Error

  • Description: The field must be a number.
  • Affected Fields:
    • All Record Types – Claimant Number

UDM27 – Length Error

  • Description: The data exceeds the maximum length for this UDS field.
  • Affected Fields
    • All

 

Validation and Formatting Errors

UDM28 – Strip Error

  • Description: There was a problem stripping whitespace from the beginning and end of the data element.
  • Affected Fields
    • All

UDM29 – Leading Whitespace Error

  • Description: Leading whitespace was detected in the field. This field should be left justified.
  • Affected Fields:
    • A Record – Insured Last Name, Insured First Name, Insured Address, Insured City, Claimant Last Name, Claimant First Name, Claimant Address, Claimant City
    • B Record – Insured Last Name, Insured First Name, Insured Address, Insured City, Claimant Last Name, Claimant First Name, Claimant Address, Claimant City
    • E Record – Insured Last Name, Insured First Name, Insured Address, Insured City, Claimant Last Name, Claimant First Name, Claimant Address, Claimant City
    • G Record – Payee Last Name, Payee First Name, Payment Comment
    • I Record – Doc Descriptor or Comment

UDM31 – SSN Length Error

  • Description: SSN and/or EIN (Federal ID) must be 9 digits long.
  • Affected Fields:
    • A Record – Claimant ID Number
    • B Record – Claimant ID Number, Payee ID Number
    • E Record – Claimant ID Number
    • G Record – Payee ID Number

UDM32 – Zip Code Error

  • Description: Zip codes must be either 5 or 9 digits long (55555 or 55555-6789).
  • Affected Fields:
    • A Record – Insured Zip, Claimant Zip
    • B Record – Insured Zip, Claimant Zip
    • E Record – Insured Zip, Claimant Zip

UDM33 – Phone Index Error

  • Description: There was an issue converting this to a 10-digit phone number.
  • Affected Fields:
    • A Record – Employer Work Phone Number
    • B Record – Claimant Phone Number
    • E Record – Employer Work Phone Number

UDM34 – Check Number Not Alphanumeric

  • Description: This field must be alphanumeric (only numbers, letters, and spaces are allowed).
  • Affected Fields:
    • G Record – Check Number

UDM36 – Yes/No/Unsure Error

  • Description: The field must be either Y, N or U.
  • Affected Fields:
    • A Record – Suit Indictor, Second Injury Fund Indictor, Aggregate Policy Indictor, Deductible Policy Indicator, WCIO Vocational Rehab Indicator
    • E Record – Suit Indictor, Second Injury Fund Indictor, Aggregate Policy Indictor, Deductible Policy Indicator, WCIO Vocational Rehab Indicator

UDM37 – Yes/No Error

  • Description: The field must be either Y or N.
  • Affected Fields:
    • A Record – Repetitive Payment Indicator
    • B Record – Final Audit Indicator
    • E Record – Repetitive Payment Indicator

 

Coverage Code and Location Errors

UDM38 – Coverage Code Error

  • Description: The coverage code is not valid.
  • Affected Fields:
    • A Record – Coverage Code
    • B Record – Coverage Code
    • E Record – Coverage Code
    • G Record – Coverage Code

UDM40 – File Location State Error

  • Description: The file location state is not a valid Guaranty Fund location state.
  • Affected Fields:
    • A Record – File Location State
    • B Record – File Location State
    • E Record – File Location State
    • MRecord – File Location State

UDM41 – File Location Code Error

  • Description: The file location code is not a valid Guaranty Fund location code.
  • Affected Fields:
    • A Record – File Location Code
    • B Record – File Location Code
    • E Record – File Location Code
    • MRecord – File Location Code

UDM43 – File Location State/Code Error

  • Description: The state and/or location code provided is not valid.
  • Affected Fields:
    • A Record – File Location State, File Location Code
    • B Record – File Location State, File Location Code
    • E Record – File Location State, File Location Code
    • MRecord – File Location State, File Location Code

 

Transaction Code Errors

UDM44 – Transaction Code A

  • Description: This value must be 100.
  • Affected Fields:
    • A Record – Transaction Code

UDM45 – Transaction Code B

  • Description: This value must be one of 800, 815, 825, or 835.
  • Affected Fields:
    • B Record – Transaction Code

UDM46 – Transaction Code G

  • Description: This value must be one of 310, 410, 320, 420, or 820.
  • Affected Fields:
    • G Record – Transaction Code

UDM47 – Final Audit Indicator Error

  • Description: The Final Audit Indicator must be ‘Y’ when Transaction Code is 800. Must be ‘N’ when Transaction code is 815
  • Affected Fields:
    • B Record – Final Audit Indicator

 

Validation and Logic Errors

UDM48 – Recovery Indicator Code Error

  • Description: This value must be one of 0-9 or R-Z.
  • Affected Fields:
    • A Record – Recovery Indicator Code
    • E Record – Recovery Indicator Code

UDM49 – Cancellation Code Error

  • Description: This value must be one of 1, 2, 3, 4, 5, or 9.
  • Affected Fields:
    • B Record – Cancellation Code

UDM53 – Surety Error

  • Description: The coverage code indicates a surety claim, which is not covered by the provided state.
  • Affected Fields:
    • A Record – Coverage Code
    • B Record – Coverage Code
    • E Record – Coverage Code
    • G Record – Coverage Code

 

I Record Image Errors

UDM54 – Image Location Not Found

  • Description: There is no file or image located at the provided path.
  • Affected Fields:
    • I Record – Document File Name, Document Path

UDM55 – File Type Not Alphabetic

  • Description: This field must be alphabetic (only letters are allowed).
  • Affected Fields:
    • I Record – File Type

UDM56 – Document Path Error

  • Description: This value must end with a forward slash (/).
  • Affected Fields:
    • I Record – Document Path

 

Generic and Other Errors

UDM57 – Agents Commission Error

  • Description: Agents Commission Error must be in format XXX.XX.
  • Affected Fields:
    • B Record – Agents Commission Rate

 

Misc Rules

 

UDM39 – Invalid Coverage Code for Insolvency Company

  • Description: Coverage Code must be a valid one for the given NAIC.
  • Affected Fields:
    • A Record – Coverage Code
    • B Record – Coverage Code
    • E Record – Coverage Code
    • G Record – Coverage Code

UDM42 – Invalid File Location State/Code for Insolvency Company

  • Description: Insolvent Companies should only be able to write claims for states/codes they reside over.
  • Affected Fields:
    • A Record – File Location State, File Location Code, NAIC Number
    • B Record – File Location State, File Location Code, NAIC Number
    • E Record – File Location State, File Location Code, NAIC Number
    • MRecord – File Location State, File Location Code, NAIC Number

UDM50 – Address Invalid

  • Description: Use some API to try to validate all parts of claimant and insured address.
  • Affected Fields:
    • A Record – Insured Last Name, Insured First Name, Insured Address, Insured City, Claimant Last Name, Claimant First Name, Claimant Address, Claimant City
    • B Record – Insured Last Name, Insured First Name, Insured Address, Insured City, Claimant Last Name, Claimant First Name, Claimant Address, Claimant City
    • E Record – Insured Last Name, Insured First Name, Insured Address, Insured City, Claimant Last Name, Claimant First Name, Claimant Address, Claimant City

UDM51 – Claimant and Insured Names

  • Description: Claimant and Insured Names should match on the 00001 Claimant.
  • Affected Fields:
    • A Record – Claimant Last Name, Claimant First Name, Insured Last Name, Insured First Name, Claimant Number
    • B Record – Claimant Last Name, Claimant First Name, Insured Last Name, Insured First Name, Claimant Number
    • E Record – Claimant Last Name, Claimant First Name, Insured Last Name, Insured First Name, Claimant Number

UDM52 – Claimant Names Don’t Match

  • Description: The Claimant Name should match the previously entered name for the given Claimant Number.
  • Affected Fields:
    • A Record – Claimant Last Name, Claimant First Name, Claimant Number
    • B Record – Claimant Last Name, Claimant First Name, Claimant Number
    • E Record – Claimant Last Name, Claimant First Name, Claimant Number

UDM60 – WCIO Injury Code Error

  • Description: This value must be in the set of valid WCIO injury codes on page 102 of the UDS Claims Manual
  • Affected Fields:
    • A Record – WCIO Type of Injury

UDM61 – WCIO Part of Body Error

  • Description: This value must be in the set of valid WCIO part of body codes on page 102 of the UDS Claims Manual
  • Affected Fields:
    • A Record – WCIO Part of Body

UDM62 – WCIO Nature of Injury Error

  • Description: This value must be in the set of valid WCIO nature of injury codes on page 105 of the UDS Claims Manual
  • Affected Fields:
    • A Record – WCIO Nature of Injury

UDM63 – WCIO Cause of Injury Error

  • Description: This value must be in the set of valid WCIO cause of injury codes on page 107 of the UDS Claims Manual
  • Affected Fields:
    • A Record – WCIO Cause of Injury

UDM64 – WCIO Act Error

  • Description: This value must be in the set of valid WCIO act codes on page 110 of the UDS Claims Manual
  • Affected Fields:
    • A Record – WCIO Act

UDM65 – WCIO Type of Loss Error

  • Description: This value must be in the set of valid WCIO type of loss codes on page 110 of the UDS Claims Manual
  • Affected Fields:
    • A Record – WCIO Type of Loss

UDM66 – WCIO Type of Recovery Error

  • Description: This value must be in the set of valid WCIO type of recovery codes on page 110 of the UDS Claims Manual
  • Affected Fields:
    • A Record – WCIO Type of Recovery

UDM67 – WCIO Type of Coverage Error

  • Description: This value must be in the set of valid WCIO type of coverage codes on page 110 of the UDS Claims Manual
  • Affected Fields:
    • A Record –WCIO Type of Coverage

UDM68 – WCIO Type of Settlement Error

  • Description: This value must be in the set of valid WCIO type of settlement codes on page 111 of the UDS Claims Manual
  • Affected Fields:
    • A Record – WCIO Type of Settlement

UDM69 – Claimant ID Indicator Error

  • Description: This value must be in the set of valid Claimant ID Indicator codes: ‘F’, ‘S’, or blank.
  • Affected Fields:
    • A Record – Claimant ID Indicator

UDM70 – Improper NAIC Error

  • Description: This value must be in the set of valid NAIC codes for your given Liquidator.
  • Affected Fields:
    • A Record – NAIC Number
    • B Record – NAIC Number
    • E Record – NAIC Number

UDM71 – Missing A Record Error

  • Description: This error occurs when an A Record is missing for the given claim number and claimant number.
  • Affected Fields:
    • F Record
    • G Record
    • I Record
    • M Record

UDM72 – Invalid Billing Mode Error

  • Description: This error occurs when the billing mode is not one of the valid options (‘A’, ‘D’, or ”).
  • Affected Fields:
    • B Record – Billing Mode