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

Hồ sơ tài nguyên: Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile

URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-location Phiên bản: 0.3.0
Computable Name: VNCoreLocation

Profile Location cho khoa, phòng, buồng khám, buồng bệnh hoặc khu vực chuyên môn trực thuộc cơ sở y tế Việt Nam. Dùng để tách rõ địa điểm cung cấp dịch vụ khỏi Organization và hỗ trợ liên kết PractitionerRole, ServiceRequest, DiagnosticReport cùng các use case EMR nội bộ. Căn cứ: TT 13/2025/TT-BYT, Luật KCB 2023, định hướng chuẩn hóa FHIR-native theo JP Core và CH Core.

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
.. Location 0..* Location Details and position information for a physical place
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:facilityCareLevel 0..1 CodeableConcept Cấp năng lực KCB nếu địa điểm được quản trị như một phân hệ chuyên môn
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level
Binding: Cấp năng lực cơ sở KCB — Vietnam Facility Care Level ValueSet (required)
.... extension:qualityScoreBand 0..1 CodeableConcept Dải điểm chất lượng nếu quản lý ở cấp địa điểm/dịch vụ
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band
Binding: Dải điểm chất lượng cơ sở KCB — Vietnam Quality Score Band ValueSet (required)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status ?!SΣ 1..1 code Trạng thái hoạt động của địa điểm
Binding: LocationStatus (required): Indicates whether the location is still in use.
... name SΣ 1..1 string Tên khoa/phòng/địa điểm
... description Σ 0..1 string Mô tả thêm về địa điểm
... type SΣ 0..* CodeableConcept Loại địa điểm theo nghiệp vụ nội bộ
Binding: ServiceDeliveryLocationRoleType (extensible): Indicates the type of function performed at the location.
... telecom S 0..* ContactPoint Thông tin liên hệ của địa điểm
... address S 0..1 VNCoreAddress Địa chỉ địa điểm
... physicalType Σ 0..1 CodeableConcept Kiểu vật lý của địa điểm
Binding: LocationType (example): Physical form of the location.
... managingOrganization SΣ 0..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở y tế quản lý địa điểm
... partOf 0..1 Reference(Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile) Địa điểm cha

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Location.status Base required LocationStatus 📍4.0.1 FHIR Std.
Location.type Base extensible ServiceDeliveryLocationRoleType 📦3.0.0 THO v7.1
Location.physicalType Base example Location type 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Location If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Location If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Location If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Location If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Location A resource should have narrative for robust management text.`div`.exists()
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
.. Location 0..* Location Details and position information for a physical place
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:facilityCareLevel 0..1 CodeableConcept Cấp năng lực KCB nếu địa điểm được quản trị như một phân hệ chuyên môn
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level
Binding: Cấp năng lực cơ sở KCB — Vietnam Facility Care Level ValueSet (required)
.... extension:qualityScoreBand 0..1 CodeableConcept Dải điểm chất lượng nếu quản lý ở cấp địa điểm/dịch vụ
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band
Binding: Dải điểm chất lượng cơ sở KCB — Vietnam Quality Score Band ValueSet (required)
... identifier S 0..* Identifier Mã khoa/phòng/địa điểm nội bộ
... status S 1..1 code Trạng thái hoạt động của địa điểm
... description 0..1 string Mô tả thêm về địa điểm
... type S 0..* CodeableConcept Loại địa điểm theo nghiệp vụ nội bộ
... telecom S 0..* ContactPoint Thông tin liên hệ của địa điểm
... address S 0..1 VNCoreAddress Địa chỉ địa điểm
... physicalType 0..1 CodeableConcept Kiểu vật lý của địa điểm
... managingOrganization S 0..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở y tế quản lý địa điểm
... partOf 0..1 Reference(Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile) Địa điểm cha

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Location 0..* Location Details and position information for a physical place
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:facilityCareLevel 0..1 CodeableConcept Cấp năng lực KCB nếu địa điểm được quản trị như một phân hệ chuyên môn
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level
Binding: Cấp năng lực cơ sở KCB — Vietnam Facility Care Level ValueSet (required)
.... extension:qualityScoreBand 0..1 CodeableConcept Dải điểm chất lượng nếu quản lý ở cấp địa điểm/dịch vụ
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band
Binding: Dải điểm chất lượng cơ sở KCB — Vietnam Quality Score Band ValueSet (required)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier SΣ 0..* Identifier Mã khoa/phòng/địa điểm nội bộ
... status ?!SΣ 1..1 code Trạng thái hoạt động của địa điểm
Binding: LocationStatus (required): Indicates whether the location is still in use.
... operationalStatus Σ 0..1 Coding The operational status of the location (typically only for a bed/room)
Binding: hl7VS-bedStatus (preferred): The operational status if the location (where typically a bed/room).
... name SΣ 1..1 string Tên khoa/phòng/địa điểm
... alias 0..* string A list of alternate names that the location is known as, or was known as, in the past
... description Σ 0..1 string Mô tả thêm về địa điểm
... mode Σ 0..1 code instance | kind
Binding: LocationMode (required): Indicates whether a resource instance represents a specific location or a class of locations.
... type SΣ 0..* CodeableConcept Loại địa điểm theo nghiệp vụ nội bộ
Binding: ServiceDeliveryLocationRoleType (extensible): Indicates the type of function performed at the location.
... telecom S 0..* ContactPoint Thông tin liên hệ của địa điểm
... address S 0..1 VNCoreAddress Địa chỉ địa điểm
... physicalType Σ 0..1 CodeableConcept Kiểu vật lý của địa điểm
Binding: LocationType (example): Physical form of the location.
... position 0..1 BackboneElement The absolute geographic location
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... longitude 1..1 decimal Longitude with WGS84 datum
.... latitude 1..1 decimal Latitude with WGS84 datum
.... altitude 0..1 decimal Altitude with WGS84 datum
... managingOrganization SΣ 0..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở y tế quản lý địa điểm
... partOf 0..1 Reference(Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile) Địa điểm cha
... hoursOfOperation 0..* BackboneElement What days/times during a week is this location usually open
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... daysOfWeek 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): The days of the week.
.... allDay 0..1 boolean The Location is open all day
.... openingTime 0..1 time Time that the Location opens
.... closingTime 0..1 time Time that the Location closes
... availabilityExceptions 0..1 string Description of availability exceptions
... endpoint 0..* Reference(Endpoint) Technical endpoints providing access to services operated for the location

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Location.language Base preferred Common Languages 📍4.0.1 FHIR Std.
Location.status Base required LocationStatus 📍4.0.1 FHIR Std.
Location.operationalStatus Base preferred hl7VS-bedStatus 📦3.0.0 THO v7.1
Location.mode Base required LocationMode 📍4.0.1 FHIR Std.
Location.type Base extensible ServiceDeliveryLocationRoleType 📦3.0.0 THO v7.1
Location.physicalType Base example Location type 📍4.0.1 FHIR Std.
Location.hoursOfOperation.​daysOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Location If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Location If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Location If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Location If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Location A resource should have narrative for robust management text.`div`.exists()
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 phần tử chính

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Location 0..* Location Details and position information for a physical place
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:facilityCareLevel 0..1 CodeableConcept Cấp năng lực KCB nếu địa điểm được quản trị như một phân hệ chuyên môn
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level
Binding: Cấp năng lực cơ sở KCB — Vietnam Facility Care Level ValueSet (required)
.... extension:qualityScoreBand 0..1 CodeableConcept Dải điểm chất lượng nếu quản lý ở cấp địa điểm/dịch vụ
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band
Binding: Dải điểm chất lượng cơ sở KCB — Vietnam Quality Score Band ValueSet (required)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status ?!SΣ 1..1 code Trạng thái hoạt động của địa điểm
Binding: LocationStatus (required): Indicates whether the location is still in use.
... name SΣ 1..1 string Tên khoa/phòng/địa điểm
... description Σ 0..1 string Mô tả thêm về địa điểm
... type SΣ 0..* CodeableConcept Loại địa điểm theo nghiệp vụ nội bộ
Binding: ServiceDeliveryLocationRoleType (extensible): Indicates the type of function performed at the location.
... telecom S 0..* ContactPoint Thông tin liên hệ của địa điểm
... address S 0..1 VNCoreAddress Địa chỉ địa điểm
... physicalType Σ 0..1 CodeableConcept Kiểu vật lý của địa điểm
Binding: LocationType (example): Physical form of the location.
... managingOrganization SΣ 0..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở y tế quản lý địa điểm
... partOf 0..1 Reference(Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile) Địa điểm cha

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Location.status Base required LocationStatus 📍4.0.1 FHIR Std.
Location.type Base extensible ServiceDeliveryLocationRoleType 📦3.0.0 THO v7.1
Location.physicalType Base example Location type 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Location If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Location If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Location If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Location If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Location A resource should have narrative for robust management text.`div`.exists()
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
.. Location 0..* Location Details and position information for a physical place
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:facilityCareLevel 0..1 CodeableConcept Cấp năng lực KCB nếu địa điểm được quản trị như một phân hệ chuyên môn
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level
Binding: Cấp năng lực cơ sở KCB — Vietnam Facility Care Level ValueSet (required)
.... extension:qualityScoreBand 0..1 CodeableConcept Dải điểm chất lượng nếu quản lý ở cấp địa điểm/dịch vụ
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band
Binding: Dải điểm chất lượng cơ sở KCB — Vietnam Quality Score Band ValueSet (required)
... identifier S 0..* Identifier Mã khoa/phòng/địa điểm nội bộ
... status S 1..1 code Trạng thái hoạt động của địa điểm
... description 0..1 string Mô tả thêm về địa điểm
... type S 0..* CodeableConcept Loại địa điểm theo nghiệp vụ nội bộ
... telecom S 0..* ContactPoint Thông tin liên hệ của địa điểm
... address S 0..1 VNCoreAddress Địa chỉ địa điểm
... physicalType 0..1 CodeableConcept Kiểu vật lý của địa điểm
... managingOrganization S 0..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở y tế quản lý địa điểm
... partOf 0..1 Reference(Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile) Địa điểm cha

doco Documentation for this format

Dạng xem SnapshotView

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Location 0..* Location Details and position information for a physical place
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:facilityCareLevel 0..1 CodeableConcept Cấp năng lực KCB nếu địa điểm được quản trị như một phân hệ chuyên môn
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level
Binding: Cấp năng lực cơ sở KCB — Vietnam Facility Care Level ValueSet (required)
.... extension:qualityScoreBand 0..1 CodeableConcept Dải điểm chất lượng nếu quản lý ở cấp địa điểm/dịch vụ
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band
Binding: Dải điểm chất lượng cơ sở KCB — Vietnam Quality Score Band ValueSet (required)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier SΣ 0..* Identifier Mã khoa/phòng/địa điểm nội bộ
... status ?!SΣ 1..1 code Trạng thái hoạt động của địa điểm
Binding: LocationStatus (required): Indicates whether the location is still in use.
... operationalStatus Σ 0..1 Coding The operational status of the location (typically only for a bed/room)
Binding: hl7VS-bedStatus (preferred): The operational status if the location (where typically a bed/room).
... name SΣ 1..1 string Tên khoa/phòng/địa điểm
... alias 0..* string A list of alternate names that the location is known as, or was known as, in the past
... description Σ 0..1 string Mô tả thêm về địa điểm
... mode Σ 0..1 code instance | kind
Binding: LocationMode (required): Indicates whether a resource instance represents a specific location or a class of locations.
... type SΣ 0..* CodeableConcept Loại địa điểm theo nghiệp vụ nội bộ
Binding: ServiceDeliveryLocationRoleType (extensible): Indicates the type of function performed at the location.
... telecom S 0..* ContactPoint Thông tin liên hệ của địa điểm
... address S 0..1 VNCoreAddress Địa chỉ địa điểm
... physicalType Σ 0..1 CodeableConcept Kiểu vật lý của địa điểm
Binding: LocationType (example): Physical form of the location.
... position 0..1 BackboneElement The absolute geographic location
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... longitude 1..1 decimal Longitude with WGS84 datum
.... latitude 1..1 decimal Latitude with WGS84 datum
.... altitude 0..1 decimal Altitude with WGS84 datum
... managingOrganization SΣ 0..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở y tế quản lý địa điểm
... partOf 0..1 Reference(Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile) Địa điểm cha
... hoursOfOperation 0..* BackboneElement What days/times during a week is this location usually open
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... daysOfWeek 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): The days of the week.
.... allDay 0..1 boolean The Location is open all day
.... openingTime 0..1 time Time that the Location opens
.... closingTime 0..1 time Time that the Location closes
... availabilityExceptions 0..1 string Description of availability exceptions
... endpoint 0..* Reference(Endpoint) Technical endpoints providing access to services operated for the location

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Location.language Base preferred Common Languages 📍4.0.1 FHIR Std.
Location.status Base required LocationStatus 📍4.0.1 FHIR Std.
Location.operationalStatus Base preferred hl7VS-bedStatus 📦3.0.0 THO v7.1
Location.mode Base required LocationMode 📍4.0.1 FHIR Std.
Location.type Base extensible ServiceDeliveryLocationRoleType 📦3.0.0 THO v7.1
Location.physicalType Base example Location type 📍4.0.1 FHIR Std.
Location.hoursOfOperation.​daysOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Location If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Location If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Location If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Location If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Location A resource should have narrative for robust management text.`div`.exists()
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()

 

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