# Terminology - Aotearoa Immunisation Register (AIR) FHIR Implementation Guide (API-V1) v1.28.0-SNAPSHOT

* [**Table of Contents**](toc.md)
* **Terminology**

## Terminology

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

### Code Systems

* Title: [AIR AGVS Schedule Type-undefined](CodeSystem-air-agvs-schedule-type.md)
  * Description: This is a code system for representing the type of AGVS schedule attached to a Scheduled Event
  * Canonical url: [https://standards.digital.health.nz/ns/air-agvs-schedule-type](https://standards.digital.health.nz/ns/air-agvs-schedule-type)
* Title: [AIR AGVS Series Type-undefined](CodeSystem-air-agvs-series-type.md)
  * Description: This is a code system for representing the type of AGVS series attached to a Scheduled Event
  * Canonical url: [https://standards.digital.health.nz/ns/air-agvs-series-type](https://standards.digital.health.nz/ns/air-agvs-series-type)
* Title: [AIR AGVS-undefined](CodeSystem-air-agvs-type.md)
  * Description: This is a code system for representing the type of AGVS attached to a Scheduled Event
  * Canonical url: [https://standards.digital.health.nz/ns/air-agvs-type](https://standards.digital.health.nz/ns/air-agvs-type)
* Title: [AIR Consumer State-undefined](CodeSystem-air-consumer-state.md)
  * Description: This is a code system for representing the current state of an AIR Patient (AKA Consumer).
  * Canonical url: [https://standards.digital.health.nz/ns/air-consumer-state](https://standards.digital.health.nz/ns/air-consumer-state)
* Title: [AIR Consumer Sub Status-undefined](CodeSystem-air-consumer-sub-status.md)
  * Description: This is a code system for representing the current sub status of an AIR Patient (AKA Consumer).
  * Canonical url: [https://standards.digital.health.nz/ns/air-consumer-sub-status](https://standards.digital.health.nz/ns/air-consumer-sub-status)
* Title: [AIR Event Type-1.0](CodeSystem-air-event-type-1.0.md)
  * Description: Identifies AIR events.
  * Canonical url: [https://standards.digital.health.nz/ns/air-event-type](https://standards.digital.health.nz/ns/air-event-type)
* Title: [AIR Forecast Status-undefined](CodeSystem-air-forecast-status.md)
  * Description: This code system includes the codes used in AIR to communicate a planned event status that are not already included in http://terminology.hl7.org/CodeSystem/immunization-recommendation-status.
  * Canonical url: [https://standards.digital.health.nz/ns/air-forecast-status](https://standards.digital.health.nz/ns/air-forecast-status)
* Title: [AIR Immunisation Notification Action Code-1.0](CodeSystem-air-immunisation-notification-action-code-1.0.md)
  * Description: Describes the action taken by Orchestration server in response to an Immunisation Notification request message
  * Canonical url: [https://standards.digital.health.nz/ns/air-immunisation-notification-action-code](https://standards.digital.health.nz/ns/air-immunisation-notification-action-code)
* Title: [AIR Related Person Relationship Terms-undefined](CodeSystem-air-related-person-terms.md)
  * Description: This code system includes the relationship type codes used in the NIR HL7v2 messasing NK1 segment Relationship field.
  * Canonical url: [https://standards.digital.health.nz/ns/air-legacy-related-person-terms](https://standards.digital.health.nz/ns/air-legacy-related-person-terms)
* Title: [AIR Operationoutcome Codes-1.0](CodeSystem-air-operationoutcome-code-1.0.md)
  * Description: Describes the AIR-specific errors
  * Canonical url: [https://standards.digital.health.nz/ns/air-operationoutcome-code](https://standards.digital.health.nz/ns/air-operationoutcome-code)
* Title: [AIR Planned Event Date Type Code System-undefined](CodeSystem-air-planned-event-date-type.md)
  * Description: This code system includes the codes used in AIR to communicate a date associated with a planned event, such as the due date or the earliest date to give. 
  * Canonical url: [https://standards.digital.health.nz/ns/air-planned-event-date-type](https://standards.digital.health.nz/ns/air-planned-event-date-type)
* Title: [AIR Processing Terms-undefined](CodeSystem-air-processing-terms.md)
  * Description: This Code System contains meta tags that AIR uses to signal processing outcomes
  * Canonical url: [https://standards.digital.health.nz/ns/air-processing-terms](https://standards.digital.health.nz/ns/air-processing-terms)
* Title: [AIR Planned Event Type-undefined](CodeSystem-air-planned-event-type-terms.md)
  * Description: This code system includes values for the types of Planned Events used in AIR.
  * Canonical url: [https://standards.digital.health.nz/ns/air-scheduled-event-type-terms](https://standards.digital.health.nz/ns/air-scheduled-event-type-terms)
* Title: [AIR Serology Protection Terms Code System-undefined](CodeSystem-air-serology-protection-terms.md)
  * Description: This local code system includes the terms used in legacy HL7 messages and FHIR requests related to serology reports for protection status for diseases such as Hepatitis B.
  * Canonical url: [https://standards.digital.health.nz/ns/air-serology-protection-terms](https://standards.digital.health.nz/ns/air-serology-protection-terms)
* Title: [AIR Status Reason Terms Code System-undefined](CodeSystem-air-status-reason-terms.md)
  * Description: This AIR code system includes the terms used in NIR HL7v2 messages to populate the RXA-18 field and and in FHIR payloads to populate immunization.statusReason.
  * Canonical url: [https://standards.digital.health.nz/ns/air-status-reason-terms](https://standards.digital.health.nz/ns/air-status-reason-terms)
* Title: [AIR Terms-undefined](CodeSystem-air-terms-code.md)
  * Description: This is a code system for terms needed in AIR ImmSoT that don't come from an external standard
  * Canonical url: [https://standards.digital.health.nz/ns/air-terms-code](https://standards.digital.health.nz/ns/air-terms-code)
* Title: [Hl7v2 Result Code-1.0](CodeSystem-Hl7v2-result.md)
  * Description: Hl7v2 Result Code
  * Canonical url: [https://standards.digital.health.nz/ns/hl7v2-result](https://standards.digital.health.nz/ns/hl7v2-result)
* Title: [NZVX Immunisation Code-undefined](CodeSystem-immunisation-code.md)
  * Description: Antigen code set for vaccines administered in New Zealand (NZVX).
  * Canonical url: [https://standards.digital.health.nz/ns/immunisation-code](https://standards.digital.health.nz/ns/immunisation-code)

### ValueSets

| | | |
| :--- | :--- | :--- |
| [AIR Administered Product Code-undefined](ValueSet-air-administered-product-code.md) | NZMT TPUU codes for use in populating the administeredProduct element in an AIR Immunization resource. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-administered-product-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-administered-product-code) |
| [AIR Antigen Group Code-undefined](ValueSet-air-antigen-group-code.md) | SNOMED CT Codes used in AIR to identify an Antigen Group. These codes are drawn from the SNOMED medicinal product hierarchy. The AIR Antigen Group is used in the ImmunizationRecommendation resource that is produced when a user requests a patient's list of Planned Events. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-antigen-group-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-antigen-group-code) |
| [AIR Consumer State Code-undefined](ValueSet-air-consumer-state-code.md) | Represents the current state of an AIR Consumer. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-consumer-state-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-consumer-state-code) |
| [AIR Consumer Sub Status Code-undefined](ValueSet-air-consumer-sub-status-code.md) | Represents the current sub status of an AIR Consumer. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-consumer-sub-state-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-consumer-sub-state-code) |
| [AIR Diseases Covered-undefined](ValueSet-air-disease-covered-code.md) | Diseases that are covered by the immunization programmes and schedules that are managed or referred to in the AIR system. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-disease-covered-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-disease-covered-code) |
| [AIR Forecast Status-undefined](ValueSet-air-forecast-status-code.md) | This value set includes the codes used in AIR to communicate the status of a planned event.  | [https://nzhts.digital.health.nz/fhir/ValueSet/air-forecast-status-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-forecast-status-code) |
| [AIR HL7v2 Immunization Function Code-undefined](ValueSet-air-hl7v2-imm-func-code.md) | This value set holds health worker function codes used in legacy NIR messaging. Its purpose in AIR is to enable a mapping to semantically equivalent AIR Terms codes. These codes should NOT be used in FHIR payloads. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-hl7v2-imm-func-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-hl7v2-imm-func-code) |
| [AIR Immunization Function Code (legacy)-undefined](ValueSet-air-imm-func-code-code-legacy.md) | This value set holds legacy health worker function codes. Its purpose in AIR is to enable a mapping to semantically equivalent AIR Terms codes. These codes should NOT be used in FHIR payloads. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-imm-func-code-legacy](https://nzhts.digital.health.nz/fhir/ValueSet/air-imm-func-code-legacy) |
| [AIR Indication Code-undefined](ValueSet-air-indication-code.md) | Coded values to describe the reason an immunisation was given. Initially drawn from legacy NIR codes and CIR SNOMED codes. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-indication-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-indication-code) |
| [AIR Performer Health Worker Function-undefined](ValueSet-air-performer-health-worker-function-code.md) | A value set of codes for the functions performed by the people who are involved in administering immunisations in Aotearoa. Note that the preferred terms are AP, OP, VC, VHW and IP. The other terms in this value set will be deprecated in the future. Note that the following codes are considered as Administering Providers: AP, IP, LMC, OIS, PV, VC, VHW, WCP. The following code is considered an Ordering Provider: GP. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-performer-health-worker-function-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-performer-health-worker-function-code) |
| [AIR Planned Event Date Type Code-undefined](ValueSet-air-planned-event-date-type-code.md) | Coded values to describe the dates associated with a Planned Event, such as the Due Date, the Earliest Date to Give, and so on. Also codes pretaining to the Planned Event record in AIR, such as the date it was created and the date the Planned Event moved in Final status. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-planned-event-date-type-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-planned-event-date-type-code) |
| [AIR Processing Terms Code-undefined](ValueSet-air-processing-terms-code.md) | This Value Set contains meta tags that AIR uses to signal processing outcomes. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-processing-terms-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-processing-terms-code) |
| [AIR Related Person Relationship Code-undefined](ValueSet-air-related-person-relationship-code.md) | This value set is used to encode the relationship of a related person to the vaccine consumer. It is a subset of the FHIR Patient Relationship Type value set and includes some customised codes and displays for NZ usage. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-related-person-relationship-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-related-person-relationship-code) |
| [AIR Route Code (Legacy HL7v2)-undefined](ValueSet-air-route-code-legacy.md) | A value set to hold the legacy HL7v2 codes for route of admin. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-route-code-legacy](https://nzhts.digital.health.nz/fhir/ValueSet/air-route-code-legacy) |
| [AIR Route of Administration-undefined](ValueSet-air-route-code.md) | Route of administration value set for AIR immunisations | [https://nzhts.digital.health.nz/fhir/ValueSet/air-route-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-route-code) |
| [AIR Scheduled Event Type Code-undefined](ValueSet-air-scheduled-event-type-code.md) | This value set lists the codes to be used to describe scheduled event type in AIR. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-scheduled-event-type-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-scheduled-event-type-code) |
| [AIR Serology Protection Code-undefined](ValueSet-air-serology-protection-code.md) | This value set includes all codes from the AIR Serology Protection code system. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-serology-protection-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-serology-protection-code) |
| [AIR Body Site-undefined](ValueSet-air-site-code.md) | Body sites value set for AIR immunisations | [https://nzhts.digital.health.nz/fhir/ValueSet/air-site-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-site-code) |
| [AIR Status Reason Code-undefined](ValueSet-air-status-reason-code.md) | Values to use in the status reason field of an immunisation event. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-status-reason-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-status-reason-code) |
| [AIR Vaccine Product-undefined](ValueSet-air-vaccine-product-code.md) | Allowable values for CVX and NZVX codes used to populate the vaccineCode element in an AIR Immunization resource. | [https://nzhts.digital.health.nz/fhir/ValueSet/air-vaccine-product-code](https://nzhts.digital.health.nz/fhir/ValueSet/air-vaccine-product-code) |
| [Hl7v2_resultResult Code-1.0](ValueSet-hl7v2-result-1.0-code.md) | Hl7v2_result Result Code | [https://nzhts.digital.health.nz/fhir/ValueSet/hl7v2-result](https://nzhts.digital.health.nz/fhir/ValueSet/hl7v2-result) |

### Concept Maps

| | | |
| :--- | :--- | :--- |
| [Gender Code HL7v2 PID < -- > Administrative Gender used in FHIR R4-undefined](ConceptMap-air-gender-code-map.md) | This maps the gender codes listed in the NIR Message Spec v4.5, Sep 2020 (HL7 Table 0001) to the codes returned by the NHI Service. | [https://nzhts.digital.health.nz/fhir/ConceptMap/air-gender-code-map](https://nzhts.digital.health.nz/fhir/ConceptMap/air-gender-code-map) |
| [Concept Map -- HL7v2 Immunization Function < -- > AIR Health Worker Function-undefined](ConceptMap-air-health-worker-function-map.md) | This maps HL7 Immunization Function Codes and Provider Roles to AIR Health Worker Function Codes. HL7v2 codes are from V2 table 0443 (Provider Role) and map to message segments as defined in [CodeSystem: providerRole](https://terminology.hl7.org/4.0.0/CodeSystem-v2-0443.html). HL7v3 codes are from [CodeSystem: ParticipationType](http://terminology.hl7.org/CodeSystem/v3-ParticipationType) | [https://nzhts.digital.health.nz/fhir/ConceptMap/air-health-worker-function-map](https://nzhts.digital.health.nz/fhir/ConceptMap/air-health-worker-function-map) |
| [AIR Route of Administration HL7v2 < -- > SNOMED-undefined](ConceptMap-air-route-map.md) | This maps the AIR Route of Administration from HL7v2 messaging to SNOMED CT NZ. | [https://nzhts.digital.health.nz/fhir/ConceptMap/air-route-map](https://nzhts.digital.health.nz/fhir/ConceptMap/air-route-map) |
| [HL7v2 Serology Obs Value < -- > AIR Serology Protection Code-undefined](ConceptMap-air-serology-protection-code-map.md) | This maps the codes used to report serology protection status in NIR HL7v2 messaging (OBX-5) to the counterpart codes used in the FHIR observation.interpretation field. Note that this map only includes those codes where the code is different between HL7v2 and FHIR standards. | [https://nzhts.digital.health.nz/fhir/ConceptMap/air-serology-protection-code-map](https://nzhts.digital.health.nz/fhir/ConceptMap/air-serology-protection-code-map) |
| [AIR Vaccination Site HL7v2 < -- > SNOMED-undefined](ConceptMap-air-site-map.md) | This maps the vaccination site codes listed in the NIR Message Spec v4.5, Sep 2020 (HL7 Table 0162) to SNOMED CT NZ. | [https://nzhts.digital.health.nz/fhir/ConceptMap/air-site-map](https://nzhts.digital.health.nz/fhir/ConceptMap/air-site-map) |
| [AIR Target Disease (SNOMED) < -- > AIR Vaccine (CVX)-undefined](ConceptMap-air-target-disease-map.md) | This map connects vaccine-preventable diseases (identified by SNOMED codes) to the vaccines that target them (identified by CVX codes). This mapping facilitates searching ImmSOT using the targetDisease search parameter. | [https://nzhts.digital.health.nz/fhir/ConceptMap/air-target-disease-map](https://nzhts.digital.health.nz/fhir/ConceptMap/air-target-disease-map) |
| [AIR Vaccine Product TPUU (NZMT) < -- > AIR Vaccine (CVX)-undefined](ConceptMap-air-vaccine-product-map.md) | This map connects vaccine products as identified by the Therapeutic Product Unit of Use (TPUU) code in the New Zealand Medicines Terminology (NZMT) to the vaccines as identified by CVX codes. This mapping facilitates translating TPUU codes stored in ImmSOT to a CVX code that can be received by legacy PMS systems. | [https://nzhts.digital.health.nz/fhir/ConceptMap/air-vaccine-product-map](https://nzhts.digital.health.nz/fhir/ConceptMap/air-vaccine-product-map) |

