Home

Reference

Error codes

Search FOCUS HL7 MSA codes (import acknowledgments) or official EQRS error codes for the selected release. These lists are for lookup only. PayloadLab does not apply FOCUS import rules when you generate an HL7 file.

Catalog
Filter updates as you type. Number 010 is shared by several truncation warnings — use the Code column to tell them apart.
FOCUS HL7 MSA 131 loaded Codes are listed as of 2026R10 — QMS-Focus-HL7-Interface-Specification.docx.

Number Code ACK Severity Class Description
001 CC NOT FND warning warning
WARNING: A default condition code cannot be determined.
A default condition code cannot be determined for the service.
WARNING: Cannot determine a default condition code on <service date>.
010 CROWN UPI TOO LONG warning warning
Field too long. Data Truncated.
CROWN UPI cannot be more than 10 characters.
WARNING: Field CROWN UPI <CROWN UPI> truncated to 10 characters
010 EMER CONTACT LOCATION TOO LONG warning warning
Field too long. Data Truncated.
Emergency contact location (address 1 + address 2) cannot be more than 30 characters.
WARNING: Field Emergency Contact Location <location> truncated to 30 characters
010 MBI TOO LONG warning warning
Field too long. Data Truncated.
MBI cannot be more than 11 characters.
WARNING: Field MBI <MBI Number> truncated to 11 characters
010 MEDICARE HIC NUM TOO LONG warning warning
Field too long. Data Truncated.
Medicare HIC number cannot be more than 19 characters.
WARNING: Field Medicare HIC Num <HIC number> truncated to 19 characters
010 PATIENT FIRST NAME TOO LONG warning warning
Field too long. Data Truncated.
Patient first name cannot be more than 35 characters.
WARNING: Field Patient First Name <first name> truncated to 35 characters
010 PATIENT LAST NAME TOO LONG warning warning
Field too long. Data Truncated.
Patient last name cannot be more than 60 characters.
WARNING: Field Patient Last Name <last name> truncated to 60 characters
010 PATIENT SUFFIX TOO LONG warning warning
Field too long. Data Truncated.
Patient suffix cannot be more than 10 characters.
WARNING: Field Patient Suffix <suffix> truncated to 10 characters
010 PREFERRED LANGUAGE TOO LONG warning warning
Field too long. Data Truncated.
Preferred language cannot be more than 20 characters.
WARNING: Field Preferred Language <language> truncated to 20 characters
100 MSG BAD FMT AR error interface
HL7 message has invalid format.
The HL7 message cannot be interpreted because it does not adhere to an HL7 rule.
HL7 Message has invalid format: <description of error>.
101 MSG BAD VER AR error interface
HL7 message version is not supported.
The HL7 version in MSH is not supported by FOCUS.
HL7 <version> messages are not supported by <application name>.
102 MSG BAD TYP AR error interface
HL7 message is of an incorrect processing type.
The HL7 processing ID/type is not supported by FOCUS.
HL7 message processing type <processing type> is not supported by <application name>.
103 MSG NOT SUP AR error interface
HL7 message type is not supported.
The HL7 message type is not supported by FOCUS.
HL7 Message type <message type> is not supported by <application name>.
104 REQD FLD NOT FND AR error interface
Required field is not found.
A field or its component is required but not present in the segment.
Field <field item# and name> or its component is required but not present.
105 BAD DATETIME AR error interface
Invalid datetime
A datetime value is not a valid HL7 datetime.
Datetime <value> is invalid in <field item# and name>.
106 BAD NUM AR error interface
Invalid number
A numeric field contains a non-numeric or otherwise invalid number.
Number <value> is invalid in <field item# and name>.
107 TOTAL BATCH NOT MATCH AR error interface
File was not imported. Total number of batches in the file mismatch.
The number of batches in the file does not match the batch count in FTS.
Total number of batches in the file does not match the batch count in FTS.
108 TOTAL MSG NOT MATCH AR error interface
Total number of batch messages mismatch.
The number of messages in the batch does not match the message count in BTS.
Batch with Control ID <batch control ID> was not imported - number of batch messages does not match the message count in BTS.
109 BAD DATE AR error interface
Invalid date
A date value is not a valid HL7 date.
Date <value> is invalid in <field item# and name>.
110 EVN BAD TYP AR error interface
Event type codes mismatch.
Event type codes in EVN and MSH segments do not match.
Event type codes in EVN and MSH segments do not match.
111 EVN BAD REASON AR error interface
Event reason code is not supported.
The event reason code is not supported by FOCUS.
Event reason code <reason code> is not supported by <application name>.
112 BAD VALUE AR error interface
Invalid value
A field contains a value that is not valid for that field.
Value <value> in <field item# and name> is not valid.
200 PAT NOT FND AE error patient
Patient is not found.
No patient matches the patient identifier in the message.
Patient <patient> is not found.
201 PAT NOT REG AE error patient
Patient is not registered at indicated facility.
The patient is not registered at the facility/unit in the message.
Patient <patient> is not registered at facility <unit>.
203 BAD SEC KEY AE error patient
Secondary keys mismatch.
Secondary matching keys in the HL7 message do not match FOCUS patient keys.
Patient <patient> - <secondary key mismatch detail>.
204 DUP PAT AE error patient
Duplicate patient
A patient with the same QMS#, SSN, or other unique keys already exists.
Patient with same QMS#, SSN, etc. already exists.
205 DOC NOT FND AE error patient
Doctor not found
The physician UPIN/NPI/ID in the message is not a valid FOCUS doctor.
<doctor role> with UPIN: <UPIN>, Physician ID: <physician ID> is not valid. (or with NPI: <NPI> when NPI validation is enabled)
206 DUP DOC AE error patient
Duplicate Doctor
More than one FOCUS doctor matches the UPIN/NPI in the message.
<doctor role> with UPIN: <UPIN>, Physician ID: <physician ID> cannot be determined in QMS Focus. (or with NPI: <NPI> when NPI validation is enabled)
207 FIELD TOO LONG AE error patient
Field is too long
A field value exceeds the maximum length allowed and cannot be truncated as a warning.
Field <field name>: <value> is too long.
208 MSG NOT PROCESSED AE error patient
Msg was not processed
The message was already processed by another user (reprocess lock).
Message with HL7 Import Msg Num <msg num> was processed by another user.
209 TX NOT FND AE error patient
Treatment not found
The treatment to delete does not exist for the patient, date, unit, access route, and quantity.
<TX ITEM> does not exist for <patient> on <tx date> in <unit> with Access Route <access route> and Qty <qty> so cannot be deleted.
210 INVALID ENROLLMENT AE error patient
Invalid Enrollment.
Medicare enrollment status is not a valid coded value.
Medicare Enrollment Status '<value>' is not valid.
211 LAB RESULT NOT FND AE error patient
Lab Result not found
The lab result to delete does not exist for the patient, date, and unit.
<lab item> result does not exist for <patient> on <lab result date> in <unit>- cannot be deleted.
212 ABSENCE NOT FND AE error patient
Absence not found
The absence to delete does not exist for the patient, date, and unit.
<absence item code> does not exist for <patient> on <absence date> in <unit>- cannot be deleted.
213 INVALID DIRECTIVE AE error patient
Invalid Directive.
Advance Directive (CW) is not a valid coded value.
Advance Directive (CW) <value> is not valid.
214 INVALID STUDENT STATUS AE error patient
Invalid Student Status.
Student status is not a valid coded value.
Student Status <value> is not valid.
215 INVALID STATUS AE error patient
Invalid Status.
Patient status is not a valid coded value.
Status <value> is not valid.
216 GS MOD NOT FND AE error patient
GS Modifier not found
The GS modifier to delete does not exist for the patient, date, and unit.
GS Modifier does not exist for <patient> on <modifier date> in <unit>- cannot be deleted.
217 INVALID STATUS CODE AE error patient
Invalid Status Code.
Status code is not a valid coded value.
Status Code <value> is not valid.
218 INVALID REPORTED BY AE error patient
Invalid Race/Ethnicity Reported By.
Race/Ethnicity Reported By is not a valid coded value.
Race/Ethnicity Reported By <value> is not valid.
220 INVALID COUNTRY/ORIGIN AE error patient
Invalid Country/Area of Origin.
Country/Area of Origin is not a valid coded value.
Country/Area of Origin <value> is not valid.
222 INVALID COUNTRY/ORIGIN AE error patient
Invalid Enrolled/Principal Tribe.
Enrolled/Principal Tribe is not a valid coded value.
Enrolled/Principal Tribe <value> is not valid.
223 MULTI PAT MATCHES AE error patient
Multiple Patient Matches
Keys used for interface with the clinical system yield multiple patient matches.
Keys used for Interface with Clinical System yield multiple patient matches.
224 PAT CLOSE MATCHES AE error patient
Patient Close Matches
One or more patients closely match the identifiers in the message.
One or more Patient closely matches found.
225 UPID TOO LONG AE error patient
UPID exceeded maximum of 9 characters.
UPID cannot be more than 9 characters.
UPID exceeded maximum of 9 characters.
226 INACTIVE PATIENT AE error patient
Inactive Patient
The matched patient status is inactive and import of inactive patients is not allowed.
Patient status is inactive.
300 SVC NOT FND AE error service
Service code is not found.
The service/treatment item code is not a valid FOCUS service code.
Service code <service code> is not valid.
301 ICD NOT JUSTIFY AE error service
ICD code is not a justification of the service code.
The ICD code is not a justification of the service code.
The ICD code <ICD> is not a justification of the service code <service code>.
302 CANNOT DEL TX AE error service
Tx cannot be deleted
The treatment cannot be deleted because it is attached to a claim.
Cannot delete treatment on <service date> - treatment is attached to a claim.
304 LAB NOT FND AE error service
Lab item code is not found.
The lab item code is not a valid FOCUS lab item.
Lab item code <lab item code> is not valid.
305 WRONG TRANSACT TYPE AE error service
Wrong Transaction Type
The FT1 transaction type is not a valid value.
Transaction Type <transaction type> is not valid.
306 MED ACCESS NOT FND AE error service
Medication access code is not found
Medication access is not a valid coded value.
Medication access <value> is not valid.
307 WRONG SELF ADMIN AE error service
Wrong Self Administered Code
Self administered code is not a valid coded value.
Self administered code <value> is not valid.
308 WRONG GIVEN HOME AE error service
Wrong given at home Code
Given at home code is not a valid coded value.
Given at home code <value> is not valid.
309 Cannot Del Lab AE error service
Lab result cannot be deleted
The lab result cannot be deleted because it is used on a claim.
Cannot delete lab result <lab item> for <patient> on <lab result date> in <unit>- result used on a claim.
310 Cannot Upd Lab AE error service
Lab result cannot be updated
The lab result cannot be updated because it is used on a claim.
Cannot update lab result <lab item> for <patient> on <lab result date> in <unit>- result used on a claim.
312 Invalid ICD code AE error service
Invalid ICD code.
The ICD code is not a valid ICD value.
Invalid ICD code <ICD>.
313 INVALID WASTAGE AE error service
Invalid wastage quantity
Wastage quantity must be greater than zero.
Wastage Quantity should be greater than zero.
314 INVALID WASTAGE AE error service
Invalid wastage quantity
Wastage quantity must be <= 99,999,999.999.
Invalid wastage quantity (<qty>) for <patient> on <service date>. Quantity must be <= 99,999,999.999.
315 NDC not enabled AE error service
NDC function not enabled.
An NDC was sent but NDC processing is not enabled for the account.
NDC function not enabled <NDC>.
316 Invalid NDC AE error service
Invalid NDC.
The NDC is not a valid NDC.
NDC <NDC> is not valid.
317 Duplicate NDC AE error service
Duplicate NDC.
The NDC is duplicated on the treatment.
Duplicate NDC <NDC>
319 INVALID Quantity AE error service
Invalid Given quantity
Given quantity must be <= 99,999,999.999.
Invalid Given quantity (<qty>) for <patient> on <service date>. Quantity must be <= 99,999,999.999.
320 Cannot Upd Lab AE error service
GS Modifier changes not allowed
GS modifier cannot be changed because a claim has been generated.
GS Modifier cannot be <action> for <patient> on <date> in <unit>. Claim has been generated.
321 Invalid Access AE error service
Invalid Access
Access code is not a valid coded value.
Access <value> is not valid.
322 Invalid Access Infection AE error service
Invalid Access Infection
Access infection is not a valid coded value.
Access Infection <value> is not valid.
323 Invalid Non-ESRD related AE error service
Invalid Non-ESRD related
Non-ESRD related indicator is not a valid coded value.
Non-ESRD related <value> is not valid.
324 NO MAPPING FOUND AE error service
Interface Code Mapping Range not found.
No interface code mapping range exists for the vendor service code and quantity.
There is no mapping range available for <service code> qty <quantity> for <service date> - <vendor>.
325 INVALID VENDOR REF CODE AE error service
Vendor Reference Code is not valid.
The vendor reference / sending application code is not a valid vendor reference code.
<value> is not a valid Vendor Reference Code.
326 Invalid Clinical Research AE error service
Invalid Clinical Research
Clinical research indicator is not a valid coded value.
Clinical Research <value> is not valid.
400 UNIT NOT FND AE error account
Unit not found.
The unit abbreviation is not a valid FOCUS unit.
Unit <unit> is not valid.
401 ACCT ID NOT MATCH AE error account
Account ID Not Match
The account ID in the batch does not match the current FOCUS account.
Batch with Control ID <batch control ID> was not imported - Account ID <account ID> in the batch does not match the account ID of the current account.
402 WASTAGE QUANTITY NOT MACH AE error account
Wastage Qty Not Match
Given quantity plus wastage quantity does not equal total quantity.
Given Quantity + Wastage Quantity does not equal Total Quantity
403 Missing Wastage AE error account
Missing Wastage Information
Required wastage information is missing.
<missing item> is missing.
404 Treatment Item Code AE error account
Invalid Treatment Item Code
The treatment item code is not valid.
<item> Treatment Item Code is not valid.
405 Treatment Item Code AE error account
Invalid Treatment Item Code
The treatment item code is not a medication type.
<item> Treatment Item Code is not Medication.
406 ICD Code AE error account
Invalid ICD Code
ICD code must be a valid value.
ICD code must be a valid value.
407 ICD Code AE error account
Invalid Effective and End Date
ICD effective date must be earlier than end date.
Effective date must be earlier than end date.
408 Current Gender Code AE error account
Invalid Current Gender Code
Current gender is not a valid coded value.
Current Gender '<value>' is not valid.
409 INVALID FREQ AE error account
Invalid dialysis orders frequency
Dialysis order frequency must be between 1 and 7.
Frequency '<value>' must be between 1 to 7
410 OVERLAPPING DATES AE error account
Overlapping date range for dialysis orders
A dialysis order already exists that overlaps the effective date.
Overlapping date exists for effective date <date>
411 INVALID ACCESS TYPE AE error account
Invalid access type
Access type is not a valid coded value.
Access Type '<value>' is not valid
412 INVALID ACCESS LOCATION AE error account
Invalid access location
Access location is not a valid coded value.
Access Location '<value>' is not valid
413 DIALYSIS ORDER AE error account
Invalid Effective and End Date
Dialysis order effective date must be earlier than end date.
Effective date must be earlier than end date.
414 PATIENT ACCESS AE error account
Invalid Start and End Date
Patient access start date must be earlier than end date.
Start date must be earlier than end date.
415 ICD Code AE error account
Invalid ICD
The ICD9 code is not a justification for this patient.
The ICD9 code <ICD> is not a justification for this patient.
416 ICD Code AE error account
Invalid ICD
ICD must be an ICD10 code when Continue ICD is Y.
ICD must be an ICD10 code when Continue ICD is Y.
417 ICD Code AE error account
Invalid ICD
Continue ICD code is not a valid coded value.
Continue ICD Code <value> is not valid.
418 ICD Code AE error account
Invalid ICD
ICD is not a justification within the effective date specified.
ICD is not a justification within the Effective Date specified.
419 Cannot del ICD9 AE error account
Cannot delete ICD9 Code
ICD9 cannot be deleted because a Continue ICD9 code was found.
Continue ICD9 Code found.
420 OVERLAPPING DATES AE error account
Overlapping date for Dispensed
A dispensed record already exists that overlaps the effective date.
Overlapping date exists for effective date <service date>
421 INVALID DISPENSED DOSAGE AE error account
Invalid Dispensed dosage
Dispensed dosage must be < 100,000.000 and may contain 3 optional decimal digits.
Invalid dispensed dosage (<dosage>) for <patient> on <service date>. Value must be < 100,000.000. May contain 3 optional decimal digits.
422 HL7 VENDOR NOT SETUP AE error account
HL7 Vendor not Setup
The HL7 vendor is not set up in FOCUS.
HL7 Vendor not Setup, contact QMS
423 UNIT NOT ASSIGNED AE error account
Unit not assigned
The unit is not assigned to the HL7 vendor.
Unit is not assigned to HL7 Vendor
424 SEX CODE NOT VALID AE error account
Sex code is not valid
Sex at birth code is not a valid coded value.
Invalid data: Sex code '<value>' is not valid.
425 RACE CODE NOT VALID AE error account
Race code is not valid
Race code is not a valid coded value.
Invalid data: Race code '<value>' is not valid.
426 MARITAL STAT INVALID AE error account
Marital status code is not valid
Marital status code is not a valid coded value.
Invalid data: Marital status code '<value>' is not valid.
427 EMER REL INVALID AE error account
Emergency contact relationship code is not valid
Emergency contact relationship code is not a valid coded value.
Invalid data: Emergency contact relationship code '<value>' is not valid.
428 MODALITY INVALID AE error account
Modality code is not valid
Modality code is not a valid coded value.
Invalid data: Modality code '<value>' is not valid.
429 ETHNICITY INVALID AE error account
Ethnicity code is not valid
Ethnicity code is not a valid coded value.
Invalid data: Ethnicity code '<value>' is not valid.
430 DOSAGE NOT MATCH AE error account
Dosages Does Not Match
Wastage plus given item dosages does not match total dosage.
Invalid data: Wastage + Given Item Dosages Does Not Match Total Dosage
431 DUPLICATED PATIENT ACCESS AE error account
Duplicated Patient Access
Patient access type/location is duplicated.
Invalid data: Patient Access is Duplicated.
432 ICD INDICATOR NOT FND/INVALID AE error account
ICD Indicator not found/invalid
ICD indicator is missing or invalid.
Invalid data: <ICD> ICD Indicator<indicator>not found/invalid.
433 ICD AND ICD INDICATOR MISMATCH AE error account
ICD value provided does not match ICD indicator provided
The ICD value does not match the ICD indicator (ICD9 vs ICD10).
Invalid data - <ICD> is not <indicator>.
434 EMER CONTACT NAME INVALID AE error account
Emergency Contact Name is not valid.
Emergency contact name is not a valid value.
Invalid data: Emergency Contact Name '<name>' is not valid.
435 INVALID INSURANCE ABBR AE error account
Invalid Insurance Abbreviation
Insurance abbreviation is not valid (acute unit hospital insurance).
Insurance abbreviation <value> is not valid.
436 TX NOT FND AE error account
Treatment not found
The treatment to delete does not exist for the patient, date, unit, hospital, and quantity (acute).
<TX ITEM> does not exist for <patient> on <tx date> in <unit> with Hospital <hospital> and Qty <qty> so cannot be deleted.
437 TX NOT FND AE error account
Treatment not found
The treatment to delete was not found by unique treatment ID.
Treatment not found so cannot be deleted.
438 UNIT CLOSED AE error account
Unit is closed
A record cannot be inserted inside a closed period for the unit.
Cannot insert record inside a closed period.
439 DUPLICATED HEMO ORDER AE error account
Duplicated Hemo Order
A hemodialysis order already exists for the patient, unit, and effective date.
Invalid data: Hemo Order is Duplicated.
440 INVALID DURATION AE error account
Invalid treatment duration
Treatment duration must be < 10,000,000 and may contain 2 optional decimal digits.
Invalid treatment duration(<duration>) for <patient> on <service date>. Duration must be < 10,000,000. May contain 2 optional decimal digits.
441 ABSENCE CODE AE error account
Invalid Absence Code Effective or End Date
Absence code has an invalid effective or end date.
Absence Code has invalid effective or end date.
442 SVC NOT ACTIVE AE error account
Service code is not active.
The service code exists but is not active.
Service code <service code> is not active.
443 TREATMENT ITEM CODE NOT ACTIVE AE error account
Treatment Item Code is not active
The treatment item code exists but is not active.
<item> Treatment Item Code is not active.
444 INVALID NO WASTAGE INDICATOR AE error account
Invalid No Wastage Indicator
No wastage indicator is not a valid coded value.
<value> No Wastage Indicator is invalid.
445 DOCTOR NOT ACTIVE AE error account
Doctor is not Active
The doctor exists but is not active (when inactive-doctor validation is enabled).
Doctor <doctor> is not active.
446 UNIT NOT ACTIVE AE error account
Unit is not Active
The unit exists but is not active (when inactive-unit validation is enabled).
Unit <unit> is not active.
447 INVALID DISCONTINUE REASON CODE AE error account
Discontinue Reason Code.
Discontinue reason code (PV1.36) is not a valid coded value.
Discontinue Reason Code <value> is not valid.
448 INVALID CAUSE OF DEATH CODE AE error account
Cause of Death Code.
Cause of death code (ZPP.3) is not a valid coded value.
Cause of Death Code <value> is not valid.
449 MISSING DISCONTINUE REASON CODE AE error account
Missing Discontinue Reason Code.
Discontinue date exists at PV1.45 but discontinue reason is not defined at PV1.36.
Discontinue Reason Code is not defined at PV1.36 while Discontinue Date exists at PV1.45
450 MISSING DISCONTINUE DATE AE error account
Missing Discontinue Date.
Discontinue reason exists at PV1.36 but discontinue date is not defined at PV1.45.
Discontinue Date is not defined at PV1.45 while Discontinue Reason Code exists at PV1.36.
451 MISSING CAUSE of DEATH AE error account
Missing Cause of Death.
Date of death exists at PID.29 but cause of death is not defined at ZPP.3.
Cause of Death is not defined at ZPP.3 while Date of Death exists at PID.29.
452 MISSING DATE of DEATH AE error account
Missing Date of Death.
Cause of death exists at ZPP.3 but date of death is not defined at PID.29.
Date of Death is not defined at PID.29 while Cause of Death exists at ZPP.3.
901 ACCESS DENIED AE error misc
Access (security) error
The user/process does not have access required to import the message.
Access denied: <detail>.
902 DB ERROR AE error misc
Database error
An unexpected database error occurred during import.
Database Error: <detail>.
903 EOF NOT EXP AR error misc
Unexpected EOF
The file ended before a complete HL7 structure was read.
Unexpected end of file.
906 FILE WAS NOT IMPORTED AR error misc
File was not imported.
Invalid file format: no carriage returns in the file.
Invalid file format. No <CR>s in file <file name> in <directory>.
907 FILE WAS NOT IMPORTED AR error misc
File was not imported.
Invalid file format: FHS is not the initial characters in the file.
Invalid file format. FHS not initial characters in file <file name> in <directory>.
908 FILE WAS NOT IMPORTED AR error misc
File was not imported.
Invalid file format: no BHS segment in the file.
Invalid file format. No BHS segment in file <file name> in <directory>.
909 FILE WAS NOT IMPORTED AR error misc
File was not imported.
Invalid file format: no BTS segment in the file.
Invalid file format. No BTS segment in file <file name> in <directory>.
910 FILE WAS NOT IMPORTED AR error misc
File was not imported.
Invalid file format: no FTS segment in the file.
Invalid file format. No FTS segment in file <file name> in <directory>.