Amakomaya Nepal FHIR Implementation Guide
2.0.0 - ci-build Nepal

Amakomaya Nepal FHIR Implementation Guide - Local Development build (v2.0.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

AMK Appointment Profile

Profile for representing appointments in the Amakomaya health system, capturing scheduling and participant

AMK Core Immunization Profile

The AMK Core Immunization Profile inherits from the FHIR Immunization resource; refer to it for scope and usage definitions. This profile sets minimum expectations for the Immunization resource to record, search, and fetch basic immunization information for an individual patient within the Nepal health system. It specifies which core elements, extensions, vocabularies, and value sets SHALL be present and constrains how the elements are used. By providing a standardized foundation for capturing immunization events in Nepal

AMK Core Medication Dispense Profile

The AMK Core MedicationDispense Profile inherits from the FHIR MedicationDispense resource; refer to it for scope and usage definitions. This profile sets minimum expectations for the MedicationDispense resource to record, search, and fetch information about medications dispensed to a patient within the Nepal health system. It specifies which core elements, extensions, vocabularies, and value sets SHALL be present and constrains how the elements are used.

AMK Core Observation Profile

Observation Profile

AMK Core Patient Profile

The AMK Core Patient Profile inherits from the FHIR Patient resource; refer to it for scope and usage definitions. This profile sets minimum expectations for the Patient resource to record, search, and fetch core patient information within the Nepal health system. It specifies which core elements, extensions, vocabularies, and value sets SHALL be present and constrains how the elements are used. By providing a standardized foundation for capturing patient demographics, identifiers, and key health attributes, this profile promotes interoperability, consistent data capture, and adoption across national health programs

AMK Core Person Profile

The AMK Core Person Profile defines a standardized representation of a real-world individual within the Nepal health system. It supports identity resolution, demographic capture, and identity assurance across Patient, Practitioner, and RelatedPerson records. This profile enables reliable identity verification, deduplication, and interoperability across national digital health programs.

AMK Encounter

Encounter representing in the Amakomaya app.

AMK Healthcare Service

Minimal profile for describing healthcare services provided by an organization at one or more locations.

AMK Location

Location resource representing a physical or virtual location, including GPS coordinates.

AMK Organization

Organization profile representing healthcare organizations such as hospitals, clinics, and health institutions.

AMK Related Person

Profile representing a person related to a patient, such as a caregiver or family member.

Amakomaya Binary (Minimal)

Minimal Binary profile for uploading and storing files in the Amakomaya system.

Amakomaya Communication

Communication profile for uploading and storing files in the Amakomaya system.

Amakomaya Consent

Consent profile for storing and managing patient consent preferences.

Amakomaya DocumentReference

DocumentReference profile for uploading and storing files in the Amakomaya system.

Reminder Task

A profile for system-generated reminder tasks created by a mobile or web application (e.g., Amakomaya App). Supports reminders for ANC visits, immunization dates, medication reminders, and follow-up actions.

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

AMK Application Mode

Allowed application modes for the AMK tracking app.

Administrative Gender

A value set containing administrative gender codes from the FHIR core.

Condition/Problem/Diagnosis codes

Condition/Problem/Diagnosis codes

Dietary Supplements (SNOMED)

Vitamins, minerals, and other dietary supplements

District

All district used in administrative divisions

Educational Level

SNOMED CT for the highest level of education attained.

LocalBody

All LocalBody used in administrative divisions

Observation ValueSet

A SNOMED CT value set for observations. Covers the three hierarchies used as Observation.code: clinical findings (what was found), observable entities (what was measured, such as sleep duration or water intake) and situations with explicit context (what was done, such as counselling given).

Option Set - Yes / No / Yes-only / Don't know / Not applicable

Master option set for Yes/No/Yes-only/Don't know/Not applicable, including Nepali designations:छ/छैन, हो/होइन, गराएको/नगराएको, लिएको/नलिएको, भएको/नभएको, पाएको/नपाएको

HL7 v2-0532 Code SNOMED CT Code English Meaning Nepali Variants
Y 373066001 Yes / Affirmative हो / गराएको / लिएको / भएको / पाएको
N 373067005 No / Negative होइन / नगराएको / नलिएको / नभएको / नपाएको
Province

All provinces used in administrative divisions

Severities

Severities

Tele Call Consent ValueSet

Allowed consent categories for telephonic communication preferences.

Vaccines (SNOMED CT)

ValueSet of routine vaccines in Nepal, based on SNOMED CT concepts.

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

Amakomaya Identifier Types

Identifier types used by Amakomaya that have no equivalent in the HL7 v2-0203 identifier type code system.

Application Mode for Amakomaya App

The different modes a user can select in the AMK tracking app.

Nepal Administrative Location Codes

Comprehensive code system for Nepals provinces, districts, and municipalities.

Tele Call Consent Categories

Consent options for telephonic communication preferences.

Terminology: Naming Systems

These define identifier and/or code system identities used by systems conforming to this implementation guide.

Aamako Maya Counselling Services ID

Unique identifier for individuals registered for counselling services under Aamako Maya.

Nepal Health Facility Registry Identifier

Unique identifier assigned to health facilities registered in the National Health Facility Registry (NHFR) of Nepal.

Nepal Health ID

Unique identifier for individuals for health services in Nepal.

Nepal National Identity Number

Nepalese National Identity Number issued by the Ministry of Home Affairs.

Nepal Telecome Subscriber Identifier Namespace

Defines the canonical identifier namespace used for all Nepal Telecome subscribers (phone numbers). Use this as identifier.system for Patient, Person, or Account resources.

Tokha Municipality Basic Health Services ID

Unique identifier for individuals registered in Basic Health Services under Tokha Municipality.

Terminology: Concept Maps

These define transformations to convert between codes by systems conforming with this implementation guide.

HL7 Administrative Gender to SNOMED CT

Maps HL7 Administrative Gender codes to SNOMED CT concepts.

Yes / No Concept Map

Mapping between HL7 v2-0532, SNOMED CT, and Nepali Yes/No custom codes

Example: Example Instances

These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.

Appointment - ANC Counseling Session for Pregnant Patient

An example appointment for an ANC counseling session scheduled for a pregnant patient.

Communication - Lab Report Notification
Consent - Opt In
DocumentReference - ANC Visit Report

ANC Visit Report from 2nd trimester

Encounter - Pregnancy Application Mode

An example instance representing an encounter with a pregnancy application mode.

HAMS Hospital Organization

HAMS Hospital, a tertiary care private hospital in Kathmandu, Nepal.

HealthcareService - Cardiology Outpatient Service

Cardiology outpatient healthcare service provided by HAMS Hospital

Immunization Record - BCG

An example of an immunization resource for BCG vaccine.

Immunization Record - DPT

An example of an immunization resource for Diphtheria, Pertussis, and Tetanus (DPT) vaccine.

Immunization Record - Fractional Injectable Polio Vaccine (fIPV)

Example immunization resource for fractional IPV, given intradermally at 14 weeks and 9 months (2 doses).

Immunization Record - HPV Vaccine

Example immunization resource for Human Papillomavirus vaccine, given intramuscularly to adolescent girls in grades 6-10 and out-of-school girls aged 10+.

Immunization Record - Japanese Encephalitis Vaccine

Example immunization resource for Japanese Encephalitis vaccine, given subcutaneously at 12 months.

Immunization Record - Measles-Rubella Vaccine

Example immunization resource for Measles-Rubella vaccine, given subcutaneously at 9 and 15 months.

Immunization Record - OPV

An example of an immunization resource for Oral Polio Vaccine (OPV).

Immunization Record - PCV

An example of an immunization resource for Pneumococcal Conjugate Vaccine (PCV).

Immunization Record - Pentavalent Vaccine

An example of an immunization resource for the Pentavalent vaccine (DPT-HepB-Hib).

Immunization Record - Polio

An example of an immunization resource for Poliomyelitis vaccine (IPV/OPV).

Immunization Record - Rotavirus

An example of an immunization resource for Rotavirus vaccine.

Immunization Record - Td

An example of an immunization resource for Tetanus and Diphtheria (Td) vaccine.

Immunization Record - Typhoid Vaccine

Example immunization resource for Typhoid vaccine, given intramuscularly at 15 months.

Location - HAMS Hospital

Physical location of HAMS Hospital, Kathmandu, Nepal.

MedicationDispense - Albendazole

Example of albendazole to a pregnant woman according to AMK Core MedicationDispense Profile.

MedicationDispense - Calcium Dispense

Example of dispensing 30 Calcium to a pregnant woman according to AMK Core MedicationDispense Profile.

MedicationDispense - Iron Tablet Dispense

Example of dispensing 60 iron tablets to a pregnant woman according to AMK Core MedicationDispense Profile.

Observation - Aamako Maya Counseling

Observation record from Aamako Maya counseling session.

Observation - Amakomaya Sleep Duration

Observation for recording a patient's sleep duration.

Observation - Amakomaya Water Intake

Observation for recording a patient's daily water intake.

Observation - Body Weight

Body weight measurement for a patient.

Patient – Child

1-year-old Suman Thapa from Kathmandu Metropolitan City Ward No. 12 visiting the Health Facility for routine immunizations.

Patient – Pregnant Woman (Mom-to-Be)

21-year-old Hiramaya Tamang from Ilam Municipality Ward No. 5 visiting the district hospital for pregnancy-related care.

Person - Master Person Index
RelatedPerson - Caregiver for Pregnant Woman

An example related person/caregiver for a pregnant woman.

Task - Simple Reminder for Pregnant Patient

A minimal example of an app-generated reminder task for a pregnant patient.