NPHCDA Immunization FHIR IG
0.7.0 - ci-build Nigeria flag

NPHCDA Immunization FHIR IG, published by https://nphcda.gov.ng. This guide is not an authorized publication; it is the continuous build for version 0.7.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/Nigeria-FHIR-Community/NPHCDA-ImmunizationIG/ and changes regularly. See the Directory of published versions

Artifacts Summary

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

Behavior: Capability Statements

The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.

NG-Imm Client CapabilityStatement

This CapabilityStatement describes the expected behavior of an offline-first client (e.g., mobile Immunization POC health facility system), FHIR-capable systems implementing Nigeria’s Immunization Implementation Guide.

NG-Imm Server CapabilityStatement

This CapabilityStatement describes the expected behaviour of an Immunization server managed by NPHCDA that other Immunization clients or server connect to or share information for care fulfillment.

Structures: Logical Models

These define data models that represent the domain covered by this implementation guide in more business-friendly terms than the underlying FHIR resources.

NG-Imm-A RegisterFacility

IMMZ.A - A logical model representing a health facility being registered in the immunization system.

NG-Imm-C5 RegisterClient

IMMZ.C5 - A logical model representing a client being registered in the immunization system.

NG-Imm-C6 UpdateClientHistory

IMMZ.C6 - A logical model for tracking client immunization history updates.

NG-Imm-D AdministerVaccine

IMMZ.D - A logical model for capturing vaccine administration details

NG-Imm-E Manage & ReportAEFI

IMMZ.E - A logical model for recording and managing AEFI treatment.

NG-Imm-G DefaulterTracking

IMMZ.G - A logical model for tracking immunization defaulters.

NG-Imm-H GenerateReport

IMMZ.H - Data elements for the IMMZ.G Report Generation Data Dictionary.

Structures: Resource Profiles

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

IMMZ.A Bundle Register Facility

Transaction Bundle used to register a facility and its core context: Organization (owner), Location (service point), Practitioner (staff), and PractitionerRole (linking staff to org/location and services).

IMMZ.C.5 Bundle Client Registration

Transaction Bundle to register an immunization client and related context.

IMMZ.C6 Bundle Update Client

Transaction Bundle used to submit client update content such as an Encounter, registration/update Observation, and one or more Immunizations — along with the acting Practitioner and the managing Organization. The Patient is assumed to already exist on the server and is referenced directly.

IMMZ.E Bundle ManageReportAEFI

Transaction Bundle for reporting and managing an Adverse Event Following Immunization (AEFI). Includes the encounter where the event was assessed, the clinical observation(s) describing the event, and an AllergyIntolerance record capturing the reaction and severity.

IMMZ.H Bundle GenerateReport

Transaction Bundle for generating and submitting immunization-related reports. Carries the Measure definition (indicator), the MeasureReport (calculated results), and contextual information about the reporting Organization and Practitioner.

NG-Imm AllergyIntolerance

Nigeria Immunization Allergy Intolerance Profile

NG-Imm ClientRegistUpdate-Observations

A composite Observation profile capturing state of health, underlying conditions, HIV status, ages in weeks/months/years during client registration.

NG-Imm Encounter

A profile for encounters in the Nigerian Immunization guide, used to document immunization visits and related healthcare interactions.

NG-Imm Immunization

Nigerian Profile for Immunization resource.

NG-Imm Location

A profile for immunization service locations, including health facilities, outreach sites, and mobile vaccination units.

NG-Imm Measure

A profile on the Measure resource used to define immunization indicators within Nigeria’s routine immunization program.

NG-Imm MeasureReport

Nigeria Immunization Measure Report Profile

NG-Imm Organization

An organization profile representing healthcare facilities responsible for immunization services or other types of organizations.

NG-Imm Patient

Nigeria Immunization Patient Profile

NG-Imm Practitioner

Profile for a Nigerian Practitioner

NG-Imm PractitionerRole

Defines the role(s) of a Nigerian healthcare practitioner in the immunization context. Links a Practitioner to an Organization, specifies their role, contact details, and periods of service, with constraints to support the Nigeria Immunization IG.

NG-Imm Provenance

A Provenance profile tailored for Nigeria’s Immunization workflows (using FHIR R4.0.1). Captures the origin, responsible party, and context for the creation, modification, or exchange of immunization-related records, including Immunization, AEFI, Defaulter Tracing, and related patient data.

NG-Imm RelatedPerson

Sibling that represents the mother’s other children as RelatedPersons.

Structures: Extension Definitions

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

NG-Imm Administrative Wards

Captures the administrative ward within a geographic address

NG-Imm Allergy Dose Number

Reference immunization dose number for this AllergyIntolerance.

NG-Imm Client's HIV status

The HIV status (positive, negative, or unknown) of the Immunization Client

NG-Imm Client's Pregnancy status

The Pregnancy status (pregnant or not-pregnant) of the Immunization Client, including the period during which the status was asserted.

NG-Imm Dose Series

Dose series number from the referenced Immunization.protocolApplied.doseNumber.

NG-Imm Encounter Signature

A digital or electronic signature capturing who signed, when, type, and signature data. Extension to capture the practitioner’s digital signature on an Encounter resource.

NG-Imm Immunization Contraindicated

Indicates whether the immunization was contraindicated

NG-Imm Next Dose Date

The recommended due date for the next vaccine dose in the schedule.

NG-Imm Sibling's health status

The health status of the Client’s sibling

NG-Imm Vaccine Contraindications

Indicates specific situations in which it is not recommended to administer certain vaccines (e.g severe AEFI, History of Anaphylactic reactions, Symptomatic HIV infection)

NG-Imm owner of health institution

An extension to define the owner of the health institution

Terminology: Value Sets

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

NG Gender or Sex VS

A subset of the administrative gender codes including only ‘male’ and ‘female’

NG IMMZ.D.DE4 Vaccine ICD ValueSet

All ICD11 vaccine codes (DE1–DE29).

NG IMMZ.D.DE4 Vaccine Local ValueSet

All local vaccine codes (DE1–DE29).

NG IMMZ.D.DE4 Vaccine SNOMED ValueSet

All SNOMED vaccine codes (DE1–DE29).

NG-Imm Client HIV Status VS

Client HIV Status

NG-Imm Clinical Status VS

The outcome of the reaction

NG-Imm Clinical Status VS

The outcome of the reaction

NG-Imm Clinical Status VS

The outcome of the reaction

NG-Imm HealthFacility Type VS

Classification of Nigerian health facilities

NG-Imm LGAs VS

The administrative Local Government Areas where a person or a facility is.

NG-Imm Location Owner

The owner of an Immunization location

NG-Imm MMZ.C.DE1 Client Identifier VS

This ValueSet defines list of options for uniquely Identifting a Client

NG-Imm Relationships VS

list of persons related to a patient, but who is not a direct target of care.

NG-Imm Session Type VS

Type of session for immunization. Could be in a fixed facility, outreach or mobile.

NG-Imm Sibling Health Status VS

This CodeSystem defines the health of the client’s sibling

NG-Imm Sibling Relationships VS

A sub list from relationship list with only two options brother and sister.

NG-Imm States VS

The state where a person or a facility is.

NG-Imm Vaccine Contraindication VS

A set of standardized codes used to represent clinical conditions, diagnoses, or circumstances that serve as contraindications to the administration of one or more vaccines.

NG-Imm Wards VS

The administrative Ward (within an LGA) where a person or a facility is.

Terminology: Code Systems

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

IMMZ.A.DE1 Facility Identifier CS

This CodeSystem IMMZ.A.DE1 defines placeholder codes to manage Facility identifiers in Nigeria.

IMMZ.C.DE1 Client Identifier CS

This CodeSystem defines list of options for uniquely Identifting a Client

IMMZ.C.DE14 Administrative Wards CS

This CodeSystem IMMZ.C.DE14 defines ward codes and names mapped to their respective Local Government Areas (LGAs) in Nigeria.

IMMZ.C.DE20 - Relationships CS

This CodeSystem IMMZ.C.DE20 defines list of persons related to a patient, but who is not a direct target of care

IMMZ.C.DE24 LGAs in Nigeria CS

This CodeSystem defines LGA codes and names mapped to their respective States in Nigeria.

IMMZ.C.DE25 States in Nigeria CS

This CodeSystem defines ward codes and names mapped to their respective States in Nigeria.

IMMZ.C.DE30 Sibling Health Status CS

This CodeSystem IMMZ.C.DE30 defines the health of the client’s sibling

IMMZ.C.DE31 - Client HIV status CS

This CodeSystem IMMZ.C.DE31 defines list of options for HIV status of a Client

IMMZ.C.DE32 Client Pregnancy status CS

This CodeSystem defines list of options for Pregnancy status of a Client

IMMZ.D.DE14 Practitioner Identifier CS

This CodeSystem IMMZ.C.DE14 defines placeholder codes to manage physician identifiers in Nigeria.

IMMZ.D.DE3 Facility Type CS

A standardized classification system IMMZ.D.DE3 used to describe the type or level of health facility within a healthcare delivery system, based on the scope of services provided, staffing, infrastructure, and administrative role.

IMMZ.D.DE3 Immunization Session types CS

Type of session for immunization IMMZ.D.DE3. Could be in a fixed facility, outreach or mobile.

IMMZ.D.DE3-2 Location Owner CS

This CodeSystem defines Immunization Location Owner.

IMMZ.D.DE6 Vaccine contraindications CS

A set of standardized codes used to represent clinical conditions, diagnoses, or circumstances that serve as contraindications to the administration of one or more vaccines.

IMMZ.E.DE6 Adverse Event Clinical Status CS

A classification system that represents the current clinical status of an individual who experienced an Adverse Event Following Immunization (AEFI), based on medical observation, investigation, or follow-up assessment.

NG Age Component Codes

This CodeSystem defines list of age options for a Client

NG IMMZ.D.DE4 Vaccine Local Codes (Dose-labelled)

Locally defined vaccine codes used for data capture and UI labels. Doses are local; external systems map at antigen/product level.

Terminology: Structure Maps

These define transformations to convert between data structures used by systems conforming to this implementation guide.

StructureMap: AdministerVaccine to FHIR Resources

Map logical AdministerVaccine to NgImmImmunization, NgImmLocation, NgImmPractitioner, and NgImmEncounter profiles

StructureMap: DefaulterTracking to Immunization and related profiles

Map logical DefaulterTracking model to NgImmImmunization, NgImmPatient, NgImmEncounter, and NgImmPractitioner profiles

StructureMap: ManageAEFI to AllergyIntolerance, Encounter, Practitioner, and Patient

Maps ManageAEFI logical model to NgImmAllergyIntolerance, NgImmEncounter, NgImmPractitioner, and NgImmPatient profiles

StructureMap: RegisterClientModel to NgImmPatient

Map logical RegisterClientModel to NgImmPatient profile

StructureMap: RegisterFacilityModel to NgImmOrganization and NgImmLocation

Map logical RegisterFacilityModel to NgImmOrganization and NgImmLocation profiles

StructureMap: ReportGeneration to MeasureReport and Related Profiles

Map ReportGeneration logical model to NgImmMeasureReport, NgImmMeasure, and NgImmPractitioner

Terminology: Concept Maps

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

Local Vaccine Codes → ICD-11

Maps local dose-labelled DE codes to ICD-11 vaccine concepts (antigen/product level).

Local Vaccine Codes → SNOMED CT

Maps local dose-labelled DE codes to SNOMED CT vaccine concepts (antigen/product level).

Example: Example Instances

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

Example NG-Imm Allergy Intolerance (Yellow Fever Vaccine, Severe)

An example of a severe allergic reaction (anaphylaxis) following Yellow Fever vaccination.

Example NG-Imm Allergy Intolerance -001

An example of allergy or intolerance to a vaccine per the NG-Imm AllergyIntolerance profile.

Example NG-Imm Allergy Intolerance 001

An example of allergy/adverse reaction following measles vaccine administration.

Example NG-Imm Encounter

An immunization visit encounter per the NG-Imm Encounter profile.

Example NG-Imm Encounter (Mobile)

A mobile team immunization encounter per the NG-Imm Encounter profile.

Example NG-Imm Encounter (Outreach)

An outreach immunization encounter per the NG-Imm Encounter profile.

Example NG-Imm Immunization (Complete)

A complete example of an immunization record per the NgImmImmunization profile.

Example NG-Imm Immunization (Simple)

A simple immunization record example with minimal fields populated.

Example NG-Imm Immunization -001

An example Immunization resource per the NG-Imm Immunization profile.

Example NG-Imm Location

An immunization service location (Primary Health Centre) in Lagos, Nigeria.

Example NG-Imm Location (Mobile Team)

A mobile immunization team location operating in Benue State, Nigeria.

Example NG-Imm Location (Outreach Site)

An outreach immunization service location (temporary site in a school) in Kano, Nigeria.

Example NG-Imm Organization (Lagos PHC)

A healthcare facility providing routine immunization services in Lagos State.

Example NG-Imm Organization (NGO Outreach Post)

A temporary outreach post supported by an international NGO providing immunization services.

Example NG-Imm Organization (Private Hospital)

A private hospital in Abuja offering immunization services.

Example NG-Imm Patient -002

A partially populated patient per NgImmPatient, with only MRN and phone identifiers.

Example NG-Imm Patient 001

An example patient resource fully populated according to the NG-Imm Patient profile.

Example NG-Imm Patient-003

A sample immunization patient from Lagos State.

Example NG-Imm Practitioner

A Nigerian healthcare practitioner serving as a Routine Immunization Officer.

Example NG-Imm Practitioner (CHEW, Kano)

A Community Health Extension Worker providing RI services in Kano State.

Example NG-Imm Practitioner (Midwife, Enugu)

A licensed midwife responsible for maternal and child health services, including immunization, at a public hospital in Enugu.

Example NG-Imm PractitionerRole

A Routine Immunization Officer role linking a practitioner to a primary health centre in Lagos.

Example NG-Imm PractitionerRole (AEFI Surveillance Officer)

An AEFI Surveillance Officer role linking a CHEW to a public health facility in Kano State.

Example NG-Imm PractitionerRole (Midwife, Enugu)

A Midwife role linking a licensed midwife to a public teaching hospital in Enugu State, providing maternal and child health immunization services.

Example NG-Imm Provenance

Provenance for creation of an Immunization record during an encounter at a Lagos PHC.

Example NG-Imm Provenance Update

Provenance for updating a Patient and AllergyIntolerance record following an adverse reaction to Measles vaccine at Kano General Hospital.

Example NG-Imm Registration Observation

An example observation recorded when a client is registered, capturing health and status data.

Example NG-Imm Registration Update Observation (Subsequent Visit)

Observation recorded during a later visit to update client status and age-related details.

Example RegisterClient (Average)

Representative example of a client registered in the immunization system.

Example RegisterFacility (Minimal)

Minimal required fields for NG-Imm-A RegisterFacility logical model.

Example UpdateClientHistory (Average)

Tracks an individual’s immunization history updates for routine antigens and supplements.

Minimal NG-Imm Provenance Example

Minimal provenance capturing creation of an immunization record.

NG-Imm Example AEFI case report

An example case of Adverse Event Following Immunization Report

NG-Imm Example Stock report

An example Stock management report

NG-Imm Routine Immunization Report - Facility A

A routine monthly immunization report summarizing vaccine stock and usage for Facility A.

Sibling RelatedPerson Example

Example of a RelatedPerson resource representing a sibling (brother) of the immunization client.

Sibling RelatedPerson Example - Infant Brother with Malnutrition

Example of a RelatedPerson resource representing a younger infant sibling (brother) of the immunization client, showing malnutrition status.

Sibling RelatedPerson Example - Sister with Asthma

Example of a RelatedPerson resource representing a sibling (sister) of the immunization client with a chronic condition (asthma).