NP Core Encounter

Sets minimum expectations for representing a clinical interaction between a patient and a healthcare provider in Nepal.

Canonical URL: http://fhir.digitalhealth.gov.np/core/StructureDefinition/np-core-encounter
Resource / type: Encounter
Based on: http://hl7.org/fhir/StructureDefinition/Encounter
Claim conformance: Put the canonical URL in meta.profile of each instance.

Required elements

“Always” means the element must be present in every instance. Otherwise it is required only when its parent element is present.

Element	Card.	When
`Encounter.identifier` Business identifier(s) for this encounter	1..*	Always
`Encounter.identifier.system` Namespace URI for the identifier value	1..1	Always
`Encounter.identifier.value` Local visit or encounter number assigned by the facility	1..1	Always
`Encounter.status` planned \| arrived \| triaged \| in-progress \| onleave \| finished \| cancelled +	1..1	Always
`Encounter.statusHistory.status` planned \| arrived \| triaged \| in-progress \| onleave \| finished \| cancelled +	1..1	If parent present
`Encounter.statusHistory.period` The time that the episode was in the specified status	1..1	If parent present
`Encounter.class` Classification of patient encounter	1..1	Always
`Encounter.classHistory.class` inpatient \| outpatient \| ambulatory \| emergency +	1..1	If parent present
`Encounter.classHistory.period` The time that the episode was in the specified class	1..1	If parent present
`Encounter.subject` The patient or group present at the encounter	1..1	Always
`Encounter.diagnosis.condition` The diagnosis or procedure relevant to the encounter	1..1	If parent present
`Encounter.location.location` Location the encounter takes place	1..1	If parent present

Must-support elements

If your system has this data it SHALL send it, and receivers SHALL process it. Must-support does not by itself make an element mandatory.

Encounter.extension:isPoliceCase
Encounter.identifier
Encounter.status
Encounter.class
Encounter.type
Encounter.subject
Encounter.participant
Encounter.period
Encounter.period.start
Encounter.reasonCode
Encounter.reasonReference
Encounter.hospitalization
Encounter.hospitalization.origin
Encounter.hospitalization.dischargeDisposition
Encounter.serviceProvider

Terminology bindings

required: codes SHALL come from the value set · extensible: use the value set if a suitable code exists · preferred / example: guidance only.

Element	Strength	Value set
`Encounter.language`	preferred	http://hl7.org/fhir/ValueSet/languages
`Encounter.identifier.use`	required	http://hl7.org/fhir/ValueSet/identifier-use
`Encounter.identifier.type`	extensible	http://hl7.org/fhir/ValueSet/identifier-type
`Encounter.status`	required	http://hl7.org/fhir/ValueSet/encounter-status
`Encounter.statusHistory.status`	required	http://hl7.org/fhir/ValueSet/encounter-status
`Encounter.class`	extensible	http://terminology.hl7.org/ValueSet/v3-ActEncounterCode
`Encounter.classHistory.class`	extensible	http://terminology.hl7.org/ValueSet/v3-ActEncounterCode
`Encounter.type`	preferred	Encounter Type ValueSet http://fhir.digitalhealth.gov.np/core/ValueSet/encounter-type-vs
`Encounter.serviceType`	example	http://hl7.org/fhir/ValueSet/service-type
`Encounter.priority`	example	http://terminology.hl7.org/ValueSet/v3-ActPriority
`Encounter.participant.type`	extensible	http://hl7.org/fhir/ValueSet/encounter-participant-type
`Encounter.reasonCode`	preferred	http://hl7.org/fhir/ValueSet/encounter-reason
`Encounter.diagnosis.use`	preferred	http://hl7.org/fhir/ValueSet/diagnosis-role
`Encounter.hospitalization.admitSource`	preferred	http://hl7.org/fhir/ValueSet/encounter-admit-source
`Encounter.hospitalization.reAdmission`	example	http://terminology.hl7.org/ValueSet/v2-0092
`Encounter.hospitalization.dietPreference`	example	http://hl7.org/fhir/ValueSet/encounter-diet
`Encounter.hospitalization.specialCourtesy`	preferred	http://hl7.org/fhir/ValueSet/encounter-special-courtesy
`Encounter.hospitalization.specialArrangement`	preferred	http://hl7.org/fhir/ValueSet/encounter-special-arrangements
`Encounter.hospitalization.dischargeDisposition`	example	http://hl7.org/fhir/ValueSet/encounter-discharge-disposition
`Encounter.location.status`	required	http://hl7.org/fhir/ValueSet/encounter-location-status
`Encounter.location.physicalType`	example	http://hl7.org/fhir/ValueSet/location-physical-type

Rules (invariants)

np-enc-1 An encounter SHALL carry at least one identifier whose system is namespaced under the assigning facility's NHFR code (i.e. http://nhfr.digitalhealth.gov.np/{nhfrCode}, with a non-empty code segment).

FHIRPath

identifier.where(system.startsWith('http://nhfr.digitalhealth.gov.np/') and system != 'http://nhfr.digitalhealth.gov.np/').exists()

Official examples

Encounter/ExampleNPCoreEncounter

View in IG ↗

{
  "resourceType": "Encounter",
  "id": "ExampleNPCoreEncounter",
  "meta": {
    "profile": [
      "http://fhir.digitalhealth.gov.np/core/StructureDefinition/np-core-encounter"
    ]
  },
  "extension": [
    {
      "url": "http://fhir.digitalhealth.gov.np/core/StructureDefinition/np-core-is-police-case",
      "valueBoolean": false
    }
  ],
  "identifier": [
    {
      "use": "official",
      "system": "http://nhfr.digitalhealth.gov.np/00XX",
      "value": "VISIT-2026-0000123"
    }
  ],
  "status": "finished",
  "class": {
    "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
    "code": "AMB",
    "display": "Ambulatory"
  },
  "type": [
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "11429006",
          "display": "Consultation"
        }
      ]
    }
  ],
  "subject": {
    "reference": "Patient/ExampleNPCorePatient"
  },
  "participant": [
    {
      "individual": {
        "reference": "Practitioner/ExampleNPCorePractitioner"
      }
    }
  ],
  "period": {
    "start": "2026-05-10T09:00:00+05:45",
    "end": "2026-05-10T09:30:00+05:45"
  },
  "serviceProvider": {
    "reference": "Organization/ExampleNPCoreOrganization"
  }
}

Narrative (text) removed for readability.

Encounter/ExampleNPCoreEncounterLabOnly

View in IG ↗

{
  "resourceType": "Encounter",
  "id": "ExampleNPCoreEncounterLabOnly",
  "meta": {
    "profile": [
      "http://fhir.digitalhealth.gov.np/core/StructureDefinition/np-core-encounter"
    ]
  },
  "identifier": [
    {
      "use": "official",
      "system": "http://nhfr.digitalhealth.gov.np/12345",
      "value": "VISIT-2026-0000456"
    }
  ],
  "status": "finished",
  "class": {
    "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
    "code": "AMB",
    "display": "Ambulatory"
  },
  "type": [
    {
      "coding": [
        {
          "system": "http://fhir.digitalhealth.gov.np/core/CodeSystem/encounter-type",
          "code": "lab-only",
          "display": "Laboratory-only visit"
        }
      ]
    }
  ],
  "subject": {
    "reference": "Patient/ExampleNPCorePatient"
  },
  "period": {
    "start": "2026-05-12T08:15:00+05:45",
    "end": "2026-05-12T08:30:00+05:45"
  },
  "serviceProvider": {
    "reference": "Organization/ExampleNPCoreOrganization"
  }
}

Narrative (text) removed for readability.