HL7 103 — Table value not found
Code 103 means a coded field contained a value that is not in the table the receiver uses for that field — for example an unrecognized gender, marital status, or facility code.
When you see 103 (Error Condition Code)
Raised when a coded value fails table validation: the receiver checks the field against an HL7 or local table and the submitted code is not a member.
Common causes
- Sender uses a local code the receiver does not recognize (e.g. gender 'U' or a custom value).
- Different table versions between systems (a value valid on one side, retired on the other).
- A facility, location, or provider code that was never mapped on the receiving side.
- Case mismatch on a case-sensitive coded value.
How to fix it
- 1Identify the field and the offending value from the ERR detail, then check it against the receiver's expected table.
- 2Add a code mapping/cross-walk in the interface engine to translate the sender's value to one the receiver accepts.
- 3Coordinate with the receiving system to add the missing value to its table if it is legitimate.
Example ACK message
A representative acknowledgment carrying ERR-3 = 103. Open it in the HL7 Viewer to inspect every field.
1MSH||^~\&|RECEIVER|HOSP|SENDER|HOSP|20260310143430||ACK^A01^ACK|ACK00013|P|2.5.1 2MSA||AE|MSG00001|Table value not found 3ERR||||103^Table value not found^HL70357|E|||PID.8 (Sex) 'X' not in table 0001
Related codes
Code 102 means a field contained a value of the wrong data type — for example text where a number or a properly formatted date/timestamp was expected.
Code 204 means a key the receiver looked up — such as a patient identifier, visit number, or order number — was not found in the receiving system.
Frequently asked questions
How do I resolve HL7 error code 103?
Code 103 (Table value not found) means a coded value is not in the receiver's table for that field. Map the sender's value to an accepted code in your interface engine, or have the receiver add the value to its table if it is valid.
Debug your ACK in the viewer
Paste the ACK (or original message) and get instant segment parsing, MSA/ERR decoding, and validation. Free, client-side, no signup.
Open HL7 Message Viewer →All HL7 error & ACK codes
Browse every acknowledgment code (Table 0008) and error condition code (Table 0357) with causes, fixes, and examples.
HL7 Error Code Reference →