HL7 Vietnam VN Core FHIR Implementation Guide

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 Viet Nam cờ

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

Hồ sơ kiểu dữ liệu: Địa chỉ VN Core — VN Core Address Profile

URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-address Phiên bản: 0.10.0
Computable Name: VNCoreAddress
Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.19

Profile Address cho Việt Nam, hỗ trợ 34 tỉnh theo NQ 202/2025/QH15 và danh mục mã 3.321 xã/phường/đặc khu theo QĐ 19/2025/QĐ-TTg Phụ lục II. Bổ sung extension mã hoá tỉnh/TP và xã/phường. Cấp huyện (district) giữ lại cho backward-compatible nhưng KHÔNG Must Support. Địa chỉ chỉ có text được hỗ trợ chính thức, kể cả khi country = 'VN'. Mã tỉnh/xã là thông tin bổ sung khi nguồn có mã đã xác minh; Must Support không buộc tạo mã hoặc tạo extension rỗng khi nguồn chỉ có chữ. Giữ nguyên địa chỉ nguồn khi bổ sung mã. Text-only addresses are supported; verified province and ward codings are optional additions. Căn cứ:

  • NQ 202/2025/QH15 — 12/6/2025 — sắp xếp ĐVHC cấp tỉnh
  • NQ 203/2025/QH15 — hiệu lực 16/6/2025; khoản 2 Điều 2 kết thúc hoạt động của đơn vị hành chính cấp huyện trong cả nước từ 01/7/2025
  • QĐ 19/2025/QĐ-TTg — 2025 — danh mục mã tỉnh/xã mới dùng cho địa chỉ.

Usages:

You can also check for usages in the FHIR IG Statistics

Các dạng xem hình thức của nội dung hồ sơ

Mô tả profile, differential, snapshot và các biểu diễn liên quan.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Address 0..* Address An address expressed using postal conventions (as opposed to GPS or other location definition formats)
... Slices for extension Content/Rules for all slices
.... extension:province S 0..1 Coding Mã tỉnh/thành phố (QĐ 19/2025/QĐ-TTg)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-province
Binding: Tỉnh/thành phố trong danh mục lịch sử — Province historical catalogue membership (extensible)
.... extension:ward S 0..1 Coding Mã xã/phường (QĐ 19/2025/QĐ-TTg)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward
Binding: Xã/phường/đặc khu trong danh mục lịch sử — Ward/commune/special administrative zone historical catalogue membership (extensible)
... use ?!Σ 0..1 code home | work | temp | old | billing - purpose of this address
Binding: AddressUse (required): The use of an address.
Example General: home
... text SΣ 0..1 string Địa chỉ đầy đủ dạng text
Example General: 137 Nowhere Street, Erewhon 9132
... district Σ 0..1 string Quận/Huyện (dữ liệu lịch sử; cấp huyện kết thúc hoạt động từ 01/07/2025 theo NQ 203/2025/QH15)
Example General: Madison
... state SΣ 0..1 string Tên tỉnh/thành phố (text)
... postalCode Σ 0..1 string Mã bưu chính
Example General: 9132
... country Σ 0..1 string Quốc gia (mặc định VN)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Address.use Base required AddressUse 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Address 0..* Address An address expressed using postal conventions (as opposed to GPS or other location definition formats)
... Slices for extension Content/Rules for all slices
.... extension:province S 0..1 Coding Mã tỉnh/thành phố (QĐ 19/2025/QĐ-TTg)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-province
Binding: Tỉnh/thành phố trong danh mục lịch sử — Province historical catalogue membership (extensible)
.... extension:ward S 0..1 Coding Mã xã/phường (QĐ 19/2025/QĐ-TTg)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward
Binding: Xã/phường/đặc khu trong danh mục lịch sử — Ward/commune/special administrative zone historical catalogue membership (extensible)
... text S 0..1 string Địa chỉ đầy đủ dạng text
... line S 0..* string Số nhà, đường, thôn/ấp
... state S 0..1 string Tên tỉnh/thành phố (text)
... postalCode 0..1 string Mã bưu chính
... country 0..1 string Quốc gia (mặc định VN)

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Address 0..* Address An address expressed using postal conventions (as opposed to GPS or other location definition formats)
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... extension:province S 0..1 Coding Mã tỉnh/thành phố (QĐ 19/2025/QĐ-TTg)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-province
Binding: Tỉnh/thành phố trong danh mục lịch sử — Province historical catalogue membership (extensible)
.... extension:ward S 0..1 Coding Mã xã/phường (QĐ 19/2025/QĐ-TTg)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward
Binding: Xã/phường/đặc khu trong danh mục lịch sử — Ward/commune/special administrative zone historical catalogue membership (extensible)
... use ?!Σ 0..1 code home | work | temp | old | billing - purpose of this address
Binding: AddressUse (required): The use of an address.
Example General: home
... text SΣ 0..1 string Địa chỉ đầy đủ dạng text
Example General: 137 Nowhere Street, Erewhon 9132
... line SΣ 0..* string Số nhà, đường, thôn/ấp
This repeating element order: The order in which lines should appear in an address label
Example General: 137 Nowhere Street
... city Σ 0..1 string Name of city, town etc.
Example General: Erewhon
... district Σ 0..1 string Quận/Huyện (dữ liệu lịch sử; cấp huyện kết thúc hoạt động từ 01/07/2025 theo NQ 203/2025/QH15)
Example General: Madison
... state SΣ 0..1 string Tên tỉnh/thành phố (text)
... postalCode Σ 0..1 string Mã bưu chính
Example General: 9132
... country Σ 0..1 string Quốc gia (mặc định VN)
... period Σ 0..1 Period Time period when address was/is in use
Example General: {"start":"2010-03-23","end":"2010-07-01"}

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Address.use Base required AddressUse 📍4.0.1 FHIR Std.
Address.type Base required AddressType 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

Summary

Must-Support: 5 elements

Extensions

This structure refers to these extensions:

Dạng xem phần tử chính

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Address 0..* Address An address expressed using postal conventions (as opposed to GPS or other location definition formats)
... Slices for extension Content/Rules for all slices
.... extension:province S 0..1 Coding Mã tỉnh/thành phố (QĐ 19/2025/QĐ-TTg)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-province
Binding: Tỉnh/thành phố trong danh mục lịch sử — Province historical catalogue membership (extensible)
.... extension:ward S 0..1 Coding Mã xã/phường (QĐ 19/2025/QĐ-TTg)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward
Binding: Xã/phường/đặc khu trong danh mục lịch sử — Ward/commune/special administrative zone historical catalogue membership (extensible)
... use ?!Σ 0..1 code home | work | temp | old | billing - purpose of this address
Binding: AddressUse (required): The use of an address.
Example General: home
... text SΣ 0..1 string Địa chỉ đầy đủ dạng text
Example General: 137 Nowhere Street, Erewhon 9132
... district Σ 0..1 string Quận/Huyện (dữ liệu lịch sử; cấp huyện kết thúc hoạt động từ 01/07/2025 theo NQ 203/2025/QH15)
Example General: Madison
... state SΣ 0..1 string Tên tỉnh/thành phố (text)
... postalCode Σ 0..1 string Mã bưu chính
Example General: 9132
... country Σ 0..1 string Quốc gia (mặc định VN)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Address.use Base required AddressUse 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

Dạng xem Differential

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Address 0..* Address An address expressed using postal conventions (as opposed to GPS or other location definition formats)
... Slices for extension Content/Rules for all slices
.... extension:province S 0..1 Coding Mã tỉnh/thành phố (QĐ 19/2025/QĐ-TTg)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-province
Binding: Tỉnh/thành phố trong danh mục lịch sử — Province historical catalogue membership (extensible)
.... extension:ward S 0..1 Coding Mã xã/phường (QĐ 19/2025/QĐ-TTg)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward
Binding: Xã/phường/đặc khu trong danh mục lịch sử — Ward/commune/special administrative zone historical catalogue membership (extensible)
... text S 0..1 string Địa chỉ đầy đủ dạng text
... line S 0..* string Số nhà, đường, thôn/ấp
... state S 0..1 string Tên tỉnh/thành phố (text)
... postalCode 0..1 string Mã bưu chính
... country 0..1 string Quốc gia (mặc định VN)

doco Documentation for this format

Dạng xem SnapshotView

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Address 0..* Address An address expressed using postal conventions (as opposed to GPS or other location definition formats)
... id 0..1 string Unique id for inter-element referencing
... Slices for extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... extension:province S 0..1 Coding Mã tỉnh/thành phố (QĐ 19/2025/QĐ-TTg)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-province
Binding: Tỉnh/thành phố trong danh mục lịch sử — Province historical catalogue membership (extensible)
.... extension:ward S 0..1 Coding Mã xã/phường (QĐ 19/2025/QĐ-TTg)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-ward
Binding: Xã/phường/đặc khu trong danh mục lịch sử — Ward/commune/special administrative zone historical catalogue membership (extensible)
... use ?!Σ 0..1 code home | work | temp | old | billing - purpose of this address
Binding: AddressUse (required): The use of an address.
Example General: home
... text SΣ 0..1 string Địa chỉ đầy đủ dạng text
Example General: 137 Nowhere Street, Erewhon 9132
... line SΣ 0..* string Số nhà, đường, thôn/ấp
This repeating element order: The order in which lines should appear in an address label
Example General: 137 Nowhere Street
... city Σ 0..1 string Name of city, town etc.
Example General: Erewhon
... district Σ 0..1 string Quận/Huyện (dữ liệu lịch sử; cấp huyện kết thúc hoạt động từ 01/07/2025 theo NQ 203/2025/QH15)
Example General: Madison
... state SΣ 0..1 string Tên tỉnh/thành phố (text)
... postalCode Σ 0..1 string Mã bưu chính
Example General: 9132
... country Σ 0..1 string Quốc gia (mặc định VN)
... period Σ 0..1 Period Time period when address was/is in use
Example General: {"start":"2010-03-23","end":"2010-07-01"}

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Address.use Base required AddressUse 📍4.0.1 FHIR Std.
Address.type Base required AddressType 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

Summary

Must-Support: 5 elements

Extensions

This structure refers to these extensions:

 

Biểu diễn khác của hồ sơ: CSV, Excel, Schematron