Clinical Document Architecture, published by Health Level 7. This guide is not an authorized publication; it is the continuous build for version 2.0.1-sd built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/CDA-core-sd/ and changes regularly. See the Directory of published versions
Official URL: http://hl7.org/cda/stds/core/ValueSet/CDARoleClassMutualRelationship | Version: 2.0.1-sd | |||
Draft as of 2024-12-18 | Computable Name: CDARoleClassMutualRelationship |
A relationship that is based on mutual behavior of the two Entities as being related. The basis of such relationship may be agreements (e.g., spouses, contract parties) or they may be de facto behavior (e.g. friends) or may be an incidental involvement with each other (e.g. parties over a dispute, siblings, children).
References
Generated Narrative: ValueSet CDARoleClassMutualRelationship
http://terminology.hl7.org/CodeSystem/v3-RoleClass
Code | Display | Definition |
LIC | licensed entity | A relationship in which the scoper certifies the player ( e. g. a medical care giver, a medical device or a provider organization) to perform certain activities that fall under the jurisdiction of the scoper (e.g., a health authority licensing healthcare providers, a medical quality authority certifying healthcare professionals). |
NOT | notary public | |
PROV | healthcare provider | An Entity (player) that is authorized to provide health care services by some authorizing agency (scoper). |
CON | contact | A person or an organization (player) which provides or receives information regarding another entity (scoper). Examples; patient NOK and emergency contacts; guarantor contact; employer contact. |
ECON | emergency contact | An entity to be contacted in the event of an emergency. |
NOK | next of kin | An individual designated for notification as the next of kin for a given entity. |
ASSIGNED | assigned entity | An agent role in which the agent is an Entity acting in the employ of an organization. The focus is on functional role on behalf of the organization, unlike the Employee role where the focus is on the 'Human Resources' relationship between the employee and the organization. |
COMPAR | commissioning party | An Entity that is authorized to issue or instantiate permissions, privileges, credentials or other formal/legal authorizations. |
SGNOFF | signing authority or officer | The role of a person (player) who is the officer or signature authority for of a scoping entity, usually an organization (scoper). |
AGNT | agent | An entity (player) that acts or is authorized to act on behalf of another entity (scoper). |
GUARD | guardian | Guardian of a ward |
EMP | employee | A relationship between a person or organization and a person or organization formed for the purpose of exchanging work for compensation. The purpose of the role is to identify the type of relationship the employee has to the employer, rather than the nature of the work actually performed. (Contrast with AssignedEntity.) |
MIL | military person | A role played by a member of a military service. Scoper is the military service (e.g. Army, Navy, Air Force, etc.) or, more specifically, the unit (e.g. Company C, 3rd Battalion, 4th Division, etc.) |
INVSBJ | Investigation Subject | An entity that is the subject of an investigation. This role is scoped by the party responsible for the investigation. |
CASESBJ | ||
RESBJ | research subject | **Definition:**Specifies the administrative functionality within a formal experimental design for which the ResearchSubject role was established. **Examples:** Screening - role is used for pre-enrollment evaluation portion of the design; enrolled - role is used for subjects admitted to the experimental portion of the design. |
CIT | citizen | Citizen of apolitical entity |
COVPTY | covered party | A role class played by a person who receives benefit coverage under the terms of a particular insurance policy. The underwriter of that policy is the scoping entity. The covered party receives coverage because of some contractual or other relationship with the holder of that policy. *Discussion:*This reason for coverage is captured in 'Role.code' and a relationship link with type code of indirect authority should be included using the policy holder role as the source, and the covered party role as the target. Note that a particular policy may cover several individuals one of whom may be, but need not be, the policy holder. Thus the notion of covered party is a role that is distinct from that of the policy holder. |
CRINV | clinical research investigator | A role played by a provider, always a person, who has agency authority from a Clinical Research Sponsor to direct the conduct of a clinical research trial or study on behalf of the sponsor. |
CRSPNSR | clinical research sponsor | A role played by an entity, usually an organization, that is the sponsor of a clinical research trial or study. The sponsor commissions the study, bears the expenses, is responsible for satisfying all legal requirements concerning subject safety and privacy, and is generally responsible for collection, storage and analysis of the data generated during the trial. No scoper is necessary, as a clinical research sponsor undertakes the role on its own authority and declaration. Clinical research sponsors are usually educational or other research organizations, government agencies or biopharmaceutical companies. |
GUAR | guarantor | A person or organization (player) that serves as a financial guarantor for another person or organization (scoper). |
PAT | patient | A Role of a LivingSubject (player) as an actual or potential recipient of health care services from a healthcare provider organization (scoper). *Usage Note:* Communication about relationships between patients and specific healthcare practitioners (people) is not done via scoper. Instead this is generally done using the CareProvision act. This allows linkage between patient and a particular healthcare practitioner role and also allows description of the type of care involved in the relationship. |
PAYEE | payee | The role of an organization or individual designated to receive payment for a claim against a particular coverage. The scoping entity is the organization that is the submitter of the invoice in question. |
PAYOR | invoice payor | The role of an organization that undertakes to accept claims invoices, assess the coverage or payments due for those invoices and pay to the designated payees for those invoices. This role may be either the underwriter or a third-party organization authorized by the underwriter. The scoping entity is the organization that underwrites the claimed coverage. |
POLHOLD | policy holder | A role played by a person or organization that holds an insurance policy. The underwriter of that policy is the scoping entity. *Discussion:*The identifier of the policy is captured in 'Role.id' when the Role is a policy holder. A particular policy may cover several individuals one of whom may be, but need not be, the policy holder. Thus the notion of covered party is a role that is distinct from that of the policy holder. |
QUAL | qualified entity | An entity (player) that has been recognized as having certain training/experience or other characteristics that would make said entity an appropriate performer for a certain activity. The scoper is an organization that educates or qualifies entities. |
SPNSR | coverage sponsor | A role played by an entity, usually an organization that is the sponsor of an insurance plan or a health program. A sponsor is the party that is ultimately accountable for the coverage by employment contract or by law. A sponsor can be an employer, union, government agency, or association. Fully insured sponsors establish the terms of the plan and contract with health insurance plans to assume the risk and to administer the plan. Self-insured sponsors delegate coverage administration, but not risk, to third-party administrators. Program sponsors designate services to be covered in accordance with statute. Program sponsors may administer the coverage themselves, delegate coverage administration, but not risk to third-party administrators, or contract with health insurance plans to assume the risk and administrator a program. Sponsors qualify individuals who may become 1. a policy holder of the plan; 2. where the sponsor is the policy holder, who may become a subscriber or a dependent to a policy under the plan; or 3. where the sponsor is a government agency, who may become program eligibles under a program. The sponsor role may be further qualified by the SponsorRole.code. Entities playing the sponsor role may also play the role of a Coverage Administrator. *Example:* An employer, union, government agency, or association. |
STD | student | A role played by an individual who is a student of a school, which is the scoping entity. |
UNDWRT | underwriter | A role played by a person or an organization. It is the party that 1. accepts fiscal responsibility for insurance plans and the policies created under those plans; 2. administers and accepts fiscal responsibility for a program that provides coverage for services to eligible individuals; and/or 3. has the responsibility to assess the merits of each risk and decide a suitable premium for accepting all or part of the risk. If played by an organization, this role may be further specified by an appropriate RoleCode. *Example:* 1. A health insurer; 2. Medicaid Program; 3. Lloyd's of London |
CAREGIVER | caregiver | A person responsible for the primary care of a patient at home. |
PRS | personal relationship | Links two entities with classCode PSN (person) in a personal relationship. The character of the relationship must be defined by a PersonalRelationshipRoleType code. The player and scoper are determined by PersonalRelationshipRoleType code as well. |
Generated Narrative: ValueSet
Expansion based on codesystem RoleClass v3.1.0 (CodeSystem)
This value set contains 30 concepts
Code | System | Display | Definition |
LIC | http://terminology.hl7.org/CodeSystem/v3-RoleClass | licensed entity | A relationship in which the scoper certifies the player ( e. g. a medical care giver, a medical device or a provider organization) to perform certain activities that fall under the jurisdiction of the scoper (e.g., a health authority licensing healthcare providers, a medical quality authority certifying healthcare professionals). |
NOT | http://terminology.hl7.org/CodeSystem/v3-RoleClass | notary public | |
PROV | http://terminology.hl7.org/CodeSystem/v3-RoleClass | healthcare provider | An Entity (player) that is authorized to provide health care services by some authorizing agency (scoper). |
CON | http://terminology.hl7.org/CodeSystem/v3-RoleClass | contact | A person or an organization (player) which provides or receives information regarding another entity (scoper). Examples; patient NOK and emergency contacts; guarantor contact; employer contact. |
ECON | http://terminology.hl7.org/CodeSystem/v3-RoleClass | emergency contact | An entity to be contacted in the event of an emergency. |
NOK | http://terminology.hl7.org/CodeSystem/v3-RoleClass | next of kin | An individual designated for notification as the next of kin for a given entity. |
ASSIGNED | http://terminology.hl7.org/CodeSystem/v3-RoleClass | assigned entity | An agent role in which the agent is an Entity acting in the employ of an organization. The focus is on functional role on behalf of the organization, unlike the Employee role where the focus is on the 'Human Resources' relationship between the employee and the organization. |
COMPAR | http://terminology.hl7.org/CodeSystem/v3-RoleClass | commissioning party | An Entity that is authorized to issue or instantiate permissions, privileges, credentials or other formal/legal authorizations. |
SGNOFF | http://terminology.hl7.org/CodeSystem/v3-RoleClass | signing authority or officer | The role of a person (player) who is the officer or signature authority for of a scoping entity, usually an organization (scoper). |
AGNT | http://terminology.hl7.org/CodeSystem/v3-RoleClass | agent | An entity (player) that acts or is authorized to act on behalf of another entity (scoper). |
GUARD | http://terminology.hl7.org/CodeSystem/v3-RoleClass | guardian | Guardian of a ward |
EMP | http://terminology.hl7.org/CodeSystem/v3-RoleClass | employee | A relationship between a person or organization and a person or organization formed for the purpose of exchanging work for compensation. The purpose of the role is to identify the type of relationship the employee has to the employer, rather than the nature of the work actually performed. (Contrast with AssignedEntity.) |
MIL | http://terminology.hl7.org/CodeSystem/v3-RoleClass | military person | A role played by a member of a military service. Scoper is the military service (e.g. Army, Navy, Air Force, etc.) or, more specifically, the unit (e.g. Company C, 3rd Battalion, 4th Division, etc.) |
INVSBJ | http://terminology.hl7.org/CodeSystem/v3-RoleClass | Investigation Subject | An entity that is the subject of an investigation. This role is scoped by the party responsible for the investigation. |
RESBJ | http://terminology.hl7.org/CodeSystem/v3-RoleClass | research subject | **Definition:**Specifies the administrative functionality within a formal experimental design for which the ResearchSubject role was established. Examples: Screening - role is used for pre-enrollment evaluation portion of the design; enrolled - role is used for subjects admitted to the experimental portion of the design. |
CIT | http://terminology.hl7.org/CodeSystem/v3-RoleClass | citizen | Citizen of apolitical entity |
COVPTY | http://terminology.hl7.org/CodeSystem/v3-RoleClass | covered party | A role class played by a person who receives benefit coverage under the terms of a particular insurance policy. The underwriter of that policy is the scoping entity. The covered party receives coverage because of some contractual or other relationship with the holder of that policy. *Discussion:*This reason for coverage is captured in 'Role.code' and a relationship link with type code of indirect authority should be included using the policy holder role as the source, and the covered party role as the target. Note that a particular policy may cover several individuals one of whom may be, but need not be, the policy holder. Thus the notion of covered party is a role that is distinct from that of the policy holder. |
CRINV | http://terminology.hl7.org/CodeSystem/v3-RoleClass | clinical research investigator | A role played by a provider, always a person, who has agency authority from a Clinical Research Sponsor to direct the conduct of a clinical research trial or study on behalf of the sponsor. |
CRSPNSR | http://terminology.hl7.org/CodeSystem/v3-RoleClass | clinical research sponsor | A role played by an entity, usually an organization, that is the sponsor of a clinical research trial or study. The sponsor commissions the study, bears the expenses, is responsible for satisfying all legal requirements concerning subject safety and privacy, and is generally responsible for collection, storage and analysis of the data generated during the trial. No scoper is necessary, as a clinical research sponsor undertakes the role on its own authority and declaration. Clinical research sponsors are usually educational or other research organizations, government agencies or biopharmaceutical companies. |
GUAR | http://terminology.hl7.org/CodeSystem/v3-RoleClass | guarantor | A person or organization (player) that serves as a financial guarantor for another person or organization (scoper). |
PAT | http://terminology.hl7.org/CodeSystem/v3-RoleClass | patient | A Role of a LivingSubject (player) as an actual or potential recipient of health care services from a healthcare provider organization (scoper). Usage Note: Communication about relationships between patients and specific healthcare practitioners (people) is not done via scoper. Instead this is generally done using the CareProvision act. This allows linkage between patient and a particular healthcare practitioner role and also allows description of the type of care involved in the relationship. |
PAYEE | http://terminology.hl7.org/CodeSystem/v3-RoleClass | payee | The role of an organization or individual designated to receive payment for a claim against a particular coverage. The scoping entity is the organization that is the submitter of the invoice in question. |
PAYOR | http://terminology.hl7.org/CodeSystem/v3-RoleClass | invoice payor | The role of an organization that undertakes to accept claims invoices, assess the coverage or payments due for those invoices and pay to the designated payees for those invoices. This role may be either the underwriter or a third-party organization authorized by the underwriter. The scoping entity is the organization that underwrites the claimed coverage. |
POLHOLD | http://terminology.hl7.org/CodeSystem/v3-RoleClass | policy holder | A role played by a person or organization that holds an insurance policy. The underwriter of that policy is the scoping entity. *Discussion:*The identifier of the policy is captured in 'Role.id' when the Role is a policy holder. A particular policy may cover several individuals one of whom may be, but need not be, the policy holder. Thus the notion of covered party is a role that is distinct from that of the policy holder. |
QUAL | http://terminology.hl7.org/CodeSystem/v3-RoleClass | qualified entity | An entity (player) that has been recognized as having certain training/experience or other characteristics that would make said entity an appropriate performer for a certain activity. The scoper is an organization that educates or qualifies entities. |
SPNSR | http://terminology.hl7.org/CodeSystem/v3-RoleClass | coverage sponsor | A role played by an entity, usually an organization that is the sponsor of an insurance plan or a health program. A sponsor is the party that is ultimately accountable for the coverage by employment contract or by law. A sponsor can be an employer, union, government agency, or association. Fully insured sponsors establish the terms of the plan and contract with health insurance plans to assume the risk and to administer the plan. Self-insured sponsors delegate coverage administration, but not risk, to third-party administrators. Program sponsors designate services to be covered in accordance with statute. Program sponsors may administer the coverage themselves, delegate coverage administration, but not risk to third-party administrators, or contract with health insurance plans to assume the risk and administrator a program. Sponsors qualify individuals who may become
The sponsor role may be further qualified by the SponsorRole.code. Entities playing the sponsor role may also play the role of a Coverage Administrator. Example: An employer, union, government agency, or association. |
STD | http://terminology.hl7.org/CodeSystem/v3-RoleClass | student | A role played by an individual who is a student of a school, which is the scoping entity. |
UNDWRT | http://terminology.hl7.org/CodeSystem/v3-RoleClass | underwriter | A role played by a person or an organization. It is the party that
Example:
|
CAREGIVER | http://terminology.hl7.org/CodeSystem/v3-RoleClass | caregiver | A person responsible for the primary care of a patient at home. |
PRS | http://terminology.hl7.org/CodeSystem/v3-RoleClass | personal relationship | Links two entities with classCode PSN (person) in a personal relationship. The character of the relationship must be defined by a PersonalRelationshipRoleType code. The player and scoper are determined by PersonalRelationshipRoleType code as well. |
Explanation of the columns that may appear on this page:
Level | A few code lists that FHIR defines are hierarchical - each code is assigned a level. In this scheme, some codes are under other codes, and imply that the code they are under also applies |
System | The source of the definition of the code (when the value set draws in codes defined elsewhere) |
Code | The code (used as the code in the resource instance) |
Display | The display (used in the display element of a Coding). If there is no display, implementers should not simply display the code, but map the concept into their application |
Definition | An explanation of the meaning of the concept |
Comments | Additional notes about how to use the code |