HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.3.0 - STU1 Draft Viet Nam cờ

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

Ví dụ Bundle: Ví dụ: Bundle hồ sơ thanh toán BHYT trẻ sơ sinh

Bundle ExampleBHYTSubmissionNewborn of type collection


Entry 1 - fullUrl = http://example.org/fhir/Patient/InlinePatientBHYTSubmissionNewborn

Resource Patient:

Trẻ sơ sinh Nguyễn Minh An Female, DoB: 2026-03-22 ( Căn cước công dân: VNCCCD#?ngen-9?)


Active:true
Other Ids:Mã bệnh nhân nội bộ/SS-CR-2026-0007
Lý do bất khả kháng thiếu CCCD — Force Majeure Reason ExtensionTrẻ sơ sinh chưa có định danh

Entry 2 - fullUrl = http://example.org/fhir/Coverage/InlineCoverageBHYTSubmissionNewborn

Resource Coverage:

Loại đối tượng BHYT — Vietnam BHYT Card Type Extension: Trẻ em dưới 6 tuổi

Nơi đăng ký KCB ban đầu — Vietnam Primary Care Facility Extension: Organization Bệnh viện Chợ Rẫy

identifier: VNBHYT/TE1791234567890

status: Active

type: Bảo hiểm y tế

beneficiary: Trẻ sơ sinh Nguyễn Minh An Female, DoB: 2026-03-22 ( Căn cước công dân: VNCCCD#?ngen-9?)

period: 2026-03-22 --> 2032-03-22


Entry 3 - fullUrl = http://example.org/fhir/Organization/ExampleOrganizationChoRay

Resource Organization:

Loại hình cơ sở y tế — Vietnam Organization Type Extension: Bệnh viện

Cấp quản lý hành chính y tế — Vietnam Administrative Health Level Extension: Trung ương

Hạng cơ sở khám bệnh, chữa bệnh — Vietnam KCB Facility Rank Extension: Đặc biệt

Tình trạng xếp hạng cơ sở y tế — Organization Rank Status Extension: Đã xếp hạng

Cấp năng lực cơ sở KCB — Facility Care Level Extension: Cấp chuyên sâu

Dải điểm chất lượng cơ sở KCB — Quality Score Band Extension: Trên 70 điểm

identifier: Mã cơ sở khám chữa bệnh/79001

active: true

name: Bệnh viện Chợ Rẫy

Contacts

-TelecomAddress
*ph: 028 3855 4137201B Nguyễn Chí Thanh, Phường Chợ Lớn, Thành phố Hồ Chí Minh

Entry 4 - fullUrl = http://example.org/fhir/Organization/ExampleOrganizationBHXH

Resource Organization:

identifier: Mã cơ quan BHXH Việt Nam (mã quy ước)/00000

active: true

type: Cơ quan bảo hiểm xã hội

name: Bảo hiểm xã hội Việt Nam

Contacts

-Address
*Số 7 Tràng Thi, Hoàn Kiếm, Hà Nội

Entry 5 - fullUrl = http://example.org/fhir/Claim/InlineClaimBHYTSubmissionNewborn

Resource Claim:

identifier: Mã liên kết hồ sơ BHYT/LK-2026-NB-000001

status: Active

type: Institutional

subType: Trẻ sơ sinh phải điều trị ngay sau khi sinh ra

use: Claim

patient: Trẻ sơ sinh Nguyễn Minh An Female, DoB: 2026-03-22 ( Căn cước công dân: VNCCCD#?ngen-9?)

created: 2026-03-22

provider: Organization Bệnh viện Chợ Rẫy

priority: Normal

Diagnoses

-SequenceDiagnosis[x]Type
*1Singleton, born in hospitalPrincipal Diagnosis

Insurances

-SequenceFocalCoverage
*1trueCoverage: extension = Trẻ em dưới 6 tuổi,->Organization Bệnh viện Chợ Rẫy; identifier = http://fhir.hl7.org.vn/core/sid/bhyt#VNBHYT#TE1791234567890; status = active; type = Medical; period = 2026-03-22 --> 2032-03-22

item

sequence: 1

category: Khám bệnh

productOrService: Theo dõi và chăm sóc sơ sinh ngay sau sinh

Nets

-ValueCurrency
*350000VND

Totals

-ValueCurrency
*350000VND

Entry 6 - fullUrl = http://example.org/fhir/Patient/InlinePatientMotherBHYTSubmissionNewborn

Resource Patient:

Trần Thị Mai Female, DoB: 1994-08-15 ( Căn cước công dân: VNCCCD#079185009876)


Active:true
Other Ids:Mã bệnh nhân nội bộ/MOTHER-CR-2026-0007

Entry 7 - fullUrl = http://example.org/fhir/RelatedPerson/InlineRelatedPersonMotherBHYTSubmissionNewborn

Resource RelatedPerson:

identifier: Căn cước công dân/079185009876

active: true

patient: Trẻ sơ sinh Nguyễn Minh An Female, DoB: 2026-03-22 ( Căn cước công dân: VNCCCD#?ngen-9?)

relationship: Mẹ

name: Trần Thị Mai

telecom: ph: 0912345678(Mobile)


Entry 8 - fullUrl = http://example.org/fhir/DocumentReference/InlineDocumentReferenceBirthCertificateBHYTSubmissionNewborn

Resource DocumentReference:

identifier: VNDocumentNumber/GS-2026-000007

status: Current

type: Giấy chứng sinh

subject: Trẻ sơ sinh Nguyễn Minh An

date: 2026-03-22 06:45:00+0700

author: Bệnh viện Chợ Rẫy

custodian: Bệnh viện Chợ Rẫy

description:

Giấy chứng sinh cho trẻ sơ sinh Nguyễn Minh An, mẹ là Trần Thị Mai.

content

Attachments

-ContentTypeLanguageTitleCreation
*application/pdfviGiayChungSinh-NguyenMinhAn-20260322.pdf2026-03-22 06:45:00+0700

Entry 9 - fullUrl = http://example.org/fhir/DocumentReference/InlineDocumentReferenceMaternityLeaveBHYTSubmissionNewborn

Resource DocumentReference:

identifier: VNDocumentNumber/DT-2026-000007

status: Current

type: Giấy nghỉ dưỡng thai

subject: Trần Thị Mai

date: 2026-03-24 09:00:00+0700

author: Bệnh viện Chợ Rẫy

custodian: Bệnh viện Chợ Rẫy

description:

Giấy nghỉ dưỡng thai sau sinh cho sản phụ Trần Thị Mai.

content

Attachments

-ContentTypeLanguageTitleCreation
*application/pdfviGiayNghiDuongThai-TranThiMai-20260324.pdf2026-03-24 09:00:00+0700