Nictiz FHIR NL STU3 Zib2017
1.3.15 - CI Build

Nictiz FHIR NL STU3 Zib2017 - Local Development build (v1.3.15) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: nl-core-practitionerrole - Detailed Descriptions

Active as of 2025-09-22

Definitions for the nl-core-practitionerrole resource profile.

Guidance on how to interpret the contents of this table can be foundhere

0. PractitionerRole
2. PractitionerRole.identifier
NoteThis is a business identifier, not a resource identifier (see discussion)
4. PractitionerRole.practitioner
TypeReference(nl-core-practitioner)
6. PractitionerRole.organization
ShortHealthcareProvider
TypeReference(nl-core-organization)
Alternate NamesZorgaanbieder
8. PractitionerRole.code
Comments

A person may have more than one role. Note: in earlier versions of this profile there used to be an association with the HCIM element NL-CM:17.1.5 HealthProfessionalRole. This mapping was semantically incorrect. The HCIM element is a property of the association of PractitionerRole to some healthcare act. In a number of FHIR Resources the association is implicit from the semantics of the resource element like in Observation.performer. In others you can make this explicit like Encounter.participant.type, CareTeam.participant.role and Procedure.performer.role. Please refer to the relevant profiles on those resources for associations with HCIM NL-CM:17.1.5 HealthProfessionalRole.

10. PractitionerRole.specialty
Definition

Health professional’s medical specialty. This refers to the recognized medical specialties as stated in the BIG Act. A PractitionerRole instance SHALL be a singular association between a person acting in a certain specialty for a certain organization. It's possible however that either specialty or organization or both is/are unknown. It is also possible that equivalent specialisms are available in multiple coding systems e.g. 01.015 UZI (Huisarts) and 0101 AGB (Huisartsen, niet apotheekhoudend). For this reason you may use multiple coding elements, each indicating the relevant code from a different system.

ShortSpecialty
Control0..1
Alternate NamesSpecialisme
12. PractitionerRole.specialty.coding
SlicingThis element introduces a set of slices on PractitionerRole.specialty.coding. The slices areUnordered and Open, and can be differentiated using the following discriminators:
  • value @ system
  • 14. PractitionerRole.specialty.coding:SpecialtyUZI
    Slice NameSpecialtyUZI
    ShortSpecialtyUZI
    BindingThe codes SHALL be taken from SpecialismeUZICodelijst
    (required to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.17.1.6--20171231000000)
    Alternate NamesSpecialismeUZI
    16. PractitionerRole.specialty.coding:SpecialtyUZI.system
    Control1..?
    Fixed Valuehttp://fhir.nl/fhir/NamingSystem/uzi-rolcode
    18. PractitionerRole.specialty.coding:SpecialtyAGB
    Slice NameSpecialtyAGB
    ShortSpecialtyAGB
    BindingThe codes SHALL be taken from SpecialismeAGBCodelijst
    (required to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.17.1.7--20171231000000)
    Alternate NamesSpecialismeAGB
    20. PractitionerRole.specialty.coding:SpecialtyAGB.system
    Control1..?
    Fixed Valueurn:oid:2.16.840.1.113883.2.4.6.7
    22. PractitionerRole.telecom
    TypeContactPoint(nl-core-contactpoint)

    Guidance on how to interpret the contents of this table can be foundhere

    0. PractitionerRole
    Definition

    A specific set of Roles/Locations/specialties/services that a practitioner may perform at an organization for a period of time.

    ShortRoles/organizations the practitioner is associated with
    Control0..*
    Invariantsdom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
    dom-1: If the resource is contained in another resource, it SHALL NOT contain any narrative (contained.text.empty())
    dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated (contained.meta.versionId.empty() and contained.meta.lastUpdated.empty())
    dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource (contained.where(('#'+id in %resource.descendants().reference).not()).empty())
    dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
    dom-1: If the resource is contained in another resource, it SHALL NOT contain any narrative (contained.text.empty())
    dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated (contained.meta.versionId.empty() and contained.meta.lastUpdated.empty())
    dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource (contained.where(('#'+id in %resource.descendants().reference).not()).empty())
    2. PractitionerRole.implicitRules
    Definition

    A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content.

    ShortA set of rules under which this content was created
    Comments

    Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element.

    This element is labelled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation.

    Control0..1
    Typeuri
    Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Summarytrue
    4. PractitionerRole.modifierExtension
    Definition

    May be used to represent additional information that is not part of the basic definition of the resource, and that modifies the understanding of the element that contains it. Usually modifier elements provide negation or qualification. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

    ShortExtensions that cannot be ignored
    Comments

    There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

    Control0..*
    TypeExtension
    Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
    Alternate Namesextensions, user content
    6. PractitionerRole.identifier
    Definition

    Business Identifiers that are specific to a role/location.

    ShortBusiness Identifiers that are specific to a role/location
    NoteThis is a business identifier, not a resource identifier (see discussion)
    Control0..*
    TypeIdentifier
    Summarytrue
    Requirements

    Often, specific identities are assigned for the agent.

    8. PractitionerRole.practitioner
    Definition

    Practitioner that is able to provide the defined services for the organation.

    ShortPractitioner that is able to provide the defined services for the organation
    Control0..1
    TypeReference(nl-core-practitioner, Practitioner)
    Summarytrue
    10. PractitionerRole.organization
    Definition

    The organization where the Practitioner performs the roles associated.

    ShortHealthcareProviderOrganization where the roles are available
    Control0..1
    TypeReference(nl-core-organization, Organization)
    Summarytrue
    Alternate NamesZorgaanbieder
    12. PractitionerRole.code
    Definition

    Roles which this practitioner is authorized to perform for the organization.

    ShortRoles which this practitioner may perform
    Comments

    A person may have more than one role. Note: in earlier versions of this profile there used to be an association with the HCIM element NL-CM:17.1.5 HealthProfessionalRole. This mapping was semantically incorrect. The HCIM element is a property of the association of PractitionerRole to some healthcare act. In a number of FHIR Resources the association is implicit from the semantics of the resource element like in Observation.performer. In others you can make this explicit like Encounter.participant.type, CareTeam.participant.role and Procedure.performer.role. Please refer to the relevant profiles on those resources for associations with HCIM NL-CM:17.1.5 HealthProfessionalRole.


    A person may have more than one role. At least one role is required.

    Control0..*
    BindingFor example codes, see PractitionerRolehttp://hl7.org/fhir/ValueSet/practitioner-role|3.0.2
    (example to http://hl7.org/fhir/ValueSet/practitioner-role|3.0.2)

    The role a person plays representing an organization

    TypeCodeableConcept
    Summarytrue
    Requirements

    Need to know what authority the practitioner has - what can they do?

    14. PractitionerRole.specialty
    Definition

    Health professional’s medical specialty. This refers to the recognized medical specialties as stated in the BIG Act. A PractitionerRole instance SHALL be a singular association between a person acting in a certain specialty for a certain organization. It's possible however that either specialty or organization or both is/are unknown. It is also possible that equivalent specialisms are available in multiple coding systems e.g. 01.015 UZI (Huisarts) and 0101 AGB (Huisartsen, niet apotheekhoudend). For this reason you may use multiple coding elements, each indicating the relevant code from a different system.


    Specific specialty of the practitioner.

    ShortSpecialtySpecific specialty of the practitioner
    Control0..1*
    BindingThe codes SHOULD be taken from Practice Setting Code Value Sethttp://hl7.org/fhir/ValueSet/c80-practice-codes|20091109
    (preferred to http://hl7.org/fhir/ValueSet/c80-practice-codes|20091109)

    Specific specialty associated with the agency

    TypeCodeableConcept
    Summarytrue
    Alternate NamesSpecialisme
    16. PractitionerRole.specialty.coding
    Definition

    A reference to a code defined by a terminology system.

    ShortCode defined by a terminology system
    Comments

    Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

    Control0..*
    TypeCoding
    Summarytrue
    Requirements

    Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

    SlicingThis element introduces a set of slices on PractitionerRole.specialty.coding. The slices areUnordered and Open, and can be differentiated using the following discriminators:
    • value @ system
    • 18. PractitionerRole.specialty.coding:SpecialtyUZI
      Slice NameSpecialtyUZI
      Definition

      A reference to a code defined by a terminology system.

      ShortSpecialtyUZICode defined by a terminology system
      Comments

      Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

      Control0..*
      BindingThe codes SHALL be taken from For codes, see SpecialismeUZICodelijst
      (required to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.17.1.6--20171231000000)
      TypeCoding
      Summarytrue
      Requirements

      Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

      Alternate NamesSpecialismeUZI
      20. PractitionerRole.specialty.coding:SpecialtyUZI.system
      Definition

      The identification of the code system that defines the meaning of the symbol in the code.

      ShortIdentity of the terminology system
      Comments

      The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should de-reference to some definition that establish the system clearly and unambiguously.

      Control10..1
      Typeuri
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      Summarytrue
      Requirements

      Need to be unambiguous about the source of the definition of the symbol.

      Fixed Valuehttp://fhir.nl/fhir/NamingSystem/uzi-rolcode
      22. PractitionerRole.specialty.coding:SpecialtyAGB
      Slice NameSpecialtyAGB
      Definition

      A reference to a code defined by a terminology system.

      ShortSpecialtyAGBCode defined by a terminology system
      Comments

      Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

      Control0..*
      BindingThe codes SHALL be taken from For codes, see SpecialismeAGBCodelijst
      (required to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.17.1.7--20171231000000)
      TypeCoding
      Summarytrue
      Requirements

      Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

      Alternate NamesSpecialismeAGB
      24. PractitionerRole.specialty.coding:SpecialtyAGB.system
      Definition

      The identification of the code system that defines the meaning of the symbol in the code.

      ShortIdentity of the terminology system
      Comments

      The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should de-reference to some definition that establish the system clearly and unambiguously.

      Control10..1
      Typeuri
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      Summarytrue
      Requirements

      Need to be unambiguous about the source of the definition of the symbol.

      Fixed Valueurn:oid:2.16.840.1.113883.2.4.6.7
      26. PractitionerRole.telecom
      Definition

      Contact details that are specific to the role/location/service.

      ShortContact details that are specific to the role/location/service
      Control0..*
      TypeContactPoint(nl-core-contactpoint)
      Summarytrue
      Requirements

      Often practitioners have a dedicated line for each location (or service) that they work at, and need to be able to define separate contact details for each of these.

      Guidance on how to interpret the contents of this table can be foundhere

      0. PractitionerRole
      Definition

      A specific set of Roles/Locations/specialties/services that a practitioner may perform at an organization for a period of time.

      ShortRoles/organizations the practitioner is associated with
      Control0..*
      Invariantsdom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
      dom-1: If the resource is contained in another resource, it SHALL NOT contain any narrative (contained.text.empty())
      dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated (contained.meta.versionId.empty() and contained.meta.lastUpdated.empty())
      dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource (contained.where(('#'+id in %resource.descendants().reference).not()).empty())
      2. PractitionerRole.id
      Definition

      The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.

      ShortLogical id of this artifact
      Comments

      The only time that a resource does not have an id is when it is being submitted to the server using a create operation.

      Control0..1
      Typeid
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      Summarytrue
      4. PractitionerRole.meta
      Definition

      The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content may not always be associated with version changes to the resource.

      ShortMetadata about the resource
      Control0..1
      TypeMeta
      Summarytrue
      6. PractitionerRole.implicitRules
      Definition

      A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content.

      ShortA set of rules under which this content was created
      Comments

      Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element.

      This element is labelled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation.

      Control0..1
      Typeuri
      Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      Summarytrue
      8. PractitionerRole.language
      Definition

      The base language in which the resource is written.

      ShortLanguage of the resource content
      Comments

      Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute).

      Control0..1
      BindingUnless not suitable, these codes SHALL be taken from Common Languages
      (extensible to http://hl7.org/fhir/ValueSet/languages|3.0.2)

      A human language.

      Additional BindingsPurpose
      All LanguagesMax Binding
      Typecode
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      10. PractitionerRole.text
      Definition

      A human-readable narrative that contains a summary of the resource, and may be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety.

      ShortText summary of the resource, for human interpretation
      Comments

      Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded in formation is added later.

      Control0..1
      This element is affected by the following invariants: dom-1
      TypeNarrative
      Alternate Namesnarrative, html, xhtml, display
      12. PractitionerRole.contained
      Definition

      These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope.

      ShortContained, inline Resources
      Comments

      This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again.

      Control0..*
      TypeResource
      Alternate Namesinline resources, anonymous resources, contained resources
      14. PractitionerRole.extension
      Definition

      May be used to represent additional information that is not part of the basic definition of the resource. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

      ShortAdditional Content defined by implementations
      Comments

      There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

      Control0..*
      TypeExtension
      Alternate Namesextensions, user content
      16. PractitionerRole.modifierExtension
      Definition

      May be used to represent additional information that is not part of the basic definition of the resource, and that modifies the understanding of the element that contains it. Usually modifier elements provide negation or qualification. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

      ShortExtensions that cannot be ignored
      Comments

      There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

      Control0..*
      TypeExtension
      Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
      Alternate Namesextensions, user content
      18. PractitionerRole.identifier
      Definition

      Business Identifiers that are specific to a role/location.

      ShortBusiness Identifiers that are specific to a role/location
      NoteThis is a business identifier, not a resource identifier (see discussion)
      Control0..*
      TypeIdentifier
      Summarytrue
      Requirements

      Often, specific identities are assigned for the agent.

      20. PractitionerRole.active
      Definition

      Whether this practitioner's record is in active use.

      ShortWhether this practitioner's record is in active use
      Comments

      Default is true.

      If the practitioner is not in use by one organization, then it should mark the period on the PractitonerRole with an end date (even if they are active) as they may be active in another role.

      Control0..1
      Typeboolean
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      Summarytrue
      Requirements

      Need to be able to mark a practitioner record as not to be used because it was created in error.

      Default Valuetrue
      22. PractitionerRole.period
      Definition

      The period during which the person is authorized to act as a practitioner in these role(s) for the organization.

      ShortThe period during which the practitioner is authorized to perform in these role(s)
      Control0..1
      TypePeriod
      Summarytrue
      Requirements

      Even after the agencies is revoked, the fact that it existed must still be recorded.

      24. PractitionerRole.practitioner
      Definition

      Practitioner that is able to provide the defined services for the organation.

      ShortPractitioner that is able to provide the defined services for the organation
      Control0..1
      TypeReference(nl-core-practitioner)
      Summarytrue
      26. PractitionerRole.organization
      Definition

      The organization where the Practitioner performs the roles associated.

      ShortHealthcareProvider
      Control0..1
      TypeReference(nl-core-organization)
      Summarytrue
      Alternate NamesZorgaanbieder
      28. PractitionerRole.code
      Definition

      Roles which this practitioner is authorized to perform for the organization.

      ShortRoles which this practitioner may perform
      Comments

      A person may have more than one role. Note: in earlier versions of this profile there used to be an association with the HCIM element NL-CM:17.1.5 HealthProfessionalRole. This mapping was semantically incorrect. The HCIM element is a property of the association of PractitionerRole to some healthcare act. In a number of FHIR Resources the association is implicit from the semantics of the resource element like in Observation.performer. In others you can make this explicit like Encounter.participant.type, CareTeam.participant.role and Procedure.performer.role. Please refer to the relevant profiles on those resources for associations with HCIM NL-CM:17.1.5 HealthProfessionalRole.

      Control0..*
      BindingFor example codes, see PractitionerRole
      (example to http://hl7.org/fhir/ValueSet/practitioner-role|3.0.2)

      The role a person plays representing an organization

      TypeCodeableConcept
      Summarytrue
      Requirements

      Need to know what authority the practitioner has - what can they do?

      30. PractitionerRole.specialty
      Definition

      Health professional’s medical specialty. This refers to the recognized medical specialties as stated in the BIG Act. A PractitionerRole instance SHALL be a singular association between a person acting in a certain specialty for a certain organization. It's possible however that either specialty or organization or both is/are unknown. It is also possible that equivalent specialisms are available in multiple coding systems e.g. 01.015 UZI (Huisarts) and 0101 AGB (Huisartsen, niet apotheekhoudend). For this reason you may use multiple coding elements, each indicating the relevant code from a different system.

      ShortSpecialty
      Control0..1
      BindingThe codes SHOULD be taken from Practice Setting Code Value Set
      (preferred to http://hl7.org/fhir/ValueSet/c80-practice-codes|20091109)

      Specific specialty associated with the agency

      TypeCodeableConcept
      Summarytrue
      Alternate NamesSpecialisme
      32. PractitionerRole.specialty.id
      Definition

      unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

      Shortxml:id (or equivalent in JSON)
      Control0..1
      Typestring
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      XML FormatIn the XML format, this property is represented as an attribute.
      34. PractitionerRole.specialty.extension
      Definition

      May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

      ShortAdditional Content defined by implementations
      Comments

      There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

      Control0..*
      TypeExtension
      Alternate Namesextensions, user content
      SlicingThis element introduces a set of slices on PractitionerRole.specialty.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
      • value @ url
      • 36. PractitionerRole.specialty.coding
        Definition

        A reference to a code defined by a terminology system.

        ShortCode defined by a terminology system
        Comments

        Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

        Control0..*
        TypeCoding
        Summarytrue
        Requirements

        Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

        SlicingThis element introduces a set of slices on PractitionerRole.specialty.coding. The slices areUnordered and Open, and can be differentiated using the following discriminators:
        • value @ system
        • 38. PractitionerRole.specialty.coding:SpecialtyUZI
          Slice NameSpecialtyUZI
          Definition

          A reference to a code defined by a terminology system.

          ShortSpecialtyUZI
          Comments

          Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

          Control0..*
          BindingThe codes SHALL be taken from SpecialismeUZICodelijst
          (required to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.17.1.6--20171231000000)
          TypeCoding
          Summarytrue
          Requirements

          Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

          Alternate NamesSpecialismeUZI
          40. PractitionerRole.specialty.coding:SpecialtyUZI.id
          Definition

          unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

          Shortxml:id (or equivalent in JSON)
          Control0..1
          Typestring
          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
          XML FormatIn the XML format, this property is represented as an attribute.
          42. PractitionerRole.specialty.coding:SpecialtyUZI.extension
          Definition

          May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

          ShortAdditional Content defined by implementations
          Comments

          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

          Control0..*
          TypeExtension
          Alternate Namesextensions, user content
          SlicingThis element introduces a set of slices on PractitionerRole.specialty.coding.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
          • value @ url
          • 44. PractitionerRole.specialty.coding:SpecialtyUZI.system
            Definition

            The identification of the code system that defines the meaning of the symbol in the code.

            ShortIdentity of the terminology system
            Comments

            The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should de-reference to some definition that establish the system clearly and unambiguously.

            Control1..1
            Typeuri
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            Summarytrue
            Requirements

            Need to be unambiguous about the source of the definition of the symbol.

            Fixed Valuehttp://fhir.nl/fhir/NamingSystem/uzi-rolcode
            46. PractitionerRole.specialty.coding:SpecialtyUZI.version
            Definition

            The version of the code system which was used when choosing this code. Note that a well-maintained code system does not need the version reported, because the meaning of codes is consistent across versions. However this cannot consistently be assured. and when the meaning is not guaranteed to be consistent, the version SHOULD be exchanged.

            ShortVersion of the system - if relevant
            Comments

            Where the terminology does not clearly define what string should be used to identify code system versions, the recommendation is to use the date (expressed in FHIR date format) on which that version was officially published as the version date.

            NoteThis is a business version Id, not a resource version Id (see discussion)
            Control0..1
            Typestring
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            Summarytrue
            48. PractitionerRole.specialty.coding:SpecialtyUZI.code
            Definition

            A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

            ShortSymbol in syntax defined by the system
            Control0..1
            Typecode
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            Summarytrue
            Requirements

            Need to refer to a particular code in the system.

            50. PractitionerRole.specialty.coding:SpecialtyUZI.display
            Definition

            A representation of the meaning of the code in the system, following the rules of the system.

            ShortRepresentation defined by the system
            Control0..1
            Typestring
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            Summarytrue
            Requirements

            Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

            52. PractitionerRole.specialty.coding:SpecialtyUZI.userSelected
            Definition

            Indicates that this coding was chosen by a user directly - i.e. off a pick list of available items (codes or displays).

            ShortIf this coding was chosen directly by the user
            Comments

            Amongst a set of alternatives, a directly chosen code is the most appropriate starting point for new translations. There is some ambiguity about what exactly 'directly chosen' implies, and trading partner agreement may be needed to clarify the use of this element and its consequences more completely.

            Control0..1
            Typeboolean
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            Summarytrue
            Requirements

            This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

            54. PractitionerRole.specialty.coding:SpecialtyAGB
            Slice NameSpecialtyAGB
            Definition

            A reference to a code defined by a terminology system.

            ShortSpecialtyAGB
            Comments

            Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

            Control0..*
            BindingThe codes SHALL be taken from SpecialismeAGBCodelijst
            (required to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.17.1.7--20171231000000)
            TypeCoding
            Summarytrue
            Requirements

            Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

            Alternate NamesSpecialismeAGB
            56. PractitionerRole.specialty.coding:SpecialtyAGB.id
            Definition

            unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

            Shortxml:id (or equivalent in JSON)
            Control0..1
            Typestring
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            XML FormatIn the XML format, this property is represented as an attribute.
            58. PractitionerRole.specialty.coding:SpecialtyAGB.extension
            Definition

            May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

            ShortAdditional Content defined by implementations
            Comments

            There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

            Control0..*
            TypeExtension
            Alternate Namesextensions, user content
            SlicingThis element introduces a set of slices on PractitionerRole.specialty.coding.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
            • value @ url
            • 60. PractitionerRole.specialty.coding:SpecialtyAGB.system
              Definition

              The identification of the code system that defines the meaning of the symbol in the code.

              ShortIdentity of the terminology system
              Comments

              The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should de-reference to some definition that establish the system clearly and unambiguously.

              Control1..1
              Typeuri
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              Summarytrue
              Requirements

              Need to be unambiguous about the source of the definition of the symbol.

              Fixed Valueurn:oid:2.16.840.1.113883.2.4.6.7
              62. PractitionerRole.specialty.coding:SpecialtyAGB.version
              Definition

              The version of the code system which was used when choosing this code. Note that a well-maintained code system does not need the version reported, because the meaning of codes is consistent across versions. However this cannot consistently be assured. and when the meaning is not guaranteed to be consistent, the version SHOULD be exchanged.

              ShortVersion of the system - if relevant
              Comments

              Where the terminology does not clearly define what string should be used to identify code system versions, the recommendation is to use the date (expressed in FHIR date format) on which that version was officially published as the version date.

              NoteThis is a business version Id, not a resource version Id (see discussion)
              Control0..1
              Typestring
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              Summarytrue
              64. PractitionerRole.specialty.coding:SpecialtyAGB.code
              Definition

              A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

              ShortSymbol in syntax defined by the system
              Control0..1
              Typecode
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              Summarytrue
              Requirements

              Need to refer to a particular code in the system.

              66. PractitionerRole.specialty.coding:SpecialtyAGB.display
              Definition

              A representation of the meaning of the code in the system, following the rules of the system.

              ShortRepresentation defined by the system
              Control0..1
              Typestring
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              Summarytrue
              Requirements

              Need to be able to carry a human-readable meaning of the code for readers that do not know the system.

              68. PractitionerRole.specialty.coding:SpecialtyAGB.userSelected
              Definition

              Indicates that this coding was chosen by a user directly - i.e. off a pick list of available items (codes or displays).

              ShortIf this coding was chosen directly by the user
              Comments

              Amongst a set of alternatives, a directly chosen code is the most appropriate starting point for new translations. There is some ambiguity about what exactly 'directly chosen' implies, and trading partner agreement may be needed to clarify the use of this element and its consequences more completely.

              Control0..1
              Typeboolean
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              Summarytrue
              Requirements

              This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing.

              70. PractitionerRole.specialty.text
              Definition

              A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

              ShortPlain text representation of the concept
              Comments

              Very often the text is the same as a displayName of one of the codings.

              Control0..1
              Typestring
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              Summarytrue
              Requirements

              The codes from the terminologies do not always capture the correct meaning with all the nuances of the human using them, or sometimes there is no appropriate code at all. In these cases, the text is used to capture the full meaning of the source.

              72. PractitionerRole.location
              Definition

              The location(s) at which this practitioner provides care.

              ShortThe location(s) at which this practitioner provides care
              Control0..*
              TypeReference(Location)
              Summarytrue
              74. PractitionerRole.healthcareService
              Definition

              The list of healthcare services that this worker provides for this role's Organization/Location(s).

              ShortThe list of healthcare services that this worker provides for this role's Organization/Location(s)
              Control0..*
              TypeReference(HealthcareService)
              76. PractitionerRole.telecom
              Definition

              Contact details that are specific to the role/location/service.

              ShortContact details that are specific to the role/location/service
              Control0..*
              TypeContactPoint(nl-core-contactpoint)
              Summarytrue
              Requirements

              Often practitioners have a dedicated line for each location (or service) that they work at, and need to be able to define separate contact details for each of these.

              78. PractitionerRole.availableTime
              Definition

              A collection of times that the Service Site is available.

              ShortTimes the Service Site is available
              Comments

              More detailed availability information may be provided in associated Schedule/Slot resources.

              Control0..*
              TypeBackboneElement
              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
              80. PractitionerRole.availableTime.id
              Definition

              unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

              Shortxml:id (or equivalent in JSON)
              Control0..1
              Typestring
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              XML FormatIn the XML format, this property is represented as an attribute.
              82. PractitionerRole.availableTime.extension
              Definition

              May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

              ShortAdditional Content defined by implementations
              Comments

              There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

              Control0..*
              TypeExtension
              Alternate Namesextensions, user content
              84. PractitionerRole.availableTime.modifierExtension
              Definition

              May be used to represent additional information that is not part of the basic definition of the element, and that modifies the understanding of the element that contains it. Usually modifier elements provide negation or qualification. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

              ShortExtensions that cannot be ignored
              Comments

              There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

              Control0..*
              TypeExtension
              Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
              Summarytrue
              Alternate Namesextensions, user content, modifiers
              86. PractitionerRole.availableTime.daysOfWeek
              Definition

              Indicates which days of the week are available between the start and end Times.

              Shortmon | tue | wed | thu | fri | sat | sun
              Control0..*
              BindingThe codes SHALL be taken from DaysOfWeek
              (required to http://hl7.org/fhir/ValueSet/days-of-week|3.0.2)

              The days of the week.

              Typecode
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              88. PractitionerRole.availableTime.allDay
              Definition

              Is this always available? (hence times are irrelevant) e.g. 24 hour service.

              ShortAlways available? e.g. 24 hour service
              Control0..1
              Typeboolean
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              90. PractitionerRole.availableTime.availableStartTime
              Definition

              The opening time of day. Note: If the AllDay flag is set, then this time is ignored.

              ShortOpening time of day (ignored if allDay = true)
              Comments

              The timezone is expected to be for where this HealthcareService is provided at.

              Control0..1
              Typetime
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              92. PractitionerRole.availableTime.availableEndTime
              Definition

              The closing time of day. Note: If the AllDay flag is set, then this time is ignored.

              ShortClosing time of day (ignored if allDay = true)
              Comments

              The timezone is expected to be for where this HealthcareService is provided at.

              Control0..1
              Typetime
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              94. PractitionerRole.notAvailable
              Definition

              The HealthcareService is not available during this period of time due to the provided reason.

              ShortNot available during this time due to provided reason
              Control0..*
              TypeBackboneElement
              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
              96. PractitionerRole.notAvailable.id
              Definition

              unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

              Shortxml:id (or equivalent in JSON)
              Control0..1
              Typestring
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              XML FormatIn the XML format, this property is represented as an attribute.
              98. PractitionerRole.notAvailable.extension
              Definition

              May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

              ShortAdditional Content defined by implementations
              Comments

              There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

              Control0..*
              TypeExtension
              Alternate Namesextensions, user content
              100. PractitionerRole.notAvailable.modifierExtension
              Definition

              May be used to represent additional information that is not part of the basic definition of the element, and that modifies the understanding of the element that contains it. Usually modifier elements provide negation or qualification. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

              ShortExtensions that cannot be ignored
              Comments

              There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

              Control0..*
              TypeExtension
              Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
              Summarytrue
              Alternate Namesextensions, user content, modifiers
              102. PractitionerRole.notAvailable.description
              Definition

              The reason that can be presented to the user as to why this time is not available.

              ShortReason presented to the user explaining why time not available
              Control1..1
              Typestring
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              104. PractitionerRole.notAvailable.during
              Definition

              Service is not available (seasonally or for a public holiday) from this date.

              ShortService not availablefrom this date
              Control0..1
              TypePeriod
              106. PractitionerRole.availabilityExceptions
              Definition

              A description of site availability exceptions, e.g. public holiday availability. Succinctly describing all possible exceptions to normal site availability as details in the available Times and not available Times.

              ShortDescription of availability exceptions
              Control0..1
              Typestring
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              108. PractitionerRole.endpoint
              Definition

              Technical endpoints providing access to services operated for the practitioner with this role.

              ShortTechnical endpoints providing access to services operated for the practitioner with this role
              Control0..*
              TypeReference(Endpoint)
              Requirements

              Organizations have multiple systems that provide various services and ,ay also be different for practitioners too.

              So the endpoint satisfies the need to be able to define the technical connection details for how to connect to them, and for what purpose.