Dissolve-E: AWMF Guideline Registry
0.2.0 - ci-build

Dissolve-E: AWMF Guideline Registry - Local Development build (v0.2.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: Medical Society

Official URL: http://fhir.awmf.org/awmf.ig/StructureDefinition/medical-society Version: 0.2.0
Draft as of 2026-01-29 Computable Name: MedicalSociety

A profile for medical societies.

Guidance

This profile represents a Medical Society – an organization involved in the development or endorsement of clinical practice guidelines.

Overview

Medical societies are professional organizations that bring together healthcare professionals in specific medical disciplines. This profile extends the base Organization resource to capture additional information relevant for guideline authorship.

Key Elements

Organization Type

The type element is fixed to identify the organization as a medical society:

* type = cs-awmf#medical-society
Medical Subject Category

Use the medicalSubjectCategory extension to specify the discipline(s) the society represents:

* extension[medicalSubjectCategory][+].valueCodeableConcept = cs-medical-subject-categories#surgical "Surgical Disciplines"
* extension[medicalSubjectCategory][+].valueCodeableConcept = cs-medical-subject-categories#psychosocial "Psychosocial Disciplines"
Medical Subject

Use the medicalSubject extension for more specific subject areas:

* extension[medicalSubject][+].valueCodeableConcept.text = "Anesthesiology and Intensive Care Medicine"
Organization Branding

The brand extension allows for logo and visual identity information:

* extension[brand].extension[brandLogo].valueUrl = "https://www.example.org/logo.png"
Organization Period

Document the active period of the organization:

* extension[organizationPeriod].valuePeriod.start = "2000-01-01"
* extension[organizationPeriod].valuePeriod.end = "2050-12-31"

Example Usage

Instance: MySociety
InstanceOf: medical-society
Usage: #example
* name = "German Society for Example Medicine"
* contact.telecom
  * system = #url
  * value = "https://www.example-society.org"
* extension[medicalSubjectCategory][+].valueCodeableConcept = cs-medical-subject-categories#surgical "Surgical Disciplines"
* extension[medicalSubject][+].valueCodeableConcept.text = "Example Surgery"

This profile of a FHIR Organization is derived from the Organization FHIR resource.

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Organization C 0..* Organization A grouping of people or organizations with a common purpose
Constraints: org-1
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:medicalSubjectCategory 0..* CodeableConcept Medical Subject Category
URL: http://fhir.awmf.org/awmf.ig/StructureDefinition/ext-medical-subject-category
.... extension:medicalSubject 0..* CodeableConcept Medical Subject
URL: http://fhir.awmf.org/awmf.ig/StructureDefinition/ext-medical-subject
.... extension:brand 0..1 (Complex) Organization Brand
URL: http://hl7.org/fhir/StructureDefinition/organization-brand
.... extension:organizationPeriod 0..1 Period Extension
URL: http://hl7.org/fhir/StructureDefinition/organization-period
... active ?!Σ 0..1 boolean Whether the organization's record is still in active use
... type Σ 1..* CodeableConcept Kind of organization
Binding: OrganizationType (example): Used to categorize the organization.

Required Pattern: At least the following
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... system 1..1 uri Identity of the terminology system
Fixed Value: http://fhir.awmf.org/awmf.ig/CodeSystem/cs-awmf
..... version 0..1 string Version of the system - if relevant
..... code 1..1 code Symbol in syntax defined by the system
Fixed Value: medical-society
..... display 0..1 string Representation defined by the system
..... userSelected 0..1 boolean If this coding was chosen directly by the user
.... text 0..1 string Plain text representation of the concept

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Organization.type Base example Organization Type 📍6.0.0-ballot3 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Organization If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Organization If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id.trace('id') in %resource.descendants().select(reference | as(uri))) or descendants().where(reference='#' | as(uri)='#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Organization 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-5 error Organization If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Organization A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
org-1 error Organization The organization SHALL at least have a name or an identifier, and possibly more than one (identifier.count() + name.count()) > 0

This structure is derived from Organization

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Organization 0..* Organization A grouping of people or organizations with a common purpose
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:medicalSubjectCategory 0..* CodeableConcept Medical Subject Category
URL: http://fhir.awmf.org/awmf.ig/StructureDefinition/ext-medical-subject-category
.... extension:medicalSubject 0..* CodeableConcept Medical Subject
URL: http://fhir.awmf.org/awmf.ig/StructureDefinition/ext-medical-subject
.... extension:brand 0..1 (Complex) Organization Brand
URL: http://hl7.org/fhir/StructureDefinition/organization-brand
.... extension:organizationPeriod 0..1 Period Extension
URL: http://hl7.org/fhir/StructureDefinition/organization-period
... type 1..* CodeableConcept Kind of organization
Required Pattern: At least the following
.... coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
..... system 1..1 uri Identity of the terminology system
Fixed Value: http://fhir.awmf.org/awmf.ig/CodeSystem/cs-awmf
..... code 1..1 code Symbol in syntax defined by the system
Fixed Value: medical-society

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Organization C 0..* Organization A grouping of people or organizations with a common purpose
Constraints: org-1
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:medicalSubjectCategory 0..* CodeableConcept Medical Subject Category
URL: http://fhir.awmf.org/awmf.ig/StructureDefinition/ext-medical-subject-category
.... extension:medicalSubject 0..* CodeableConcept Medical Subject
URL: http://fhir.awmf.org/awmf.ig/StructureDefinition/ext-medical-subject
.... extension:brand 0..1 (Complex) Organization Brand
URL: http://hl7.org/fhir/StructureDefinition/organization-brand
.... extension:organizationPeriod 0..1 Period Extension
URL: http://hl7.org/fhir/StructureDefinition/organization-period
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
... identifier ΣC 0..* Identifier Identifies this organization across multiple systems
... active ?!Σ 0..1 boolean Whether the organization's record is still in active use
... type Σ 1..* CodeableConcept Kind of organization
Binding: OrganizationType (example): Used to categorize the organization.

Required Pattern: At least the following
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... system 1..1 uri Identity of the terminology system
Fixed Value: http://fhir.awmf.org/awmf.ig/CodeSystem/cs-awmf
..... version 0..1 string Version of the system - if relevant
..... code 1..1 code Symbol in syntax defined by the system
Fixed Value: medical-society
..... display 0..1 string Representation defined by the system
..... userSelected 0..1 boolean If this coding was chosen directly by the user
.... text 0..1 string Plain text representation of the concept
... name ΣC 0..1 string Name used for the organization
... alias 0..* string A list of alternate names that the organization is known as, or was known as in the past
... description Σ 0..1 markdown Additional details about the Organization that could be displayed as further information to identify the Organization beyond its name
... contact C 0..* ExtendedContactDetail Official contact details for the Organization
Constraints: org-3, org-4
... partOf Σ 0..1 Reference(Organization) The organization of which this organization forms a part
... endpoint 0..* Reference(Endpoint) Technical endpoints providing access to services operated for the organization
... qualification 0..* BackboneElement Qualifications, certifications, accreditations, licenses, training, etc. pertaining to the provision of care
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... identifier 0..* Identifier An identifier for this qualification for the organization
.... code 1..1 CodeableConcept Coded representation of the qualification
Binding Description: (example): Specific qualification the organization has to provide a service.
.... status 0..1 CodeableConcept Status/progress of the qualification
Binding: QualificationStatus (preferred): Status of the Qualification
.... period 0..1 Period Period during which the qualification is valid
.... issuer 0..1 Reference(Organization) Organization that regulates and issues the qualification

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Organization.language Base required All Languages 📍6.0.0-ballot3 FHIR Std.
Organization.type Base example Organization Type 📍6.0.0-ballot3 FHIR Std.
Organization.qualification.​code Base example Not State Unknown
Organization.qualification.​status Base preferred Qualification Status 📍6.0.0-ballot3 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Organization If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Organization If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id.trace('id') in %resource.descendants().select(reference | as(uri))) or descendants().where(reference='#' | as(uri)='#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Organization 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-5 error Organization If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Organization A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
org-1 error Organization The organization SHALL at least have a name or an identifier, and possibly more than one (identifier.count() + name.count()) > 0
org-3 error Organization.contact The telecom of an organization can never be of use 'home' telecom.where(use = 'home').empty()
org-4 error Organization.contact The address of an organization can never be of use 'home' address.where(use = 'home').empty()

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Organization C 0..* Organization A grouping of people or organizations with a common purpose
Constraints: org-1
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:medicalSubjectCategory 0..* CodeableConcept Medical Subject Category
URL: http://fhir.awmf.org/awmf.ig/StructureDefinition/ext-medical-subject-category
.... extension:medicalSubject 0..* CodeableConcept Medical Subject
URL: http://fhir.awmf.org/awmf.ig/StructureDefinition/ext-medical-subject
.... extension:brand 0..1 (Complex) Organization Brand
URL: http://hl7.org/fhir/StructureDefinition/organization-brand
.... extension:organizationPeriod 0..1 Period Extension
URL: http://hl7.org/fhir/StructureDefinition/organization-period
... active ?!Σ 0..1 boolean Whether the organization's record is still in active use
... type Σ 1..* CodeableConcept Kind of organization
Binding: OrganizationType (example): Used to categorize the organization.

Required Pattern: At least the following
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... system 1..1 uri Identity of the terminology system
Fixed Value: http://fhir.awmf.org/awmf.ig/CodeSystem/cs-awmf
..... version 0..1 string Version of the system - if relevant
..... code 1..1 code Symbol in syntax defined by the system
Fixed Value: medical-society
..... display 0..1 string Representation defined by the system
..... userSelected 0..1 boolean If this coding was chosen directly by the user
.... text 0..1 string Plain text representation of the concept

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Organization.type Base example Organization Type 📍6.0.0-ballot3 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Organization If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Organization If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id.trace('id') in %resource.descendants().select(reference | as(uri))) or descendants().where(reference='#' | as(uri)='#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Organization 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-5 error Organization If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Organization A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
org-1 error Organization The organization SHALL at least have a name or an identifier, and possibly more than one (identifier.count() + name.count()) > 0

Differential View

This structure is derived from Organization

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Organization 0..* Organization A grouping of people or organizations with a common purpose
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:medicalSubjectCategory 0..* CodeableConcept Medical Subject Category
URL: http://fhir.awmf.org/awmf.ig/StructureDefinition/ext-medical-subject-category
.... extension:medicalSubject 0..* CodeableConcept Medical Subject
URL: http://fhir.awmf.org/awmf.ig/StructureDefinition/ext-medical-subject
.... extension:brand 0..1 (Complex) Organization Brand
URL: http://hl7.org/fhir/StructureDefinition/organization-brand
.... extension:organizationPeriod 0..1 Period Extension
URL: http://hl7.org/fhir/StructureDefinition/organization-period
... type 1..* CodeableConcept Kind of organization
Required Pattern: At least the following
.... coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
..... system 1..1 uri Identity of the terminology system
Fixed Value: http://fhir.awmf.org/awmf.ig/CodeSystem/cs-awmf
..... code 1..1 code Symbol in syntax defined by the system
Fixed Value: medical-society

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Organization C 0..* Organization A grouping of people or organizations with a common purpose
Constraints: org-1
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:medicalSubjectCategory 0..* CodeableConcept Medical Subject Category
URL: http://fhir.awmf.org/awmf.ig/StructureDefinition/ext-medical-subject-category
.... extension:medicalSubject 0..* CodeableConcept Medical Subject
URL: http://fhir.awmf.org/awmf.ig/StructureDefinition/ext-medical-subject
.... extension:brand 0..1 (Complex) Organization Brand
URL: http://hl7.org/fhir/StructureDefinition/organization-brand
.... extension:organizationPeriod 0..1 Period Extension
URL: http://hl7.org/fhir/StructureDefinition/organization-period
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
... identifier ΣC 0..* Identifier Identifies this organization across multiple systems
... active ?!Σ 0..1 boolean Whether the organization's record is still in active use
... type Σ 1..* CodeableConcept Kind of organization
Binding: OrganizationType (example): Used to categorize the organization.

Required Pattern: At least the following
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... coding 1..* Coding Code defined by a terminology system
Fixed Value: (Complex)
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... system 1..1 uri Identity of the terminology system
Fixed Value: http://fhir.awmf.org/awmf.ig/CodeSystem/cs-awmf
..... version 0..1 string Version of the system - if relevant
..... code 1..1 code Symbol in syntax defined by the system
Fixed Value: medical-society
..... display 0..1 string Representation defined by the system
..... userSelected 0..1 boolean If this coding was chosen directly by the user
.... text 0..1 string Plain text representation of the concept
... name ΣC 0..1 string Name used for the organization
... alias 0..* string A list of alternate names that the organization is known as, or was known as in the past
... description Σ 0..1 markdown Additional details about the Organization that could be displayed as further information to identify the Organization beyond its name
... contact C 0..* ExtendedContactDetail Official contact details for the Organization
Constraints: org-3, org-4
... partOf Σ 0..1 Reference(Organization) The organization of which this organization forms a part
... endpoint 0..* Reference(Endpoint) Technical endpoints providing access to services operated for the organization
... qualification 0..* BackboneElement Qualifications, certifications, accreditations, licenses, training, etc. pertaining to the provision of care
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... identifier 0..* Identifier An identifier for this qualification for the organization
.... code 1..1 CodeableConcept Coded representation of the qualification
Binding Description: (example): Specific qualification the organization has to provide a service.
.... status 0..1 CodeableConcept Status/progress of the qualification
Binding: QualificationStatus (preferred): Status of the Qualification
.... period 0..1 Period Period during which the qualification is valid
.... issuer 0..1 Reference(Organization) Organization that regulates and issues the qualification

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Organization.language Base required All Languages 📍6.0.0-ballot3 FHIR Std.
Organization.type Base example Organization Type 📍6.0.0-ballot3 FHIR Std.
Organization.qualification.​code Base example Not State Unknown
Organization.qualification.​status Base preferred Qualification Status 📍6.0.0-ballot3 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Organization If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Organization If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id.trace('id') in %resource.descendants().select(reference | as(uri))) or descendants().where(reference='#' | as(uri)='#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Organization 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-5 error Organization If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Organization A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
org-1 error Organization The organization SHALL at least have a name or an identifier, and possibly more than one (identifier.count() + name.count()) > 0
org-3 error Organization.contact The telecom of an organization can never be of use 'home' telecom.where(use = 'home').empty()
org-4 error Organization.contact The address of an organization can never be of use 'home' address.where(use = 'home').empty()

 

Other representations of profile: CSV, Excel, Schematron