KR Core Implementation Guide
2.0.0-ballot2 - STU 2

This page is part of the KR Core Implementation Guide (v2.0.0-ballot2: STU 2 Ballot 2) based on FHIR (HL7® FHIR® Standard) R4. This version is a pre-release. The current official version is 1.0.2. For a full list of available versions, see the Directory of published versions

## Change Log

Page standards status: Informative

### Version = 2.0.0-ballot2

- Publication Date: 2025-07-31
- ​url: http://www.hl7korea.or.kr/fhir/krcore/2025July
- Based on FHIR version: 4.0.1

#### Changes:

1. KR CDI 문서 추가
2. Terminology 문서의 External Links 문단 업데이트
3. 그 외 문서 내용 보충 및 예제 추가

### Version = 2.0.0-ballot

- Publication Date: 2025-06-26
- ​url: http://www.hl7korea.or.kr/fhir/krcore/2025July
- Based on FHIR version: 4.0.1

#### Changes:

1. 신규 KR Core 프로파일(Profile)
   - KR Core Organization Profile
   - KR Core Practitioner Profile
   - KR Core PractitionerRole Profile
   - KR Core Specimen Profile
2. 신규 KR Core 확장(Extension)
   - KR Core Medication Ingredient Extension
3. 신규 코드체계(CodeSystem)
   - KR Core Procedure Category Types
4. 신규 코드집합(ValueSet)
   - KR Core SNOMED CT Codes
   - KR Core LOINC Codes
   - KR Core Diagnostic Imaging Codes
   - KR Core Laboratory Codes
   - KR Core Pathology Codes
   - KR Core Procedure Category Codes
   - KR Core Procedure Codes
   - KR Core Specimen Type Codes
5. 슬라싱 제거 및 바인딩 방식 변경
   - 아래 항목들의 슬라이싱을 제거하고, 바인딩 강도를 이용해 용어 사용 필수 여부를 표현하도록 변경
     - KR Core AllergyItolerance Profile: AllergyItolerance.code
       - 바인딩 코드집합: ATC Codes
       - 바인딩 강도: Preferred
     - KR Core Condition Profile for Encounter Diagnosis: Condition.code
       - 바인딩 코드집합: KR Core Condition Category Codes
       - 바인딩 강도: Extensible
     - KR Core DiagnosticReport Profile for Diagnostic Imaging: DiagnosticReport.code
       - 바인딩 코드집합: KR Core Diagnostic Imaging Codes (신규)
       - 바인딩 강도: Extensible
     - KR Core DiagnosticReport Profile for Functional Tests: DiagnosticReport.code
       - 바인딩 코드집합: KR Core EDI Procedure Codes
       - 바인딩 강도: Extensible
     - KR Core DiagnosticReport Profile for Laboratory Results: DiagnosticReport.code
       - 바인딩 코드집합: KR Core Laboratory Codes
       - 바인딩 강도: Extensible
     - KR Core DiagnosticReport Profile for Pathology Results: DiagnosticReport.code
       - 바인딩 코드집합: KR Core Pathology Codes
       - 바인딩 강도: Extensible
     - KR Core Observation Profile for Functional Test: Observation.code
       - 바인딩 코드집합: KR Core EDI Procedure Codes
       - 바인딩 강도: Extensible
     - KR Core Observation Profile for Laboratory Result: Observation.code
       - 바인딩 코드집합: KR Core Laboratory Codes
       - 바인딩 강도: Extensible
     - KR Core Medication Profile: Medication.code
       - 바인딩 코드집합: KR Core EDI Medication Codes
       - 바인딩 강도: Extensible
     - KR Core Medication Profile: Medication.ingredient.itemCodeableConcept
       - 바인딩 코드집합: ATC Codes
       - 바인딩 강도: Preferred
     - KR Core Healthcare Organization Profile: Organization.type
       - 바인딩 코드집합: KR Core Organization Type Codes
       - 바인딩 강도: Required
     - KR Core Procedure Profile: Procedure.code
       - 바인딩 코드집합: KR Core Procedure Codes
       - 바인딩 강도: Extensible
     - KR Core Insurance Types Extension: Extension.valueCodeableConcept
       - 바인딩 코드집합: KR Core Insurance Types Codes
       - 바인딩 강도: Required
6. KR Core Observation Profile for Vital Signs: Blood Pressure 수정 사항
   - 요소별 허용 개수(Cardinality) 수정
   - Observation.componenet:Systolic
   - 기존: 1..1
   - 현재: 0..1
   - Observation.componenet:Diastolic
   - 기존: 1..1
   - 현재: 0..1
7. KR Core Condition Profile for Encounter Diagnosis 추가 수정 사항
   - 요소별 허용 개수(Cardinality) 수정
   - Condition.clinicalStatus
   - 기존: 1..1
   - 현재: 0..1
8. KR Core DiagnosticReport Profile for Laboratory Results 추가 수정 사항
   - 신규 요소
   - DiagnosticReport.specimen
9. KR Core DiagnosticReport Profile for Pathology Results 추가 수정 사항
   - 신규 요소
   - DiagnosticReport.specimen
10. KR Core Observation Profile for Laboratory Result 추가 수정 사항
    - 신규 요소
    - Observation.specimen
11. KR Core MedicationRequest Profile 추가 수정 사항
    - 신규 요소
    - MedicationRequest.medicationCodeableConcept
    - 추가 사유: KR Core IG 외 국내 진료정보교류 관련 표준들과 호환성을 확보하기 위해 추가함
    - MedicationRequest.medicationCodeableConcept.extension('http://www.hl7korea.or.kr/fhir/krcore/StructureDefinition/krcore-medicationIngredient')
    - 추가 사유: MedicationRequest.medicationCodeableConcept 요소를 사용한 경우, 해당 약품의 약품성분명 정보를 제공하기 위해 추가함
12. KR Core Procedure Profile 추가 수정 사항
    - 신규 요소
    - Procedure.category
    - Procedure.partOf
13. 필수 지원 요소(Must Support Element) 정의 변경
    - 필수 지원 요소(Must Support Element) 참고
14. 처리 지침(Obligation) 추가
    - KR Core Patient Profile에 시범 적용
    - 처리 지침(Obligation) 참고
    - Actor Definitions 참고
15. 데이터 부재 사유(Data Absernt Reason) 문서 및 예시 추가
    - 데이터 부재 사유(Data Absernt Reason) 참고
    - 참고 예시
    - 환자 정보 예제 - 개인정보보호
    - 환자 정보 예제 - 신원미확인
    - 진료의 정보 예제 02 - 개인정보보호
16. Key Terms 문서 추가

### Version = 1.0.2

- Publication Date: 2023-12-04
- ​url: http://www.hl7korea.or.kr/fhir/krcore/STU1.0.2
- Based on FHIR version: 4.0.1

#### Changes:

1. CodeSystem.url 오타 수정
   - ​HIRA EDI Material의 url 값을 다음과 같이 수정
     - 이전: http://www.hl7korea.or.kr/fhir/krcore/CodeSystem/hira-edi-material
     - ​현재: http://www.hl7korea.or.kr/CodeSystem/hira-edi-material
   - ​HIRA EDI Medication의 url 값을 다음과 같이 수정
     - 이전: http://www.hl7korea.or.kr/fhir/krcore/CodeSystem/hira-edi-medication
     - ​현재: http://www.hl7korea.or.kr/CodeSystem/hira-edi-medication
   - ​HIRA EDI Procedure의 url 값을 다음과 같이 수정
     - 이전: http://www.hl7korea.or.kr/fhir/krcore/CodeSystem/hira-edi-procedure
     - ​현재: http://www.hl7korea.or.kr/CodeSystem/hira-edi-procedure
   - ​KOSTAT KCD-8의 url 값을 다음과 같이 수정
     - 이전: http://www.hl7korea.or.kr/fhir/krcore/CodeSystem/kostat-kcd-8
     - ​현재: http://www.hl7korea.or.kr/CodeSystem/kostat-kcd-8
   - ​KPIS Korea Drug Code의 url 값을 다음과 같이 수정
     - 이전: http://www.hl7korea.or.kr/fhir/krcore/CodeSystem/kpis-kdcode
     - ​현재: http://www.hl7korea.or.kr/CodeSystem/kpis-kdcode
2. package.json의 url 값이 올바른 KR Core IG URL을 가리키도록 수정

### Version = 1.0.1

- Publication Date: 2023-06-30
- ​url: http://www.hl7korea.or.kr/fhir/krcore/STU1.0.1
- Based on FHIR version: 4.0.1

#### Changes:

1. KR Core Condition Profile for Encounter Diagnosis 정의 및 페이지 수정
   - ​KR CDI 항목 정의 변경을 반영하기 위해, 진단일자를 표현하기 위한 항목을 krcore-diagnosisDateTime에서 recordedDate로 변경
   - 위 변경사항을 반영하여, KR CDI 관련항목 수정
   - ​KR Core Search Parameters (defined) 항목 및 해당 항목의 krcore-sp-condition-diagnosis-date search parameter 링크 제거
   - KR Core Search Parameters (derived) 항목에 krcore-sp-condition-recorded-date search parameter 링크 추가
2. KR Core Condition Profile for Chief Complaint 페이지 수정
   - ​KR Core Search Parameters (defined) 항목 및 해당 항목의 krcore-sp-condition-diagnosis-date search parameter 링크 제거
   - KR Core Search Parameters (derived) 항목에 krcore-sp-condition-recorded-date search parameter 링크 추가
3. ​ krcore-diagnosisDateTime 확장 삭제
4. ​ krcore-sp-condition-diagnosis-date search parameter 삭제
5. krcore-sp-condition-recorded-date search parameter 추가
6. KR Core Server CapabilityStatement 정의 수정
   - ​krcore-sp-condition-diagnosis-date search parameter 구현 기대치 삭제
   - krcore-sp-condition-recorded-date search parameter 구현 기대치 추가
7. KR Core Client CapabilityStatement 정의 수정
   - ​krcore-sp-condition-diagnosis-date search parameter 구현 기대치 삭제
   - krcore-sp-condition-recorded-date search parameter 구현 기대치 추가
8. Search Parameters 페이지 수정
   - ​krcore-sp-condition-diagnosis-date search parameter 링크 제거
   - krcore-sp-condition-recorded-date search parameter 링크 추가

### Version = 1.0.0

- Publication Date: 2023-06-19
- ​url: http://www.hl7korea.or.kr/fhir/krcore/STU1
- Based on FHIR version: 4.0.1

#### Changes:

1. ​ IG Home 페이지 수정
   - KR Core IG는 HL7 FHIR R4를 기반으로함을 명시
   - 개발 주체가 한국보건의료정보원과 HL7 Korea임을 명시
   - ​ 소개 수정
   - ​ 배경 수정
   - ​ 문서의 내용 및 안내 수정
2. ​ General Requirements 페이지 수정
   - ​ KR Core Conformance Artifacts 단락에 Profiles and Extensions 페이지 링크 추가
   - 전체적인 표현 통일
3. ​ Mandatory and Must Support 페이지 수정
   - 의무 요소와 필수 지원 요소에 대한 설명을 KR Core 1.0.0 버전의 정의에 맞게 수정
   - ​ 의무 요소 및 필수 지원 요소 지정 규칙 단락 추가
4. ​ General Guidance 페이지 수정
   - 전체적인 표현 통일
5. ​ Terminology 페이지 수정
   - ​HL7 FHIR R4 기본 CodeSystem, ValueSet 링크 추가
6. ​ Downloads 페이지 수정
   - ​ Examples 단락의 예제 다운로드 시, 압축파일에 예제가 아닌 리소스들이 포함되어 있는 오류를 수정
7. ​ KR Core Server CapabilityStatement 페이지 수정
   - KR Core Server의 기능별 지원 기대치 테이블 추가
8. ​ KR Core Client CapabilityStatement 페이지 수정
   - KR Core Client의 기능별 지원 기대치 테이블 추가
9. ​ CodeSystem: MOHW Practitioner Qualification Types 수정
   - class 속성 삭제
   - display 오타 수정
10. ​ KR Core AllergyIntolerance Profile 수정
    - AllergyIntolerance.code 설명을 '알레르기 및 불내성 반응 원인물질'에서 '알레르기 및 불내성 반응 원인물질 및 증상'으로 수정
    - AllergyIntolerance.code에 example 강도로 바인딩 된 ValueSet을 SubstanceCode에서 AllergyIntoleranceSubstance/Product,ConditionAndNegationCodes으로 수정
    - AllergyIntolerance.code.coding:ATC slicing의 최대 사용 횟수를 무제한에서 1로 감소
    - AllergyIntolerance.code.coding:ATC slicing의 system 값을 다음 값으로 명시: http://www.whocc.no/atc
11. ​ KR Core Condition Profile for Chief Complaint 수정
    - Condition.code 최소 사용 횟수 0에서 1로 증가 및 HL7 FHIR R4 사양으로 제공되는 기본 ValueSet을 명시
12. ​ KR Core Condition Profile for Encounter Diagnosis 수정
    - Condition.code.coding:KCD-8 slicing의 system 값을 다음 값으로 명시: http://www.hl7korea.or.kr/CodeSystem/kostat-kcd-8
13. ​ KR Core DiagnosticReport Profile for Diagnostic Imaging 수정
    - DiagnosticReport.code.coding:EDI slicing의 최소 사용 횟수를 1에서 0으로 완화
    - DiagnosticReport.code.coding:EDI slicing의 system 값을 다음 값으로 명시: http://www.hl7korea.or.kr/CodeSystem/hira-edi-procedure
14. ​ KR Core DiagnosticReport Profile for Functional Tests 수정
    - DiagnosticReport.code.coding:EDI slicing의 최소 사용 횟수를 1에서 0으로 완화
    - DiagnosticReport.code.coding:EDI slicing의 system 값을 다음 값으로 명시: http://www.hl7korea.or.kr/CodeSystem/hira-edi-procedure
15. ​ KR Core DiagnosticReport Profile for Laboratory Results 수정
    - DiagnosticReport.code.coding:EDI slicing의 최소 사용 횟수를 1에서 0으로 완화
    - DiagnosticReport.code.coding:EDI slicing의 system 값을 다음 값으로 명시: http://www.hl7korea.or.kr/CodeSystem/hira-edi-procedure
16. ​ KR Core DiagnosticReport Profile for Pathology Results 수정
    - DiagnosticReport.code.coding:EDI slicing의 최소 사용 횟수를 1에서 0으로 완화
    - DiagnosticReport.code.coding:EDI slicing의 system 값을 다음 값으로 명시: http://www.hl7korea.or.kr/CodeSystem/hira-edi-procedure
17. ​ KR Core Immunization Profile 수정
    - Immunization.vaccineCode.coding:VcntType slicing의 system 값을 다음 값으로 명시: http://www.hl7korea.or.kr/fhir/krcore/CodeSystem/krcore-vcnt-types
    - Immunization.vaccineCode.coding:KDCode slicing의 system 값을 다음 값으로 명시: http://www.hl7korea.or.kr/CodeSystem/kpis-kdcode
18. ​ KR Core Medication Profile 수정
    - Medication.code.coding:EDI slicing의 최소 사용 횟수를 1에서 0으로 완화
    - Medication.code.coding:EDI slicing의 system 값을 다음 값으로 명시: http://www.hl7korea.or.kr/CodeSystem/hira-edi-medication
    - Medication.itemCodeableConcept.coding:ATC slicing의 system 값을 다음 값으로 명시: http://www.whocc.no/atc
19. ​ KR Core Observation Profile for Functional Test 수정
    - 사용처에 대한 설명을 다음과 같이 변경: KR Core의 기능검사 측정 정보에 적용되는 Observation 구조. 기능검사는 진단검사, 영상검사, 병리검사를 제외한 검사를 의미함. (예: 과내검사)
    - Observation.code.coding:EDI slicing의 최소 사용 횟수를 1에서 0으로 완화
    - Observation.code.coding:EDI slicing의 system 값을 다음 값으로 명시: http://www.hl7korea.or.kr/CodeSystem/hira-edi-procedure
20. ​ KR Core Observation Profile for Laboratory Result 수정
    - Observation.code.coding:EDI slicing의 최소 사용 횟수를 1에서 0으로 완화
    - Observation.code.coding:EDI slicing의 system 값을 다음 값으로 명시: http://www.hl7korea.or.kr/CodeSystem/hira-edi-procedure
21. ​ KR Core Observation Profile for Vital Signs 수정
    - Observation.code.coding:Loinc slicing의 system 값을 다음 값으로 명시: http://loinc.org
    - Observation.componenet.code.coding:Loinc slicing의 system 값을 다음 값으로 명시: http://loinc.org
22. ​ KR Core Patient Profile 수정
    - Patient.contact.address에 krcore-roadNameAddress 확장을 추가
    - ​ krcore-patient-example-02를 수정하여, 병원에서 임의의 identifier를 정의하고 환자 ID를 사용하는 예를 추가.
23. ​ KR Core Practitioner Profile for Medical Doctor 수정
    - Practitioner.address에 krcore-roadNameAddress 확장을 추가
    - ​Practitioner.qualification.code.coding의 slicing을 제거하고, Practitioner.qualification.code에 KR Core Doctor Qualification Codes을 preferred 강도로 바인딩
24. ​ KR Core Procedure Profile 수정
    - Procedure.code.coding:EDI slicing의 최소 사용 횟수를 1에서 0으로 완화
    - Procedure.code.coding:EDI slicing의 system 값을 다음 값으로 명시: http://www.hl7korea.or.kr/CodeSystem/hira-edi-procedure
25. Search Parameters
    - ​Condition 리소스의 diagnosis-date search parameter 설명을 '주호소 진단일자'에서 '진단일자'로 수정
26. 각 페이지 상단에 HL7 Korea 로고 및 HL7 FHIR 로고 추가
27. Snapshot Table의 미번역 된 설명을 번역
28. Differential Table 및 Snapshot Table의 간격 수정

### Version = 1.0.0-ballot

- Publication Date: 2023-05-19
- ​url: http://www.hl7korea.or.kr/fhir/krcore/2023June
- Based on FHIR version: 4.0.1

#### Changes:

Initial Version