Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Local Development build (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

• Nội dung
• Mô tả chi tiết
• Ánh xạ
• Các ví dụ
• XML
• JSON
• TTL

Hồ sơ tài nguyên: Endpoint cổng giám định BHYT — VN Core Endpoint BHYT Profile

Profile Endpoint biểu diễn một địa chỉ tích hợp dùng trong luồng gửi/nhận dữ liệu giám định, thanh toán và quyết toán chi phí KCB BHYT. TT 12/2026/TT-BTC Điều 2 xác định Cổng tiếp nhận dữ liệu thuộc Hệ thống thông tin giám định BHYT tại https://gdbhyt.baohiemxahoi.gov.vn; Thông tư không công bố trong profile này một FHIR API path, header hay cơ chế xác thực cụ thể. Địa chỉ kỹ thuật phải lấy từ cấu hình/hợp đồng trao đổi hiện hành do bên nhận cung cấp. Căn cứ:

• TT 12/2026/TT-BTC (Bộ Tài chính, 03/2026), Điều 2 — CSKCB gửi hồ sơ giám định/quyết toán BHYT qua cổng gdbhyt;
• NĐ 164/2025/NĐ-CP (29/06/2025) — giao dịch điện tử BHXH/BHYT;
• QĐ 3176/QĐ-BYT (29/10/2024) — chuẩn dữ liệu đầu ra KCB phục vụ BHXH (XML 4210).

Usages:

• Examples for this Profile: Endpoint FHIR BHYT minh họa — không dùng trong sản xuất

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.

• Bảng phần tử chính
• Bảng Differential
• Bảng Snapshot
• Thống kê/Tham chiếu
• Tất cả

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Endpoint		0..*	Endpoint	The technical details of an endpoint that can be used for electronic services
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
status	?!SΣ	1..1	code	Trạng thái endpoint (active/suspended/error/off/test) Binding: EndpointStatus (required): The status of the endpoint.
connectionType	SΣ	1..1	Coding	Loại kết nối (vd: hl7-fhir-rest, hl7-v2, hl7-v3, custom) Binding: EndpointConnectionType (extensible)
payloadType	Σ	1..*	CodeableConcept	Loại payload trao đổi (vd: BHYT submission bundle, XML 4210) Binding: EndpointPayloadType (example)
address	SΣ	1..1	url	Địa chỉ kết nối được bên nhận cấp cho môi trường triển khai
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Endpoint.status	Base	required	EndpointStatus	📍4.0.1	FHIR Std.
Endpoint.connectionType	Base	extensible	Endpoint Connection Type	📍4.0.1	FHIR Std.
Endpoint.payloadType	Base	example	Endpoint Payload Type	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Endpoint	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Endpoint	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	Endpoint	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	Endpoint	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Endpoint	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()

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Endpoint		0..*	Endpoint	The technical details of an endpoint that can be used for electronic services
status	S	1..1	code	Trạng thái endpoint (active/suspended/error/off/test)
connectionType	S	1..1	Coding	Loại kết nối (vd: hl7-fhir-rest, hl7-v2, hl7-v3, custom)
payloadType		1..*	CodeableConcept	Loại payload trao đổi (vd: BHYT submission bundle, XML 4210)
address	S	1..1	url	Địa chỉ kết nối được bên nhận cấp cho môi trường triển khai
Documentation for this format

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Endpoint		0..*	Endpoint	The technical details of an endpoint that can be used for electronic services
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
language		0..1	code	Language of the resource content Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
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
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier	Σ	0..*	Identifier	Identifies this endpoint across multiple systems
status	?!SΣ	1..1	code	Trạng thái endpoint (active/suspended/error/off/test) Binding: EndpointStatus (required): The status of the endpoint.
connectionType	SΣ	1..1	Coding	Loại kết nối (vd: hl7-fhir-rest, hl7-v2, hl7-v3, custom) Binding: EndpointConnectionType (extensible)
name	Σ	0..1	string	A name that this endpoint can be identified by
managingOrganization	Σ	0..1	Reference(Organization)	Organization that manages this endpoint (might not be the organization that exposes the endpoint)
contact		0..*	ContactPoint	Contact details for source (e.g. troubleshooting)
period	Σ	0..1	Period	Interval the endpoint is expected to be operational
payloadType	Σ	1..*	CodeableConcept	Loại payload trao đổi (vd: BHYT submission bundle, XML 4210) Binding: EndpointPayloadType (example)
payloadMimeType	Σ	0..*	code	Mimetype to send. If not specified, the content could be anything (including no payload, if the connectionType defined this) Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed.
address	SΣ	1..1	url	Địa chỉ kết nối được bên nhận cấp cho môi trường triển khai
header		0..*	string	Usage depends on the channel type
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Endpoint.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
Endpoint.status	Base	required	EndpointStatus	📍4.0.1	FHIR Std.
Endpoint.connectionType	Base	extensible	Endpoint Connection Type	📍4.0.1	FHIR Std.
Endpoint.payloadType	Base	example	Endpoint Payload Type	📍4.0.1	FHIR Std.
Endpoint.payloadMimeType	Base	required	MimeType	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Endpoint	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Endpoint	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	Endpoint	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	Endpoint	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Endpoint	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()

Summary

Must-Support: 3 elements

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

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Endpoint		0..*	Endpoint	The technical details of an endpoint that can be used for electronic services
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
status	?!SΣ	1..1	code	Trạng thái endpoint (active/suspended/error/off/test) Binding: EndpointStatus (required): The status of the endpoint.
connectionType	SΣ	1..1	Coding	Loại kết nối (vd: hl7-fhir-rest, hl7-v2, hl7-v3, custom) Binding: EndpointConnectionType (extensible)
payloadType	Σ	1..*	CodeableConcept	Loại payload trao đổi (vd: BHYT submission bundle, XML 4210) Binding: EndpointPayloadType (example)
address	SΣ	1..1	url	Địa chỉ kết nối được bên nhận cấp cho môi trường triển khai
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Endpoint.status	Base	required	EndpointStatus	📍4.0.1	FHIR Std.
Endpoint.connectionType	Base	extensible	Endpoint Connection Type	📍4.0.1	FHIR Std.
Endpoint.payloadType	Base	example	Endpoint Payload Type	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Endpoint	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Endpoint	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	Endpoint	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	Endpoint	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Endpoint	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

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Endpoint		0..*	Endpoint	The technical details of an endpoint that can be used for electronic services
status	S	1..1	code	Trạng thái endpoint (active/suspended/error/off/test)
connectionType	S	1..1	Coding	Loại kết nối (vd: hl7-fhir-rest, hl7-v2, hl7-v3, custom)
payloadType		1..*	CodeableConcept	Loại payload trao đổi (vd: BHYT submission bundle, XML 4210)
address	S	1..1	url	Địa chỉ kết nối được bên nhận cấp cho môi trường triển khai
Documentation for this format

Dạng xem SnapshotView

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Endpoint		0..*	Endpoint	The technical details of an endpoint that can be used for electronic services
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
language		0..1	code	Language of the resource content Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
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
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier	Σ	0..*	Identifier	Identifies this endpoint across multiple systems
status	?!SΣ	1..1	code	Trạng thái endpoint (active/suspended/error/off/test) Binding: EndpointStatus (required): The status of the endpoint.
connectionType	SΣ	1..1	Coding	Loại kết nối (vd: hl7-fhir-rest, hl7-v2, hl7-v3, custom) Binding: EndpointConnectionType (extensible)
name	Σ	0..1	string	A name that this endpoint can be identified by
managingOrganization	Σ	0..1	Reference(Organization)	Organization that manages this endpoint (might not be the organization that exposes the endpoint)
contact		0..*	ContactPoint	Contact details for source (e.g. troubleshooting)
period	Σ	0..1	Period	Interval the endpoint is expected to be operational
payloadType	Σ	1..*	CodeableConcept	Loại payload trao đổi (vd: BHYT submission bundle, XML 4210) Binding: EndpointPayloadType (example)
payloadMimeType	Σ	0..*	code	Mimetype to send. If not specified, the content could be anything (including no payload, if the connectionType defined this) Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed.
address	SΣ	1..1	url	Địa chỉ kết nối được bên nhận cấp cho môi trường triển khai
header		0..*	string	Usage depends on the channel type
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Endpoint.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
Endpoint.status	Base	required	EndpointStatus	📍4.0.1	FHIR Std.
Endpoint.connectionType	Base	extensible	Endpoint Connection Type	📍4.0.1	FHIR Std.
Endpoint.payloadType	Base	example	Endpoint Payload Type	📍4.0.1	FHIR Std.
Endpoint.payloadMimeType	Base	required	MimeType	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Endpoint	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Endpoint	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	Endpoint	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	Endpoint	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Endpoint	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()

Summary

Must-Support: 3 elements

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