HL7 205 — Duplicate key identifier
Code 205 means the receiver rejected a create because a record with the same key already exists — for example admitting a patient or creating an order that is already on file.
When you see 205 (Error Condition Code)
Raised on create/insert messages when the receiver enforces uniqueness and the key (MRN, visit number, order number, placer order ID) is already present.
Common causes
- A retransmission or duplicate of an admit/order message that already succeeded.
- An A01 (admit) sent for a patient/visit that was already created.
- Reusing a placer order number that already exists.
- Interface replay after a queue reset resending already-processed messages.
How to fix it
- 1Determine whether this is a genuine duplicate (often safe to ignore) or a real new event that needs a different key.
- 2If it is a true update, send the appropriate update event (e.g. A08) instead of a create (A01).
- 3Check the sending interface for replays or missing de-duplication after a restart.
Example ACK message
A representative acknowledgment carrying ERR-3 = 205. Open it in the HL7 Viewer to inspect every field.
1MSH||^~\&|RECEIVER|HOSP|SENDER|HOSP|20260310143530||ACK^A01^ACK|ACK00025|P|2.5.1 2MSA||AE|MSG00001|Duplicate key identifier 3ERR||||205^Duplicate key identifier^HL70357|E|||Visit number 'V00123456' already exists
Related codes
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.
Code 206 means the transaction could not be performed because the target record was locked by another process.
Frequently asked questions
What does HL7 error code 205 mean?
Code 205 (Duplicate key identifier) means a create message used a key (MRN, visit, or order number) that already exists on the receiver. Decide whether it is a harmless duplicate/replay or should be sent as an update event (e.g. A08) instead.
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 →