New Zealand NHI IG
1.6.1 - Release

New Zealand NHI IG - Local Development build (v1.6.1) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Consumer Facing Application Authentication Compliance Testing

NHI Consumer Get tests

Reference Purpose – Demonstrate that the Input values Expected outcome Mandatory
NHI-Consumer-Get-1 application can clearly display that the information has come from the NHI rather than another source Di.mha.test+INT-ZKV6957@gmail.com Output: The application alerts the user that the information they are viewing has been returned from the NHI Mandatory
NHI-Consumer-Get-2 application can display all relevant patient information
  • NHI numbers
    • All NHI numbers clearly labelled (live and dormant)
  • Names
    • All names clearly labelled, exclude any 'BabyOf' Names
    • Name details as appropriate
  • Address
    • Residential address
    • Postal address if present
  • Gender
    • Gender code
    • Gender-original-text if present
  • Date of Birth
  • Place of Birth
  • Ethnicities
    • All (up to six)
  • NZ Citizenship status
  • DHB - optional
Di.mha.test+INT-ZKV6957@gmail.com Output: Person's information clearly displayed Mandatory
(for data items being handled)
NHI-Consumer-Get-3 application has an appropriate exception flow if a patient record has a Date of Death Di.mha.test+INT-ZKV7015@gmail.com Output: The application alerts the user of the exception flow and an appropriate business process to reslove data quality errors Mandatory
NHI-Consumer-Get-4 application can display all other identity data returned by the NHI in a Get response including:
  • A non validated residential (physical) and mailing (postal) address
  • A year of birth
  • Unknown citizenship
Di.mha.test+INT-ZKV7520@gmail.com Output: All identity information is displayed for the patient. This is for a patient record that has partial information in some fields. The patient has:
  • A not validated physical address
  • A not validated postal address
  • Partial date of birth
Mandatory
(for data items being handled)
NHI-Consumer-Get-5
TBD-MHA
Describe the excpetion flow if the requested NHI is dormant, and that the live NHI has been returned. Di.mha.test+INT-ZKV7457@gmail.com
  • Outout: Notification to the user that the requested NHI was dormant and the live NHI has been returned
  • Output: Patient Live NHI returned should be XXXXXXX
Mandatory
NHI-Consumer-Get-6 application can receive and display NHI responses that have fields populated with the maximum allowable sizes (e.g. A given name of 50 characters, Other given name(s) of 100 characters, Family Name of 100 characters) Di.mha.test+INT-ZBE4905@gmail.com
  • Output: Patient information supplied is displayed without loss of data
  • This is for a patient record that has attribute values which are the maximum allowed field length in some fields
  • The patient has the following fields fully populated in the test record (field lengths in parentheses):
    • Given name (50)
    • Other Given Name(s) (100)
    • Family Name (100)
    • Address line 1 (100)
    • Address lines 2-5 (50)
    • Building name/additional details (255)
Mandatory
NHI-Consumer-Get-7 application behaves appropriately when a new format NHI number is returned
  • Di.mha.test+INT-ZUG37LU@gmail.com
Output: Application does not error Mandatory
NHI-Consumer-Get-8 application can synchronize with local system in response to the NHI version changing Di.mha.test+INT-ZCX7065@gmail.com
  • Do a Get
  • Update the patient details (to simulate a 3rd party updating the NHI info)
  • Do another Get
  • Demonstrate how end user can view the difference then synchronize
Mandatory
NHI-Consumer-Get-9 application can handle a response when a patient has
  • only a family name
  • only a given name
Do all
  • Di.mha.test+INT-ZKV8747@gmail.com
  • Di.mha.test+INT-ZAV8657@gmail.com
  • Output:
    • application does not error
    • application returns all name parts when present
    • order of name parts is clear to the user
  • mandatory

    NHI Consumer set-address tests

    Use Di.mha.test+INT-ZUG37LU@gmail.com for all updates
    Reference Purpose – Demonstrate that the Input values Expected outcome Mandatory
    NHI-Consumer-set-address-1 application can replace the primary residential address on a patient record with a validated address
    • Locate a validated address to use (this can be done using https://www.nzpost.co.nz/tools/address-postcode-finder) or use Health_UI
    • Add a new primary residential address to the patient record using the set-addresss operation
    • Input: Application can validate an address via e-SAM (using suggest or search)
    • Input: An address request can be populated with appropriate information
    • Output: The address that is displayed to the end user is the address that is returned in the update response
    mandatory
    NHI-Consumer-set-address-2 application can add (or replace) the postal address on a patient record with a validated address
    • Locate a validated address to use (this can be done using https://www.nzpost.co.nz/tools/address-postcode-finder) or use Health_UI
    • Add a new postal address to the patient record using the set-addresss operation
    • Input: Application can validate an address via e-SAM (using suggest or search)
    • Input: An address request can be populated with appropriate information
    • Output: The address that is displayed to the end user is the address that is returned in the update response
    mandatory
    NHI-Consumer-set-address-3 application can remove the postal address on a patient record
  • Remove the postal address from the patient record using the $remove-postal-address operation
  • Output: The patient record has Postal address removed
  • mandatory
    NHI-Consumer-set-address-4 Not currently implemented
    Application will show the correct error when attempting to add the supplied address that has been previously removed from the patient record by NHI administration
    • address-line: 24 Anglesea Avenue
    • nz-address-id: 967406
    • address-type: physical
    Error: EM02004 - The Patient Address requested has been removed from the Patient record by Te Whatu Ora Mandatory
    NHI-Consumer-set-address-5 Application will show the correct error when attempting to add the following postal address for an undeliverable address
    • address-line: 748E Whitemans Valley Road
    • nz-address-id: 3193368
    • address-type: postal
    Error: EM02209 - A validated mailing address must be an address at which mail can be delivered Mandatory
    NHI-Consumer-set-address-6 Application will show the correct error when attempting to add an address where the nz address id does not match the first line of the validated address
    • address-line: 24 Ranglesey Place
    • nz-address-id: 1199146
    • address-type: physical
    Error: "address-line must match the espatial value: ..." Mandatory

    NHI Consumer set-preferred-name tests

    Use Di.mha.test+INT-ZUG37LU@gmail.com for all updates
    Reference Purpose – Demonstrate that the Input values Expected outcome Mandatory
    NHI-Conumer-set-preferred-name-1 application can set the patients preferred name
    • Do a Get Patient request to see active patient names
    • Change the preferred name from the current name to another active name for the patient
    • Input:
      • An application can select a Patients preferred name from the active names list
    • Output:
      • The preferred name that is displayed to the end user is the name that was selected in the operation
      • The name is presented to the user with all name parts
    mandatory

    NHI Consumer Update-identity tests

    Use Di.mha.test+INT-ZUG37LU@gmail.com for all updates
    Reference Purpose – Demonstrate that the Input values Expected outcome Mandatory
    NHI-Consumer-update-identity-1
    Ethnicity
    application can correctly re-collect ethnicity information from a person Ethnicity question presented correctly
    Update the set of ethnicity information based on the responses to the standard ethnicity collection question for the selected NHI number
  • Output:
    • Person able to select their ethnicities
    • The application can update the patients ethnicity information
    • Patient’s ethnicity after update should be:
      • 11111
      • 21111
      • 31111
  • mandatory
    NHI-Consumer-update-identity-2
    Ethnicity
    application can correctly re-collect ethnicity information from a person Ethnicity question presented correctly
    Update the set of ethnicity information based on the responses to the standard ethnicity collection question for the selected NHI number
  • Output:
    • Person able to select their ethnicities
    • The application can update the patients ethnicity information
    • Patient’s ethnicity after update should be:
      • 11111
      • 34111
      • 51120
      • 4211
  • mandatory
    NHI-Consumer-update-identity-3
    Ethnicity-error
    application can display an error when ethnicity information invalid
    set of supplied ethnicities that includes a duplicate ethnicity
    Update the ethnicity information for Patient: ZAA1063
    Ethnicities to use:
  • 32100 (Cook Islands Maori) and,
  • 12948 (South African) and,
  • 32100 (Cook Islands Maori)
  • Output: EM02301 - "A Patient must have at least one valid ethnicity code, only one instance of each selected ethnicity, and no more than one ‘unspecified’ ethnicity code" mandatory
    NHI-Consumer-update-identity-4
    Gender
    application can correctly update a gender value on a patient's record Change the gender from current gender to one of the three acceptable gender codes
    Do all
    • Male
    • Female
    • Another gender
    Output:
  • Patients gender coded updated corrctly
  • mandatory
    NHI-Consumer-update-identity-5
    Gender
    application can correctly update the gender value and gender-original-text on a patient record
    • Change the gender code from current gender to 'Another gender'
    • include an original text response that a patient might submit
    Output:
  • Patients gender coded updated corrctly
  • Mandatory if allowing a gendeer text update
    NHI-Consumer-update-identity-6
    Gender-error
    application can display an error when gender-original-text updated without a gender value Update the gender-original-text for Patient Output: EM07201 - "Is a required field - Patient.gender" Mandatory if allowing a gendeer text update