KR Core Implementation Guide
3.0.0-ballot - STU 3 Korea, Republic of flag

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

Change Log

Page standards status: Informative

Version = 3.0.0-ballot

  • Publication Date: 2026-10-27
  • Status: active
  • Sequence: STU 3
  • Based on FHIR version: 4.0.1

Changes:

  1. KR Core 메타데이터 수정
    • 현행 정의 리소스의 버전·발행일 관리를 정비하고, 발행 상태를 active로 설정. 사용 중단된 Profile의 retired 상태는 유지
    • hl7.fhir.uv.smart-app-launch 의존성 버전을 2.2.0으로 변경
  2. 프로파일(Profile) 추가, 대체 및 주요 변경
  3. 확장(Extension) 추가 및 변경
  4. 코드체계(CodeSystem), 명명체계(NamingSystem) 및 코드집합(ValueSet) 변경
  5. CapabilityStatement 및 SearchParameter 변경
  6. 예제 및 설명 문서 보강
    • 음주상태와 흡연상태를 개별 Observation으로 표현하는 예제와 hasMember로 여러 평가 결과를 묶는 예제를 추가
    • KCD-9와 SNOMED CT, LOINC와 MDC 등 복수 코드체계를 함께 사용하는 만성폐쇄성폐질환 정기 외래 진료 시나리오 예제를 추가
    • 검체검사, 예방접종, 연명의료 의향 및 마취 정보의 예제를 추가하거나 변경된 정의에 맞게 정비
    • 신규·변경 Profile의 KR CDI 관련항목 매핑과 사용 지침을 정비하고, 진단검사·병리검사 항목의 통합 대응표, 연명의료 의향 코드집합 안내 및 마취 정보 표현 예시를 제공
    • 사용 중단된 Profile을 Deprecated Profiles 목록으로 분리하고, 프로파일 표, 코드 블록, 추가 바인딩 및 코드집합의 표시 방식을 개선
    • FHIR IG Statistics 링크 오류로 Profile 페이지의 XIG 사용 현황 링크를 일시적으로 제거
    • 문서 전반의 KR CDI 항목명, 범용 Profile의 사용 범위와 주의사항, 용어, 오탈자, 내부 링크 및 매핑 경로를 정비


Version = 2.0.0

Changes:

  1. 일부 페이지의 텍스트 수정


Version = 2.0.0-ballot-final

Changes:

  1. 사용되고 있지 않던 KR Core Specimen Type Codes 용어집합 삭제


Version = 2.0.0-ballot2

Changes:

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


Version = 2.0.0-ballot

Changes:

  1. 신규 KR Core 프로파일(Profile)
  2. 신규 KR Core 확장(Extension)
  3. 신규 코드체계(CodeSystem)
  4. 신규 코드집합(ValueSet)
  5. 슬라싱 제거 및 바인딩 방식 변경
  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) 정의 변경
  14. 처리 지침(Obligation) 추가
  15. 데이터 부재 사유(Data Absent Reason) 문서 및 예시 추가
  16. Key Terms 문서 추가


Version = 1.0.2

Changes:

  1. CodeSystem.url 오타 수정
  2. package.json의 url 값이 올바른 KR Core IG URL을 가리키도록 수정


Version = 1.0.1

Changes:

  1. KR Core Condition Profile for Encounter Diagnosis 정의 및 페이지 수정
  2. KR Core Condition Profile for Chief Complaint 페이지 수정
  3. krcore-diagnosisDateTime 확장 삭제
  4. krcore-sp-condition-diagnosis-date search parameter 삭제
  5. krcore-sp-condition-recorded-date search parameter 추가
  6. KR Core Server CapabilityStatement 정의 수정
  7. KR Core Client CapabilityStatement 정의 수정
  8. Search Parameters 페이지 수정


Version = 1.0.0

Changes:

  1. IG Home 페이지 수정
  2. General Requirements 페이지 수정
  3. Mandatory and Must Support 페이지 수정
  4. General Guidance 페이지 수정
    • 전체적인 표현 통일
  5. Terminology 페이지 수정
  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 수정
  13. KR Core DiagnosticReport Profile for Diagnostic Imaging 수정
  14. KR Core DiagnosticReport Profile for Functional Tests 수정
  15. KR Core DiagnosticReport Profile for Laboratory Results 수정
  16. KR Core DiagnosticReport Profile for Pathology Results 수정
  17. KR Core Immunization Profile 수정
  18. KR Core Medication Profile 수정
  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 수정
  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 수정
  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

Changes:

Initial Version