MajwareMAJWARE
ERR-3 = 101ErrorTable 0357

HL7 101 — Required field missing

Code 101 means a field the receiver requires was empty. This is one of the most common HL7 errors and is almost always correctable by populating the field and resending.

When you see 101 (Error Condition Code)

Raised when a required field — by the standard or by the receiver's interface specification — is blank. ERR-7/ERR-8 usually name the exact location (e.g. PID.3, PID.5, PV1.7).

Common causes

  • Patient identifier (PID-3) or patient name (PID-5) is empty.
  • A field the receiver marks as required in its spec (even if optional in the standard) was not sent.
  • An upstream system left a field blank that the downstream system depends on.
  • A transformation cleared a field while reformatting.

How to fix it

  1. 1Read ERR-7/ERR-8 (or the diagnostic text) to find the exact field location, then ensure the sending system populates it.
  2. 2Reconcile the two systems' interface specifications — a field required by the receiver but optional upstream must be mapped or defaulted.
  3. 3Add a validation check in the interface engine to catch the empty field before transmission.

Example ACK message

A representative acknowledgment carrying ERR-3 = 101. Open it in the HL7 Viewer to inspect every field.

HL7 v2.x Message
1MSH||^~\&|RECEIVER|HOSP|SENDER|HOSP|20260310143410||ACK^A01^ACK|ACK00011|P|2.5.1
2MSA||AE|MSG00001|Required field missing
3ERR||||101^Required field missing^HL70357|E|||PID.5 (Patient Name) is required but was empty

Related codes

Frequently asked questions

How do I fix HL7 error code 101?

Code 101 (Required field missing) means a field the receiver requires is empty. Read ERR-7/ERR-8 to find the exact field (often PID.3 or PID.5), populate it in the sending system or interface mapping, and resend.

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 →