Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.3.0 - STU1 Draft
Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.3.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| URL chính thức: http://fhir.hl7.org.vn/core/CapabilityStatement/vn-core-server | Phiên bản: 0.3.0 | ||||
| Computable Name: VNCoreServerCapabilityStatement | |||||
Máy chủ FHIR tuân thủ VN Core IG PHẢI đáp ứng tối thiểu các yêu cầu được liệt kê dưới đây. Đây là CapabilityStatement yêu cầu mức cơ sở; khi triển khai theo từng vai trò cụ thể nên tham chiếu thêm VNCoreEMRServer, VNBHYTGatewayClient, VNBHYTGatewayServer, hoặc VNCitizenAppClient.
Raw OpenAPI-Swagger Definition file | Tải xuống
Language: vi
json, xmlNote to Implementers: FHIR Capabilities
Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.
serverMáy chủ FHIR tuân thủ VN Core IG. Hỗ trợ JSON và XML. Yêu cầu xác thực theo SMART on FHIR hoặc OAuth 2.0. Tuân thủ Luật 91/2025 về bảo vệ dữ liệu cá nhân.
SMART-on-FHIRHệ thống PHẢI tuân thủ Luật 91/2025/QH15 (BVDLCN) và NĐ 356/2025/NĐ-CP. Dữ liệu y tế = DLCN nhạy cảm. Xem Bảo mật và Quyền riêng tư.
| Conformance | Operation | Documentation |
|---|---|---|
| SHALL | $validate-bhyt-claim | |
| SHALL | $submit-bhyt-claim | |
| SHALL | $reverse-bhyt-claim |
The summary table lists the resources that are part of this configuration, and for each resource it lists:
_include_revincluderead, search-type, create, update.Bệnh nhân Việt Nam — VNCorePatient profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | identifier | token | Tìm theo CCCD, mã BHXH, GKS, hộ chiếu, MRN hoặc định danh khác |
| SHALL | name | string | Tìm theo họ tên (hỗ trợ Unicode tiếng Việt) |
| SHALL | birthdate | date | |
| SHALL | gender | token | |
| SHALL | vn-cccd | token | Tìm theo số CCCD 12 chữ số (Luật Căn cước 2023) |
| SHALL | vn-bhyt | token | Tìm theo số thẻ BHYT (Luật BHYT) |
| SHALL | vn-vneid | token | Tìm theo tài khoản định danh điện tử VNeID |
| SHALL | vn-bhxh | token | Tìm theo mã số BHXH 10 chữ số |
| SHALL | vn-gks | token | Tìm theo số Giấy khai sinh |
read, search-type, create, update.Cha/mẹ/người giám hộ/người đại diện — VNCoreRelatedPerson profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | Tìm RelatedPerson theo bệnh nhân liên quan |
| SHALL | identifier | token | Tìm theo CCCD, VNeID hoặc hộ chiếu của người liên quan |
| SHALL | name | string |
read, search-type.Nhân viên y tế — VNCorePractitioner profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | identifier | token | Tìm theo GPHN hiện hành, CCCD, hoặc CCHN lịch sử |
| SHALL | name | string | |
| SHALL | vn-gphn | token | Tìm theo số Giấy phép hành nghề khám bệnh, chữa bệnh hiện hành |
| SHALL | vn-cchn | token | Tìm theo số Chứng chỉ hành nghề lịch sử khi chuyển đổi dữ liệu cũ |
read, search-type.Vai trò nhân viên y tế — VNCorePractitionerRole profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | practitioner | reference | |
| SHALL | organization | reference | |
| SHALL | location | reference |
read, search-type.Cơ sở KCB — VNCoreOrganization profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | identifier | token | Tìm theo mã CSKCB |
| SHALL | name | string | |
| SHALL | vn-cskcb | token | Tìm theo mã cơ sở KCB 5 số (QĐ 3176/QĐ-BYT) |
read, search-type, create, update.Khoa/phòng/địa điểm cung cấp dịch vụ — VNCoreLocation profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | identifier | token | Tìm theo mã khoa/phòng hoặc mã địa điểm nội bộ |
| SHALL | organization | reference | Tìm các Location thuộc một Organization |
| SHALL | partof | reference | Tìm các Location con |
| SHALL | name | string | Tìm theo tên khoa/phòng/địa điểm |
read, search-type, create, update.Lượt khám/điều trị — VNCoreEncounter profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | |
| SHALL | date | date | |
| SHALL | status | token | |
| SHALL | class | token | |
| SHALL | vn-malydo | token | Tìm theo loại KCB BHYT — MALYDO (QĐ 3176/QĐ-BYT) |
| SHALL | vn-ma-luot-kcb | token | Tìm theo Identifier MA_LUOT_KCB dùng đối soát BHXH; system khuyến nghị = http://fhir.hl7.org.vn/core/sid/ma-luot-kcb |
read, search-type, create.Chẩn đoán — VNCoreCondition profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | |
| SHALL | code | token | Tìm theo mã ICD-10 VN hoặc Mã U (YHCT) |
| SHALL | encounter | reference | |
| SHALL | vn-icd10 | token | Tìm theo mã ICD-10 (QĐ 4469/QĐ-BYT, QĐ 98/QĐ-BYT) |
Sinh hiệu VN Core — VN Core Observation Vital Signs Profile
Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile
read, search-type, create.Kết quả xét nghiệm, sinh hiệu, và quan sát YHCT — VNCoreObservationLab + VNCoreObservationVitalSigns + VNCoreObservationYHCT profiles
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | |
| SHALL | code | token | Tìm theo LOINC code |
| SHALL | date | date | |
| SHALL | category | token |
read, search-type, create, update.Mẫu bệnh phẩm — VNCoreSpecimen profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | subject | reference | Tìm theo bệnh nhân cung cấp mẫu |
| SHALL | type | token | Tìm theo loại mẫu bệnh phẩm |
| SHALL | accession | token | Tìm theo mã tiếp nhận mẫu tại phòng xét nghiệm |
read, search-type, create.Dị ứng — VNCoreAllergyIntolerance profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | |
| SHALL | clinical-status | token |
read, search-type, create.Thủ thuật/phẫu thuật — VNCoreProcedure profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | |
| SHALL | code | token | Tìm theo mã ICD-9-CM |
| SHALL | date | date |
read, search-type.Thẻ BHYT — VNCoreCoverage profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | beneficiary | reference | Tìm theo bệnh nhân thụ hưởng BHYT |
| SHALL | identifier | token | Tìm theo số thẻ BHYT qua Coverage.identifier (CCCD/BHXH/format cũ) |
| SHALL | subscriber | reference | Tìm theo subscriber của Coverage |
| SHALL | status | token | |
| SHALL | vn-bhyt-card | token | Tìm theo số thẻ BHYT trong Coverage.identifier[BHYT] (NĐ 188/2025/NĐ-CP) |
| SHALL | vn-ma-dkbd | token | Tìm theo mã nơi ĐKKCB ban đầu MA_DKBD |
read, search-type, create, update.Yêu cầu thanh toán KCB BHYT — VNCoreClaim profile (QĐ 3176 → QĐ 697)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | Tìm theo bệnh nhân |
| SHALL | provider | reference | Tìm theo cơ sở KCB |
| SHALL | status | token | |
| SHALL | created | date | Tìm theo ngày tạo yêu cầu |
| SHALL | vn-ma-lk | token | Tìm theo mã liên kết hồ sơ MA_LK |
read, search-type, create.Nhật ký truy cập/chia sẻ dữ liệu y tế — VNCoreAuditEvent profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | date | date | Tìm theo thời điểm ghi nhận audit |
| SHALL | patient | reference | Tìm audit liên quan tới bệnh nhân |
| SHALL | agent | reference | Tìm theo người/hệ thống thực hiện hành động |
read, search-type, create.Nguồn gốc và chữ ký số của tài liệu/hồ sơ y tế — VNCoreProvenance profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | target | reference | Tìm theo resource đích được ký/xác nhận |
| SHALL | recorded | date | Tìm theo thời điểm ghi nhận provenance |
read, search-type, create, update.Đơn thuốc — VNCoreMedicationRequest profile (TT 13/2025, Luật Dược 2016)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | Tìm theo bệnh nhân |
| SHALL | status | token | |
| SHALL | intent | token | |
| SHALL | authoredon | date | Tìm theo ngày kê đơn |
| SHALL | medication | reference | Tìm theo thuốc |
read, search-type, create, update.Yêu cầu DVKT/CLS — VNCoreServiceRequest profile (TT 13/2025, TT 20/2014)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | Tìm theo bệnh nhân |
| SHALL | status | token | |
| SHALL | category | token | Tìm theo loại dịch vụ (XN, CĐHA, PT, TT...) |
| SHALL | code | token | Tìm theo mã DVKT / ICD-9-CM |
| SHALL | authored | date | Tìm theo ngày chỉ định |
read, search-type, create.Tài liệu y tế / Bệnh án điện tử — VNCoreDocumentReference profile (TT 13/2025)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | Tìm theo bệnh nhân |
| SHALL | type | token | Tìm theo loại tài liệu |
| SHALL | date | date | Tìm theo thời điểm tạo |
| SHALL | encounter | reference | Tìm theo lượt khám liên quan |
| SHALL | custodian | reference | Tìm theo cơ sở y tế lưu trữ |
read, search-type.Phản hồi thanh toán BHYT — VNCoreClaimResponse profile (QĐ 3176, QĐ 697)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | Tìm theo bệnh nhân |
| SHALL | request | reference | Tìm theo Claim gốc |
| SHALL | status | token |
read, search-type.Giải trình quyền lợi BHYT — VNCoreExplanationOfBenefit profile (QĐ 697)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | Tìm theo bệnh nhân |
| SHALL | status | token | |
| SHALL | created | date | Tìm theo ngày tạo |
read, search-type, create.Kết quả cận lâm sàng — VNCoreDiagnosticReport profile (TT 13/2025, QĐ 1227)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | Tìm theo bệnh nhân |
| SHALL | code | token | Tìm theo loại báo cáo (LOINC) |
| SHALL | date | date | Tìm theo ngày báo cáo |
| SHALL | category | token | Tìm theo nhóm CLS (XN, CĐHA, GPB) |
| SHALL | encounter | reference | Tìm theo lượt khám liên quan |
read, search-type.Thuốc — VNCoreMedication profile (Luật Dược 2016, ATC/SNOMED CT)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | code | token | Tìm theo mã thuốc (ATC, SNOMED CT) |
| SHALL | status | token |
read, search-type.Trang thiết bị y tế — VNCoreDevice profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | type | token | Tìm theo loại thiết bị |
| SHALL | status | token |
read, search-type.Sử dụng TBYT cho bệnh nhân — VNCoreDeviceUseStatement profile
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | Tìm theo bệnh nhân |
| SHALL | device | reference | Tìm theo thiết bị |
read, search-type, create, update.Đồng ý xử lý DLCN y tế — VNCoreConsent profile (Luật 91/2025)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | Tìm theo bệnh nhân |
| SHALL | status | token | Tìm theo trạng thái (active, rejected, inactive) |
| SHALL | category | token | Tìm theo loại đồng ý |
| SHALL | date | date | Tìm theo ngày đồng ý |
read, search-type, create, update.Bệnh án điện tử — VNCoreComposition profile (TT 13/2025)
| Conformance | Parameter | Type | Documentation |
|---|---|---|---|
| SHALL | patient | reference | Tìm theo bệnh nhân |
| SHALL | type | token | Tìm theo loại bệnh án (LOINC) |
| SHALL | date | date | Tìm theo ngày lập bệnh án |
| SHALL | encounter | reference | Tìm theo lượt khám |