SGHI FHIR Profile Implementation Guide
0.1.0 - ci-build

SGHI FHIR Profile Implementation Guide, published by Kathurima Kimathi. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/savannahghi/sil_fhir_profile_ig/ and changes regularly. See the Directory of published versions

## Data Type Profile: SGHI CodeableConcept

Official URL: https://fhir.slade360.co.ke/fhir/StructureDefinition/codeableconcept | Version: 0.1.0
Draft as of 2026-05-21 | Computable Name: SGHICodeableConcept

A CodeableConcept represents a value that is usually supplied by providing a reference to one or more terminologies or ontologies but may also be defined by the provision of text. This is a common pattern in healthcare data.

Usages:

- Use this DataType Profile: SGHI Activity Defintion Profile, SGHI AllergyIntolerance, SGHI Appointment Profile, SGHI Care Plan... Show 26 more, SGHI CodeableReference, SGHI Composition, SGHI Condition, SGHI Consent, SGHI DiagnosticReport, SGHI DocumentReference Profile., SGHI Dosage, SGHI Encounter, SGHI EpisodeOfCare, SGHI Location, SGHI Medication, SGHI Medication Dispense, SGHI MedicationRequest, SGHI Observation, SGHI Organization, SGHI Patient, SGHI Plan Definition Profile, SGHI Practitioner, SGHI PractitionerRole, SGHI Procedure, SGHI QuestionnaireResponse, SGHI RiskAssessment, SGHI ServiceRequest, SGHI Specimen, SGHI Substance and SGHI Task

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.

- Key Elements Table
- Differential Table
- Snapshot Table
- Statistics/References
- All

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
CodeableConcept |  | 0..* | CodeableConcept | Concept - reference to a terminology or just text
coding | Σ | 1..* | Coding | Code defined by a terminology system
system | Σ | 1..1 | uri | Identity of the terminology system
code | Σ C | 1..1 | code | Symbol in syntax defined by the system
display | Σ C | 1..1 | string | Representation defined by the system
Documentation for this format

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`

This structure is derived from CodeableConcept

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
CodeableConcept |  |  | CodeableConcept |
coding |  | 1..* | Coding | Code defined by a terminology system
system |  | 1..1 | uri | Identity of the terminology system
code |  | 1..1 | code | Symbol in syntax defined by the system
display |  | 1..1 | string | Representation defined by the system
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
CodeableConcept |  | 0..* | CodeableConcept | Concept - reference to a terminology or just text
id |  | 0..1 | id | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
coding | Σ | 1..* | Coding | Code defined by a terminology system
id |  | 0..1 | id | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | Σ | 1..1 | uri | Identity of the terminology system
version | Σ | 0..1 | string | Version of the system - if relevant
code | Σ C | 1..1 | code | Symbol in syntax defined by the system
display | Σ C | 1..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
Documentation for this format

#### Constraints

Id | Grade | Path(s) | Description | Expression
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()`

This structure is derived from CodeableConcept

Summary

Mandatory: 4 elements

Key Elements View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
CodeableConcept |  | 0..* | CodeableConcept | Concept - reference to a terminology or just text
coding | Σ | 1..* | Coding | Code defined by a terminology system
system | Σ | 1..1 | uri | Identity of the terminology system
code | Σ C | 1..1 | code | Symbol in syntax defined by the system
display | Σ C | 1..1 | string | Representation defined by the system
Documentation for this format

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`

Differential View

This structure is derived from CodeableConcept

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
CodeableConcept |  |  | CodeableConcept |
coding |  | 1..* | Coding | Code defined by a terminology system
system |  | 1..1 | uri | Identity of the terminology system
code |  | 1..1 | code | Symbol in syntax defined by the system
display |  | 1..1 | string | Representation defined by the system
Documentation for this format

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
CodeableConcept |  | 0..* | CodeableConcept | Concept - reference to a terminology or just text
id |  | 0..1 | id | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
coding | Σ | 1..* | Coding | Code defined by a terminology system
id |  | 0..1 | id | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | Σ | 1..1 | uri | Identity of the terminology system
version | Σ | 0..1 | string | Version of the system - if relevant
code | Σ C | 1..1 | code | Symbol in syntax defined by the system
display | Σ C | 1..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
Documentation for this format

#### Constraints

Id | Grade | Path(s) | Description | Expression
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()`

This structure is derived from CodeableConcept

Summary

Mandatory: 4 elements

Other representations of profile: CSV, Excel, Schematron