HIMS • 14 October 2026

Clinical data-entry guide: all eight HI types

Every field in the application, with save rules. Use actual documented clinical data. Examples are fictional formatting examples, not treatment instructions. This guide does not submit patient data.

OPD error: “Enter a valid record ID to amend.”

For a NEW OPD record, leave Prior record ID completely blank. Enter the OPD number under Record / report / invoice number. The prior ID accepts only a positive numeric database ID, e.g. 123. It does not accept OPD-001, a patient ID, CLR-123 or descriptive text.

For continuation/amendment, use Open saved record so the numeric ID is filled automatically. Keep the same patient, HI type and record number. Saving creates a new version and retains the original. Do not clear the prior ID on an amendment merely to bypass an error.

The reported URL has an empty patientId. Search and select an existing patient before saving.

Common fields for every type

  1. Search and select the patient, then select the record type.
  2. Fill the common fields and type-specific details below.
  3. Add applicable rows; remove unused empty rows.
  4. Save draft or Finalize record; read the confirmation and retain the returned record ID.
  5. Use Open saved record to continue/amend, or Add another record for a new entry.
FieldHow to fill
Patient ID or patient name *Search and select an existing HIMS patient; the stored value must be the patient ID.
Record type *Choose one of the eight HI types. Only the selected type is submitted.
Clinical date/time (IST) *Actual clinical event date/time. Stored as UTC after subtracting 5 hours 30 minutes.
Record / report / invoice number *Hospital identifier, e.g. OPD-DEMO-001. Max 100 characters. New entries must not reuse a number for the same patient/type.
Encounter / visit reference *Actual visit/admission reference, e.g. VISIT-DEMO-001; max 100 characters.
Practitioner / author name *Recorded author name; max 300 characters.
Practitioner registration numberActual registration identifier if available; max 100 characters.
FacilitySet by server configuration; a configured facility ID is required.
Prior record IDBlank for a new entry; positive numeric database ID only for continuation/amendment.
Original / supporting documentValid PDF, JPG/JPEG or PNG, at most 2 MB; extension must match content. Required for a new finalized HealthDocumentRecord. Re-select after a validation error.
Additional clinical notesRelevant supplementary narrative; optional, max 4,000 characters.

Drafts: common required fields still apply. Detail fields marked * are required for finalization. Each added row needs its starred fields even in a draft. Supplied dates/numbers and conditional validation still apply. Drafts are excluded from ABDM linking.

Finalization: clinical saving and M2 registration are separate. If saved but registration is pending, retry registration from M2 Record Availability. ABHA is not required to save clinical care; link ABHA before ABDM linking.

Jump to a type

OPConsultation

Finalization requires Department, Chief complaint and Diagnosis. Add documented Measurements, Allergies and Medicines where applicable. Record symptom duration and history, examination, investigations, procedures, advice and follow-up from the consultation. Local codes come from HIMS; standard code systems and mapped codes must use verified mappings, not guesses.

FieldRequirementHow to fill
DepartmentRequired *Enter documented department. Up to 300 characters.
Visit reasonOptionalEnter documented visit reason. Up to 300 characters.
Chief complaintRequired *Enter documented chief complaint. Up to 300 characters.
Complaint durationOptionalEnter documented complaint duration. Up to 300 characters.
Present illnessOptionalEnter documented present illness. Up to 4,000 characters.
Past historyOptionalEnter documented past history. Up to 4,000 characters.
Family historyOptionalEnter documented family history. Up to 4,000 characters.
Surgical historyOptionalEnter documented surgical history. Up to 4,000 characters.
Social historyOptionalEnter documented social history. Up to 4,000 characters.
DiagnosisRequired *Enter documented diagnosis. Up to 300 characters.
Local diagnosis codeOptionalEnter documented local diagnosis code. Up to 300 characters.
Standard diagnosis code systemOptionalEnter documented standard diagnosis code system. Up to 300 characters.
Mapped standard diagnosis codeOptionalEnter documented mapped standard diagnosis code. Up to 300 characters.
ExaminationOptionalEnter documented examination. Up to 4,000 characters.
Investigation ordersOptionalEnter documented investigation orders. Up to 4,000 characters.
ProceduresOptionalEnter documented procedures. Up to 4,000 characters.
Advice and referralOptionalEnter documented advice and referral. Up to 4,000 characters.
Follow-up dateOptionalDocumented calendar date; YYYY-MM-DD.

Add applicable Measurements rows using Add row; see every row field below.

Add applicable Allergies rows using Add row; see every row field below.

Add applicable Medicines rows using Add row; see every row field below.

Prescription

Finalization requires Diagnosis / indication and at least one complete Medicines row. Copy the actual prescription, including dose, route, frequency and duration. Select the recorded medication status; the default is active.

FieldRequirementHow to fill
Diagnosis / indicationRequired *Enter documented diagnosis / indication. Up to 300 characters.
Medication statusOptionalChoose: active, completed, stopped, cancelled
Stop reasonOptionalEnter documented stop reason. Up to 300 characters.
Additional instructionsOptionalEnter documented additional instructions. Up to 4,000 characters.

Add applicable Medicines rows using Add row; see every row field below.

DiagnosticReport

Finalization requires Accession and Test / panel name. Laboratory category requires at least one Results row; Radiology and Other do not. Enter order and accession identifiers, specimen, collection/receipt timestamps, ordering doctor, technique, findings, signed impression and recommendation from the original report. Use verified terminology mappings for result codes.

FieldRequirementHow to fill
Order numberOptionalEnter documented order number. Up to 300 characters.
Accession / barcodeRequired *Enter documented accession / barcode. Up to 300 characters.
Report categoryOptionalChoose: Laboratory, Radiology, Other
Test / panel nameRequired *Enter documented test / panel name. Up to 300 characters.
Local test codeOptionalEnter documented local test code. Up to 300 characters.
Specimen typeOptionalEnter documented specimen type. Up to 300 characters.
Collected date/timeOptionalDocumented date and time in IST.
Received date/timeOptionalDocumented date and time in IST.
Ordering doctorOptionalEnter documented ordering doctor. Up to 300 characters.
TechniqueOptionalEnter documented technique. Up to 4,000 characters.
FindingsOptionalEnter documented findings. Up to 4,000 characters.
Impression / conclusionOptionalEnter documented impression / conclusion. Up to 4,000 characters.
RecommendationOptionalEnter documented recommendation. Up to 4,000 characters.

Add applicable Results rows using Add row; see every row field below.

DischargeSummary

Finalization requires Admission date/time, Discharge date/time, Final diagnosis and Hospital course. Discharge cannot precede admission. Enter recorded admission reason, ward, comorbidities, procedures, complications, condition/disposition, advice, warning signs and referral. Add discharge medicines and allergies where documented.

FieldRequirementHow to fill
Admission date/timeRequired *Documented date and time in IST.
Discharge date/timeRequired *Documented date and time in IST.
Admission typeOptionalEnter documented admission type. Up to 300 characters.
Ward / bedOptionalEnter documented ward / bed. Up to 300 characters.
Reason for admissionOptionalEnter documented reason for admission. Up to 4,000 characters.
Final diagnosisRequired *Enter documented final diagnosis. Up to 300 characters.
Local diagnosis codeOptionalEnter documented local diagnosis code. Up to 300 characters.
ComorbiditiesOptionalEnter documented comorbidities. Up to 4,000 characters.
Hospital courseRequired *Enter documented hospital course. Up to 4,000 characters.
Procedures / investigationsOptionalEnter documented procedures / investigations. Up to 4,000 characters.
ComplicationsOptionalEnter documented complications. Up to 4,000 characters.
Condition at dischargeOptionalEnter documented condition at discharge. Up to 300 characters.
Discharge dispositionOptionalEnter documented discharge disposition. Up to 300 characters.
Diet / activity / wound careOptionalEnter documented diet / activity / wound care. Up to 4,000 characters.
Warning signs / emergency adviceOptionalEnter documented warning signs / emergency advice. Up to 4,000 characters.
Follow-up dateOptionalDocumented calendar date; YYYY-MM-DD.
ReferralOptionalEnter documented referral. Up to 300 characters.

Add applicable Medicines rows using Add row; see every row field below.

Add applicable Allergies rows using Add row; see every row field below.

ImmunizationRecord

Finalization requires Vaccine name. Status defaults to completed; completed immunization requires Administration date/time on finalization. Status not-done requires Not-given reason, even for a draft. Supplied dose number and dose quantity must be positive. Copy route, site, manufacturer, batch, expiry and next-dose plan from the actual administration record.

FieldRequirementHow to fill
Vaccine nameRequired *Enter documented vaccine name. Up to 300 characters.
Local vaccine codeOptionalEnter documented local vaccine code. Up to 300 characters.
Target diseaseOptionalEnter documented target disease. Up to 300 characters.
Dose numberOptionalRecorded whole number.
Dose quantityOptionalRecorded numeric value, decimal point, up to four decimal places. Money allows two.
Dose unitOptionalEnter documented dose unit. Up to 300 characters.
Administration date/timeOptionalDocumented date and time in IST.
RouteOptionalEnter documented route. Up to 300 characters.
SiteOptionalEnter documented site. Up to 300 characters.
ManufacturerOptionalEnter documented manufacturer. Up to 300 characters.
Batch / lotOptionalEnter documented batch / lot. Up to 300 characters.
Expiry dateOptionalDocumented calendar date; YYYY-MM-DD.
StatusOptionalChoose: completed, not-done, entered-in-error
Not-given reasonOptionalEnter documented not-given reason. Up to 300 characters.
Adverse reaction notesOptionalEnter documented adverse reaction notes. Up to 4,000 characters.
Next vaccine / doseOptionalEnter documented next vaccine / dose. Up to 300 characters.
Next dose dueOptionalDocumented calendar date; YYYY-MM-DD.

HealthDocumentRecord

Finalization requires Document type, Title and an original PDF/JPG/PNG. Enter the issuing facility, author and searchable description. An existing attachment is reused when continuing or amending unless replaced.

FieldRequirementHow to fill
Document typeRequired *Enter documented document type. Up to 300 characters.
TitleRequired *Enter documented title. Up to 300 characters.
Source facilityOptionalEnter documented source facility. Up to 300 characters.
Source doctorOptionalEnter documented source doctor. Up to 300 characters.
Description / searchable notesOptionalEnter documented description / searchable notes. Up to 4,000 characters.

WellnessRecord

Finalization requires at least one Measurements row. All four assessment fields are optional. Enter documented lifestyle, general assessment, questionnaire findings and measurement device/source.

FieldRequirementHow to fill
Lifestyle / wellness assessmentOptionalEnter documented lifestyle / wellness assessment. Up to 4,000 characters.
General assessmentOptionalEnter documented general assessment. Up to 4,000 characters.
Questionnaire / women wellness notesOptionalEnter documented questionnaire / women wellness notes. Up to 4,000 characters.
Measurement device / sourceOptionalEnter documented measurement device / source. Up to 300 characters.

Add applicable Measurements rows using Add row; see every row field below.

Invoice

Finalization requires at least one InvoiceLines row. Select the actual invoice and payment types; defaults are Consultation, INR and Unpaid. Quantity must be positive; rate, discount, tax, other charges and paid must be non-negative. Money allows two decimal places; discount cannot exceed quantity multiplied by rate, and paid cannot exceed total.

FieldRequirementHow to fill
Invoice typeOptionalChoose: Consultation, Pharmacy, Laboratory, Hospital, Other
CurrencyOptionalChoose: INR
Other chargesOptionalRecorded numeric value, decimal point, up to four decimal places. Money allows two.
Amount paidOptionalRecorded numeric value, decimal point, up to four decimal places. Money allows two.
Payment modeOptionalChoose: Unpaid, Cash, UPI, Card, Bank, Other
Payment referenceOptionalEnter documented payment reference. Up to 300 characters.
Payment date/timeOptionalDocumented date and time in IST.

Add applicable InvoiceLines rows using Add row; see every row field below.

Repeatable row fields

Maximum 100 rows per group. Optional groups can have zero rows. Every row added must have its required fields, even for draft saving.

Medicines

FieldRequirementHow to fill
MedicineRequired *Enter documented medicine. Up to 300 characters.
Local medicine codeOptionalEnter documented local medicine code. Up to 300 characters.
Generic / brandOptionalEnter documented generic / brand. Up to 300 characters.
StrengthOptionalEnter documented strength. Up to 300 characters.
DoseRequired *Recorded numeric value, decimal point, up to four decimal places. Money allows two.
Dose unitRequired *Enter documented dose unit. Up to 300 characters.
RouteRequired *Enter documented route. Up to 300 characters.
FrequencyRequired *Enter documented frequency. Up to 300 characters.
Timing / foodOptionalEnter documented timing / food. Up to 300 characters.
DurationRequired *Enter documented duration. Up to 300 characters.
QuantityOptionalRecorded numeric value, decimal point, up to four decimal places. Money allows two.
Instructions / PRN reasonOptionalEnter documented instructions / prn reason. Up to 300 characters.
Start dateOptionalDocumented calendar date; YYYY-MM-DD.
End dateOptionalDocumented calendar date; YYYY-MM-DD.

Results

FieldRequirementHow to fill
ParameterRequired *Enter documented parameter. Up to 300 characters.
Local parameter codeOptionalEnter documented local parameter code. Up to 300 characters.
Mapped code systemOptionalEnter documented mapped code system. Up to 300 characters.
Mapped standard codeOptionalEnter documented mapped standard code. Up to 300 characters.
Value typeOptionalChoose: Numeric, Text
Numeric valueOptionalRecorded numeric value, decimal point, up to four decimal places. Money allows two.
Text valueOptionalEnter documented text value. Up to 300 characters.
UnitOptionalEnter documented unit. Up to 300 characters.
Reference rangeOptionalEnter documented reference range. Up to 300 characters.
FlagOptionalChoose: Normal, High, Low, Abnormal
InterpretationOptionalEnter documented interpretation. Up to 300 characters.

Measurements

FieldRequirementHow to fill
MeasurementOptionalChoose: Height, Weight, BMI, SystolicBP, DiastolicBP, Pulse, RespiratoryRate, Temperature, SpO2, Waist
ValueRequired *Recorded numeric value, decimal point, up to four decimal places. Money allows two.
UnitRequired *Enter documented unit. Up to 300 characters.
Measured date/timeRequired *Documented date and time in IST.
Performer / sourceOptionalEnter documented performer / source. Up to 300 characters.

Allergies

FieldRequirementHow to fill
AllergenRequired *Enter documented allergen. Up to 300 characters.
ReactionOptionalEnter documented reaction. Up to 300 characters.
SeverityOptionalChoose: mild, moderate, severe
StatusOptionalChoose: active, inactive, resolved
Recorded dateOptionalDocumented calendar date; YYYY-MM-DD.

InvoiceLines

FieldRequirementHow to fill
Service / itemRequired *Enter documented service / item. Up to 300 characters.
Local item codeOptionalEnter documented local item code. Up to 300 characters.
QuantityRequired *Recorded numeric value, decimal point, up to four decimal places. Money allows two.
Unit rateRequired *Recorded numeric value, decimal point, up to four decimal places. Money allows two.
Discount amountOptionalRecorded numeric value, decimal point, up to four decimal places. Money allows two.
Tax amountOptionalRecorded numeric value, decimal point, up to four decimal places. Money allows two.

Medicines: copy the prescription accurately. Dose and any supplied quantity must be positive. End date cannot precede start date. Dose unit, route, frequency and duration are required for each row.

Results: Numeric requires numeric value and unit; Text requires text value. Only the selected value is retained. Defaults are Numeric and Normal; select the actual value type and flag from the report. Local and mapped codes must come from verified laboratory mappings.

Measurements: value must be positive; enter actual unit, IST timestamp and source. Blood pressure uses separate SystolicBP and DiastolicBP rows. Example format only: Height, 165, cm, documented date/time.

Allergies: record documented allergen and reaction; no rows does not establish no known allergies. Default severity is mild and status is active; change them to match the record.

Invoice lines: discount and tax are currency amounts, not percentages. Gross = quantity × rate rounded to two decimals; net = gross − discount + tax. Total = sum of net lines + other charges; balance = total − paid. Fictional example: item Consultation fee, quantity 1, rate 500.00, discount 0, tax 0, other charges 50.00, paid 550.00 gives total 550.00 and balance 0.

Before saving

Scope: application capture and validation. This guide does not certify ABDM/FHIR conformance or confirm PHR delivery.

Record numbers and dated labels

Numeric record numbers receive a type prefix on save: OPD-, RX-, LAB-, IPD-, IMM-, DOC-, WELL- or INV-. Existing custom alphanumeric numbers are retained. Already prefixed numbers are not prefixed again. The maximum stored length including the prefix is 100 characters.

Example: OPConsultation number 2222 becomes OPD-2222. Its care-context display is OPConsultation - 2222 - 14-10-2026, using the clinical event date in IST. Encounter references and linked care-context references stay unchanged.