Profile Comparison between http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-address vs http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-address

Messages

Metadata

Name	Value		Comments
abstract	false
baseDefinition	http://hl7.org/fhir/StructureDefinition/Address
copyright
date	2026-03-21	2026-05-10	Values Differ
description	Profile Address cho Việt Nam, hỗ trợ ĐVHC mới theo NQ 202/2025 (34 tỉnh, 3.321 xã). Bổ sung extension mã hóa tỉnh/TP và xã/phường. Cấp huyện (district) giữ lại cho backward-compatible nhưng KHÔNG Must Support — khuyến khích dùng extension:province + extension:ward. Căn cứ: - **NQ 202/2025/QH15** — 12/6/2025 — sắp xếp ĐVHC cấp tỉnh, mô hình 2 cấp từ 01/7/2025 - **QĐ 19/2025/QĐ-TTg** — 2025 — danh mục mã tỉnh/xã mới dùng cho địa chỉ.
experimental
fhirVersion	4.0.1
jurisdiction
jurisdiction[0]	urn:iso:std:iso:3166#VN
kind	complex-type
name	VNCoreAddress
publisher	Omi HealthTech / VN Core FHIR Community Initiative
purpose
status	draft
title	Địa chỉ VN Core — VN Core Address Profile
type	Address
url	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-address
version	0.5.0	0.5.1	Values Differ

Structure

Name	L Flags	L Card.	L Type	L Description & Constraints	R Flags	R Card.	R Type	R Description & Constraints	Comments
Address	C	0..*	Address	An address expressed using postal conventions (as opposed to GPS or other location definition formats) Constraints: vn-addr-province	C	0..*	Address	An address expressed using postal conventions (as opposed to GPS or other location definition formats) Constraints: vn-addr-province
id		0..1	string	Unique id for inter-element referencing		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		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
use	?!Σ	0..1	code	home | work | temp | old | billing - purpose of this address Binding: ?? (required): The use of an address. Example General: home	?!Σ	0..1	code	home | work | temp | old | billing - purpose of this address Binding: ?? (required): The use of an address. Example General: home
type	Σ	0..1	code	postal | physical | both Binding: ?? (required): The type of an address (physical / postal). Example General: both	Σ	0..1	code	postal | physical | both Binding: ?? (required): The type of an address (physical / postal). Example General: both
text	SΣ	0..1	string	Địa chỉ đầy đủ dạng text Example General: 137 Nowhere Street, Erewhon 9132	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	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	Σ	0..1	string	Name of city, town etc. Example General: Erewhon
district	Σ	0..1	string	Quận/Huyện (legacy — không còn chính thức sau NQ 202/2025) Example General: Madison	Σ	0..1	string	Quận/Huyện (legacy — không còn chính thức sau NQ 202/2025) Example General: Madison
state	SΣ	0..1	string	Tên tỉnh/thành phố (text)	SΣ	0..1	string	Tên tỉnh/thành phố (text)
postalCode	Σ	0..1	string	Mã bưu chính Example General: 9132	Σ	0..1	string	Mã bưu chính Example General: 9132
country	Σ	0..1	string	Quốc gia (mặc định VN)	Σ	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"}	Σ	0..1	Period	Time period when address was/is in use Example General: {"start":"2010-03-23","end":"2010-07-01"}
Documentation for this format