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 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
- Search and select the patient, then select the record type.
- Fill the common fields and type-specific details below.
- Add applicable rows; remove unused empty rows.
- Save draft or Finalize record; read the confirmation and retain the returned record ID.
- Use Open saved record to continue/amend, or Add another record for a new entry.
| Field | How 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 number | Actual registration identifier if available; max 100 characters. |
| Facility | Set by server configuration; a configured facility ID is required. |
| Prior record ID | Blank for a new entry; positive numeric database ID only for continuation/amendment. |
| Original / supporting document | Valid 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 notes | Relevant 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.
| Field | Requirement | How to fill |
|---|---|---|
| Department | Required * | Enter documented department. Up to 300 characters. |
| Visit reason | Optional | Enter documented visit reason. Up to 300 characters. |
| Chief complaint | Required * | Enter documented chief complaint. Up to 300 characters. |
| Complaint duration | Optional | Enter documented complaint duration. Up to 300 characters. |
| Present illness | Optional | Enter documented present illness. Up to 4,000 characters. |
| Past history | Optional | Enter documented past history. Up to 4,000 characters. |
| Family history | Optional | Enter documented family history. Up to 4,000 characters. |
| Surgical history | Optional | Enter documented surgical history. Up to 4,000 characters. |
| Social history | Optional | Enter documented social history. Up to 4,000 characters. |
| Diagnosis | Required * | Enter documented diagnosis. Up to 300 characters. |
| Local diagnosis code | Optional | Enter documented local diagnosis code. Up to 300 characters. |
| Standard diagnosis code system | Optional | Enter documented standard diagnosis code system. Up to 300 characters. |
| Mapped standard diagnosis code | Optional | Enter documented mapped standard diagnosis code. Up to 300 characters. |
| Examination | Optional | Enter documented examination. Up to 4,000 characters. |
| Investigation orders | Optional | Enter documented investigation orders. Up to 4,000 characters. |
| Procedures | Optional | Enter documented procedures. Up to 4,000 characters. |
| Advice and referral | Optional | Enter documented advice and referral. Up to 4,000 characters. |
| Follow-up date | Optional | Documented 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.
| Field | Requirement | How to fill |
|---|---|---|
| Diagnosis / indication | Required * | Enter documented diagnosis / indication. Up to 300 characters. |
| Medication status | Optional | Choose: active, completed, stopped, cancelled |
| Stop reason | Optional | Enter documented stop reason. Up to 300 characters. |
| Additional instructions | Optional | Enter 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.
| Field | Requirement | How to fill |
|---|---|---|
| Order number | Optional | Enter documented order number. Up to 300 characters. |
| Accession / barcode | Required * | Enter documented accession / barcode. Up to 300 characters. |
| Report category | Optional | Choose: Laboratory, Radiology, Other |
| Test / panel name | Required * | Enter documented test / panel name. Up to 300 characters. |
| Local test code | Optional | Enter documented local test code. Up to 300 characters. |
| Specimen type | Optional | Enter documented specimen type. Up to 300 characters. |
| Collected date/time | Optional | Documented date and time in IST. |
| Received date/time | Optional | Documented date and time in IST. |
| Ordering doctor | Optional | Enter documented ordering doctor. Up to 300 characters. |
| Technique | Optional | Enter documented technique. Up to 4,000 characters. |
| Findings | Optional | Enter documented findings. Up to 4,000 characters. |
| Impression / conclusion | Optional | Enter documented impression / conclusion. Up to 4,000 characters. |
| Recommendation | Optional | Enter 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.
| Field | Requirement | How to fill |
|---|---|---|
| Admission date/time | Required * | Documented date and time in IST. |
| Discharge date/time | Required * | Documented date and time in IST. |
| Admission type | Optional | Enter documented admission type. Up to 300 characters. |
| Ward / bed | Optional | Enter documented ward / bed. Up to 300 characters. |
| Reason for admission | Optional | Enter documented reason for admission. Up to 4,000 characters. |
| Final diagnosis | Required * | Enter documented final diagnosis. Up to 300 characters. |
| Local diagnosis code | Optional | Enter documented local diagnosis code. Up to 300 characters. |
| Comorbidities | Optional | Enter documented comorbidities. Up to 4,000 characters. |
| Hospital course | Required * | Enter documented hospital course. Up to 4,000 characters. |
| Procedures / investigations | Optional | Enter documented procedures / investigations. Up to 4,000 characters. |
| Complications | Optional | Enter documented complications. Up to 4,000 characters. |
| Condition at discharge | Optional | Enter documented condition at discharge. Up to 300 characters. |
| Discharge disposition | Optional | Enter documented discharge disposition. Up to 300 characters. |
| Diet / activity / wound care | Optional | Enter documented diet / activity / wound care. Up to 4,000 characters. |
| Warning signs / emergency advice | Optional | Enter documented warning signs / emergency advice. Up to 4,000 characters. |
| Follow-up date | Optional | Documented calendar date; YYYY-MM-DD. |
| Referral | Optional | Enter 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.
| Field | Requirement | How to fill |
|---|---|---|
| Vaccine name | Required * | Enter documented vaccine name. Up to 300 characters. |
| Local vaccine code | Optional | Enter documented local vaccine code. Up to 300 characters. |
| Target disease | Optional | Enter documented target disease. Up to 300 characters. |
| Dose number | Optional | Recorded whole number. |
| Dose quantity | Optional | Recorded numeric value, decimal point, up to four decimal places. Money allows two. |
| Dose unit | Optional | Enter documented dose unit. Up to 300 characters. |
| Administration date/time | Optional | Documented date and time in IST. |
| Route | Optional | Enter documented route. Up to 300 characters. |
| Site | Optional | Enter documented site. Up to 300 characters. |
| Manufacturer | Optional | Enter documented manufacturer. Up to 300 characters. |
| Batch / lot | Optional | Enter documented batch / lot. Up to 300 characters. |
| Expiry date | Optional | Documented calendar date; YYYY-MM-DD. |
| Status | Optional | Choose: completed, not-done, entered-in-error |
| Not-given reason | Optional | Enter documented not-given reason. Up to 300 characters. |
| Adverse reaction notes | Optional | Enter documented adverse reaction notes. Up to 4,000 characters. |
| Next vaccine / dose | Optional | Enter documented next vaccine / dose. Up to 300 characters. |
| Next dose due | Optional | Documented 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.
| Field | Requirement | How to fill |
|---|---|---|
| Document type | Required * | Enter documented document type. Up to 300 characters. |
| Title | Required * | Enter documented title. Up to 300 characters. |
| Source facility | Optional | Enter documented source facility. Up to 300 characters. |
| Source doctor | Optional | Enter documented source doctor. Up to 300 characters. |
| Description / searchable notes | Optional | Enter 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.
| Field | Requirement | How to fill |
|---|---|---|
| Lifestyle / wellness assessment | Optional | Enter documented lifestyle / wellness assessment. Up to 4,000 characters. |
| General assessment | Optional | Enter documented general assessment. Up to 4,000 characters. |
| Questionnaire / women wellness notes | Optional | Enter documented questionnaire / women wellness notes. Up to 4,000 characters. |
| Measurement device / source | Optional | Enter 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.
| Field | Requirement | How to fill |
|---|---|---|
| Invoice type | Optional | Choose: Consultation, Pharmacy, Laboratory, Hospital, Other |
| Currency | Optional | Choose: INR |
| Other charges | Optional | Recorded numeric value, decimal point, up to four decimal places. Money allows two. |
| Amount paid | Optional | Recorded numeric value, decimal point, up to four decimal places. Money allows two. |
| Payment mode | Optional | Choose: Unpaid, Cash, UPI, Card, Bank, Other |
| Payment reference | Optional | Enter documented payment reference. Up to 300 characters. |
| Payment date/time | Optional | Documented 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
| Field | Requirement | How to fill |
|---|---|---|
| Medicine | Required * | Enter documented medicine. Up to 300 characters. |
| Local medicine code | Optional | Enter documented local medicine code. Up to 300 characters. |
| Generic / brand | Optional | Enter documented generic / brand. Up to 300 characters. |
| Strength | Optional | Enter documented strength. Up to 300 characters. |
| Dose | Required * | Recorded numeric value, decimal point, up to four decimal places. Money allows two. |
| Dose unit | Required * | Enter documented dose unit. Up to 300 characters. |
| Route | Required * | Enter documented route. Up to 300 characters. |
| Frequency | Required * | Enter documented frequency. Up to 300 characters. |
| Timing / food | Optional | Enter documented timing / food. Up to 300 characters. |
| Duration | Required * | Enter documented duration. Up to 300 characters. |
| Quantity | Optional | Recorded numeric value, decimal point, up to four decimal places. Money allows two. |
| Instructions / PRN reason | Optional | Enter documented instructions / prn reason. Up to 300 characters. |
| Start date | Optional | Documented calendar date; YYYY-MM-DD. |
| End date | Optional | Documented calendar date; YYYY-MM-DD. |
Results
| Field | Requirement | How to fill |
|---|---|---|
| Parameter | Required * | Enter documented parameter. Up to 300 characters. |
| Local parameter code | Optional | Enter documented local parameter code. Up to 300 characters. |
| Mapped code system | Optional | Enter documented mapped code system. Up to 300 characters. |
| Mapped standard code | Optional | Enter documented mapped standard code. Up to 300 characters. |
| Value type | Optional | Choose: Numeric, Text |
| Numeric value | Optional | Recorded numeric value, decimal point, up to four decimal places. Money allows two. |
| Text value | Optional | Enter documented text value. Up to 300 characters. |
| Unit | Optional | Enter documented unit. Up to 300 characters. |
| Reference range | Optional | Enter documented reference range. Up to 300 characters. |
| Flag | Optional | Choose: Normal, High, Low, Abnormal |
| Interpretation | Optional | Enter documented interpretation. Up to 300 characters. |
Measurements
| Field | Requirement | How to fill |
|---|---|---|
| Measurement | Optional | Choose: Height, Weight, BMI, SystolicBP, DiastolicBP, Pulse, RespiratoryRate, Temperature, SpO2, Waist |
| Value | Required * | Recorded numeric value, decimal point, up to four decimal places. Money allows two. |
| Unit | Required * | Enter documented unit. Up to 300 characters. |
| Measured date/time | Required * | Documented date and time in IST. |
| Performer / source | Optional | Enter documented performer / source. Up to 300 characters. |
Allergies
| Field | Requirement | How to fill |
|---|---|---|
| Allergen | Required * | Enter documented allergen. Up to 300 characters. |
| Reaction | Optional | Enter documented reaction. Up to 300 characters. |
| Severity | Optional | Choose: mild, moderate, severe |
| Status | Optional | Choose: active, inactive, resolved |
| Recorded date | Optional | Documented calendar date; YYYY-MM-DD. |
InvoiceLines
| Field | Requirement | How to fill |
|---|---|---|
| Service / item | Required * | Enter documented service / item. Up to 300 characters. |
| Local item code | Optional | Enter documented local item code. Up to 300 characters. |
| Quantity | Required * | Recorded numeric value, decimal point, up to four decimal places. Money allows two. |
| Unit rate | Required * | Recorded numeric value, decimal point, up to four decimal places. Money allows two. |
| Discount amount | Optional | Recorded numeric value, decimal point, up to four decimal places. Money allows two. |
| Tax amount | Optional | Recorded 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
- Confirm patient, author, type, record number and IST timestamp.
- For new records, confirm Prior record ID is blank.
- Complete starred details for finalization and required fields on every added row.
- Confirm dropdown defaults match the source. Optional dropdowns select their first option initially.
- Use a decimal point without thousands separators; at most four decimal places for general numbers, two for money.
- Upload the required original for a health document; keep it within 2 MB.
- Read the confirmation before retrying; use the saved link for an amendment.
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.