MII-Initiative

[EN] Module Person - Version 1.0 - IG

Patient (Patient)

This profile describes a patient in the medical informatics initiative.

It should be noted that no specifications are made for mapping a pseudonymized patient. In the future, specifications may arise in this regard through other core data set modules.

Name: "ProfilePatientPatientIn" (Simplifier Link)

Canonical: https://www.medizininformatik-initiative.de/fhir/core/modul-person/StructureDefinition/Patient

Differential

idS Σ0..1string
id0..1string
extensionI0..*Extension
versionIdΣ0..1id
lastUpdatedΣ0..1instant
sourceS Σ0..1uri
profileS Σ0..*canonical(StructureDefinition)
securityΣ0..*CodingBinding
tagΣ0..*Coding
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBindingFixed Value
typeS Σ0..1CodeableConceptBindingPattern
systemS Σ1..1uriFixed Value
valueS Σ I1..1string
periodΣ I0..1Period
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ0..1uriBinding
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBindingFixed Value
typeS Σ0..1CodeableConceptBindingPattern
systemS Σ1..1uriFixed Value
valueS Σ I1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
displayΣ0..1string
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBindingFixed Value
typeS Σ1..1CodeableConceptBindingPattern
systemS Σ1..1uri
valueS Σ1..1string
periodΣ I0..1Period
id0..1string
extensionI0..*Extension
referenceS Σ I0..1string
typeΣ0..1uriBinding
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
typeS Σ0..1CodeableConceptBindingPattern
systemS Σ I1..1uri
valueS Σ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
displayΣ0..1string
id0..1string
extensionI0..*Extension
useS Σ ?!0..1codeBindingFixed Value
typeS Σ0..1CodeableConceptBindingPattern
systemΣ0..1uri
valueS Σ1..1string
periodΣ I0..1Period
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ0..1uriBinding
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBindingFixed Value
typeS Σ0..1CodeableConceptBindingPattern
systemS Σ1..1uriFixed Value
valueS Σ I1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
displayS Σ1..1string
activeΣ ?!0..1boolean
id0..1string
extensionI0..*Extension
useS Σ ?!1..1codeBindingFixed Value
textΣ0..1string
id0..1string
namenszusatzS I0..1Extension(string)
nachnameS I0..1Extension(string)
vorsatzwortS I0..1Extension(string)
value0..1System.String
givenS Σ1..*string
id0..1string
prefix-qualifierS I0..1Extension(code)
value0..1System.String
suffixΣ0..*string
periodΣ I0..1Period
id0..1string
extensionI0..*Extension
useS Σ ?!1..1codeBindingFixed Value
textΣ0..1string
id0..1string
namenszusatzS I0..1Extension(string)
nachnameS I0..1Extension(string)
vorsatzwortS I0..1Extension(string)
value0..1System.String
givenΣ0..0string
suffixΣ0..*string
periodΣ I0..1Period
telecomΣ I0..*ContactPoint
id0..1string
other-amtlichS I0..1Extension(Coding)
value0..1System.String
id0..1string
data-absent-reasonS I0..1Extension(code)
value0..1System.Date
deceasedBooleanboolean
deceasedDateTimedateTime
id0..1string
StadtteilS I0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingFixed Value
textΣ0..1string
id0..1string
StrasseS I0..1Extension(string)
HausnummerS I0..1Extension(string)
AdresszusatzS I0..1Extension(string)
PostfachI0..0Extension(string)
value0..1System.String
id0..1string
gemeindeschluesselS I0..1Extension(Coding)
value0..1System.String
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ1..1string
countryS Σ I1..1stringBinding
id0..1string
extensionI0..*Extension
startΣ I0..1dateTime
endΣ I0..1dateTime
id0..1string
StadtteilS I0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingFixed Value
textΣ0..1string
id0..1string
StrasseI0..0Extension(string)
HausnummerI0..0Extension(string)
AdresszusatzI0..0Extension(string)
PostfachS I0..1Extension(string)
value0..1System.String
id0..1string
gemeindeschluesselS I0..1Extension(Coding)
value0..1System.String
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ1..1string
countryS Σ I1..1stringBinding
id0..1string
extensionI0..*Extension
startΣ I0..1dateTime
endΣ I0..1dateTime
maritalStatus0..1CodeableConceptBinding
multipleBirthBooleanboolean
multipleBirthIntegerinteger
photoI0..*Attachment
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
relationship0..*CodeableConceptBinding
name0..1HumanName
telecomI0..*ContactPoint
address0..1Address
gender0..1codeBinding
organizationI0..1Reference(Organization)
periodI0..1Period
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
language1..1CodeableConceptBinding
preferred0..1boolean
generalPractitionerI0..*Reference(Organization | Practitioner | PractitionerRole)
managingOrganizationΣ I0..1Reference(Organization)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
otherS Σ I1..1MII-Reference(Patient | RelatedPerson)
typeS Σ1..1codeBinding


FHIR-Element Explanation
Patient.id Must-support, but optional
Patient.meta Must-support, but optional
Patient.identifier:versichertenId_GKV See Base Profile - Statutory health insurance number (10-digit KVID). It should be noted that the IKNR of the issuing institution must be entered in the 'Assigner' element. This is always the current insurance number of the patient.
Patient.identifier:versicherungsnummer_pkv Siehe Base Profile - Private health insurance number. This is always the patient's current insurance number.
Patient.identifier:pid See Base Profile Internal organization patient identifier (PID). Leading (MPI) ID of the patient. In Patient.identifier:pid.assigner a reference to the issuing organization is required. Logical reference by IK number or IHE Affinity Domain OID is allowed. Furthermore, the following code system of all MII sites can be used: Core-Location-Identifier.
Patient.identifier Any other identifiers if GKV/PKV/PID is not applicable.
Patient.name See Base Profile for data type HumanName. It should be noted that the division of the full name into its components (e.g. prefix words, name suffix, surname) should only be performed if this information is explicitly available in this granularity (e.g. through a direct import based on a VSDM dataset). It should be noted that, by general convention, the birth name contains only the family name.
Patient.gender See Base Profile - Sex
Patient.birthDate See Base Profile - Date of Birth
Patient.deceased[x] deceasedBoolean is to be replaced by deceasedDateTime where possible if patient is deceased.
Patient.address Siehe Base Profile - Address. Multiple addresses are allowed. Systems are required to mark former addresses as such, so that the current address of the patient is recognizable.
Patient.link Necessary for linking multiple patient resources, e.g. in the context of patient matching. The present specification does not contain any requirements in this regard; further design is necessary.

FHIR-Element Logical Data Set
Patient.identifier:versichertenId_GKV Person.Patient.Versicherung.Versichertennummer.VersichertenID-GKV
Patient.identifier:versicherungsnummer_pkv Person.Patient.Versicherung.Versichertennummer.VersichertenID-PKV
Patient.identifier:default Person.Patient.Versicherung, falls keine Versicherung (GKV / PKV) vorliegt
Patient.identifier:pid Person.Patient.Patienten-Identifikator
Patient.name Person.Name
Patient.name.given Person.Name.Vorname
Patient.name.family Person.Name.Familienname
Patient.name.family.extension.nachname Person.Name.Nachname
Patient.name.family.extension.vorsatzwort Person.Name.Vorsatzwort
Patient.name.family.extension.namenszusatz Person.Name.Namenszusatz
Patient.name.prefix Person.Name.Präfix
Patient.name.prefix.extension-prefix-qualifier Person.Name.ArtDesPräfix
Patient.name.use Person.Name.Geburtsname
Patient.gender Person.Demographie.AdministrativesGeschlecht
Patient.birthDate Person.Demographie.Geburtsdatum
Patient.deceased[x] Person.Demographie.VitalStatus.PatientVerstorben / Todeszeitpunkt
Patient.address Person.Demographie.Adresse
Patient.address.country Person.Demographie.Adresse.Land
Patient.address.postalCode Person.Demographie.Adresse.PLZ
Patient.address.City +
Patient.address.extension.Stadtteil
(In case of In city-states)
Person.Demographie.Adresse.Wohnort.
Note:
The district is not part of the VSDM dataset of Gematik. Other sources compliant with §21 KHEntgG may need to be consulted.
Patient.address.line Person.Demographie.Adresse.Staße

The following invariants must be considered when implementing the profile:

Constraints:

keyseverityhumanexpression
pat-de-1errorDie amtliche Differenzierung der Geschlechtsangabe 'other' darf nur gefüllt sein, wenn das Geschlecht 'other' angegeben istgender='other' or gender.extension('http://fhir.de/StructureDefinition/gender-amtlich-de').empty()
mii-pat-1errorEntweder IKNR oder MII Core Location Identifier soll verwendet werden$this = 'http://fhir.de/NamingSystem/arge-ik/iknr' or $this = 'https://www.medizininformatik-initiative.de/fhir/core/CodeSystem/core-location-identifier'
pat-cnt-2or3-charwarningThe content of the country element (if present) SHALL be selected EITHER from ValueSet ISO Country Alpha-2 http://hl7.org/fhir/ValueSet/iso3166-1-2 OR MAY be selected from ISO Country Alpha-3 Value Set http://hl7.org/fhir/ValueSet/iso3166-1-3, IF the country is not specified in value Set ISO Country Alpha-2 http://hl7.org/fhir/ValueSet/iso3166-1-2.country.empty() or (country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-2') or country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-3'))
pat-cnt-2or3-charwarningThe content of the country element (if present) SHALL be selected EITHER from ValueSet ISO Country Alpha-2 http://hl7.org/fhir/ValueSet/iso3166-1-2 OR MAY be selected from ISO Country Alpha-3 Value Set http://hl7.org/fhir/ValueSet/iso3166-1-3, IF the country is not specified in value Set ISO Country Alpha-2 http://hl7.org/fhir/ValueSet/iso3166-1-2.country.empty() or (country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-2') or country.memberOf('http://hl7.org/fhir/ValueSet/iso3166-1-3'))

Further specifications are made by the profiles for the data types HumanName and Address by the German base profiles.


Snapshot

idS Σ0..1string
id0..1string
extensionI0..*Extension
versionIdΣ0..1id
lastUpdatedΣ0..1instant
sourceS Σ0..1uri
profileS Σ0..*canonical(StructureDefinition)
securityΣ0..*CodingBinding
tagΣ0..*Coding
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBindingFixed Value
typeS Σ0..1CodeableConceptBindingPattern
systemS Σ1..1uriFixed Value
valueS Σ I1..1string
periodΣ I0..1Period
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ0..1uriBinding
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBindingFixed Value
typeS Σ0..1CodeableConceptBindingPattern
systemS Σ1..1uriFixed Value
valueS Σ I1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
displayΣ0..1string
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBindingFixed Value
typeS Σ1..1CodeableConceptBindingPattern
systemS Σ1..1uri
valueS Σ1..1string
periodΣ I0..1Period
id0..1string
extensionI0..*Extension
referenceS Σ I0..1string
typeΣ0..1uriBinding
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
typeS Σ0..1CodeableConceptBindingPattern
systemS Σ I1..1uri
valueS Σ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
displayΣ0..1string
id0..1string
extensionI0..*Extension
useS Σ ?!0..1codeBindingFixed Value
typeS Σ0..1CodeableConceptBindingPattern
systemΣ0..1uri
valueS Σ1..1string
periodΣ I0..1Period
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ0..1uriBinding
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBindingFixed Value
typeS Σ0..1CodeableConceptBindingPattern
systemS Σ1..1uriFixed Value
valueS Σ I1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
displayS Σ1..1string
activeΣ ?!0..1boolean
id0..1string
extensionI0..*Extension
useS Σ ?!1..1codeBindingFixed Value
textΣ0..1string
id0..1string
namenszusatzS I0..1Extension(string)
nachnameS I0..1Extension(string)
vorsatzwortS I0..1Extension(string)
value0..1System.String
givenS Σ1..*string
id0..1string
prefix-qualifierS I0..1Extension(code)
value0..1System.String
suffixΣ0..*string
periodΣ I0..1Period
id0..1string
extensionI0..*Extension
useS Σ ?!1..1codeBindingFixed Value
textΣ0..1string
id0..1string
namenszusatzS I0..1Extension(string)
nachnameS I0..1Extension(string)
vorsatzwortS I0..1Extension(string)
value0..1System.String
givenΣ0..0string
suffixΣ0..*string
periodΣ I0..1Period
telecomΣ I0..*ContactPoint
id0..1string
other-amtlichS I0..1Extension(Coding)
value0..1System.String
id0..1string
data-absent-reasonS I0..1Extension(code)
value0..1System.Date
deceasedBooleanboolean
deceasedDateTimedateTime
id0..1string
StadtteilS I0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingFixed Value
textΣ0..1string
id0..1string
StrasseS I0..1Extension(string)
HausnummerS I0..1Extension(string)
AdresszusatzS I0..1Extension(string)
PostfachI0..0Extension(string)
value0..1System.String
id0..1string
gemeindeschluesselS I0..1Extension(Coding)
value0..1System.String
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ1..1string
countryS Σ I1..1stringBinding
id0..1string
extensionI0..*Extension
startΣ I0..1dateTime
endΣ I0..1dateTime
id0..1string
StadtteilS I0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ1..1codeBindingFixed Value
textΣ0..1string
id0..1string
StrasseI0..0Extension(string)
HausnummerI0..0Extension(string)
AdresszusatzI0..0Extension(string)
PostfachS I0..1Extension(string)
value0..1System.String
id0..1string
gemeindeschluesselS I0..1Extension(Coding)
value0..1System.String
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ1..1string
countryS Σ I1..1stringBinding
id0..1string
extensionI0..*Extension
startΣ I0..1dateTime
endΣ I0..1dateTime
maritalStatus0..1CodeableConceptBinding
multipleBirthBooleanboolean
multipleBirthIntegerinteger
photoI0..*Attachment
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
relationship0..*CodeableConceptBinding
name0..1HumanName
telecomI0..*ContactPoint
address0..1Address
gender0..1codeBinding
organizationI0..1Reference(Organization)
periodI0..1Period
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
language1..1CodeableConceptBinding
preferred0..1boolean
generalPractitionerI0..*Reference(Organization | Practitioner | PractitionerRole)
managingOrganizationΣ I0..1Reference(Organization)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
otherS Σ I1..1MII-Reference(Patient | RelatedPerson)
typeS Σ1..1codeBinding


Examples

Example (minimal):

{
    "resourceType": "Patient",
    "id": "ExamplePatientPatientMinimal",
    "meta": {
        "profile":  [
            "https://www.medizininformatik-initiative.de/fhir/core/modul-person/StructureDefinition/Patient"
        ]
    },
    "identifier":  [
        {
            "use": "usual",
            "type": {
                "coding":  [
                    {
                        "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                        "code": "MR"
                    }
                ]
            },
            "system": "https://www.example.org/fhir/sid/patienten",
            "value": "42285243",
            "assigner": {
                "display": "Charité – Universitätsmedizin Berlin",
                "identifier": {
                    "system": "http://fhir.de/NamingSystem/arge-ik/iknr",
                    "value": "261101015"
                }
            }
        },
        {
            "use": "official",
            "type": {
                "coding":  [
                    {
                        "system": "http://fhir.de/CodeSystem/identifier-type-de-basis",
                        "code": "GKV"
                    }
                ]
            },
            "system": "http://fhir.de/NamingSystem/gkv/kvid-10",
            "value": "A999999999",
            "assigner": {
                "identifier": {
                    "use": "official",
                    "system": "http://fhir.de/NamingSystem/arge-ik/iknr",
                    "value": "260326822"
                }
            }
        }
    ],
    "name":  [
        {
            "use": "official",
            "family": "Van-der-Dussen",
            "given":  [
                "Maja",
                "Julia"
            ]
        }
    ],
    "address":  [
        {
            "type": "both",
            "line":  [
                "Teststraße 2"
            ],
            "city": "Köln",
            "postalCode": "50823",
            "country": "DE"
        }
    ],
    "gender": "other",
    "_gender": {
        "extension":  [
            {
                "url": "http://fhir.de/StructureDefinition/gender-amtlich-de",
                "valueCoding": {
                    "system": "http://fhir.de/CodeSystem/gender-amtlich-de",
                    "code": "D",
                    "display": "divers"
                }
            }
        ]
    },
    "birthDate": "1998-09-19",
    "managingOrganization": {
        "reference": "Organization/Charite-Universitaetsmedizin-Berlin"
    }
}

Example (complete):

{
    "resourceType": "Patient",
    "id": "ExamplePatientPatientFull",
    "meta": {
        "profile":  [
            "https://www.medizininformatik-initiative.de/fhir/core/modul-person/StructureDefinition/Patient"
        ]
    },
    "identifier":  [
        {
            "use": "usual",
            "type": {
                "coding":  [
                    {
                        "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                        "code": "MR"
                    }
                ]
            },
            "system": "https://www.example.org/fhir/sid/patienten",
            "value": "42285243",
            "assigner": {
                "display": "Charité – Universitätsmedizin Berlin",
                "identifier": {
                    "system": "https://www.medizininformatik-initiative.de/fhir/core/CodeSystem/core-location-identifier",
                    "value": "Charité"
                }
            }
        },
        {
            "use": "official",
            "type": {
                "coding":  [
                    {
                        "system": "http://fhir.de/CodeSystem/identifier-type-de-basis",
                        "code": "GKV"
                    }
                ]
            },
            "system": "http://fhir.de/NamingSystem/gkv/kvid-10",
            "value": "Z234567890",
            "assigner": {
                "identifier": {
                    "use": "official",
                    "value": "109519005",
                    "system": "http://fhir.de/NamingSystem/arge-ik/iknr"
                }
            }
        },
        {
            "use": "secondary",
            "type": {
                "coding":  [
                    {
                        "system": "http://fhir.de/CodeSystem/identifier-type-de-basis",
                        "code": "PKV"
                    }
                ]
            },
            "value": "123456",
            "assigner": {
                "display": "Signal Iduna"
            }
        }
    ],
    "name":  [
        {
            "use": "official",
            "family": "Van-der-Dussen",
            "_family": {
                "extension":  [
                    {
                        "url": "http://hl7.org/fhir/StructureDefinition/humanname-own-name",
                        "valueString": "Van-der-Dussen"
                    }
                ]
            },
            "given":  [
                "Maja",
                "Julia"
            ],
            "prefix":  [
                "Prof. Dr. med."
            ],
            "_prefix":  [
                {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier",
                            "valueCode": "AC"
                        }
                    ]
                }
            ]
        },
        {
            "use": "maiden",
            "family": "Haffer"
        }
    ],
    "gender": "other",
    "_gender": {
        "extension":  [
            {
                "url": "http://fhir.de/StructureDefinition/gender-amtlich-de",
                "valueCoding": {
                    "system": "http://fhir.de/CodeSystem/gender-amtlich-de",
                    "code": "D",
                    "display": "divers"
                }
            }
        ]
    },
    "birthDate": "1998-09-19",
    "deceasedBoolean": false,
    "address":  [
        {
            "type": "both",
            "line":  [
                "Anna-Louisa-Karsch Str. 2"
            ],
            "city": "Berlin",
            "_city": {
                "extension":  [
                    {
                        "url": "http://fhir.de/StructureDefinition/destatis/ags",
                        "valueCoding": {
                            "system": "http://fhir.de/NamingSystem/destatis/ags",
                            "code": "11000000"
                        }
                    }
                ]
            },
            "state": "DE-BE",
            "postalCode": "10178",
            "country": "DE"
        }
    ],
    "managingOrganization": {
        "reference": "Organization/Charite-Universitaetsmedizin-Berlin"
    }
}