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

• Content
• Detailed Descriptions
• Mappings
• Examples
• XML
• JSON
• TTL

Resource Profile: Create NHI Patient

The information to be supplied when requesting that a new Patient resource be created in the NHI.

Describe information to be supplied when requesting that a new Patient resource be created in the NHI

Usage:

• Examples for this Resource Profile: Patient/create1, Patient/create2-error- and Patient/create3-errors

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

• Differential Table
• Key Elements Table
• Snapshot Table
• Statistics/References
• All

This structure is derived from NhiPatient

Name	Flags	Card.	Type	Description & Constraints
Patient	C	0..*	NhiPatient	Information about an individual or animal receiving health care services EM02106: A Patient must have an active Preferred Name EM02201: A Patient must have a primary residential address EM02101: A Patient name must contain either a given or family name EM07225: If name-use-extra is supplied name-use must be temp, and source NPRF EM07212: birthdate must be after 1 January 1900, and not a future date EM07212-1: Date of Death cannot be a future date EM07215: Date of Death must be greater than, or equal to Date of Birth
implicitRules		0..0
language		0..0
Slices for contained				Content/Rules for all slices
contained:GP		0..0
extension		2..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:ethnicity		1..6	Nz_ethnicity	NZ Ethnicity
Slices for extension				Content/Rules for all slices
extension:nzCitizen		1..1	Nz_citizenship	NZ Citizenship
extension		2..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:status		1..1	Extension	Extension
value[x]		1..1	CodeableConcept	Value of extension
Slices for value[x]				Content/Rules for all slices
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension
Slices for extension				Content/Rules for all slices
extension:source		1..1	Extension	Extension
value[x]		1..1	CodeableConcept	Value of extension
Slices for value[x]				Content/Rules for all slices
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension
Slices for extension				Content/Rules for all slices
extension:dhb		0..0
Slices for extension				Content/Rules for all slices
extension:birthPlace		0..1	BirthPlace	Extension
extension		2..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:country		1..1	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:source		1..1	Extension	Extension
value[x]		1..1	CodeableConcept	Value of extension
Slices for identifier				Content/Rules for all slices
identifier:NHI		0..0
name	C	1..1	HumanName	A name associated with the patient EM07225: If name-use-extra is supplied name-use must be temp, and source NPRF
extension		2..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:information-source		1..1	Information_source	Information Source
value[x]		1..1	CodeableConcept	Value of extension
Slices for value[x]				Content/Rules for all slices
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension
prefix		0..1	string	Parts that come before the name
telecom		0..0
gender		1..1	code	male | female | other | unknown
birthDate		1..1	date	The date of birth for the individual
extension		1..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:information-source		1..1	Information_source	Information Source
value[x]		1..1	CodeableConcept	Value of extension
Slices for value[x]				Content/Rules for all slices
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension
deceased[x]
extension		1..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:information-source		1..1	Information_source	Information Source
value[x]		1..1	CodeableConcept	Value of extension
Slices for value[x]				Content/Rules for all slices
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension
address		1..1	NhiAddress	An address expressed using postal conventions (as opposed to GPS or other location definition formats)
use		1..1	code	home | work | temp | old | billing - purpose of this address
line		1..2	string	Street name, number, direction & P.O. Box etc.
generalPractitioner		0..0
Documentation for this format

Constraints

Id	Grade	Path(s)	Details	Requirements
EM02101	error	Patient	A Patient name must contain either a given or family name : Patient.name.all(given.exists() and family.exists())
EM02106	error	Patient	A Patient must have an active Preferred Name : Patient.name.extension.where((url = 'http://hl7.org/fhir/StructureDefinition/iso21090-preferred') and (valueBoolean=true)).count()=1
EM02201	error	Patient	A Patient must have a primary residential address : Patient.address.where( (use = 'home') and (type = 'physical')).count()=1
EM07212	error	Patient	birthdate must be after 1 January 1900, and not a future date : (birthDate > @1900-01-01) and (birthDate < now())
EM07212-1	error	Patient	Date of Death cannot be a future date : deceasedDateTime < now()
EM07215	error	Patient	Date of Death must be greater than, or equal to Date of Birth : deceasedDateTime >= birthDate
EM07225	error	Patient, Patient.name	If name-use-extra is supplied name-use must be temp, and source NPRF : name.where(use='temp').exists() implies (extension.where((url='http://hl7.org.nz/fhir/StructureDefinition/information-source') and (valueCodeableConcept.coding.code ='NPRF')).exists())

Name	Flags	Card.	Type	Description & Constraints
Patient	C	0..*	NhiPatient	Information about an individual or animal receiving health care services nz-pat-1: only a single official NHI nhi-nz-pat-1: only allows certain name name use values EM02106: A Patient must have an active Preferred Name EM02201: A Patient must have a primary residential address EM02101: A Patient name must contain either a given or family name EM07225: If name-use-extra is supplied name-use must be temp, and source NPRF EM07212: birthdate must be after 1 January 1900, and not a future date EM07212-1: Date of Death cannot be a future date EM07215: Date of Death must be greater than, or equal to Date of Birth
Slices for contained		0..*	Resource	Contained, inline Resources Slice: Unordered, Closed by type:$this
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
ethnicity		1..6	(Complex)	NZ Ethnicity URL: http://hl7.org.nz/fhir/StructureDefinition/nz-ethnicity
extension		0..0
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/nz-ethnicity"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: Hip_ethnicity_lvl_4 (2.0) (required)
nzCitizen		1..1	(Complex)	NZ Citizenship URL: http://hl7.org.nz/fhir/StructureDefinition/nz-citizenship
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
Slices for extension				Content/Rules for all slices
extension:status		1..1	Extension	Extension
extension		0..0
url		1..1	uri	"status"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: NZ Citizenship status (preferred)
Slices for extension				Content/Rules for all slices
extension:source		1..1	Extension	Extension
extension		0..0
url		1..1	uri	"source"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
Slices for value[x]				Content/Rules for all slices
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: NZ Citizenship Information Source (required)
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/nz-citizenship"
birthPlace		0..1	(Complex)	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/birth-place
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
Slices for extension				Content/Rules for all slices
extension:country		1..1	Extension	Extension
extension		0..0
url		1..1	uri	"country"
Slices for extension				Content/Rules for all slices
extension:place-of-birth		0..1	Extension	Extension
extension		0..0
url		1..1	uri	"place-of-birth"
Slices for extension				Content/Rules for all slices
extension:source		1..1	Extension	Extension
extension		0..0
url		1..1	uri	"source"
value[x]		1..1	CodeableConcept	Value of extension Binding: Country of Birth Information Source (required)
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/birth-place"
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	Σ	0..*	Identifier	An identifier for this patient Slice: Unordered, Closed by value:system
name	ΣC	1..1	HumanName	A name associated with the patient EM07225: If name-use-extra is supplied name-use must be temp, and source NPRF
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
information-source		1..1	(Complex)	Information Source URL: http://hl7.org.nz/fhir/StructureDefinition/information-source
extension		0..0
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/information-source"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: Name Information Source (required)
preferred		1..1	boolean	Preferred URL: http://hl7.org/fhir/StructureDefinition/iso21090-preferred
nhi-name-use-extra		0..1	CodeableConcept	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/name-use-extra Binding: NHI Name Use Extra (required)
use	?!Σ	0..1	code	temp | nickname | maiden Binding: NameUse (required): The use of a human name.
given	Σ	0..2	string	Given name and other given name(s) This repeating element order: Given Names appear in the correct order for presenting the name
prefix	Σ	0..1	string	Parts that come before the name Binding: Name Prefix Codes (required) This repeating element order: Prefixes appear in the correct order for presenting the name
gender	Σ	1..1	code	male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes.
Slices for extension				Content/Rules for all slices
originalText		0..1	string	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/gender-original-text
birthDate	Σ	1..1	date	The date of birth for the individual
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
information-source		1..1	(Complex)	Information Source URL: http://hl7.org.nz/fhir/StructureDefinition/information-source
extension		0..0
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/information-source"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: Date of Birth Information Source (required)
deceased[x]	?!Σ	0..1	dateTime	Indicates if the individual is deceased or not
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
information-source		1..1	(Complex)	Information Source URL: http://hl7.org.nz/fhir/StructureDefinition/information-source
extension		0..0
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/information-source"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: Date of Death Information Source (required)
address		1..1	NhiAddress	An address expressed using postal conventions (as opposed to GPS or other location definition formats)
Slices for extension				Content/Rules for all slices
nz-geocode		0..1	(Complex)	A geocode using the NZ specific datum (reference point) URL: http://hl7.org.nz/fhir/StructureDefinition/nz-geocode
suburb		0..1	string	The suburb part of the address URL: http://hl7.org.nz/fhir/StructureDefinition/suburb
building-name		0..1	string	The name of the building URL: http://hl7.org.nz/fhir/StructureDefinition/building-name
domicile-code		0..1	CodeableConcept	The domicile code associated with this address URL: http://hl7.org.nz/fhir/StructureDefinition/domicile-code Binding: Domicile Code (preferred)
notValidatedAddressReason		0..1	CodeableConcept	The reason an address was not validated URL: http://hl7.org.nz/fhir/StructureDefinition/not-validated-address-reason Binding: Address Not Validated Reason (preferred)
nz-address-id		0..1	string	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/nz-address-id
nz-address-derived		0..1	(Complex)	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/nhi-address-derived
use	?!Σ	1..1	code	home | work | temp | old | billing - purpose of this address Binding: NHI Address Use Codes (required) Example General: home
type	Σ	1..1	code	postal | physical Binding: NHI Address Type Codes (required) Example General: both
line	Σ	1..2	string	Street name, number, direction & P.O. Box etc. This repeating element order: The order in which lines should appear in an address label Example General: 137 Nowhere Street
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Patient.extension:ethnicity.value[x]:valueCodeableConcept	required	Hip_ethnicity_lvl_4 https://nzhts.digital.health.nz/fhir/ValueSet/ethnic-group-level-4-code|2.0
Patient.extension:nzCitizen.extension:status.value[x]:valueCodeableConcept	preferred	CitizenshipStatus https://nzhts.digital.health.nz/fhir/ValueSet/nz-citizenship-status-code
Patient.extension:nzCitizen.extension:source.value[x]:valueCodeableConcept	required	Nhi_citizenship_source https://nzhts.digital.health.nz/fhir/ValueSet/nz-citizenship-source-code
Patient.extension:birthPlace.extension:source.value[x]	required	Nhi_country_of_birth_source https://nzhts.digital.health.nz/fhir/ValueSet/country-of-birth-source-code
Patient.identifier:NHI.use	required	NHIUse https://nzhts.digital.health.nz/fhir/ValueSet/nhi-use-code
Patient.name.extension:information-source.value[x]:valueCodeableConcept	required	Nhi_name_source https://nzhts.digital.health.nz/fhir/ValueSet/name-source-code
Patient.name.use	required	NameUse http://hl7.org/fhir/ValueSet/name-use|4.0.1 from the FHIR Standard
Patient.name.prefix	required	Hpi_name_prefix https://nzhts.digital.health.nz/fhir/ValueSet/name-prefix-code
Patient.telecom.use	required	NhiContactPointUse https://nzhts.digital.health.nz/fhir/ValueSet/nhiContactUseType from this IG
Patient.gender	required	AdministrativeGender http://hl7.org/fhir/ValueSet/administrative-gender|4.0.1 from the FHIR Standard
Patient.birthDate.extension:information-source.value[x]:valueCodeableConcept	required	Nhi_date_of_birth_source https://nzhts.digital.health.nz/fhir/ValueSet/date-of-birth-source-code
Patient.deceased[x].extension:information-source.value[x]:valueCodeableConcept	required	Nhi_date_of_death_source https://nzhts.digital.health.nz/fhir/ValueSet/dod-information-source-code
Patient.address.use	required	NhiAddressUse https://nzhts.digital.health.nz/fhir/ValueSet/nhiaddressUse
Patient.address.type	required	NhiAddressType https://nzhts.digital.health.nz/fhir/ValueSet/addressType
Patient.communication.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding http://hl7.org/fhir/ValueSet/languages from the FHIR Standard
Patient.link.type	required	LinkType http://hl7.org/fhir/ValueSet/link-type|4.0.1 from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
EM02101	error	Patient	A Patient name must contain either a given or family name : Patient.name.all(given.exists() and family.exists())
EM02106	error	Patient	A Patient must have an active Preferred Name : Patient.name.extension.where((url = 'http://hl7.org/fhir/StructureDefinition/iso21090-preferred') and (valueBoolean=true)).count()=1
EM02201	error	Patient	A Patient must have a primary residential address : Patient.address.where( (use = 'home') and (type = 'physical')).count()=1
EM07212	error	Patient	birthdate must be after 1 January 1900, and not a future date : (birthDate > @1900-01-01) and (birthDate < now())
EM07212-1	error	Patient	Date of Death cannot be a future date : deceasedDateTime < now()
EM07215	error	Patient	Date of Death must be greater than, or equal to Date of Birth : deceasedDateTime >= birthDate
EM07225	error	Patient, Patient.name	If name-use-extra is supplied name-use must be temp, and source NPRF : name.where(use='temp').exists() implies (extension.where((url='http://hl7.org.nz/fhir/StructureDefinition/information-source') and (valueCodeableConcept.coding.code ='NPRF')).exists())

Name	Flags	Card.	Type	Description & Constraints
Patient	C	0..*	NhiPatient	Information about an individual or animal receiving health care services nz-pat-1: only a single official NHI nhi-nz-pat-1: only allows certain name name use values EM02106: A Patient must have an active Preferred Name EM02201: A Patient must have a primary residential address EM02101: A Patient name must contain either a given or family name EM07225: If name-use-extra is supplied name-use must be temp, and source NPRF EM07212: birthdate must be after 1 January 1900, and not a future date EM07212-1: Date of Death cannot be a future date EM07215: Date of Death must be greater than, or equal to Date of Birth
id	Σ	0..1	id	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
text		0..1	Narrative	Text summary of the resource, for human interpretation
Slices for contained		0..*	Resource	Contained, inline Resources Slice: Unordered, Closed by type:$this
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
ethnicity		1..6	(Complex)	NZ Ethnicity URL: http://hl7.org.nz/fhir/StructureDefinition/nz-ethnicity
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/nz-ethnicity"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: Hip_ethnicity_lvl_4 (2.0) (required)
nzCitizen		1..1	(Complex)	NZ Citizenship URL: http://hl7.org.nz/fhir/StructureDefinition/nz-citizenship
id		0..1	string	Unique id for inter-element referencing
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
Slices for extension				Content/Rules for all slices
extension:status		1..1	Extension	Extension
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"status"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: NZ Citizenship status (preferred)
Slices for extension				Content/Rules for all slices
extension:source		1..1	Extension	Extension
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"source"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
Slices for value[x]				Content/Rules for all slices
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: NZ Citizenship Information Source (required)
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/nz-citizenship"
birthPlace		0..1	(Complex)	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/birth-place
id		0..1	string	Unique id for inter-element referencing
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
Slices for extension				Content/Rules for all slices
extension:country		1..1	Extension	Extension
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"country"
value[x]		0..1	CodeableConcept	Value of extension Binding: ISO 3166-1:2013 (2-alpha country code) (required)
Slices for extension				Content/Rules for all slices
extension:place-of-birth		0..1	Extension	Extension
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"place-of-birth"
value[x]		0..1	string	Value of extension
Slices for extension				Content/Rules for all slices
extension:source		1..1	Extension	Extension
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"source"
value[x]		1..1	CodeableConcept	Value of extension Binding: Country of Birth Information Source (required)
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/birth-place"
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	Σ	0..*	Identifier	An identifier for this patient Slice: Unordered, Closed by value:system
name	ΣC	1..1	HumanName	A name associated with the patient EM07225: If name-use-extra is supplied name-use must be temp, and source NPRF
id		0..1	string	Unique id for inter-element referencing
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
information-source		1..1	(Complex)	Information Source URL: http://hl7.org.nz/fhir/StructureDefinition/information-source
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/information-source"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: Name Information Source (required)
preferred		1..1	boolean	Preferred URL: http://hl7.org/fhir/StructureDefinition/iso21090-preferred
nhi-name-use-extra		0..1	CodeableConcept	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/name-use-extra Binding: NHI Name Use Extra (required)
use	?!Σ	0..1	code	temp | nickname | maiden Binding: NameUse (required): The use of a human name.
family	Σ	0..1	string	Family name (often called 'Surname')
given	Σ	0..2	string	Given name and other given name(s) This repeating element order: Given Names appear in the correct order for presenting the name
prefix	Σ	0..1	string	Parts that come before the name Binding: Name Prefix Codes (required) This repeating element order: Prefixes appear in the correct order for presenting the name
gender	Σ	1..1	code	male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes.
id		0..1	string	xml:id (or equivalent in JSON)
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
originalText		0..1	string	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/gender-original-text
value		0..1	string	Primitive value for code
birthDate	Σ	1..1	date	The date of birth for the individual
id		0..1	string	xml:id (or equivalent in JSON)
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
information-source		1..1	(Complex)	Information Source URL: http://hl7.org.nz/fhir/StructureDefinition/information-source
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/information-source"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: Date of Birth Information Source (required)
value		0..1	date	Primitive value for date
deceased[x]	?!Σ	0..1	dateTime	Indicates if the individual is deceased or not
id		0..1	string	xml:id (or equivalent in JSON)
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
information-source		1..1	(Complex)	Information Source URL: http://hl7.org.nz/fhir/StructureDefinition/information-source
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/information-source"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: Date of Death Information Source (required)
value		0..1	dateTime	Primitive value for dateTime
address		1..1	NhiAddress	An address expressed using postal conventions (as opposed to GPS or other location definition formats)
id		0..1	string	Unique id for inter-element referencing
Slices for extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
nz-geocode		0..1	(Complex)	A geocode using the NZ specific datum (reference point) URL: http://hl7.org.nz/fhir/StructureDefinition/nz-geocode
suburb		0..1	string	The suburb part of the address URL: http://hl7.org.nz/fhir/StructureDefinition/suburb
building-name		0..1	string	The name of the building URL: http://hl7.org.nz/fhir/StructureDefinition/building-name
domicile-code		0..1	CodeableConcept	The domicile code associated with this address URL: http://hl7.org.nz/fhir/StructureDefinition/domicile-code Binding: Domicile Code (preferred)
notValidatedAddressReason		0..1	CodeableConcept	The reason an address was not validated URL: http://hl7.org.nz/fhir/StructureDefinition/not-validated-address-reason Binding: Address Not Validated Reason (preferred)
nz-address-id		0..1	string	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/nz-address-id
nz-address-derived		0..1	(Complex)	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/nhi-address-derived
use	?!Σ	1..1	code	home | work | temp | old | billing - purpose of this address Binding: NHI Address Use Codes (required) Example General: home
type	Σ	1..1	code	postal | physical Binding: NHI Address Type Codes (required) Example General: both
text	Σ	0..1	string	Text representation of the address Example General: 137 Nowhere Street, Erewhon 9132
line	Σ	1..2	string	Street name, number, direction & P.O. Box etc. This repeating element order: The order in which lines should appear in an address label Example General: 137 Nowhere Street
city	Σ	0..1	string	Name of city, town etc. Example General: Erewhon
postalCode	Σ	0..1	string	Postal code for area Example General: 9132
country	Σ	0..1	string	Country (e.g. can be ISO 3166 2 or 3 letter code) Binding: ISO 3166-1:2013 (2-alpha country code) (required)
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Patient.extension:ethnicity.value[x]:valueCodeableConcept	required	Hip_ethnicity_lvl_4 https://nzhts.digital.health.nz/fhir/ValueSet/ethnic-group-level-4-code|2.0
Patient.extension:nzCitizen.extension:status.value[x]:valueCodeableConcept	preferred	CitizenshipStatus https://nzhts.digital.health.nz/fhir/ValueSet/nz-citizenship-status-code
Patient.extension:nzCitizen.extension:source.value[x]:valueCodeableConcept	required	Nhi_citizenship_source https://nzhts.digital.health.nz/fhir/ValueSet/nz-citizenship-source-code
Patient.extension:birthPlace.extension:country.value[x]	required	Hpi_country_code_iso_3166_1 https://nzhts.digital.health.nz/fhir/ValueSet/country-code
Patient.extension:birthPlace.extension:source.value[x]	required	Nhi_country_of_birth_source https://nzhts.digital.health.nz/fhir/ValueSet/country-of-birth-source-code
Patient.identifier:NHI.use	required	NHIUse https://nzhts.digital.health.nz/fhir/ValueSet/nhi-use-code
Patient.name.extension:information-source.value[x]:valueCodeableConcept	required	Nhi_name_source https://nzhts.digital.health.nz/fhir/ValueSet/name-source-code
Patient.name.use	required	NameUse http://hl7.org/fhir/ValueSet/name-use|4.0.1 from the FHIR Standard
Patient.name.prefix	required	Hpi_name_prefix https://nzhts.digital.health.nz/fhir/ValueSet/name-prefix-code
Patient.telecom.system	required	NhiContactPointSystem https://nzhts.digital.health.nz/fhir/ValueSet/nhi-contact-point-system-code from this IG
Patient.telecom.use	required	NhiContactPointUse https://nzhts.digital.health.nz/fhir/ValueSet/nhiContactUseType from this IG
Patient.gender	required	AdministrativeGender http://hl7.org/fhir/ValueSet/administrative-gender|4.0.1 from the FHIR Standard
Patient.birthDate.extension:information-source.value[x]:valueCodeableConcept	required	Nhi_date_of_birth_source https://nzhts.digital.health.nz/fhir/ValueSet/date-of-birth-source-code
Patient.deceased[x].extension:information-source.value[x]:valueCodeableConcept	required	Nhi_date_of_death_source https://nzhts.digital.health.nz/fhir/ValueSet/dod-information-source-code
Patient.address.use	required	NhiAddressUse https://nzhts.digital.health.nz/fhir/ValueSet/nhiaddressUse
Patient.address.type	required	NhiAddressType https://nzhts.digital.health.nz/fhir/ValueSet/addressType
Patient.address.country	required	Hpi_country_code_iso_3166_1 https://nzhts.digital.health.nz/fhir/ValueSet/country-code
Patient.contact.relationship	extensible	PatientContactRelationship http://hl7.org/fhir/ValueSet/patient-contactrelationship from the FHIR Standard
Patient.contact.gender	required	AdministrativeGender http://hl7.org/fhir/ValueSet/administrative-gender|4.0.1 from the FHIR Standard
Patient.communication.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding http://hl7.org/fhir/ValueSet/languages from the FHIR Standard
Patient.link.type	required	LinkType http://hl7.org/fhir/ValueSet/link-type|4.0.1 from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
EM02101	error	Patient	A Patient name must contain either a given or family name : Patient.name.all(given.exists() and family.exists())
EM02106	error	Patient	A Patient must have an active Preferred Name : Patient.name.extension.where((url = 'http://hl7.org/fhir/StructureDefinition/iso21090-preferred') and (valueBoolean=true)).count()=1
EM02201	error	Patient	A Patient must have a primary residential address : Patient.address.where( (use = 'home') and (type = 'physical')).count()=1
EM07212	error	Patient	birthdate must be after 1 January 1900, and not a future date : (birthDate > @1900-01-01) and (birthDate < now())
EM07212-1	error	Patient	Date of Death cannot be a future date : deceasedDateTime < now()
EM07215	error	Patient	Date of Death must be greater than, or equal to Date of Birth : deceasedDateTime >= birthDate
EM07225	error	Patient, Patient.name	If name-use-extra is supplied name-use must be temp, and source NPRF : name.where(use='temp').exists() implies (extension.where((url='http://hl7.org.nz/fhir/StructureDefinition/information-source') and (valueCodeableConcept.coding.code ='NPRF')).exists())

This structure is derived from NhiPatient

Summary

Mandatory: 20 elements(7 nested mandatory elements)
Prohibited: 7 elements

Differential View

This structure is derived from NhiPatient

Name	Flags	Card.	Type	Description & Constraints
Patient	C	0..*	NhiPatient	Information about an individual or animal receiving health care services EM02106: A Patient must have an active Preferred Name EM02201: A Patient must have a primary residential address EM02101: A Patient name must contain either a given or family name EM07225: If name-use-extra is supplied name-use must be temp, and source NPRF EM07212: birthdate must be after 1 January 1900, and not a future date EM07212-1: Date of Death cannot be a future date EM07215: Date of Death must be greater than, or equal to Date of Birth
implicitRules		0..0
language		0..0
Slices for contained				Content/Rules for all slices
contained:GP		0..0
extension		2..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:ethnicity		1..6	Nz_ethnicity	NZ Ethnicity
Slices for extension				Content/Rules for all slices
extension:nzCitizen		1..1	Nz_citizenship	NZ Citizenship
extension		2..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:status		1..1	Extension	Extension
value[x]		1..1	CodeableConcept	Value of extension
Slices for value[x]				Content/Rules for all slices
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension
Slices for extension				Content/Rules for all slices
extension:source		1..1	Extension	Extension
value[x]		1..1	CodeableConcept	Value of extension
Slices for value[x]				Content/Rules for all slices
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension
Slices for extension				Content/Rules for all slices
extension:dhb		0..0
Slices for extension				Content/Rules for all slices
extension:birthPlace		0..1	BirthPlace	Extension
extension		2..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:country		1..1	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:source		1..1	Extension	Extension
value[x]		1..1	CodeableConcept	Value of extension
Slices for identifier				Content/Rules for all slices
identifier:NHI		0..0
name	C	1..1	HumanName	A name associated with the patient EM07225: If name-use-extra is supplied name-use must be temp, and source NPRF
extension		2..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:information-source		1..1	Information_source	Information Source
value[x]		1..1	CodeableConcept	Value of extension
Slices for value[x]				Content/Rules for all slices
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension
prefix		0..1	string	Parts that come before the name
telecom		0..0
gender		1..1	code	male | female | other | unknown
birthDate		1..1	date	The date of birth for the individual
extension		1..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:information-source		1..1	Information_source	Information Source
value[x]		1..1	CodeableConcept	Value of extension
Slices for value[x]				Content/Rules for all slices
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension
deceased[x]
extension		1..*	Extension	Extension
Slices for extension				Content/Rules for all slices
extension:information-source		1..1	Information_source	Information Source
value[x]		1..1	CodeableConcept	Value of extension
Slices for value[x]				Content/Rules for all slices
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension
address		1..1	NhiAddress	An address expressed using postal conventions (as opposed to GPS or other location definition formats)
use		1..1	code	home | work | temp | old | billing - purpose of this address
line		1..2	string	Street name, number, direction & P.O. Box etc.
generalPractitioner		0..0
Documentation for this format

Constraints

Id	Grade	Path(s)	Details	Requirements
EM02101	error	Patient	A Patient name must contain either a given or family name : Patient.name.all(given.exists() and family.exists())
EM02106	error	Patient	A Patient must have an active Preferred Name : Patient.name.extension.where((url = 'http://hl7.org/fhir/StructureDefinition/iso21090-preferred') and (valueBoolean=true)).count()=1
EM02201	error	Patient	A Patient must have a primary residential address : Patient.address.where( (use = 'home') and (type = 'physical')).count()=1
EM07212	error	Patient	birthdate must be after 1 January 1900, and not a future date : (birthDate > @1900-01-01) and (birthDate < now())
EM07212-1	error	Patient	Date of Death cannot be a future date : deceasedDateTime < now()
EM07215	error	Patient	Date of Death must be greater than, or equal to Date of Birth : deceasedDateTime >= birthDate
EM07225	error	Patient, Patient.name	If name-use-extra is supplied name-use must be temp, and source NPRF : name.where(use='temp').exists() implies (extension.where((url='http://hl7.org.nz/fhir/StructureDefinition/information-source') and (valueCodeableConcept.coding.code ='NPRF')).exists())

Key Elements View

Name	Flags	Card.	Type	Description & Constraints
Patient	C	0..*	NhiPatient	Information about an individual or animal receiving health care services nz-pat-1: only a single official NHI nhi-nz-pat-1: only allows certain name name use values EM02106: A Patient must have an active Preferred Name EM02201: A Patient must have a primary residential address EM02101: A Patient name must contain either a given or family name EM07225: If name-use-extra is supplied name-use must be temp, and source NPRF EM07212: birthdate must be after 1 January 1900, and not a future date EM07212-1: Date of Death cannot be a future date EM07215: Date of Death must be greater than, or equal to Date of Birth
Slices for contained		0..*	Resource	Contained, inline Resources Slice: Unordered, Closed by type:$this
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
ethnicity		1..6	(Complex)	NZ Ethnicity URL: http://hl7.org.nz/fhir/StructureDefinition/nz-ethnicity
extension		0..0
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/nz-ethnicity"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: Hip_ethnicity_lvl_4 (2.0) (required)
nzCitizen		1..1	(Complex)	NZ Citizenship URL: http://hl7.org.nz/fhir/StructureDefinition/nz-citizenship
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
Slices for extension				Content/Rules for all slices
extension:status		1..1	Extension	Extension
extension		0..0
url		1..1	uri	"status"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: NZ Citizenship status (preferred)
Slices for extension				Content/Rules for all slices
extension:source		1..1	Extension	Extension
extension		0..0
url		1..1	uri	"source"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
Slices for value[x]				Content/Rules for all slices
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: NZ Citizenship Information Source (required)
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/nz-citizenship"
birthPlace		0..1	(Complex)	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/birth-place
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
Slices for extension				Content/Rules for all slices
extension:country		1..1	Extension	Extension
extension		0..0
url		1..1	uri	"country"
Slices for extension				Content/Rules for all slices
extension:place-of-birth		0..1	Extension	Extension
extension		0..0
url		1..1	uri	"place-of-birth"
Slices for extension				Content/Rules for all slices
extension:source		1..1	Extension	Extension
extension		0..0
url		1..1	uri	"source"
value[x]		1..1	CodeableConcept	Value of extension Binding: Country of Birth Information Source (required)
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/birth-place"
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	Σ	0..*	Identifier	An identifier for this patient Slice: Unordered, Closed by value:system
name	ΣC	1..1	HumanName	A name associated with the patient EM07225: If name-use-extra is supplied name-use must be temp, and source NPRF
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
information-source		1..1	(Complex)	Information Source URL: http://hl7.org.nz/fhir/StructureDefinition/information-source
extension		0..0
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/information-source"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: Name Information Source (required)
preferred		1..1	boolean	Preferred URL: http://hl7.org/fhir/StructureDefinition/iso21090-preferred
nhi-name-use-extra		0..1	CodeableConcept	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/name-use-extra Binding: NHI Name Use Extra (required)
use	?!Σ	0..1	code	temp | nickname | maiden Binding: NameUse (required): The use of a human name.
given	Σ	0..2	string	Given name and other given name(s) This repeating element order: Given Names appear in the correct order for presenting the name
prefix	Σ	0..1	string	Parts that come before the name Binding: Name Prefix Codes (required) This repeating element order: Prefixes appear in the correct order for presenting the name
gender	Σ	1..1	code	male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes.
Slices for extension				Content/Rules for all slices
originalText		0..1	string	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/gender-original-text
birthDate	Σ	1..1	date	The date of birth for the individual
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
information-source		1..1	(Complex)	Information Source URL: http://hl7.org.nz/fhir/StructureDefinition/information-source
extension		0..0
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/information-source"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: Date of Birth Information Source (required)
deceased[x]	?!Σ	0..1	dateTime	Indicates if the individual is deceased or not
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
information-source		1..1	(Complex)	Information Source URL: http://hl7.org.nz/fhir/StructureDefinition/information-source
extension		0..0
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/information-source"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: Date of Death Information Source (required)
address		1..1	NhiAddress	An address expressed using postal conventions (as opposed to GPS or other location definition formats)
Slices for extension				Content/Rules for all slices
nz-geocode		0..1	(Complex)	A geocode using the NZ specific datum (reference point) URL: http://hl7.org.nz/fhir/StructureDefinition/nz-geocode
suburb		0..1	string	The suburb part of the address URL: http://hl7.org.nz/fhir/StructureDefinition/suburb
building-name		0..1	string	The name of the building URL: http://hl7.org.nz/fhir/StructureDefinition/building-name
domicile-code		0..1	CodeableConcept	The domicile code associated with this address URL: http://hl7.org.nz/fhir/StructureDefinition/domicile-code Binding: Domicile Code (preferred)
notValidatedAddressReason		0..1	CodeableConcept	The reason an address was not validated URL: http://hl7.org.nz/fhir/StructureDefinition/not-validated-address-reason Binding: Address Not Validated Reason (preferred)
nz-address-id		0..1	string	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/nz-address-id
nz-address-derived		0..1	(Complex)	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/nhi-address-derived
use	?!Σ	1..1	code	home | work | temp | old | billing - purpose of this address Binding: NHI Address Use Codes (required) Example General: home
type	Σ	1..1	code	postal | physical Binding: NHI Address Type Codes (required) Example General: both
line	Σ	1..2	string	Street name, number, direction & P.O. Box etc. This repeating element order: The order in which lines should appear in an address label Example General: 137 Nowhere Street
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Patient.extension:ethnicity.value[x]:valueCodeableConcept	required	Hip_ethnicity_lvl_4 https://nzhts.digital.health.nz/fhir/ValueSet/ethnic-group-level-4-code|2.0
Patient.extension:nzCitizen.extension:status.value[x]:valueCodeableConcept	preferred	CitizenshipStatus https://nzhts.digital.health.nz/fhir/ValueSet/nz-citizenship-status-code
Patient.extension:nzCitizen.extension:source.value[x]:valueCodeableConcept	required	Nhi_citizenship_source https://nzhts.digital.health.nz/fhir/ValueSet/nz-citizenship-source-code
Patient.extension:birthPlace.extension:source.value[x]	required	Nhi_country_of_birth_source https://nzhts.digital.health.nz/fhir/ValueSet/country-of-birth-source-code
Patient.identifier:NHI.use	required	NHIUse https://nzhts.digital.health.nz/fhir/ValueSet/nhi-use-code
Patient.name.extension:information-source.value[x]:valueCodeableConcept	required	Nhi_name_source https://nzhts.digital.health.nz/fhir/ValueSet/name-source-code
Patient.name.use	required	NameUse http://hl7.org/fhir/ValueSet/name-use|4.0.1 from the FHIR Standard
Patient.name.prefix	required	Hpi_name_prefix https://nzhts.digital.health.nz/fhir/ValueSet/name-prefix-code
Patient.telecom.use	required	NhiContactPointUse https://nzhts.digital.health.nz/fhir/ValueSet/nhiContactUseType from this IG
Patient.gender	required	AdministrativeGender http://hl7.org/fhir/ValueSet/administrative-gender|4.0.1 from the FHIR Standard
Patient.birthDate.extension:information-source.value[x]:valueCodeableConcept	required	Nhi_date_of_birth_source https://nzhts.digital.health.nz/fhir/ValueSet/date-of-birth-source-code
Patient.deceased[x].extension:information-source.value[x]:valueCodeableConcept	required	Nhi_date_of_death_source https://nzhts.digital.health.nz/fhir/ValueSet/dod-information-source-code
Patient.address.use	required	NhiAddressUse https://nzhts.digital.health.nz/fhir/ValueSet/nhiaddressUse
Patient.address.type	required	NhiAddressType https://nzhts.digital.health.nz/fhir/ValueSet/addressType
Patient.communication.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding http://hl7.org/fhir/ValueSet/languages from the FHIR Standard
Patient.link.type	required	LinkType http://hl7.org/fhir/ValueSet/link-type|4.0.1 from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
EM02101	error	Patient	A Patient name must contain either a given or family name : Patient.name.all(given.exists() and family.exists())
EM02106	error	Patient	A Patient must have an active Preferred Name : Patient.name.extension.where((url = 'http://hl7.org/fhir/StructureDefinition/iso21090-preferred') and (valueBoolean=true)).count()=1
EM02201	error	Patient	A Patient must have a primary residential address : Patient.address.where( (use = 'home') and (type = 'physical')).count()=1
EM07212	error	Patient	birthdate must be after 1 January 1900, and not a future date : (birthDate > @1900-01-01) and (birthDate < now())
EM07212-1	error	Patient	Date of Death cannot be a future date : deceasedDateTime < now()
EM07215	error	Patient	Date of Death must be greater than, or equal to Date of Birth : deceasedDateTime >= birthDate
EM07225	error	Patient, Patient.name	If name-use-extra is supplied name-use must be temp, and source NPRF : name.where(use='temp').exists() implies (extension.where((url='http://hl7.org.nz/fhir/StructureDefinition/information-source') and (valueCodeableConcept.coding.code ='NPRF')).exists())

Snapshot View

Name	Flags	Card.	Type	Description & Constraints
Patient	C	0..*	NhiPatient	Information about an individual or animal receiving health care services nz-pat-1: only a single official NHI nhi-nz-pat-1: only allows certain name name use values EM02106: A Patient must have an active Preferred Name EM02201: A Patient must have a primary residential address EM02101: A Patient name must contain either a given or family name EM07225: If name-use-extra is supplied name-use must be temp, and source NPRF EM07212: birthdate must be after 1 January 1900, and not a future date EM07212-1: Date of Death cannot be a future date EM07215: Date of Death must be greater than, or equal to Date of Birth
id	Σ	0..1	id	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
text		0..1	Narrative	Text summary of the resource, for human interpretation
Slices for contained		0..*	Resource	Contained, inline Resources Slice: Unordered, Closed by type:$this
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
ethnicity		1..6	(Complex)	NZ Ethnicity URL: http://hl7.org.nz/fhir/StructureDefinition/nz-ethnicity
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/nz-ethnicity"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: Hip_ethnicity_lvl_4 (2.0) (required)
nzCitizen		1..1	(Complex)	NZ Citizenship URL: http://hl7.org.nz/fhir/StructureDefinition/nz-citizenship
id		0..1	string	Unique id for inter-element referencing
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
Slices for extension				Content/Rules for all slices
extension:status		1..1	Extension	Extension
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"status"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: NZ Citizenship status (preferred)
Slices for extension				Content/Rules for all slices
extension:source		1..1	Extension	Extension
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"source"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
Slices for value[x]				Content/Rules for all slices
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: NZ Citizenship Information Source (required)
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/nz-citizenship"
birthPlace		0..1	(Complex)	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/birth-place
id		0..1	string	Unique id for inter-element referencing
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
Slices for extension				Content/Rules for all slices
extension:country		1..1	Extension	Extension
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"country"
value[x]		0..1	CodeableConcept	Value of extension Binding: ISO 3166-1:2013 (2-alpha country code) (required)
Slices for extension				Content/Rules for all slices
extension:place-of-birth		0..1	Extension	Extension
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"place-of-birth"
value[x]		0..1	string	Value of extension
Slices for extension				Content/Rules for all slices
extension:source		1..1	Extension	Extension
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"source"
value[x]		1..1	CodeableConcept	Value of extension Binding: Country of Birth Information Source (required)
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/birth-place"
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	Σ	0..*	Identifier	An identifier for this patient Slice: Unordered, Closed by value:system
name	ΣC	1..1	HumanName	A name associated with the patient EM07225: If name-use-extra is supplied name-use must be temp, and source NPRF
id		0..1	string	Unique id for inter-element referencing
Slices for extension		2..*	Extension	Extension Slice: Unordered, Open by value:url
information-source		1..1	(Complex)	Information Source URL: http://hl7.org.nz/fhir/StructureDefinition/information-source
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/information-source"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: Name Information Source (required)
preferred		1..1	boolean	Preferred URL: http://hl7.org/fhir/StructureDefinition/iso21090-preferred
nhi-name-use-extra		0..1	CodeableConcept	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/name-use-extra Binding: NHI Name Use Extra (required)
use	?!Σ	0..1	code	temp | nickname | maiden Binding: NameUse (required): The use of a human name.
family	Σ	0..1	string	Family name (often called 'Surname')
given	Σ	0..2	string	Given name and other given name(s) This repeating element order: Given Names appear in the correct order for presenting the name
prefix	Σ	0..1	string	Parts that come before the name Binding: Name Prefix Codes (required) This repeating element order: Prefixes appear in the correct order for presenting the name
gender	Σ	1..1	code	male | female | other | unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes.
id		0..1	string	xml:id (or equivalent in JSON)
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
originalText		0..1	string	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/gender-original-text
value		0..1	string	Primitive value for code
birthDate	Σ	1..1	date	The date of birth for the individual
id		0..1	string	xml:id (or equivalent in JSON)
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
information-source		1..1	(Complex)	Information Source URL: http://hl7.org.nz/fhir/StructureDefinition/information-source
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/information-source"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: Date of Birth Information Source (required)
value		0..1	date	Primitive value for date
deceased[x]	?!Σ	0..1	dateTime	Indicates if the individual is deceased or not
id		0..1	string	xml:id (or equivalent in JSON)
Slices for extension		1..*	Extension	Extension Slice: Unordered, Open by value:url
information-source		1..1	(Complex)	Information Source URL: http://hl7.org.nz/fhir/StructureDefinition/information-source
id		0..1	string	Unique id for inter-element referencing
extension		0..0
url		1..1	uri	"http://hl7.org.nz/fhir/StructureDefinition/information-source"
Slices for value[x]		1..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		1..1	CodeableConcept	Value of extension Binding: Date of Death Information Source (required)
value		0..1	dateTime	Primitive value for dateTime
address		1..1	NhiAddress	An address expressed using postal conventions (as opposed to GPS or other location definition formats)
id		0..1	string	Unique id for inter-element referencing
Slices for extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
nz-geocode		0..1	(Complex)	A geocode using the NZ specific datum (reference point) URL: http://hl7.org.nz/fhir/StructureDefinition/nz-geocode
suburb		0..1	string	The suburb part of the address URL: http://hl7.org.nz/fhir/StructureDefinition/suburb
building-name		0..1	string	The name of the building URL: http://hl7.org.nz/fhir/StructureDefinition/building-name
domicile-code		0..1	CodeableConcept	The domicile code associated with this address URL: http://hl7.org.nz/fhir/StructureDefinition/domicile-code Binding: Domicile Code (preferred)
notValidatedAddressReason		0..1	CodeableConcept	The reason an address was not validated URL: http://hl7.org.nz/fhir/StructureDefinition/not-validated-address-reason Binding: Address Not Validated Reason (preferred)
nz-address-id		0..1	string	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/nz-address-id
nz-address-derived		0..1	(Complex)	Extension URL: http://hl7.org.nz/fhir/StructureDefinition/nhi-address-derived
use	?!Σ	1..1	code	home | work | temp | old | billing - purpose of this address Binding: NHI Address Use Codes (required) Example General: home
type	Σ	1..1	code	postal | physical Binding: NHI Address Type Codes (required) Example General: both
text	Σ	0..1	string	Text representation of the address Example General: 137 Nowhere Street, Erewhon 9132
line	Σ	1..2	string	Street name, number, direction & P.O. Box etc. This repeating element order: The order in which lines should appear in an address label Example General: 137 Nowhere Street
city	Σ	0..1	string	Name of city, town etc. Example General: Erewhon
postalCode	Σ	0..1	string	Postal code for area Example General: 9132
country	Σ	0..1	string	Country (e.g. can be ISO 3166 2 or 3 letter code) Binding: ISO 3166-1:2013 (2-alpha country code) (required)
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Patient.extension:ethnicity.value[x]:valueCodeableConcept	required	Hip_ethnicity_lvl_4 https://nzhts.digital.health.nz/fhir/ValueSet/ethnic-group-level-4-code|2.0
Patient.extension:nzCitizen.extension:status.value[x]:valueCodeableConcept	preferred	CitizenshipStatus https://nzhts.digital.health.nz/fhir/ValueSet/nz-citizenship-status-code
Patient.extension:nzCitizen.extension:source.value[x]:valueCodeableConcept	required	Nhi_citizenship_source https://nzhts.digital.health.nz/fhir/ValueSet/nz-citizenship-source-code
Patient.extension:birthPlace.extension:country.value[x]	required	Hpi_country_code_iso_3166_1 https://nzhts.digital.health.nz/fhir/ValueSet/country-code
Patient.extension:birthPlace.extension:source.value[x]	required	Nhi_country_of_birth_source https://nzhts.digital.health.nz/fhir/ValueSet/country-of-birth-source-code
Patient.identifier:NHI.use	required	NHIUse https://nzhts.digital.health.nz/fhir/ValueSet/nhi-use-code
Patient.name.extension:information-source.value[x]:valueCodeableConcept	required	Nhi_name_source https://nzhts.digital.health.nz/fhir/ValueSet/name-source-code
Patient.name.use	required	NameUse http://hl7.org/fhir/ValueSet/name-use|4.0.1 from the FHIR Standard
Patient.name.prefix	required	Hpi_name_prefix https://nzhts.digital.health.nz/fhir/ValueSet/name-prefix-code
Patient.telecom.system	required	NhiContactPointSystem https://nzhts.digital.health.nz/fhir/ValueSet/nhi-contact-point-system-code from this IG
Patient.telecom.use	required	NhiContactPointUse https://nzhts.digital.health.nz/fhir/ValueSet/nhiContactUseType from this IG
Patient.gender	required	AdministrativeGender http://hl7.org/fhir/ValueSet/administrative-gender|4.0.1 from the FHIR Standard
Patient.birthDate.extension:information-source.value[x]:valueCodeableConcept	required	Nhi_date_of_birth_source https://nzhts.digital.health.nz/fhir/ValueSet/date-of-birth-source-code
Patient.deceased[x].extension:information-source.value[x]:valueCodeableConcept	required	Nhi_date_of_death_source https://nzhts.digital.health.nz/fhir/ValueSet/dod-information-source-code
Patient.address.use	required	NhiAddressUse https://nzhts.digital.health.nz/fhir/ValueSet/nhiaddressUse
Patient.address.type	required	NhiAddressType https://nzhts.digital.health.nz/fhir/ValueSet/addressType
Patient.address.country	required	Hpi_country_code_iso_3166_1 https://nzhts.digital.health.nz/fhir/ValueSet/country-code
Patient.contact.relationship	extensible	PatientContactRelationship http://hl7.org/fhir/ValueSet/patient-contactrelationship from the FHIR Standard
Patient.contact.gender	required	AdministrativeGender http://hl7.org/fhir/ValueSet/administrative-gender|4.0.1 from the FHIR Standard
Patient.communication.language	preferred	CommonLanguages Additional Bindings Purpose AllLanguages Max Binding http://hl7.org/fhir/ValueSet/languages from the FHIR Standard
Patient.link.type	required	LinkType http://hl7.org/fhir/ValueSet/link-type|4.0.1 from the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
EM02101	error	Patient	A Patient name must contain either a given or family name : Patient.name.all(given.exists() and family.exists())
EM02106	error	Patient	A Patient must have an active Preferred Name : Patient.name.extension.where((url = 'http://hl7.org/fhir/StructureDefinition/iso21090-preferred') and (valueBoolean=true)).count()=1
EM02201	error	Patient	A Patient must have a primary residential address : Patient.address.where( (use = 'home') and (type = 'physical')).count()=1
EM07212	error	Patient	birthdate must be after 1 January 1900, and not a future date : (birthDate > @1900-01-01) and (birthDate < now())
EM07212-1	error	Patient	Date of Death cannot be a future date : deceasedDateTime < now()
EM07215	error	Patient	Date of Death must be greater than, or equal to Date of Birth : deceasedDateTime >= birthDate
EM07225	error	Patient, Patient.name	If name-use-extra is supplied name-use must be temp, and source NPRF : name.where(use='temp').exists() implies (extension.where((url='http://hl7.org.nz/fhir/StructureDefinition/information-source') and (valueCodeableConcept.coding.code ='NPRF')).exists())

This structure is derived from NhiPatient

Summary

Mandatory: 20 elements(7 nested mandatory elements)
Prohibited: 7 elements