Angehöriger (RelatedPerson)
Motivation
Der Angehörige wird vor allem im Zusammenhang mit Anwendungsszenarien verwendet, in denen das Versicherungsverhältnis eine Rolle spielt. Hier können Angehörige, bspw. der hauptversicherte Elternteil eines minderjährigen Kindes, in der Familienversicherung sein. In Selbstzahler-Szenarien können Angehörige die Zahler für eine im Krankenhaus erbrachte Leistung sein.
Kompatibilität
Zum Zeitpunkt der Erstellung dieses Leitfadens waren keine geeigneten Basis-Profile zur Darstellung von Angehörigen bekannt.
Instanzen, die gegen dieses Profil valide sind, auch valide gegen
- Profil Bezugsperson der KBV Archiv- und Wechselschnittstelle - v1.2.0
- sofern für den Angehörigen mindestens ein Vor- und Nachname angegeben wurde.
- wenn die Ressource einen Narrative enthält und in den Metadaten die Canonical-URL des KBV-Profile angegeben wird
Profil
Canonical URL: https://gematik.de/fhir/ISiK/StructureDefinition/ISiKAngehoeriger
RelatedPerson | I | RelatedPerson | |
id | Σ | 0..1 | string |
meta | Σ | 0..1 | Meta |
implicitRules | Σ ?! | 0..1 | uri |
language | 0..1 | codeBinding | |
text | 0..1 | Narrative | |
contained | 0..* | Resource | |
extension | I | 0..* | Extension |
modifierExtension | ?! I | 0..* | Extension |
identifier | Σ | 0..* | Identifier |
active | Σ ?! | 0..1 | boolean |
patient | S Σ I | 1..1 | Reference(Patient) |
id | 0..1 | string | |
extension | I | 0..* | Extension |
reference | Σ I | 1..1 | string |
type | Σ | 0..1 | uriBinding |
identifier | Σ | 0..1 | Identifier |
display | Σ | 0..1 | string |
relationship | Σ | 0..* | CodeableConceptBinding |
name | S Σ I | 1..1 | HumanName, deutsches Basisprofil |
telecom | Σ I | 0..* | ContactPoint |
gender | Σ | 0..1 | codeBinding |
id | 0..1 | string | |
extension | I | 0..* | Extension |
Geschlecht-Administrativ | I | 0..* | Extension(Coding) |
value | 0..1 | System.String | |
birthDate | Σ | 0..1 | date |
address | S Σ | 0..* | Address |
Strassenanschrift | S Σ I | 0..* | Adresse, deutsches BasisprofilPattern |
id | 0..1 | string | |
extension | I | 0..* | Extension |
Stadtteil | S I | 0..1 | Extension(string) |
use | Σ ?! | 0..1 | codeBinding |
type | S Σ | 1..1 | codeBindingPattern |
text | Σ | 0..1 | string |
line | S Σ | 1..3 | string |
id | 0..1 | string | |
extension | I | 0..* | Extension |
Strasse | S I | 0..1 | Extension(string) |
Hausnummer | S I | 0..1 | Extension(string) |
Adresszusatz | S I | 0..1 | Extension(string) |
Postfach | I | 0..1 | Extension(string) |
value | 0..1 | System.String | |
city | S Σ | 1..1 | string |
district | Σ | 0..0 | string |
state | Σ | 0..1 | stringBinding |
postalCode | S Σ | 1..1 | string |
country | S Σ I | 1..1 | stringBinding |
period | Σ I | 0..1 | Period |
id | 0..1 | string | |
extension | I | 0..* | Extension |
start | Σ I | 0..1 | dateTime |
end | Σ I | 0..1 | dateTime |
Postfach | S Σ I | 0..* | Adresse, deutsches BasisprofilPattern |
id | 0..1 | string | |
extension | I | 0..* | Extension |
Stadtteil | I | 0..1 | Extension(string) |
use | Σ ?! | 0..1 | codeBinding |
type | S Σ | 1..1 | codeBindingPattern |
text | Σ | 0..1 | string |
line | S Σ | 1..3 | string |
id | 0..1 | string | |
extension | I | 0..* | Extension |
Strasse | I | 0..1 | Extension(string) |
Hausnummer | I | 0..1 | Extension(string) |
Adresszusatz | I | 0..1 | Extension(string) |
Postfach | S I | 0..1 | Extension(string) |
value | 0..1 | System.String | |
city | S Σ | 1..1 | string |
district | Σ | 0..0 | string |
state | Σ | 0..1 | stringBinding |
postalCode | S Σ I | 1..1 | string |
country | Σ | 0..1 | stringBinding |
period | Σ I | 0..1 | Period |
id | 0..1 | string | |
extension | I | 0..* | Extension |
start | Σ I | 0..1 | dateTime |
end | Σ I | 0..1 | dateTime |
photo | I | 0..* | Attachment |
period | I | 0..1 | Period |
communication | 0..* | BackboneElement | |
id | 0..1 | string | |
extension | I | 0..* | Extension |
modifierExtension | Σ ?! I | 0..* | Extension |
language | 1..1 | CodeableConceptBinding | |
preferred | 0..1 | boolean |
Link Simplifier Profil Übersicht
key | severity | human | expression |
---|---|---|---|
relatedp-de-1 | error | Falls die Geschlechtsangabe 'other' gewählt wird, muss die amtliche Differenzierung per Extension angegeben werden | gender.exists() and gender='other' implies gender.extension('http://fhir.de/StructureDefinition/gender-amtlich-de').exists() |
address-cnt-2or3-char | warning | The 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')) |
address-cnt-2or3-char | warning | The 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')) |
Anmerkungen zu den Must-Support-Feldern
Im Profil ISiKAngehoeriger sind keine Must-Support-Felder definiert.
Interaktionen
Für die Ressource RelatedPerson MUSS die REST-Interaktion "READ" implementiert werden.
Folgende Suchparameter sind für das Bestätigungsverfahren relevant, auch in Kombination:
Der Suchparameter "_id" MUSS unterstützt werden:
Beispiele:
GET [base]/RelatedPerson?_id=103270
Anwendungshinweise: Weitere Informationen zur Suche nach "_id" finden sich in der FHIR-Basisspezifikation - Abschnitt "Parameters for all resources".
Die Suche nach einem beliebigen Bestandteil des Namens KANN unterstützt werden:
Beispiele:
GET [base]/RelatedPerson?name=Heidi
GET [base]/RelatedPerson?name=Alpenzauber
Anwendungshinweise: Weitere Informationen zur Suche nach "RelatedPerson.name" finden sich in der FHIR-Basisspezifikation - Abschnitt "String Search".
Der Suchparameter "patient" KANN unterstützt werden:
Beispiele:
GET [base]/RelatedPerson?patient=Patient/123
Anwendungshinweise: Weitere Informationen zur Suche nach "Coverage.beneficiary" finden sich in der FHIR-Basisspezifikation - Abschnitt "Reference Search".
Beispiele
Valides Minimalbeispiel für das Profil ISiKAngehoeriger:
{ "resourceType": "StructureDefinition", "id": "patient-relatedPerson", "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg", "valueCode": "pa" }, { "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm", "valueInteger": 1 } ], "url": "http://hl7.org/fhir/StructureDefinition/patient-relatedPerson", "version": "4.0.1", "name": "relatedPerson", "title": "relatedPerson", "status": "draft", "date": "2019-11-01T09:29:23+11:00", "publisher": "HL7", "description": "In some cases a Patient.contact will also be populated as a RelatedPerson resource. This linkage permits the linkage between the 2 resources to be able to accurately indicate a representation of the same individual, and updating details between could be appropriate.", "fhirVersion": "4.0.1", "mapping": [ { "identity": "rim", "uri": "http://hl7.org/v3", "name": "RIM Mapping" } ], "kind": "complex-type", "abstract": false, "context": [ { "type": "element", "expression": "Patient.contact" } ], "type": "Extension", "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Extension", "derivation": "constraint", "snapshot": { "element": [ { "id": "Extension", "path": "Extension", "short": "This contact may have further details in this RelatedPerson", "definition": "In some cases a Patient.contact will also be populated as a RelatedPerson resource. This linkage permits the linkage between the 2 resources to be able to accurately indicate a representation of the same individual, and updating details between could be appropriate.", "min": 0, "max": "*", "base": { "path": "Extension", "min": 0, "max": "*" }, "condition": [ "ele-1" ], "constraint": [ { "key": "ele-1", "severity": "error", "human": "All FHIR elements must have a @value or children", "expression": "hasValue() or (children().count() > id.count())", "xpath": "@value|f:*|h:div", "source": "http://hl7.org/fhir/StructureDefinition/Element" }, { "key": "ext-1", "severity": "error", "human": "Must have either extensions or value[x], not both", "expression": "extension.exists() != value.exists()", "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])", "source": "http://hl7.org/fhir/StructureDefinition/Extension" } ], "isModifier": false }, { "id": "Extension.id", "path": "Extension.id", "representation": [ "xmlAttr" ], "short": "Unique id for inter-element referencing", "definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.", "min": 0, "max": "1", "base": { "path": "Element.id", "min": 0, "max": "1" }, "type": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type", "valueUrl": "string" } ], "code": "http://hl7.org/fhirpath/System.String" } ], "isModifier": false, "isSummary": false, "mapping": [ { "identity": "rim", "map": "n/a" } ] }, { "id": "Extension.extension", "path": "Extension.extension", "slicing": { "discriminator": [ { "type": "value", "path": "url" } ], "description": "Extensions are always sliced by (at least) url", "rules": "open" }, "short": "Extension", "definition": "An Extension", "min": 0, "max": "0", "base": { "path": "Element.extension", "min": 0, "max": "*" }, "type": [ { "code": "Extension" } ], "constraint": [ { "key": "ele-1", "severity": "error", "human": "All FHIR elements must have a @value or children", "expression": "hasValue() or (children().count() > id.count())", "xpath": "@value|f:*|h:div", "source": "http://hl7.org/fhir/StructureDefinition/Element" }, { "key": "ext-1", "severity": "error", "human": "Must have either extensions or value[x], not both", "expression": "extension.exists() != value.exists()", "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])", "source": "http://hl7.org/fhir/StructureDefinition/Extension" } ], "isModifier": false, "isSummary": false }, { "id": "Extension.url", "path": "Extension.url", "representation": [ "xmlAttr" ], "short": "identifies the meaning of the extension", "definition": "Source of the definition for the extension code - a logical name or a URL.", "comment": "The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.", "min": 1, "max": "1", "base": { "path": "Extension.url", "min": 1, "max": "1" }, "type": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type", "valueUrl": "uri" } ], "code": "http://hl7.org/fhirpath/System.String" } ], "fixedUri": "http://hl7.org/fhir/StructureDefinition/patient-relatedPerson", "isModifier": false, "isSummary": false, "mapping": [ { "identity": "rim", "map": "N/A" } ] }, { "id": "Extension.value[x]", "path": "Extension.value[x]", "short": "Value of extension", "definition": "Value of extension - must be one of a constrained set of the data types (see [Extensibility](http://hl7.org/fhir/extensibility.html) for a list).", "min": 1, "max": "1", "base": { "path": "Extension.value[x]", "min": 0, "max": "1" }, "type": [ { "code": "Reference", "targetProfile": [ "http://hl7.org/fhir/StructureDefinition/RelatedPerson" ] } ], "constraint": [ { "key": "ele-1", "severity": "error", "human": "All FHIR elements must have a @value or children", "expression": "hasValue() or (children().count() > id.count())", "xpath": "@value|f:*|h:div", "source": "http://hl7.org/fhir/StructureDefinition/Element" } ], "isModifier": false, "isSummary": false, "mapping": [ { "identity": "rim", "map": "N/A" } ] } ] }, "differential": { "element": [ { "id": "Extension", "path": "Extension", "short": "This contact may have further details in this RelatedPerson", "definition": "In some cases a Patient.contact will also be populated as a RelatedPerson resource. This linkage permits the linkage between the 2 resources to be able to accurately indicate a representation of the same individual, and updating details between could be appropriate.", "min": 0, "max": "*" }, { "id": "Extension.extension", "path": "Extension.extension", "max": "0" }, { "id": "Extension.url", "path": "Extension.url", "fixedUri": "http://hl7.org/fhir/StructureDefinition/patient-relatedPerson" }, { "id": "Extension.value[x]", "path": "Extension.value[x]", "min": 1, "type": [ { "code": "Reference", "targetProfile": [ "http://hl7.org/fhir/StructureDefinition/RelatedPerson" ] } ] } ] } }