KR Core Implementation Guide
2.0.0 - STU 2

This page is part of the KR Core Implementation Guide (v2.0.0: Release) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

## Extension: KR Core Medication Ingredient Extension

Official URL: http://www.hl7korea.or.kr/fhir/krcore/StructureDefinition/krcore-medicationIngredient | Version: 2.0.0
Standards status: Trial-use | Computable Name: KRCore_MedicationIngredient_Extension

KR Core Medication Ingredient Extension은 KR Core Server와 KR Core Client가 진료정보를 교류할 때 처방정보 내에서 약품 성분명 정보를 표현하는데 사용되며, 이 경우 아래의 조건에 따라 본 Extension을 적용한다.

※ 사용조건

- KR Core MedicationRequest Profile을 적용한 리소스 인스턴스 내에서, `MedicationRequest.medicationCodeableConcept`를 사용하여 약품 제품명을 표현하는 경우에, 동일한 리소스 인스턴스 내에서 반드시(SHALL) 약품 성분명을 함께 표현해야 하며, 이를 위해 반드시(SHALL) 본 Extension을 사용해야 한다.
- KR Core MedicationRequest Profile을 적용한 리소스 인스턴스가 `MedicationRequest.medicationReference`를 사용하여 약품 제품명과 약품 성분명 정보를 간접적으로 제공한 경우에는, 가능한 한(SHOULD) 본 Extension을 사용하지 않는다.

KR CDI V2 약물 정보 클래스에서 정의한 약품 성분명 항목을 표현하기 위해 정의한 Extension.

This extension may be used on the following element(s):

- Element ID MedicationRequest.medication.ofType(CodeableConcept)

Usages:

- 본 확장을 사용: KR Core MedicationRequest Profile
- 본 확장의 예시: MedicationRequest/krcore-medicationrequest-example-02, MedicationRequest/krcore-medicationrequest-example-03 and MedicationRequest/krcore-medicationrequest-example-04
- 본 확장에 대한 검색 인자: KRCoreSearchParameterMedicationRequestIngredientCode

You can also check for usages in the FHIR IG Statistics

### Formal Views of Extension Content

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

- Differential Table
- Snapshot Table
- All

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | KR Core Medication Ingredient Extension
extension |  | 0..0 |  |
url |  | 1..1 | uri | "http://www.hl7korea.or.kr/fhir/krcore/StructureDefinition/krcore-medicationIngredient"
value[x] | S | 1..1 | CodeableConcept | 약품 성분 코드 바인딩(Binding): ATC Codes (preferred)
coding | S | 0..* | Coding | 코드체계에 의해 정의된 코드
system | S | 1..1 | uri | 코드체계 식별자
code | S | 1..1 | code | 코드
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | KR Core Medication Ingredient Extension
id |  | 0..1 | string | 요소 간 참조를 위한 고유 ID
extension |  | 0..0 |  |
url |  | 1..1 | uri | "http://www.hl7korea.or.kr/fhir/krcore/StructureDefinition/krcore-medicationIngredient"
value[x] | S | 1..1 | CodeableConcept | 약품 성분 코드 바인딩(Binding): ATC Codes (preferred)
id |  | 0..1 | string | 요소 간 참조를 위한 고유 ID
extension |  | 0..* | Extension | 추가 정보를 제공하기 위해 정의한 확장(Extension) 목록 분할항목(Slice): 순서 없음, 다음 요소의 값이 다른 임의의 분할항목을 허용:url
coding | S Σ | 0..* | Coding | 코드체계에 의해 정의된 코드
id |  | 0..1 | string | 요소 간 참조를 위한 고유 ID
extension |  | 0..* | Extension | 추가 정보를 제공하기 위해 정의한 확장(Extension) 목록 분할항목(Slice): 순서 없음, 다음 요소의 값이 다른 임의의 분할항목을 허용:url
system | S Σ | 1..1 | uri | 코드체계 식별자
version | Σ | 0..1 | string | 시스템의 버전 - 필요한 경우에 제공
code | S Σ | 1..1 | code | 코드
display | Σ | 0..1 | string | 시스템에서 정의한 표현
userSelected | Σ | 0..1 | boolean | 이 coding을 사용자가 직접 선택한 경우
text | Σ | 0..1 | string | 개념의 일반 텍스트 표현
Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type CodeableConcept: KR Core Medication Ingredient Extension은 KR Core Server와 KR Core Client가 진료정보를 교류할 때 처방정보 내에서 약품 성분명 정보를 표현하는데 사용되며, 이 경우 아래의 조건에 따라 본 Extension을 적용한다.

※ 사용조건

- KR Core MedicationRequest Profile을 적용한 리소스 인스턴스 내에서, `MedicationRequest.medicationCodeableConcept`를 사용하여 약품 제품명을 표현하는 경우에, 동일한 리소스 인스턴스 내에서 반드시(SHALL) 약품 성분명을 함께 표현해야 하며, 이를 위해 반드시(SHALL) 본 Extension을 사용해야 한다.
- KR Core MedicationRequest Profile을 적용한 리소스 인스턴스가 `MedicationRequest.medicationReference`를 사용하여 약품 제품명과 약품 성분명 정보를 간접적으로 제공한 경우에는, 가능한 한(SHOULD) 본 Extension을 사용하지 않는다.

Differential View

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | KR Core Medication Ingredient Extension
extension |  | 0..0 |  |
url |  | 1..1 | uri | "http://www.hl7korea.or.kr/fhir/krcore/StructureDefinition/krcore-medicationIngredient"
value[x] | S | 1..1 | CodeableConcept | 약품 성분 코드 바인딩(Binding): ATC Codes (preferred)
coding | S | 0..* | Coding | 코드체계에 의해 정의된 코드
system | S | 1..1 | uri | 코드체계 식별자
code | S | 1..1 | code | 코드
Documentation for this format

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | KR Core Medication Ingredient Extension
id |  | 0..1 | string | 요소 간 참조를 위한 고유 ID
extension |  | 0..0 |  |
url |  | 1..1 | uri | "http://www.hl7korea.or.kr/fhir/krcore/StructureDefinition/krcore-medicationIngredient"
value[x] | S | 1..1 | CodeableConcept | 약품 성분 코드 바인딩(Binding): ATC Codes (preferred)
id |  | 0..1 | string | 요소 간 참조를 위한 고유 ID
extension |  | 0..* | Extension | 추가 정보를 제공하기 위해 정의한 확장(Extension) 목록 분할항목(Slice): 순서 없음, 다음 요소의 값이 다른 임의의 분할항목을 허용:url
coding | S Σ | 0..* | Coding | 코드체계에 의해 정의된 코드
id |  | 0..1 | string | 요소 간 참조를 위한 고유 ID
extension |  | 0..* | Extension | 추가 정보를 제공하기 위해 정의한 확장(Extension) 목록 분할항목(Slice): 순서 없음, 다음 요소의 값이 다른 임의의 분할항목을 허용:url
system | S Σ | 1..1 | uri | 코드체계 식별자
version | Σ | 0..1 | string | 시스템의 버전 - 필요한 경우에 제공
code | S Σ | 1..1 | code | 코드
display | Σ | 0..1 | string | 시스템에서 정의한 표현
userSelected | Σ | 0..1 | boolean | 이 coding을 사용자가 직접 선택한 경우
text | Σ | 0..1 | string | 개념의 일반 텍스트 표현
Documentation for this format

Other representations of profile: CSV, Excel, Schematron

#### Terminology Bindings

Path | Conformance | ValueSet | URI
Extension.value[x] | preferred | KR_Core_ATC_Codes `http://www.hl7korea.or.kr/fhir/krcore/ValueSet/krcore-atc-codes` From this IG

#### Constraints

Id | Grade | Path(s) | Details | Requirements
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() |