Uzbekistan Digital Health Platform
0.13.0 - ci-build
Uzbekistan Digital Health Platform, published by Ministry of Health of the Republic of Uzbekistan. This guide is not an authorized publication; it is the continuous build for version 0.13.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/uzinfocom-org/digital-health-ig/ and changes regularly. See the Directory of published versions
| Official URL: https://dhp.uz/fhir/core/StructureDefinition/uz-core-composition | Version: 0.13.0 | ||||
| Active as of 2026-03-05 | Computable Name: UZCoreComposition | ||||
UZ Core Composition profile, used as a foundation for creating medical documents and digital forms
UZ Core Composition is the header of a medical document or digital form: a patient's medical record, a register, a certificate, a signed report. It says what kind of document it is (type, from the national list of medical document forms), whom it is about, who wrote it, who attested it and which organization keeps it, and it organises the content into titled sections. Each section has a human-readable text and references the resources that hold the data, such as a Condition, an Observation or a DiagnosticReport; the Composition points to them rather than copying them. A finalised document is sent as a document Bundle with the Composition as its first entry and signed through a Provenance; how documents are assembled and signed is specified in the DHP Integrations IG. Store ongoing clinical facts as their own resources, and use a Composition only when you need a finalised document.
The elements below must always be present (mandatory) or must be supported when the data is available (Must Support). Not all of them are required, but your system must populate each Must Support element when it has the data, and process it on receipt. This is the human-readable summary; the formal views below give the exact cardinalities, types and terminology bindings.
status (preliminary / final / amended / entered-in-error …);type;date the document was last edited;author;title.These all come from the base resource. Each attester must have a mode, and each section text, when present, must have a status and a div.
status and the document type (the form from the national list of medical documents);category (medical record / register / form);subject), usually the patient;date, the authors (practitioner, role, organization, related person, patient or device) and the title;attesters: how they attested (personal / professional / legal / official) and who they are (party);custodian);sections, each with its title, code, author, narrative text, the order of its entries (orderedBy), the entry references, and why it is empty (emptyReason).The examples below go from the smallest valid Composition to one with sections. Each one validates against this profile. The complete reference instance is the medical record composition.
A Composition needs a status, a type, a date, an author and a title:
{
"resourceType": "Composition",
"meta": { "profile": ["https://dhp.uz/fhir/core/StructureDefinition/uz-core-composition"] },
"language": "uz",
"status": "final",
"type": {
"coding": [
{
"system": "https://terminology.dhp.uz/fhir/core/CodeSystem/composition-type-cs",
"code": "emdoc-0010-0003",
"display": "BEMORNING TIBBIY KARTASI №"
}
]
},
"date": "2026-03-05T10:00:00+05:00",
"author": [ { "reference": "PractitionerRole/example-practitionerrole" } ],
"title": "Bemorning elektron tibbiy kartasi"
}
type must come from the national medical document types, here emdoc-0010-0003 (patient medical record). That code system is in Uzbek, so a display you send must be the Uzbek one and the resource must say "language": "uz"; or leave display out. date changes whenever the document is edited; author repeats when several people or systems wrote it.
A medical record is about a patient, is attested by the clinician responsible for it, and is kept by a health facility:
{
"resourceType": "Composition",
"meta": { "profile": ["https://dhp.uz/fhir/core/StructureDefinition/uz-core-composition"] },
"language": "uz",
"status": "final",
"type": {
"coding": [
{
"system": "https://terminology.dhp.uz/fhir/core/CodeSystem/composition-type-cs",
"code": "emdoc-0010-0003",
"display": "BEMORNING TIBBIY KARTASI №"
}
]
},
"category": [
{
"coding": [
{
"system": "https://terminology.dhp.uz/fhir/core/CodeSystem/composition-category-cs",
"code": "Comp-001-0001",
"display": "Tibbiy karta"
}
]
}
],
"subject": [ { "reference": "Patient/example-salim" } ],
"date": "2026-03-05T10:00:00+05:00",
"author": [ { "reference": "PractitionerRole/example-practitionerrole" } ],
"title": "Bemorning elektron tibbiy kartasi",
"attester": [
{
"mode": { "coding": [ { "system": "http://hl7.org/fhir/composition-attestation-mode", "code": "legal" } ] },
"time": "2026-03-05T10:15:00+05:00",
"party": { "reference": "PractitionerRole/example-practitionerrole" }
}
],
"custodian": { "reference": "Organization/tashkent-hospital" }
}
category takes a code from the national document categories (medical record / register / form); codes from other systems may sit beside it. attester.mode is required whenever an attester is given. The attestation is a statement in the document; the digital signature that gives it legal force is a separate Provenance.
Each section has a title, a code saying what it contains, a narrative text, and entry references to the resources behind it. A section with nothing to report keeps its text and gives an emptyReason instead of entries:
{
"resourceType": "Composition",
"meta": { "profile": ["https://dhp.uz/fhir/core/StructureDefinition/uz-core-composition"] },
"language": "uz",
"status": "final",
"type": {
"coding": [
{ "system": "https://terminology.dhp.uz/fhir/core/CodeSystem/composition-type-cs", "code": "emdoc-0010-0003" }
]
},
"subject": [ { "reference": "Patient/example-salim" } ],
"date": "2026-03-05T10:00:00+05:00",
"author": [ { "reference": "PractitionerRole/example-practitionerrole" } ],
"title": "Bemorning elektron tibbiy kartasi",
"section": [
{
"title": "Anamnez",
"code": { "coding": [ { "system": "http://loinc.org", "code": "10164-2" } ] },
"author": [ { "reference": "PractitionerRole/example-practitionerrole" } ],
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Bosh og'rig'i, 3 kundan beri.</div>"
},
"orderedBy": { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/list-order", "code": "event-date" } ] },
"entry": [ { "reference": "Condition/example-headache" } ]
},
{
"title": "Allergiyalar",
"code": { "coding": [ { "system": "http://loinc.org", "code": "48765-2" } ] },
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Ma'lum allergiyalar yo'q.</div>"
},
"emptyReason": {
"coding": [ { "system": "http://terminology.hl7.org/CodeSystem/list-empty-reason", "code": "nilknown" } ]
}
}
]
}
A section must have at least one of text, entry or nested section, and emptyReason is only allowed when the section has no entries. Section codes are usually LOINC document section codes, here 10164-2 (history of present illness) and 48765-2 (allergies). text.status is generated when the narrative is produced from the entries, additional when it says more than they do. orderedBy tells the reader how the entries are sorted, here by event date. Section author is only needed when it differs from the document author.
For example API calls, see the Quick Start at the bottom of this page.
Usages:
You can also check for usages in the FHIR IG Statistics
Description Differentials, Snapshots, and other representations.
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() |
|---|---|---|---|---|
![]() |
0..* | Composition(5.0.0) | A set of resources composed into a single coherent clinical statement with clinical attestation | |
![]() ![]() |
0..1 | uri | A set of rules under which this content was created | |
![]() ![]() |
0..* | Resource | Contained, inline Resources | |
![]() ![]() |
0..* | Extension | Extensions that cannot be ignored Constraints: ext-1 | |
![]() ![]() |
1..1 | code | registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown Binding: CompositionStatusVS (0.13.0) (required) | |
![]() ![]() |
1..1 | CodeableConcept | Kind of composition (LOINC if possible) Binding: CompositionTypeVS (0.13.0) (required) | |
![]() ![]() |
0..* | CodeableConcept | Categorization of Composition Slice: Unordered, Open by value:$this Binding: CompositionCategoryVS (0.13.0) (preferred) Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |
![]() ![]() ![]() |
0..* | CodeableConcept | Category from the national value set Binding: CompositionCategoryVS (0.13.0) (required) | |
![]() ![]() |
0..* | Reference(Resource) | Who and/or what the medical document or digital form is about. | |
![]() ![]() |
1..1 | dateTime | Composition editing time | |
![]() ![]() |
1..* | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0) | UZ Core Device(0.13.0)) | Who and/or what authored the composition | |
![]() ![]() |
1..1 | string | Human Readable name/title | |
![]() ![]() |
0..* | BackboneElement | Attests to accuracy of composition | |
![]() ![]() ![]() |
0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | |
![]() ![]() ![]() |
1..1 | CodeableConcept | personal | professional | legal | official Binding: CompositionAttModeVS (0.13.0) (preferred) | |
![]() ![]() ![]() |
0..1 | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) | Who attested the composition | |
![]() ![]() |
0..1 | Reference(UZ Core Organization(0.13.0)) | Organization which maintains the composition | |
![]() ![]() |
C | 0..* | BackboneElement | Composition is broken into sections Constraints: cmp-1, cmp-2 |
![]() ![]() ![]() |
0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | |
![]() ![]() ![]() |
0..1 | string | Label for section (e.g. for ToC) | |
![]() ![]() ![]() |
0..1 | CodeableConcept | Classification of section (recommended) Binding: DocumentSectionCodes (example): Classification of a section of a composition/document. | |
![]() ![]() ![]() |
0..* | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) | Who and/or what authored the section | |
![]() ![]() ![]() |
C | 0..1 | Narrative | Text summary of the section, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements |
![]() ![]() ![]() ![]() |
1..1 | code | generated | extensions | additional | empty Binding: CompositionNarrativeStatusVS (0.13.0) (required) | |
![]() ![]() ![]() ![]() |
C | 1..1 | xhtml | Limited xhtml content Constraints: txt-1, txt-2 |
![]() ![]() ![]() |
0..1 | CodeableConcept | Order of section entries Binding: CompositionListOrderVS (0.13.0) (preferred) | |
![]() ![]() ![]() |
C | 0..* | Reference(Resource) | A reference to data that supports this section |
![]() ![]() ![]() |
C | 0..1 | CodeableConcept | Why the section is empty Binding: CompositionListEmptyReasonVS (0.13.0) (required) |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Composition.status | Base | required | Composition status | 📍0.13.0 | This IG |
| Composition.type | Base | required | Composition type | 📍0.13.0 | This IG |
| Composition.category | Base | preferred | Composition category | 📍0.13.0 | This IG |
| Composition.category:dhpCategory | Base | required | Composition category | 📍0.13.0 | This IG |
| Composition.attester.mode | Base | preferred | Composition attestation mode | 📍0.13.0 | This IG |
| Composition.section.code | Base | example | Document Section Codes | 📍5.0.0 | FHIR Std. |
| Composition.section.text.status | Base | required | Composition narrative status | 📍0.13.0 | This IG |
| Composition.section.orderedBy | Base | preferred | Composition list order | 📍0.13.0 | This IG |
| Composition.section.emptyReason | Base | required | Composition list empty reason | 📍0.13.0 | This IG |
| Id | Grade | Path(s) | Description | Expression |
This structure is derived from Composition
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() |
|---|---|---|---|---|
![]() |
0..* | Composition(5.0.0) | A set of resources composed into a single coherent clinical statement with clinical attestation | |
![]() ![]() |
1..1 | code | registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown Binding: CompositionStatusVS (0.13.0) (required) | |
![]() ![]() |
1..1 | CodeableConcept | Kind of composition (LOINC if possible) Binding: CompositionTypeVS (0.13.0) (required) | |
![]() ![]() |
0..* | CodeableConcept | Categorization of Composition Slice: Unordered, Open by value:$this Binding: CompositionCategoryVS (0.13.0) (preferred) Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |
![]() ![]() ![]() |
0..* | CodeableConcept | Category from the national value set Binding: CompositionCategoryVS (0.13.0) (required) | |
![]() ![]() |
0..* | Reference(Resource) | Who and/or what the medical document or digital form is about. | |
![]() ![]() |
1..1 | dateTime | Composition editing time | |
![]() ![]() |
1..* | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0) | UZ Core Device(0.13.0)) | Who and/or what authored the composition | |
![]() ![]() |
1..1 | string | Human Readable name/title | |
![]() ![]() |
0..* | BackboneElement | Attests to accuracy of composition | |
![]() ![]() ![]() |
1..1 | CodeableConcept | personal | professional | legal | official Binding: CompositionAttModeVS (0.13.0) (preferred) | |
![]() ![]() ![]() |
0..1 | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) | Who attested the composition | |
![]() ![]() |
0..1 | Reference(UZ Core Organization(0.13.0)) | Organization which maintains the composition | |
![]() ![]() |
0..* | BackboneElement | Composition is broken into sections | |
![]() ![]() ![]() |
0..1 | string | Label for section (e.g. for ToC) | |
![]() ![]() ![]() |
0..1 | CodeableConcept | Classification of section (recommended) | |
![]() ![]() ![]() |
0..* | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) | Who and/or what authored the section | |
![]() ![]() ![]() |
0..1 | Narrative | Text summary of the section, for human interpretation | |
![]() ![]() ![]() ![]() |
1..1 | code | generated | extensions | additional | empty Binding: CompositionNarrativeStatusVS (0.13.0) (required) | |
![]() ![]() ![]() ![]() |
1..1 | xhtml | Limited xhtml content | |
![]() ![]() ![]() |
0..1 | CodeableConcept | Order of section entries Binding: CompositionListOrderVS (0.13.0) (preferred) | |
![]() ![]() ![]() |
0..* | Reference(Resource) | A reference to data that supports this section | |
![]() ![]() ![]() |
0..1 | CodeableConcept | Why the section is empty Binding: CompositionListEmptyReasonVS (0.13.0) (required) | |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Composition.status | Base | required | Composition status | 📍0.13.0 | This IG |
| Composition.type | Base | required | Composition type | 📍0.13.0 | This IG |
| Composition.category | Base | preferred | Composition category | 📍0.13.0 | This IG |
| Composition.category:dhpCategory | Base | required | Composition category | 📍0.13.0 | This IG |
| Composition.attester.mode | Base | preferred | Composition attestation mode | 📍0.13.0 | This IG |
| Composition.section.text.status | Base | required | Composition narrative status | 📍0.13.0 | This IG |
| Composition.section.orderedBy | Base | preferred | Composition list order | 📍0.13.0 | This IG |
| Composition.section.emptyReason | Base | required | Composition list empty reason | 📍0.13.0 | This IG |
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() | ||||
|---|---|---|---|---|---|---|---|---|
![]() |
0..* | Composition(5.0.0) | A set of resources composed into a single coherent clinical statement with clinical attestation | |||||
![]() ![]() |
0..1 | id | Logical id of this artifact | |||||
![]() ![]() |
0..1 | Meta | Metadata about the resource | |||||
![]() ![]() |
0..1 | uri | A set of rules under which this content was created | |||||
![]() ![]() |
0..1 | code | Language of the resource content Binding: AllLanguages (required): IETF language tag for a human language
| |||||
![]() ![]() |
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 | |||||
![]() ![]() |
0..* | Resource | Contained, inline Resources | |||||
![]() ![]() |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
![]() ![]() |
0..* | Extension | Extensions that cannot be ignored Constraints: ext-1 | |||||
![]() ![]() |
0..1 | uri | Canonical identifier for this Composition, represented as a URI (globally unique) | |||||
![]() ![]() |
0..* | Identifier | Version-independent identifier for the Composition | |||||
![]() ![]() |
0..1 | string | An explicitly assigned identifer of a variation of the content in the Composition | |||||
![]() ![]() |
1..1 | code | registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown Binding: CompositionStatusVS (0.13.0) (required) | |||||
![]() ![]() |
1..1 | CodeableConcept | Kind of composition (LOINC if possible) Binding: CompositionTypeVS (0.13.0) (required) | |||||
![]() ![]() |
0..* | CodeableConcept | Categorization of Composition Slice: Unordered, Open by value:$this Binding: CompositionCategoryVS (0.13.0) (preferred) Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |||||
![]() ![]() ![]() |
0..* | CodeableConcept | Category from the national value set Binding: CompositionCategoryVS (0.13.0) (required) | |||||
![]() ![]() |
0..* | Reference(Resource) | Who and/or what the medical document or digital form is about. | |||||
![]() ![]() |
0..1 | Reference(Encounter) | Context of the Composition | |||||
![]() ![]() |
1..1 | dateTime | Composition editing time | |||||
![]() ![]() |
0..* | UsageContext | The context that the content is intended to support | |||||
![]() ![]() |
1..* | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0) | UZ Core Device(0.13.0)) | Who and/or what authored the composition | |||||
![]() ![]() |
0..1 | string | Name for this Composition (computer friendly) | |||||
![]() ![]() |
1..1 | string | Human Readable name/title | |||||
![]() ![]() |
0..* | Annotation | For any additional notes | |||||
![]() ![]() |
0..* | BackboneElement | Attests to accuracy of composition | |||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
![]() ![]() ![]() |
0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | |||||
![]() ![]() ![]() |
1..1 | CodeableConcept | personal | professional | legal | official Binding: CompositionAttModeVS (0.13.0) (preferred) | |||||
![]() ![]() ![]() |
0..1 | dateTime | When the composition was attested | |||||
![]() ![]() ![]() |
0..1 | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) | Who attested the composition | |||||
![]() ![]() |
0..1 | Reference(UZ Core Organization(0.13.0)) | Organization which maintains the composition | |||||
![]() ![]() |
0..* | RelatedArtifact | Relationships to other compositions/documents | |||||
![]() ![]() |
0..* | BackboneElement | The clinical service(s) being documented | |||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
![]() ![]() ![]() |
0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | |||||
![]() ![]() ![]() |
0..1 | Period | The period covered by the documentation | |||||
![]() ![]() ![]() |
0..* | CodeableReference(Resource) | The event(s) being documented, as code(s), reference(s), or both Binding: ActCode (3.0.0) (example): This list of codes represents the main clinical acts being documented. | |||||
![]() ![]() |
C | 0..* | BackboneElement | Composition is broken into sections Constraints: cmp-1, cmp-2 | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
![]() ![]() ![]() |
0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | |||||
![]() ![]() ![]() |
0..1 | string | Label for section (e.g. for ToC) | |||||
![]() ![]() ![]() |
0..1 | CodeableConcept | Classification of section (recommended) Binding: DocumentSectionCodes (example): Classification of a section of a composition/document. | |||||
![]() ![]() ![]() |
0..* | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) | Who and/or what authored the section | |||||
![]() ![]() ![]() |
0..1 | Reference(Resource) | Who/what the section is about, when it is not about the subject of composition | |||||
![]() ![]() ![]() |
C | 0..1 | Narrative | Text summary of the section, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | ||||
![]() ![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||
![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1 | |||||
![]() ![]() ![]() ![]() |
1..1 | code | generated | extensions | additional | empty Binding: CompositionNarrativeStatusVS (0.13.0) (required) | |||||
![]() ![]() ![]() ![]() |
C | 1..1 | xhtml | Limited xhtml content Constraints: txt-1, txt-2 | ||||
![]() ![]() ![]() |
0..1 | CodeableConcept | Order of section entries Binding: CompositionListOrderVS (0.13.0) (preferred) | |||||
![]() ![]() ![]() |
C | 0..* | Reference(Resource) | A reference to data that supports this section | ||||
![]() ![]() ![]() |
C | 0..1 | CodeableConcept | Why the section is empty Binding: CompositionListEmptyReasonVS (0.13.0) (required) | ||||
![]() ![]() ![]() |
0..* | See section (Composition) | Nested Section | |||||
Documentation for this format | ||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| Composition.language | Base | required | All Languages | 📍5.0.0 | FHIR Std. |
| Composition.status | Base | required | Composition status | 📍0.13.0 | This IG |
| Composition.type | Base | required | Composition type | 📍0.13.0 | This IG |
| Composition.category | Base | preferred | Composition category | 📍0.13.0 | This IG |
| Composition.category:dhpCategory | Base | required | Composition category | 📍0.13.0 | This IG |
| Composition.attester.mode | Base | preferred | Composition attestation mode | 📍0.13.0 | This IG |
| Composition.event.detail | Base | example | v3 Code System ActCode | 📍3.0.0 | THO v7.5 |
| Composition.section.code | Base | example | Document Section Codes | 📍5.0.0 | FHIR Std. |
| Composition.section.text.status | Base | required | Composition narrative status | 📍0.13.0 | This IG |
| Composition.section.orderedBy | Base | preferred | Composition list order | 📍0.13.0 | This IG |
| Composition.section.emptyReason | Base | required | Composition list empty reason | 📍0.13.0 | This IG |
| Id | Grade | Path(s) | Description | Expression |
This structure is derived from Composition
Summary
Must-Support: 22 elements
Structures
This structure refers to these other structures:
Slices
This structure defines the following Slices:
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() |
|---|---|---|---|---|
![]() |
0..* | Composition(5.0.0) | A set of resources composed into a single coherent clinical statement with clinical attestation | |
![]() ![]() |
0..1 | uri | A set of rules under which this content was created | |
![]() ![]() |
0..* | Resource | Contained, inline Resources | |
![]() ![]() |
0..* | Extension | Extensions that cannot be ignored Constraints: ext-1 | |
![]() ![]() |
1..1 | code | registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown Binding: CompositionStatusVS (0.13.0) (required) | |
![]() ![]() |
1..1 | CodeableConcept | Kind of composition (LOINC if possible) Binding: CompositionTypeVS (0.13.0) (required) | |
![]() ![]() |
0..* | CodeableConcept | Categorization of Composition Slice: Unordered, Open by value:$this Binding: CompositionCategoryVS (0.13.0) (preferred) Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |
![]() ![]() ![]() |
0..* | CodeableConcept | Category from the national value set Binding: CompositionCategoryVS (0.13.0) (required) | |
![]() ![]() |
0..* | Reference(Resource) | Who and/or what the medical document or digital form is about. | |
![]() ![]() |
1..1 | dateTime | Composition editing time | |
![]() ![]() |
1..* | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0) | UZ Core Device(0.13.0)) | Who and/or what authored the composition | |
![]() ![]() |
1..1 | string | Human Readable name/title | |
![]() ![]() |
0..* | BackboneElement | Attests to accuracy of composition | |
![]() ![]() ![]() |
0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | |
![]() ![]() ![]() |
1..1 | CodeableConcept | personal | professional | legal | official Binding: CompositionAttModeVS (0.13.0) (preferred) | |
![]() ![]() ![]() |
0..1 | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) | Who attested the composition | |
![]() ![]() |
0..1 | Reference(UZ Core Organization(0.13.0)) | Organization which maintains the composition | |
![]() ![]() |
C | 0..* | BackboneElement | Composition is broken into sections Constraints: cmp-1, cmp-2 |
![]() ![]() ![]() |
0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | |
![]() ![]() ![]() |
0..1 | string | Label for section (e.g. for ToC) | |
![]() ![]() ![]() |
0..1 | CodeableConcept | Classification of section (recommended) Binding: DocumentSectionCodes (example): Classification of a section of a composition/document. | |
![]() ![]() ![]() |
0..* | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) | Who and/or what authored the section | |
![]() ![]() ![]() |
C | 0..1 | Narrative | Text summary of the section, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements |
![]() ![]() ![]() ![]() |
1..1 | code | generated | extensions | additional | empty Binding: CompositionNarrativeStatusVS (0.13.0) (required) | |
![]() ![]() ![]() ![]() |
C | 1..1 | xhtml | Limited xhtml content Constraints: txt-1, txt-2 |
![]() ![]() ![]() |
0..1 | CodeableConcept | Order of section entries Binding: CompositionListOrderVS (0.13.0) (preferred) | |
![]() ![]() ![]() |
C | 0..* | Reference(Resource) | A reference to data that supports this section |
![]() ![]() ![]() |
C | 0..1 | CodeableConcept | Why the section is empty Binding: CompositionListEmptyReasonVS (0.13.0) (required) |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Composition.status | Base | required | Composition status | 📍0.13.0 | This IG |
| Composition.type | Base | required | Composition type | 📍0.13.0 | This IG |
| Composition.category | Base | preferred | Composition category | 📍0.13.0 | This IG |
| Composition.category:dhpCategory | Base | required | Composition category | 📍0.13.0 | This IG |
| Composition.attester.mode | Base | preferred | Composition attestation mode | 📍0.13.0 | This IG |
| Composition.section.code | Base | example | Document Section Codes | 📍5.0.0 | FHIR Std. |
| Composition.section.text.status | Base | required | Composition narrative status | 📍0.13.0 | This IG |
| Composition.section.orderedBy | Base | preferred | Composition list order | 📍0.13.0 | This IG |
| Composition.section.emptyReason | Base | required | Composition list empty reason | 📍0.13.0 | This IG |
| Id | Grade | Path(s) | Description | Expression |
Differential View
This structure is derived from Composition
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() |
|---|---|---|---|---|
![]() |
0..* | Composition(5.0.0) | A set of resources composed into a single coherent clinical statement with clinical attestation | |
![]() ![]() |
1..1 | code | registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown Binding: CompositionStatusVS (0.13.0) (required) | |
![]() ![]() |
1..1 | CodeableConcept | Kind of composition (LOINC if possible) Binding: CompositionTypeVS (0.13.0) (required) | |
![]() ![]() |
0..* | CodeableConcept | Categorization of Composition Slice: Unordered, Open by value:$this Binding: CompositionCategoryVS (0.13.0) (preferred) Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |
![]() ![]() ![]() |
0..* | CodeableConcept | Category from the national value set Binding: CompositionCategoryVS (0.13.0) (required) | |
![]() ![]() |
0..* | Reference(Resource) | Who and/or what the medical document or digital form is about. | |
![]() ![]() |
1..1 | dateTime | Composition editing time | |
![]() ![]() |
1..* | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0) | UZ Core Device(0.13.0)) | Who and/or what authored the composition | |
![]() ![]() |
1..1 | string | Human Readable name/title | |
![]() ![]() |
0..* | BackboneElement | Attests to accuracy of composition | |
![]() ![]() ![]() |
1..1 | CodeableConcept | personal | professional | legal | official Binding: CompositionAttModeVS (0.13.0) (preferred) | |
![]() ![]() ![]() |
0..1 | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) | Who attested the composition | |
![]() ![]() |
0..1 | Reference(UZ Core Organization(0.13.0)) | Organization which maintains the composition | |
![]() ![]() |
0..* | BackboneElement | Composition is broken into sections | |
![]() ![]() ![]() |
0..1 | string | Label for section (e.g. for ToC) | |
![]() ![]() ![]() |
0..1 | CodeableConcept | Classification of section (recommended) | |
![]() ![]() ![]() |
0..* | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) | Who and/or what authored the section | |
![]() ![]() ![]() |
0..1 | Narrative | Text summary of the section, for human interpretation | |
![]() ![]() ![]() ![]() |
1..1 | code | generated | extensions | additional | empty Binding: CompositionNarrativeStatusVS (0.13.0) (required) | |
![]() ![]() ![]() ![]() |
1..1 | xhtml | Limited xhtml content | |
![]() ![]() ![]() |
0..1 | CodeableConcept | Order of section entries Binding: CompositionListOrderVS (0.13.0) (preferred) | |
![]() ![]() ![]() |
0..* | Reference(Resource) | A reference to data that supports this section | |
![]() ![]() ![]() |
0..1 | CodeableConcept | Why the section is empty Binding: CompositionListEmptyReasonVS (0.13.0) (required) | |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| Composition.status | Base | required | Composition status | 📍0.13.0 | This IG |
| Composition.type | Base | required | Composition type | 📍0.13.0 | This IG |
| Composition.category | Base | preferred | Composition category | 📍0.13.0 | This IG |
| Composition.category:dhpCategory | Base | required | Composition category | 📍0.13.0 | This IG |
| Composition.attester.mode | Base | preferred | Composition attestation mode | 📍0.13.0 | This IG |
| Composition.section.text.status | Base | required | Composition narrative status | 📍0.13.0 | This IG |
| Composition.section.orderedBy | Base | preferred | Composition list order | 📍0.13.0 | This IG |
| Composition.section.emptyReason | Base | required | Composition list empty reason | 📍0.13.0 | This IG |
Snapshot ViewView
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() | ||||
|---|---|---|---|---|---|---|---|---|
![]() |
0..* | Composition(5.0.0) | A set of resources composed into a single coherent clinical statement with clinical attestation | |||||
![]() ![]() |
0..1 | id | Logical id of this artifact | |||||
![]() ![]() |
0..1 | Meta | Metadata about the resource | |||||
![]() ![]() |
0..1 | uri | A set of rules under which this content was created | |||||
![]() ![]() |
0..1 | code | Language of the resource content Binding: AllLanguages (required): IETF language tag for a human language
| |||||
![]() ![]() |
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 | |||||
![]() ![]() |
0..* | Resource | Contained, inline Resources | |||||
![]() ![]() |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
![]() ![]() |
0..* | Extension | Extensions that cannot be ignored Constraints: ext-1 | |||||
![]() ![]() |
0..1 | uri | Canonical identifier for this Composition, represented as a URI (globally unique) | |||||
![]() ![]() |
0..* | Identifier | Version-independent identifier for the Composition | |||||
![]() ![]() |
0..1 | string | An explicitly assigned identifer of a variation of the content in the Composition | |||||
![]() ![]() |
1..1 | code | registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown Binding: CompositionStatusVS (0.13.0) (required) | |||||
![]() ![]() |
1..1 | CodeableConcept | Kind of composition (LOINC if possible) Binding: CompositionTypeVS (0.13.0) (required) | |||||
![]() ![]() |
0..* | CodeableConcept | Categorization of Composition Slice: Unordered, Open by value:$this Binding: CompositionCategoryVS (0.13.0) (preferred) Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them | |||||
![]() ![]() ![]() |
0..* | CodeableConcept | Category from the national value set Binding: CompositionCategoryVS (0.13.0) (required) | |||||
![]() ![]() |
0..* | Reference(Resource) | Who and/or what the medical document or digital form is about. | |||||
![]() ![]() |
0..1 | Reference(Encounter) | Context of the Composition | |||||
![]() ![]() |
1..1 | dateTime | Composition editing time | |||||
![]() ![]() |
0..* | UsageContext | The context that the content is intended to support | |||||
![]() ![]() |
1..* | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0) | UZ Core Device(0.13.0)) | Who and/or what authored the composition | |||||
![]() ![]() |
0..1 | string | Name for this Composition (computer friendly) | |||||
![]() ![]() |
1..1 | string | Human Readable name/title | |||||
![]() ![]() |
0..* | Annotation | For any additional notes | |||||
![]() ![]() |
0..* | BackboneElement | Attests to accuracy of composition | |||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
![]() ![]() ![]() |
0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | |||||
![]() ![]() ![]() |
1..1 | CodeableConcept | personal | professional | legal | official Binding: CompositionAttModeVS (0.13.0) (preferred) | |||||
![]() ![]() ![]() |
0..1 | dateTime | When the composition was attested | |||||
![]() ![]() ![]() |
0..1 | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) | Who attested the composition | |||||
![]() ![]() |
0..1 | Reference(UZ Core Organization(0.13.0)) | Organization which maintains the composition | |||||
![]() ![]() |
0..* | RelatedArtifact | Relationships to other compositions/documents | |||||
![]() ![]() |
0..* | BackboneElement | The clinical service(s) being documented | |||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
![]() ![]() ![]() |
0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | |||||
![]() ![]() ![]() |
0..1 | Period | The period covered by the documentation | |||||
![]() ![]() ![]() |
0..* | CodeableReference(Resource) | The event(s) being documented, as code(s), reference(s), or both Binding: ActCode (3.0.0) (example): This list of codes represents the main clinical acts being documented. | |||||
![]() ![]() |
C | 0..* | BackboneElement | Composition is broken into sections Constraints: cmp-1, cmp-2 | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Constraints: ext-1 | |||||
![]() ![]() ![]() |
0..* | Extension | Extensions that cannot be ignored even if unrecognized Constraints: ext-1 | |||||
![]() ![]() ![]() |
0..1 | string | Label for section (e.g. for ToC) | |||||
![]() ![]() ![]() |
0..1 | CodeableConcept | Classification of section (recommended) Binding: DocumentSectionCodes (example): Classification of a section of a composition/document. | |||||
![]() ![]() ![]() |
0..* | Reference(UZ Core PractitionerRole(0.13.0) | UZ Core Practitioner(0.13.0) | UZ Core Organization(0.13.0) | UZ Core RelatedPerson(0.13.0) | UZ Core Patient(0.13.0)) | Who and/or what authored the section | |||||
![]() ![]() ![]() |
0..1 | Reference(Resource) | Who/what the section is about, when it is not about the subject of composition | |||||
![]() ![]() ![]() |
C | 0..1 | Narrative | Text summary of the section, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | ||||
![]() ![]() ![]() ![]() |
0..1 | id | Unique id for inter-element referencing | |||||
![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1 | |||||
![]() ![]() ![]() ![]() |
1..1 | code | generated | extensions | additional | empty Binding: CompositionNarrativeStatusVS (0.13.0) (required) | |||||
![]() ![]() ![]() ![]() |
C | 1..1 | xhtml | Limited xhtml content Constraints: txt-1, txt-2 | ||||
![]() ![]() ![]() |
0..1 | CodeableConcept | Order of section entries Binding: CompositionListOrderVS (0.13.0) (preferred) | |||||
![]() ![]() ![]() |
C | 0..* | Reference(Resource) | A reference to data that supports this section | ||||
![]() ![]() ![]() |
C | 0..1 | CodeableConcept | Why the section is empty Binding: CompositionListEmptyReasonVS (0.13.0) (required) | ||||
![]() ![]() ![]() |
0..* | See section (Composition) | Nested Section | |||||
Documentation for this format | ||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| Composition.language | Base | required | All Languages | 📍5.0.0 | FHIR Std. |
| Composition.status | Base | required | Composition status | 📍0.13.0 | This IG |
| Composition.type | Base | required | Composition type | 📍0.13.0 | This IG |
| Composition.category | Base | preferred | Composition category | 📍0.13.0 | This IG |
| Composition.category:dhpCategory | Base | required | Composition category | 📍0.13.0 | This IG |
| Composition.attester.mode | Base | preferred | Composition attestation mode | 📍0.13.0 | This IG |
| Composition.event.detail | Base | example | v3 Code System ActCode | 📍3.0.0 | THO v7.5 |
| Composition.section.code | Base | example | Document Section Codes | 📍5.0.0 | FHIR Std. |
| Composition.section.text.status | Base | required | Composition narrative status | 📍0.13.0 | This IG |
| Composition.section.orderedBy | Base | preferred | Composition list order | 📍0.13.0 | This IG |
| Composition.section.emptyReason | Base | required | Composition list empty reason | 📍0.13.0 | This IG |
| Id | Grade | Path(s) | Description | Expression |
This structure is derived from Composition
Summary
Must-Support: 22 elements
Structures
This structure refers to these other structures:
Slices
This structure defines the following Slices:
Other representations of profile: CSV, Excel, Schematron
Common API interactions for this profile. Requests require a JWT access token - see Security and authentication. [base] is the FHIR server base URL; | separates a code system from its value and must be URL-encoded as %7C.
Read a composition by server id, and its earlier versions
GET [base]/Composition/[id]
GET [base]/Composition/[id]/_history
Search
GET [base]/Composition?patient=Patient/[id]
GET [base]/Composition?patient=Patient/[id]&type=https://terminology.dhp.uz/fhir/core/CodeSystem/composition-type-cs%7Cemdoc-0010-0003
GET [base]/Composition?patient=Patient/[id]&category=https://terminology.dhp.uz/fhir/core/CodeSystem/composition-category-cs%7CComp-001-0001
GET [base]/Composition?patient=Patient/[id]&status=final&date=ge2026-01-01
GET [base]/Composition?author=PractitionerRole/[id]
GET [base]/Composition?encounter=Encounter/[id]
GET [base]/Composition?entry=Condition/[id]
GET [base]/Composition?section=http://loinc.org%7C48765-2
GET [base]/Composition?patient=Patient/[id]&_include=Composition:entry
The last query returns the compositions together with the resources their sections reference.
Create a composition
POST [base]/Composition
{
"resourceType": "Composition",
"meta": { "profile": [ "https://dhp.uz/fhir/core/StructureDefinition/uz-core-composition" ] },
"language": "uz",
"status": "preliminary",
"type": { "coding": [ { "system": "https://terminology.dhp.uz/fhir/core/CodeSystem/composition-type-cs", "code": "..." } ] },
"subject": [ { "reference": "Patient/[id]" } ],
"date": "...",
"author": [ { "reference": "PractitionerRole/[id]" } ],
"title": "...",
"section": [ ... ]
}
Update an existing composition (e.g. set status to final once the document is complete, or to amended after a change)
PUT [base]/Composition/[id]
If-Match: W/"3" # the ETag from your last read; 412 if it changed since
{
"resourceType": "Composition",
"id": "[id]",
"meta": { "profile": [ "https://dhp.uz/fhir/core/StructureDefinition/uz-core-composition" ] },
"status": "final",
...
}
Update date with every change. Assembling and signing finalised documents is specified in the DHP Integrations IG.
See the CapabilityStatement for the full list of supported search parameters.