TI Human Name - Implementation Guide TI Common v1.5.0-ballot.1

Implementation Guide
TI Common

Version 1.5.0-ballot.1 - ballot

Datentyp-Profil: TI Human Name

Offizielle URL: https://gematik.de/fhir/ti/StructureDefinition/ti-human-name				Version: 1.5.0
Active Stand: 2026-11-16				Maschinenlesbarer Name: TIHumanName
Copyright/Rechtliches: gematik GmbH / Dieses Artefakt ist lizenziert unter Apache License, Version 2.0.

Dieses Profil definiert die Repräsentation des offiziellen Namens innerhalb der Telematikinfrastruktur (TI) auf Grundlage des deutschen HumanName-Basisprofils. Der Name wird durch use = official gekennzeichnet und legt die für den offiziellen Namen relevanten Namensbestandteile sowie die Kennzeichnung akademischer Titel fest.

Usages:

Use this DataType Profile: TI Patient and TI Related Person

You can also check for usages in the FHIR IG Statistics

Formale Ansichten des Profilinhalts

Beschreibung von Profilen, Differentials, Snapshots und deren Repräsentationen.

Schlüsselelemente-Tabelle
Differential-Tabelle
Snapshot-Tabelle
Statistiken/Referenzen
Alle

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
HumanName	C	0..*	HumannameDeBasis	Personenname Constraints: hum-1, hum-2, hum-3, hum-4
use	?!SΣ	1..1	code	usual \| official \| temp \| nickname \| anonymous \| old \| maiden Binding: NameUse (required): The use of a human name. Fixed Value: official
family	SΣ	1..1	string	Familienname
Slices for extension				Content/Rules for all slices
extension:namenszusatz	S	0..1	string	Namenszusatz gemäß VSDM (Versichertenstammdatenmanagement, "eGK") URL: http://fhir.de/StructureDefinition/humanname-namenszusatz
extension:nachname	S	0..1	string	Portion derived from person's own surname URL: http://hl7.org/fhir/StructureDefinition/humanname-own-name
extension:vorsatzwort	S	0..1	string	Voorvoegsel derived from person's own surname URL: http://hl7.org/fhir/StructureDefinition/humanname-own-prefix
given	SΣ	1..*	string	Vorname This repeating element order: Given Names appear in the correct order for presenting the name
prefix	SΣ	0..*	string	Namensteile vor dem Vornamen This repeating element order: Prefixes appear in the correct order for presenting the name
Slices for extension				Content/Rules for all slices
extension:prefix-qualifier	S	0..1	(Complex)	LS \| AC \| NB \| PR \| HON \| BR \| AD \| SP \| MID \| CL \| IN \| VV URL: http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier
extension		0..0		Additional content defined by implementations Slice: Unordered, Open by value:url
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier"
value[x]	S	1..1	code	Value of extension Binding: EntityNamePartQualifier (required) Fixed Value: AC
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
HumanName.use	Base	required	NameUse	📍4.0.1	FHIR Std.
HumanName.prefix.extension:prefix-qualifier.value[x]	Base	required	EntityNamePartQualifier	📦4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
ele-1	error	ALL elements	All FHIR elements must have a @value or children	`hasValue() or (children().count() > id.count())`
ext-1	error	ALL extensions	Must have either extensions or value[x], not both	`extension.exists() != value.exists()`
hum-1	error	HumanName	Wenn die Extension 'namenszusatz' verwendet wird, dann muss der vollständige Name im Attribut 'family' angegeben werden	`family.extension('http://fhir.de/StructureDefinition/humanname-namenszusatz').empty() or family.hasValue()`
hum-2	error	HumanName	Wenn die Extension 'nachname' verwendet wird, dann muss der vollständige Name im Attribut 'family' angegeben werden	`family.extension('http://hl7.org/fhir/StructureDefinition/humanname-own-name').empty() or family.hasValue()`
hum-3	error	HumanName	Wenn die Extension 'vorsatzwort' verwendet wird, dann muss der vollständige Name im Attribut 'family' angegeben werden	`family.extension('http://hl7.org/fhir/StructureDefinition/humanname-own-prefix').empty() or family.hasValue()`
hum-4	error	HumanName	Wenn die Extension 'prefix-qualifier' verwendet wird, dann muss ein Namenspräfix im Attribut 'prefix' angegeben werden	`prefix.all($this.extension('http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier').empty() or $this.hasValue())`

Diese Struktur ist abgeleitet von HumannameDeBasis

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
HumanName		0..*	HumannameDeBasis	Personenname
use	S	1..1	code	usual \| official \| temp \| nickname \| anonymous \| old \| maiden Fixed Value: official
family	S	1..1	string	Familienname
Slices for extension				Content/Rules for all slices
extension:namenszusatz	S	0..1	HumannameNamenszusatz	Namenszusatz gemäß VSDM (Versichertenstammdatenmanagement, "eGK")
extension:nachname	S	0..1	OwnName(5.3.0)	Portion derived from person's own surname
extension:vorsatzwort	S	0..1	OwnPrefix(5.3.0)	Voorvoegsel derived from person's own surname
given	S	1..*	string	Vorname
prefix	S	0..*	string	Namensteile vor dem Vornamen
Slices for extension				Content/Rules for all slices
extension:prefix-qualifier	S	0..1	ENQualifier(5.3.0)	LS \| AC \| NB \| PR \| HON \| BR \| AD \| SP \| MID \| CL \| IN \| VV
value[x]	S	1..1	code	Value of extension Fixed Value: AC
Documentation for this format

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
HumanName	C	0..*	HumannameDeBasis	Personenname Constraints: hum-1, hum-2, hum-3, hum-4
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
use	?!SΣ	1..1	code	usual \| official \| temp \| nickname \| anonymous \| old \| maiden Binding: NameUse (required): The use of a human name. Fixed Value: official
text	Σ	0..1	string	Text representation of the full name
family	SΣ	1..1	string	Familienname
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
extension:namenszusatz	S	0..1	string	Namenszusatz gemäß VSDM (Versichertenstammdatenmanagement, "eGK") URL: http://fhir.de/StructureDefinition/humanname-namenszusatz
extension:nachname	S	0..1	string	Portion derived from person's own surname URL: http://hl7.org/fhir/StructureDefinition/humanname-own-name
extension:vorsatzwort	S	0..1	string	Voorvoegsel derived from person's own surname URL: http://hl7.org/fhir/StructureDefinition/humanname-own-prefix
value		0..1	string	Primitive value for string Max Length:1048576
given	SΣ	1..*	string	Vorname This repeating element order: Given Names appear in the correct order for presenting the name
prefix	SΣ	0..*	string	Namensteile vor dem Vornamen This repeating element order: Prefixes appear in the correct order for presenting the name
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
extension:prefix-qualifier	S	0..1	(Complex)	LS \| AC \| NB \| PR \| HON \| BR \| AD \| SP \| MID \| CL \| IN \| VV URL: http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Additional content defined by implementations Slice: Unordered, Open by value:url
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier"
value[x]	S	1..1	code	Value of extension Binding: EntityNamePartQualifier (required) Fixed Value: AC
value		0..1	string	Primitive value for string Max Length:1048576
suffix	Σ	0..*	string	Namensteile nach dem Nachnamen This repeating element order: Suffixes appear in the correct order for presenting the name
period	ΣC	0..1	Period	Time period when name was/is in use Constraints: per-1
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
HumanName.use	Base	required	NameUse	📍4.0.1	FHIR Std.
HumanName.prefix.extension:prefix-qualifier.value[x]	Base	required	EntityNamePartQualifier	📦4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
ele-1	error	ALL elements	All FHIR elements must have a @value or children	`hasValue() or (children().count() > id.count())`
ext-1	error	ALL extensions	Must have either extensions or value[x], not both	`extension.exists() != value.exists()`
hum-1	error	HumanName	Wenn die Extension 'namenszusatz' verwendet wird, dann muss der vollständige Name im Attribut 'family' angegeben werden	`family.extension('http://fhir.de/StructureDefinition/humanname-namenszusatz').empty() or family.hasValue()`
hum-2	error	HumanName	Wenn die Extension 'nachname' verwendet wird, dann muss der vollständige Name im Attribut 'family' angegeben werden	`family.extension('http://hl7.org/fhir/StructureDefinition/humanname-own-name').empty() or family.hasValue()`
hum-3	error	HumanName	Wenn die Extension 'vorsatzwort' verwendet wird, dann muss der vollständige Name im Attribut 'family' angegeben werden	`family.extension('http://hl7.org/fhir/StructureDefinition/humanname-own-prefix').empty() or family.hasValue()`
hum-4	error	HumanName	Wenn die Extension 'prefix-qualifier' verwendet wird, dann muss ein Namenspräfix im Attribut 'prefix' angegeben werden	`prefix.all($this.extension('http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier').empty() or $this.hasValue())`
per-1	error	HumanName.period	If present, start SHALL have a lower value than end	`start.hasValue().not() or end.hasValue().not() or (start <= end)`

Diese Struktur ist abgeleitet von HumannameDeBasis

Summary

Mandatory: 3 elements
Must-Support: 9 elements
Fixed: 2 elements

Schlüsselelemente-Ansicht

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
HumanName	C	0..*	HumannameDeBasis	Personenname Constraints: hum-1, hum-2, hum-3, hum-4
use	?!SΣ	1..1	code	usual \| official \| temp \| nickname \| anonymous \| old \| maiden Binding: NameUse (required): The use of a human name. Fixed Value: official
family	SΣ	1..1	string	Familienname
Slices for extension				Content/Rules for all slices
extension:namenszusatz	S	0..1	string	Namenszusatz gemäß VSDM (Versichertenstammdatenmanagement, "eGK") URL: http://fhir.de/StructureDefinition/humanname-namenszusatz
extension:nachname	S	0..1	string	Portion derived from person's own surname URL: http://hl7.org/fhir/StructureDefinition/humanname-own-name
extension:vorsatzwort	S	0..1	string	Voorvoegsel derived from person's own surname URL: http://hl7.org/fhir/StructureDefinition/humanname-own-prefix
given	SΣ	1..*	string	Vorname This repeating element order: Given Names appear in the correct order for presenting the name
prefix	SΣ	0..*	string	Namensteile vor dem Vornamen This repeating element order: Prefixes appear in the correct order for presenting the name
Slices for extension				Content/Rules for all slices
extension:prefix-qualifier	S	0..1	(Complex)	LS \| AC \| NB \| PR \| HON \| BR \| AD \| SP \| MID \| CL \| IN \| VV URL: http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier
extension		0..0		Additional content defined by implementations Slice: Unordered, Open by value:url
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier"
value[x]	S	1..1	code	Value of extension Binding: EntityNamePartQualifier (required) Fixed Value: AC
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
HumanName.use	Base	required	NameUse	📍4.0.1	FHIR Std.
HumanName.prefix.extension:prefix-qualifier.value[x]	Base	required	EntityNamePartQualifier	📦4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
ele-1	error	ALL elements	All FHIR elements must have a @value or children	`hasValue() or (children().count() > id.count())`
ext-1	error	ALL extensions	Must have either extensions or value[x], not both	`extension.exists() != value.exists()`
hum-1	error	HumanName	Wenn die Extension 'namenszusatz' verwendet wird, dann muss der vollständige Name im Attribut 'family' angegeben werden	`family.extension('http://fhir.de/StructureDefinition/humanname-namenszusatz').empty() or family.hasValue()`
hum-2	error	HumanName	Wenn die Extension 'nachname' verwendet wird, dann muss der vollständige Name im Attribut 'family' angegeben werden	`family.extension('http://hl7.org/fhir/StructureDefinition/humanname-own-name').empty() or family.hasValue()`
hum-3	error	HumanName	Wenn die Extension 'vorsatzwort' verwendet wird, dann muss der vollständige Name im Attribut 'family' angegeben werden	`family.extension('http://hl7.org/fhir/StructureDefinition/humanname-own-prefix').empty() or family.hasValue()`
hum-4	error	HumanName	Wenn die Extension 'prefix-qualifier' verwendet wird, dann muss ein Namenspräfix im Attribut 'prefix' angegeben werden	`prefix.all($this.extension('http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier').empty() or $this.hasValue())`

Differential-Ansicht

Diese Struktur ist abgeleitet von HumannameDeBasis

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
HumanName		0..*	HumannameDeBasis	Personenname
use	S	1..1	code	usual \| official \| temp \| nickname \| anonymous \| old \| maiden Fixed Value: official
family	S	1..1	string	Familienname
Slices for extension				Content/Rules for all slices
extension:namenszusatz	S	0..1	HumannameNamenszusatz	Namenszusatz gemäß VSDM (Versichertenstammdatenmanagement, "eGK")
extension:nachname	S	0..1	OwnName(5.3.0)	Portion derived from person's own surname
extension:vorsatzwort	S	0..1	OwnPrefix(5.3.0)	Voorvoegsel derived from person's own surname
given	S	1..*	string	Vorname
prefix	S	0..*	string	Namensteile vor dem Vornamen
Slices for extension				Content/Rules for all slices
extension:prefix-qualifier	S	0..1	ENQualifier(5.3.0)	LS \| AC \| NB \| PR \| HON \| BR \| AD \| SP \| MID \| CL \| IN \| VV
value[x]	S	1..1	code	Value of extension Fixed Value: AC
Documentation for this format

Snapshot-AnsichtView

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
HumanName	C	0..*	HumannameDeBasis	Personenname Constraints: hum-1, hum-2, hum-3, hum-4
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
use	?!SΣ	1..1	code	usual \| official \| temp \| nickname \| anonymous \| old \| maiden Binding: NameUse (required): The use of a human name. Fixed Value: official
text	Σ	0..1	string	Text representation of the full name
family	SΣ	1..1	string	Familienname
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
extension:namenszusatz	S	0..1	string	Namenszusatz gemäß VSDM (Versichertenstammdatenmanagement, "eGK") URL: http://fhir.de/StructureDefinition/humanname-namenszusatz
extension:nachname	S	0..1	string	Portion derived from person's own surname URL: http://hl7.org/fhir/StructureDefinition/humanname-own-name
extension:vorsatzwort	S	0..1	string	Voorvoegsel derived from person's own surname URL: http://hl7.org/fhir/StructureDefinition/humanname-own-prefix
value		0..1	string	Primitive value for string Max Length:1048576
given	SΣ	1..*	string	Vorname This repeating element order: Given Names appear in the correct order for presenting the name
prefix	SΣ	0..*	string	Namensteile vor dem Vornamen This repeating element order: Prefixes appear in the correct order for presenting the name
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
extension:prefix-qualifier	S	0..1	(Complex)	LS \| AC \| NB \| PR \| HON \| BR \| AD \| SP \| MID \| CL \| IN \| VV URL: http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier
id		0..1	string	Unique id for inter-element referencing
extension		0..0		Additional content defined by implementations Slice: Unordered, Open by value:url
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier"
value[x]	S	1..1	code	Value of extension Binding: EntityNamePartQualifier (required) Fixed Value: AC
value		0..1	string	Primitive value for string Max Length:1048576
suffix	Σ	0..*	string	Namensteile nach dem Nachnamen This repeating element order: Suffixes appear in the correct order for presenting the name
period	ΣC	0..1	Period	Time period when name was/is in use Constraints: per-1
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
HumanName.use	Base	required	NameUse	📍4.0.1	FHIR Std.
HumanName.prefix.extension:prefix-qualifier.value[x]	Base	required	EntityNamePartQualifier	📦4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
ele-1	error	ALL elements	All FHIR elements must have a @value or children	`hasValue() or (children().count() > id.count())`
ext-1	error	ALL extensions	Must have either extensions or value[x], not both	`extension.exists() != value.exists()`
hum-1	error	HumanName	Wenn die Extension 'namenszusatz' verwendet wird, dann muss der vollständige Name im Attribut 'family' angegeben werden	`family.extension('http://fhir.de/StructureDefinition/humanname-namenszusatz').empty() or family.hasValue()`
hum-2	error	HumanName	Wenn die Extension 'nachname' verwendet wird, dann muss der vollständige Name im Attribut 'family' angegeben werden	`family.extension('http://hl7.org/fhir/StructureDefinition/humanname-own-name').empty() or family.hasValue()`
hum-3	error	HumanName	Wenn die Extension 'vorsatzwort' verwendet wird, dann muss der vollständige Name im Attribut 'family' angegeben werden	`family.extension('http://hl7.org/fhir/StructureDefinition/humanname-own-prefix').empty() or family.hasValue()`
hum-4	error	HumanName	Wenn die Extension 'prefix-qualifier' verwendet wird, dann muss ein Namenspräfix im Attribut 'prefix' angegeben werden	`prefix.all($this.extension('http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier').empty() or $this.hasValue())`
per-1	error	HumanName.period	If present, start SHALL have a lower value than end	`start.hasValue().not() or end.hasValue().not() or (start <= end)`

Diese Struktur ist abgeleitet von HumannameDeBasis

Summary

Mandatory: 3 elements
Must-Support: 9 elements
Fixed: 2 elements

Weitere Repräsentationen des Profils: CSV, Excel, Schematron

<vorherige

oben

nächste>

IG © 2026+ gematik GmbH. Package de.gematik.ti#1.5.0-ballot.1 basiert auf FHIR 4.0.1. Erstellt 2026-09-14
Links: Inhaltsverzeichnis | QA-Bericht