Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.5.0 - Draft for Community Review
Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.5.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
Ngữ nghĩa pháp lý của các thuộc tính Organization và Location trong VN Core: ranh giới giữa hai resource, extension phản ánh pháp lý hiện hành và extension chỉ giữ cho dữ liệu lịch sử.
VN Core tách dứt khoát 4 khái niệm:
| Khái niệm | Tài nguyên | Căn cứ chính | Dùng cho |
|---|---|---|---|
| Hạng pháp lý của cơ sở KCB | VNHospitalRankCS, VNCoreExtOrgRank | TT 06/2024/TT-BYT | Bệnh viện, phòng khám, cơ sở KCB có xếp hạng |
| Hạng pháp lý của đơn vị y tế không phải cơ sở KCB | VNHealthUnitRankCS, VNCoreExtHealthUnitRank | TT 06/2024/TT-BYT | Y tế dự phòng, TTYT, kiểm nghiệm, kiểm định |
| Cấp KCB hiện hành | VNFacilityCareLevelCS, VNCoreExtFacilityCareLevel | Luật KCB 2023, NĐ 96/2023/NĐ-CP | Organization, Location |
| Tuyến chuyên môn kỹ thuật lịch sử | VNLegacyTechnicalLineCS, VNCoreExtLegacyTechnicalLine | TT 43/2013/TT-BYT, TT 23/2024/TT-BYT | Dữ liệu lịch sử / chuyển đổi |
VNCoreExtOrgLevel chỉ còn mang nghĩa cấp quản lý hành chính y tế hiện hành, không dùng thay cho tuyến kỹ thuật cũ.
VNCoreOrganizationDepartment biểu diễn khoa/phòng nội bộ của một cơ sở y tế, ví dụ Khoa Nội Tim mạch, Khoa Chẩn đoán hình ảnh, Khoa Xét nghiệm hoặc Khoa Dược.
MA_KHOA trong XML đầu ra KCB hoặc đối soát bảng kê chi phí.Encounter, PractitionerRole, Claim.item hoặc báo cáo cận lâm sàng cần chỉ rõ khoa thực hiện.Organization base, tách riêng và không extend VNCoreOrganization, tương tự pattern tách department khỏi organization chính trong các IG quốc gia.type fixed dept từ http://terminology.hl7.org/CodeSystem/organization-type.vn-org-dept-partof-required có severity error: partOf phải tham chiếu cơ sở y tế chủ quản.identifier có slice departmentCode dùng VNDepartmentCS cho mã K01-K53, K99 theo QĐ 2010/QĐ-BYT ngày 19/06/2025 Phụ lục 6.identifier có slice localCode cho mã khoa/phòng cục bộ của bệnh viện, phục vụ mapping HIS/EMR nội bộ.Căn cứ triển khai: QĐ 2010/QĐ-BYT ngày 19/06/2025 Phụ lục 6 ban hành tạm thời danh mục mã khoa dùng chung; QĐ 3176/QĐ-BYT ngày 29/10/2024 duy trì trường MA_KHOA trong dữ liệu đầu ra KCB.
chưa xếp hạng.ban đầu, cơ bản, chuyên sâu.Organization hoặc Location.| Loại hình | organizationRank | healthUnitRank | facilityCareLevel | legacyTechnicalLine |
|---|---|---|---|---|
| Bệnh viện | Có thể có | Không | Nên có | Chỉ khi là dữ liệu lịch sử |
| Phòng khám | Có thể có hoặc chưa xếp hạng | Không | Nên có | Chỉ khi là dữ liệu lịch sử |
| Trạm y tế | Thường không áp dụng | Không | Nên có (ban đầu) |
Chỉ khi là dữ liệu lịch sử |
| Trung tâm y tế | Không dùng rank KCB nếu đang mô hình như đơn vị sự nghiệp y tế | Có thể có | Có thể có | Có thể có |
| CDC / đơn vị dự phòng | Không | Có thể có | Thường không áp dụng | Không bắt buộc |
| Nếu cần | Nên đọc tiếp |
|---|---|
| Xem chi tiết hồ sơ Organization và Location | Danh mục hồ sơ |
| Tra cứu extension dùng cho hạng, cấp, tuyến của cơ sở | Danh mục extension |
| Hiểu cơ sở pháp lý cho hạng/cấp/tuyến (NĐ 188/2025, NQ 202/2025) | Cơ sở pháp lý |
| Tra cứu CodeSystem/ValueSet cho hạng, cấp, tuyến | Danh mục thuật ngữ |
VN Core separates legal rank, current care level, administrative oversight level, and historical technical line for healthcare organizations. organizationRank is reserved for legally ranked care-delivery organizations, healthUnitRank is used for non-care-delivery health institutions, facilityCareLevel represents the current 3-level care model, and legacyTechnicalLine is kept only for migration from historical data.