Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review
Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Draft tại thời điểm 2026-09-22 |
Ánh xạ cho bhytXml9BirthCertificateLm mô hình logic.
No Mappings Found
No Mappings Found
| Name | VN Core FHIR mapping |
|---|---|
  bhytXml9BirthCertificateLm |
|
  maLk |
VNCoreClaim.identifier[MALK].value |
| maBhxhNnd |
VNCoreRelatedPerson.identifier.value | VNCoreRelatedPerson.identifier.value |
| maTheNnd |
VNCoreCoverage.subscriber.resolve().identifier[BHYT].value | VNCoreRelatedPerson.identifier.value |
| hoTenNnd |
VNCoreRelatedPerson.name.text | VNCorePatient.contact.name.text |
| ngaySinhNnd |
VNCoreRelatedPerson.birthDate |
| maDanTocNnd |
VNCoreRelatedPerson.extension[ethnicity].valueCodeableConcept.coding.code |
| soCccdNnd |
VNCoreRelatedPerson.identifier[CCCD].value | VNCoreRelatedPerson.identifier[HC].value Ghi số căn cước công dân hoặc số định danh cá nhân trên thẻ căn cước của mẹ hoặc người nuôi dưỡng; trường hợp người nuôi dưỡng là người nước ngoài thì ghi số hộ chiếu (slice identifier[HC]). Diễn giải sửa đổi toàn bộ, đổi kiểu dữ liệu sang chuỗi và kích thước tối đa n ký tự theo QĐ 3176/QĐ-BYT (kế thừa QĐ 130/QĐ-BYT, sửa đổi bởi QĐ 4750/QĐ-BYT). |
| ngayCapCccdNnd |
VNCoreRelatedPerson.identifier[CCCD].period.start |
| noiCapCccdNnd |
VNCoreRelatedPerson.identifier[CCCD].assigner.display |
| noiCuTruNnd |
VNCoreRelatedPerson.address.text | VNCorePatient.contact.address.text |
| maQuocTich |
VNCorePatient.extension[citizenship].extension.valueCodeableConcept.coding.code Mã nguồn là mã quốc tịch 3 chữ số do Bộ Công an ban hành, KHÔNG phải ISO 3166. Phải chuyển sang hệ mã mà extension[citizenship] bind, hoặc ghi kèm đúng system của mã nguồn. |
| maTinhCuTru |
VNCoreRelatedPerson.address.extension[province].valueCoding.code | VNCorePatient.address.extension[province].valueCoding.code Giữ mã tỉnh nguồn và ngày hồ sơ. Sau khi xác định hệ mã nhà nước, dùng vn-province-cs; binding history hỗ trợ mã đã thu nhận. Không tự đổi mã lịch sử sang tỉnh hiện hành. Tên/hiệu lực theo ngày cần giai đoạn đã xác minh; thiếu căn cứ giữ địa chỉ text và báo không đủ căn cứ. |
| maHuyenCuTru |
VNCoreRelatedPerson.address.district | VNCorePatient.address.district Address.district là tên huyện dạng string. Nếu nguồn dùng mã TMS hoặc mã ghép tỉnh+huyện năm chữ số, chỉ chuyển qua registry có scheme và edition tường minh sang mã nhà nước ba chữ số. Tra tên trong vn-district-cs theo ngày hồ sơ khi có bằng chứng; thiếu căn cứ giữ text nguồn, không lấy display hiện hành làm tên lịch sử. Việc đổi cách biểu diễn mã không chứng minh hiệu lực hoặc địa giới. |
| maXaCuTru |
VNCoreRelatedPerson.address.extension[ward].valueCoding.code | VNCorePatient.address.extension[ward].valueCoding.code Giữ mã xã nguồn gồm năm chữ số và ngày hồ sơ; dùng vn-ward-cs sau khi xác định đúng hệ mã. Binding history không buộc đổi mã xã cũ sang xã mới. Tra tên/tỉnh quản lý theo giai đoạn có bằng chứng; thiếu căn cứ giữ text nguồn, không tự suy từ tên hoặc mã hiện hành. |
| hoTenCha |
VNCoreRelatedPerson.where(relationship.coding.code='FTH').name.text | VNCorePatient.contact.where(relationship.coding.code='FTH').name.text |
| maTheTam |
VNCoreCoverage.identifier.value Temporary card identifiers are kept as Coverage.identifier until a dedicated temporary-card slice is profiled. |
| hoTenCon |
VNCorePatient.name.text |
| gioiTinhCon |
VNCorePatient.gender |
| soCon |
Observation.valueQuantity |
| lanSinh |
Observation.valueInteger |
| soConSong |
Observation.valueQuantity |
| canNangCon |
Observation.valueQuantity | VNCorePatient.extension.valueQuantity |
| ngaySinhCon |
VNCorePatient.birthDate Đính chính 16/08/2026: bỏ hai đích DocumentReference.date và content.attachment.creation — cả hai là mốc tạo BẢN GHI/TỆP tài liệu (date đã là đích của NGAY_CT), không phải ngày sinh của trẻ. Ngày sinh con thuộc Patient.birthDate của chính đứa trẻ. |
| noiSinhCon |
VNCorePatient.extension[birthPlace].valueAddress.text | VNCoreEncounter.location.location.resolve().name |
| tinhTrangCon |
Observation.valueString | VNCoreCondition.code.text Ghi rõ tình trạng của trẻ tại thời điểm làm Giấy chứng sinh — các giá trị diễn giải theo QĐ 3176/QĐ-BYT: 'khoẻ mạnh', 'yếu', 'dị tật' hoặc các biểu hiện liên quan đến sức khoẻ khác (nếu có). Nếu trẻ bị dị dạng, dị tật thì ghi cụ thể loại dị dạng, dị tật, kể cả khuyết tật về hình thái nếu phát hiện được — dị tật bẩm sinh ánh xạ VNCoreCondition.code, narrative tổng quát ghi vào Observation.valueString. Kiểu chuỗi n ký tự. |
| sinhConPhauThuat |
VNCoreProcedure.code | Observation.valueBoolean |
| sinhConDuoi32Tuan |
Observation.valueBoolean |
| ghiChu |
VNCoreDocumentReference.description | VNCoreComposition.section.text Theo QĐ 3176/QĐ-BYT: bắt buộc ghi khi SINHCON_PHAUTHUAT=1 hoặc SINHCON_DUOI32TUAN=1 (hoặc cả hai); nội dung phải đúng 1 trong 3 giá trị cố định: 'Sinh con phải phẫu thuật', 'Sinh con dưới 32 tuần tuổi', hoặc 'Phẫu thuật, sinh con dưới 32 tuần tuổi'. Kiểu chuỗi n ký tự. |
| nguoiDoDe |
VNCoreComposition.author.resolve().identifier.value | VNCorePractitioner.identifier.value |
| nguoiGhiPhieu |
VNCoreDocumentReference.author.resolve().identifier.value | VNCorePractitioner.identifier.value |
| ngayCt |
VNCoreDocumentReference.date | VNCoreComposition.date |
| so |
VNCoreDocumentReference.identifier.value | VNCoreComposition.identifier.value |
| quyenSo |
VNCoreDocumentReference.identifier.value |
| maTtdv |
VNCorePractitioner.identifier[GPHN].value | VNCorePractitioner.identifier[CCCD].value (fallback khi không có GPHN) QĐ 3176/QĐ-BYT ưu tiên mã hoá theo GPHN; nếu không có GPHN thì ghi số CCCD hoặc số định danh cá nhân của người ký. Đổi kiểu dữ liệu sang chuỗi, tăng kích thước tối đa 255 ký tự (trước đây là mã số định danh y tế/mã số BHXH của Thủ trưởng CSKCB). |
 duPhong |
|
| Documentation for this format | |
