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

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

Hồ sơ tài nguyên: Lượt khám/nhập viện VN Core — VN Core Encounter Profile

Profile Encounter cho Việt Nam. Bao gồm extension loại KCB BHYT legacy của VN Core (từ trường MA_LYDO_VVIEN), thông tin chẩn đoán, cơ sở y tế, và kết quả điều trị/tình trạng ra viện. Căn cứ:

• NĐ 102/2025/NĐ-CP — 13/5/2025 — quản lý dữ liệu y tế số và CSDL quốc gia về y tế
• TT 13/2025/TT-BYT — 06/6/2025 — bệnh án điện tử
• TT 30/2023/TT-BYT — 30/12/2023 — khám bệnh, chữa bệnh từ xa khi Encounter.class = VR/virtual
• Luật 51/2024/QH15 — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025
• QĐ 4210/QĐ-BYT — chỉ là nguồn lịch sử cho MA_LYDO_VVIEN; đã hết hiệu lực từ 01/07/2024 theo Điều 3 QĐ 4750/QĐ-BYT
• QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT — chuẩn dữ liệu KCB/BHYT hiện hành
• QĐ 3276/QĐ-BYT — MA_DOITUONG_KCB; QĐ 1804/QĐ-BYT — MA_LOAI_KCB 01–16 và danh mục mã khoa.

Usages:

• Use this Profile: Bundle hồ sơ thanh toán BHYT — VN Core BHYT Submission Bundle
• Refer to this Profile: Dị ứng/Bất dung nạp VN Core — VN Core AllergyIntolerance Profile, Quyết định xử lý dựa trên căn cứ pháp lý — VN Core Legal-Basis Decision AuditEvent, Kế hoạch chăm sóc VN Core — VN Core CarePlan Profile, Nhóm chăm sóc VN Core — VN Core CareTeam Profile... Show 20 more, Dòng chi phí phát sinh — VN Core ChargeItem, Nhận định lâm sàng VN Core — VN Core ClinicalImpression Profile, Giấy khám sức khoẻ định kỳ VN Core — VN Core Health Checkup Composition Profile, Sổ Sức khoẻ điện tử VN Core — VN Core Health Record Summary (Patient Summary) Profile, Bệnh án điện tử VN Core — VN Core Composition Profile, Chẩn đoán VN Core — VN Core Condition Profile, Bản ghi attestation bảng kê chi phí khám bệnh, chữa bệnh — VN Core Cost Statement Composition, Báo cáo cận lâm sàng VN Core — VN Core DiagnosticReport Profile, Tài liệu y tế VN Core — VN Core DocumentReference Profile, Tiêm chủng — VN Core Immunization, Sử dụng/Cho dùng thuốc VN Core — VN Core Medication Administration Profile, Cấp phát thuốc VN Core — VN Core Medication Dispense Profile, Đơn thuốc VN Core — VN Core MedicationRequest Profile, Tiền sử dùng thuốc VN Core — VN Core MedicationStatement Profile, Xét nghiệm VN Core — VN Core Observation Laboratory Profile, Phân loại ưu tiên cấp cứu VN Core — VN Core Triage Acuity Observation, Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile, Thủ thuật/DVKT VN Core — VN Core Procedure Profile, Yêu cầu DVKT/Cận lâm sàng VN Core — VN Core ServiceRequest Profile and Công việc điều phối VN Core — VN Core Task Profile
• Examples for this Profile: Encounter/ExampleEncounterCardiacInpatient, Encounter/ExampleEncounterDiabeticRetinopathyPair, Encounter/ExampleEncounterEmergency, Encounter/ExampleEncounterEnteredInError... Show 9 more, Encounter/ExampleEncounterHealthCheckup, Encounter/ExampleEncounterImmunizationSession, Encounter/ExampleEncounterInpatient, Encounter/ExampleEncounterLegacyInsuranceVisitType, Encounter/ExampleEncounterOutpatient, Encounter/ExampleEncounterTelehealth, Encounter/ExampleEncounterTelehealthMissingClass, Encounter/ExampleEncounterVisitCodeNoAssigner and Encounter/ExampleEncounterYHCT
• CapabilityStatements using this Profile: VN Core Data Requester CapabilityStatement, VN Core Data Responder CapabilityStatement, VN Core EMR Server CapabilityStatement and VN Core Server CapabilityStatement

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
• Nghĩa vụ hỗ trợ
• Thống kê/Tham chiếu
• Tất cả

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Encounter	C	0..*	Encounter	An interaction during which services are provided to the patient Constraints: vn-encounter-visit-code-issuer-scoped, vn-encounter-telehealth-two-axes
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:insuranceVisitType		0..1	CodeableConcept	Legacy-only trước 01/07/2024; không dùng cho trao đổi BHXH hiện hành URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-visit-type Binding: Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type ValueSet (required)
extension:referralMode	SO	0..1	CodeableConcept	Hình thức chuyển tuyến — trường HTCHUYEN (tự đến, chuyển lên, chuyển xuống, cùng tuyến, cấp cứu) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-referral-mode Binding: Hình thức chuyển tuyến — VN Referral Mode ValueSet (required) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
extension:treatmentOutcome	SO	0..1	CodeableConcept	Kết quả điều trị — xem VNTreatmentOutcomeVS URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-treatment-outcome Binding: Kết quả điều trị — Vietnam Treatment Outcome ValueSet (required) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
extension:paymentMethod		0..1	CodeableConcept	Phương thức thanh toán BHYT (FFS/Capitation/DRG) — trường MA_PTTT URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method Binding: Phương thức thanh toán BHYT — VN Payment Method ValueSet (extensible)
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	Σ	0..*	Identifier	Định danh lượt khám (gồm slice MA_LUOT_KCB) Slice: Unordered, Open by value:system
identifier:maLuotKcb	SOΣ	0..1	Identifier	Mã lượt KCB (MA_LUOT_KCB) theo convention VN Core; tương thích khoá MA_LK khi trao đổi BHYT Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	1..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: MA_LUOT_KCB
display		1..1	string	Representation defined by the system Fixed Value: Mã lượt khám chữa bệnh
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/ma-luot-kcb
value	Σ	1..1	string	The value that is unique Example General: 123456
status	?!SOΣ	1..1	code	Trạng thái lượt khám Binding: EncounterStatus (required): Current state of the encounter. Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
class	SOΣ	1..1	Coding	Loại hình KCB: AMB (ngoại trú), IMP (nội trú), EMER (cấp cứu), VR (khám từ xa) Binding: ActEncounterCode (extensible): Classification of the encounter. Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
type	SOΣ	0..*	CodeableConcept	Loại hình KCB (MA_LOAI_KCB): 01=khám, 02=ngoại trú, 03=nội trú, 04=điều trị ban ngày, …, 14=từ xa, 15=KSK định kỳ, 16=sàng lọc Binding: Loại khám chữa bệnh — Vietnam Encounter Type ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
subject	SOΣ	1..1	Reference(Bệnh nhân VN Core — VN Core Patient Profile)	Bệnh nhân Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
participant	Σ	0..*	BackboneElement	Bác sĩ/NVYT tham gia
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
individual	Σ	0..1	Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile)	Persons involved in the encounter other than the patient
appointment	Σ	0..*	Reference(Cuộc hẹn khám bệnh VN Core — VN Core Appointment Profile)	Cuộc hẹn đã đặt dẫn tới lượt khám này
period	SO	0..1	Period	Thời gian khám/nhập viện Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
reasonCode	SOΣ	0..*	CodeableConcept	Lý do đến khám/chief complaint Binding: Mã chẩn đoán — VN Core Condition Code ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
text	SΣ	0..1	string	Diễn giải tự do của lý do đến khám
diagnosis	SOΣ	0..*	BackboneElement	Chẩn đoán Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
condition	SΣ	1..1	Reference(Chẩn đoán VN Core — VN Core Condition Profile)	The diagnosis or procedure relevant to the encounter
use		0..1	CodeableConcept	Loại chẩn đoán (chính, phụ, nhập viện, ra viện) Binding: DiagnosisRole (preferred): The type of diagnosis this condition represents.
account	SO	0..*	Reference(Tài khoản viện phí — VN Core Account)	Tài khoản viện phí gom chi phí của đợt điều trị Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
hospitalization		0..1	BackboneElement	Thông tin nhập viện/ra viện
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
dischargeDisposition	SO	0..1	CodeableConcept	Tình trạng ra viện Binding: Tình trạng ra viện — Vietnam Discharge Disposition ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
serviceProvider	SO	1..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile)	Cơ sở KCB Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Kho hồ sơ EMR (Repository)	Bên đáp ứng dữ liệu lõi (Data Responder)	Nguồn tạo hồ sơ lâm sàng (Document Source)
Encounter
Slices for extension
extension:referralMode	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
extension:treatmentOutcome	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
Slices for identifier
identifier:maLuotKcb	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
status	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
class	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
type	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
subject	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
period	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
reasonCode	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
diagnosis	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
account	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
hospitalization
dischargeDisposition	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
serviceProvider	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Encounter.identifier:maLuotKcb.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Encounter.identifier:maLuotKcb.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Encounter.status	Base	required	EncounterStatus	📍4.0.1	FHIR Std.
Encounter.class	Base	extensible	ActEncounterCode	📦3.0.0	THO v7.2
Encounter.type	Base	extensible	Loại khám chữa bệnh — Vietnam Encounter Type ValueSet	📦0.10.0	This IG
Encounter.reasonCode	Base	extensible	Mã chẩn đoán — VN Core Condition Code ValueSet	📦0.10.0	This IG
Encounter.diagnosis.​use	Base	preferred	DiagnosisRole	📍4.0.1	FHIR Std.
Encounter.hospitalization.​dischargeDisposition	Base	extensible	Tình trạng ra viện — Vietnam Discharge Disposition ValueSet	📦0.10.0	This IG

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Encounter	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Encounter	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	Encounter	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	Encounter	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Encounter	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()
vn-encounter-telehealth-two-axes	error	Encounter	Lượt khám từ xa phải mang cả hai trục: `class = VR` (phương thức ảo) và `type` chứa mã 14 (loại hình KCB từ xa theo QĐ 1804/QĐ-BYT). A telehealth encounter SHALL carry both axes: virtual class and the national telemedicine encounter type.	(class.code = 'VR') = type.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-encounter-type-cs' and code = '14').exists()
vn-encounter-visit-code-issuer-scoped	error	Encounter	Mã lượt khám ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/ma-luot-kcb) phải kèm `assigner` chỉ rõ cơ sở cấp mã; khuyến nghị chính là mỗi cơ sở công bố URI riêng. A visit code recorded under the shared national placeholder URI SHALL name its assigning facility; per-facility namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/ma-luot-kcb').all(assigner.exists())

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Encounter	C	0..*	Encounter	An interaction during which services are provided to the patient Constraints: vn-encounter-visit-code-issuer-scoped, vn-encounter-telehealth-two-axes
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
extension:insuranceVisitType		0..1	CodeableConcept	Legacy-only trước 01/07/2024; không dùng cho trao đổi BHXH hiện hành URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-visit-type Binding: Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type ValueSet (required)
extension:referralMode	SO	0..1	CodeableConcept	Hình thức chuyển tuyến — trường HTCHUYEN (tự đến, chuyển lên, chuyển xuống, cùng tuyến, cấp cứu) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-referral-mode Binding: Hình thức chuyển tuyến — VN Referral Mode ValueSet (required) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
extension:treatmentOutcome	SO	0..1	CodeableConcept	Kết quả điều trị — xem VNTreatmentOutcomeVS URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-treatment-outcome Binding: Kết quả điều trị — Vietnam Treatment Outcome ValueSet (required) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
extension:paymentMethod		0..1	CodeableConcept	Phương thức thanh toán BHYT (FFS/Capitation/DRG) — trường MA_PTTT URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method Binding: Phương thức thanh toán BHYT — VN Payment Method ValueSet (extensible)
Slices for identifier		0..*	Identifier	Định danh lượt khám (gồm slice MA_LUOT_KCB) Slice: Unordered, Open by value:system
identifier:maLuotKcb	SO	0..1	Identifier	Mã lượt KCB (MA_LUOT_KCB) theo convention VN Core; tương thích khoá MA_LK khi trao đổi BHYT Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
type		1..1	CodeableConcept	Description of identifier Required Pattern: At least the following
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
code		1..1	code	Symbol in syntax defined by the system Fixed Value: MA_LUOT_KCB
display		1..1	string	Representation defined by the system Fixed Value: Mã lượt khám chữa bệnh
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/ma-luot-kcb
value		1..1	string	The value that is unique
status	SO	1..1	code	Trạng thái lượt khám Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
class	SO	1..1	Coding	Loại hình KCB: AMB (ngoại trú), IMP (nội trú), EMER (cấp cứu), VR (khám từ xa) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
type	SO	0..*	CodeableConcept	Loại hình KCB (MA_LOAI_KCB): 01=khám, 02=ngoại trú, 03=nội trú, 04=điều trị ban ngày, …, 14=từ xa, 15=KSK định kỳ, 16=sàng lọc Binding: Loại khám chữa bệnh — Vietnam Encounter Type ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
subject	SO	1..1	Reference(Bệnh nhân VN Core — VN Core Patient Profile)	Bệnh nhân Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
participant		0..*	BackboneElement	Bác sĩ/NVYT tham gia
individual		0..1	Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile)	Persons involved in the encounter other than the patient
appointment		0..*	Reference(Cuộc hẹn khám bệnh VN Core — VN Core Appointment Profile)	Cuộc hẹn đã đặt dẫn tới lượt khám này
period	SO	0..1	Period	Thời gian khám/nhập viện Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
reasonCode	SO	0..*	CodeableConcept	Lý do đến khám/chief complaint Binding: Mã chẩn đoán — VN Core Condition Code ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
text	S	0..1	string	Diễn giải tự do của lý do đến khám
diagnosis	SO	0..*	BackboneElement	Chẩn đoán Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
condition	S	1..1	Reference(Chẩn đoán VN Core — VN Core Condition Profile)	The diagnosis or procedure relevant to the encounter
use		0..1	CodeableConcept	Loại chẩn đoán (chính, phụ, nhập viện, ra viện)
account	SO	0..*	Reference(Tài khoản viện phí — VN Core Account)	Tài khoản viện phí gom chi phí của đợt điều trị Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
hospitalization		0..1	BackboneElement	Thông tin nhập viện/ra viện
dischargeDisposition	SO	0..1	CodeableConcept	Tình trạng ra viện Binding: Tình trạng ra viện — Vietnam Discharge Disposition ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
serviceProvider	SO	1..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile)	Cơ sở KCB Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Kho hồ sơ EMR (Repository)	Bên đáp ứng dữ liệu lõi (Data Responder)	Nguồn tạo hồ sơ lâm sàng (Document Source)
Encounter
Slices for extension
extension:referralMode	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
extension:treatmentOutcome	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
Slices for identifier
identifier:maLuotKcb	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
status	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
class	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
type	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
subject	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
period	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
reasonCode	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
diagnosis	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
account	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
hospitalization
dischargeDisposition	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
serviceProvider	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
Encounter.type	Base	extensible	Loại khám chữa bệnh — Vietnam Encounter Type ValueSet	📦0.10.0	This IG
Encounter.reasonCode	Base	extensible	Mã chẩn đoán — VN Core Condition Code ValueSet	📦0.10.0	This IG
Encounter.hospitalization.​dischargeDisposition	Base	extensible	Tình trạng ra viện — Vietnam Discharge Disposition ValueSet	📦0.10.0	This IG

Constraints

Id	Grade	Path(s)	Description	Expression
vn-encounter-telehealth-two-axes	error	Encounter	Lượt khám từ xa phải mang cả hai trục: `class = VR` (phương thức ảo) và `type` chứa mã 14 (loại hình KCB từ xa theo QĐ 1804/QĐ-BYT). A telehealth encounter SHALL carry both axes: virtual class and the national telemedicine encounter type.	(class.code = 'VR') = type.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-encounter-type-cs' and code = '14').exists()
vn-encounter-visit-code-issuer-scoped	error	Encounter	Mã lượt khám ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/ma-luot-kcb) phải kèm `assigner` chỉ rõ cơ sở cấp mã; khuyến nghị chính là mỗi cơ sở công bố URI riêng. A visit code recorded under the shared national placeholder URI SHALL name its assigning facility; per-facility namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/ma-luot-kcb').all(assigner.exists())

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Encounter	C	0..*	Encounter	An interaction during which services are provided to the patient Constraints: vn-encounter-visit-code-issuer-scoped, vn-encounter-telehealth-two-axes
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
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
extension:insuranceVisitType		0..1	CodeableConcept	Legacy-only trước 01/07/2024; không dùng cho trao đổi BHXH hiện hành URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-visit-type Binding: Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type ValueSet (required)
extension:referralMode	SO	0..1	CodeableConcept	Hình thức chuyển tuyến — trường HTCHUYEN (tự đến, chuyển lên, chuyển xuống, cùng tuyến, cấp cứu) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-referral-mode Binding: Hình thức chuyển tuyến — VN Referral Mode ValueSet (required) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
extension:treatmentOutcome	SO	0..1	CodeableConcept	Kết quả điều trị — xem VNTreatmentOutcomeVS URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-treatment-outcome Binding: Kết quả điều trị — Vietnam Treatment Outcome ValueSet (required) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
extension:paymentMethod		0..1	CodeableConcept	Phương thức thanh toán BHYT (FFS/Capitation/DRG) — trường MA_PTTT URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method Binding: Phương thức thanh toán BHYT — VN Payment Method ValueSet (extensible)
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	Σ	0..*	Identifier	Định danh lượt khám (gồm slice MA_LUOT_KCB) Slice: Unordered, Open by value:system
identifier:maLuotKcb	SOΣ	0..1	Identifier	Mã lượt KCB (MA_LUOT_KCB) theo convention VN Core; tương thích khoá MA_LK khi trao đổi BHYT Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	1..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: MA_LUOT_KCB
display		1..1	string	Representation defined by the system Fixed Value: Mã lượt khám chữa bệnh
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/ma-luot-kcb
value	Σ	1..1	string	The value that is unique Example General: 123456
period	Σ	0..1	Period	Time period when id is/was valid for use
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
status	?!SOΣ	1..1	code	Trạng thái lượt khám Binding: EncounterStatus (required): Current state of the encounter. Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
statusHistory		0..*	BackboneElement	List of past encounter statuses
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
status		1..1	code	planned | arrived | triaged | in-progress | onleave | finished | cancelled + Binding: EncounterStatus (required): Current state of the encounter.
period		1..1	Period	The time that the episode was in the specified status
class	SOΣ	1..1	Coding	Loại hình KCB: AMB (ngoại trú), IMP (nội trú), EMER (cấp cứu), VR (khám từ xa) Binding: ActEncounterCode (extensible): Classification of the encounter. Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
classHistory		0..*	BackboneElement	List of past encounter classes
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
class		1..1	Coding	inpatient | outpatient | ambulatory | emergency + Binding: ActEncounterCode (extensible): Classification of the encounter.
period		1..1	Period	The time that the episode was in the specified class
type	SOΣ	0..*	CodeableConcept	Loại hình KCB (MA_LOAI_KCB): 01=khám, 02=ngoại trú, 03=nội trú, 04=điều trị ban ngày, …, 14=từ xa, 15=KSK định kỳ, 16=sàng lọc Binding: Loại khám chữa bệnh — Vietnam Encounter Type ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
serviceType	Σ	0..1	CodeableConcept	Specific type of service Binding: ServiceType (example): Broad categorization of the service that is to be provided.
priority		0..1	CodeableConcept	Indicates the urgency of the encounter Binding: ActPriority (example): Indicates the urgency of the encounter.
subject	SOΣ	1..1	Reference(Bệnh nhân VN Core — VN Core Patient Profile)	Bệnh nhân Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
episodeOfCare	Σ	0..*	Reference(EpisodeOfCare)	Episode(s) of care that this encounter should be recorded against
basedOn		0..*	Reference(ServiceRequest)	The ServiceRequest that initiated this encounter
participant	Σ	0..*	BackboneElement	Bác sĩ/NVYT tham gia
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
type	Σ	0..*	CodeableConcept	Role of participant in encounter Binding: ParticipantType (extensible): Role of participant in encounter.
period		0..1	Period	Period of time during the encounter that the participant participated
individual	Σ	0..1	Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile)	Persons involved in the encounter other than the patient
appointment	Σ	0..*	Reference(Cuộc hẹn khám bệnh VN Core — VN Core Appointment Profile)	Cuộc hẹn đã đặt dẫn tới lượt khám này
period	SO	0..1	Period	Thời gian khám/nhập viện Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
length		0..1	Duration	Quantity of time the encounter lasted (less time absent)
reasonCode	SOΣ	0..*	CodeableConcept	Lý do đến khám/chief complaint Binding: Mã chẩn đoán — VN Core Condition Code ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
coding	Σ	0..*	Coding	Code defined by a terminology system
text	SΣ	0..1	string	Diễn giải tự do của lý do đến khám
reasonReference	Σ	0..*	Reference(Condition | Procedure | Observation | ImmunizationRecommendation)	Reason the encounter takes place (reference)
diagnosis	SOΣ	0..*	BackboneElement	Chẩn đoán Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
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
condition	SΣ	1..1	Reference(Chẩn đoán VN Core — VN Core Condition Profile)	The diagnosis or procedure relevant to the encounter
use		0..1	CodeableConcept	Loại chẩn đoán (chính, phụ, nhập viện, ra viện) Binding: DiagnosisRole (preferred): The type of diagnosis this condition represents.
rank		0..1	positiveInt	Ranking of the diagnosis (for each role type)
account	SO	0..*	Reference(Tài khoản viện phí — VN Core Account)	Tài khoản viện phí gom chi phí của đợt điều trị Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
hospitalization		0..1	BackboneElement	Thông tin nhập viện/ra viện
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
preAdmissionIdentifier		0..1	Identifier	Pre-admission identifier
origin		0..1	Reference(Location | Organization)	The location/organization from which the patient came before admission
admitSource		0..1	CodeableConcept	From where patient was admitted (physician referral, transfer) Binding: AdmitSource (preferred): From where the patient was admitted.
reAdmission		0..1	CodeableConcept	The type of hospital re-admission that has occurred (if any). If the value is absent, then this is not identified as a readmission Binding: Hl7VSReAdmissionIndicator (3.0.0) (example): The reason for re-admission of this hospitalization encounter.
dietPreference		0..*	CodeableConcept	Diet preferences reported by the patient Binding: Diet (example): Medical, cultural or ethical food preferences to help with catering requirements.
specialCourtesy		0..*	CodeableConcept	Special courtesies (VIP, board member) Binding: SpecialCourtesy (preferred): Special courtesies.
specialArrangement		0..*	CodeableConcept	Wheelchair, translator, stretcher, etc. Binding: SpecialArrangements (preferred): Special arrangements.
destination		0..1	Reference(Location | Organization)	Location/organization to which the patient is discharged
dischargeDisposition	SO	0..1	CodeableConcept	Tình trạng ra viện Binding: Tình trạng ra viện — Vietnam Discharge Disposition ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
location		0..*	BackboneElement	List of locations where the patient has been
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
location		1..1	Reference(Location)	Location the encounter takes place
status		0..1	code	planned | active | reserved | completed Binding: EncounterLocationStatus (required): The status of the location.
physicalType		0..1	CodeableConcept	The physical type of the location (usually the level in the location hierachy - bed room ward etc.) Binding: LocationType (example): Physical form of the location.
period		0..1	Period	Time period during which the patient was present at the location
serviceProvider	SO	1..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile)	Cơ sở KCB Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
partOf		0..1	Reference(Encounter)	Another Encounter this encounter is part of
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Kho hồ sơ EMR (Repository)	Bên đáp ứng dữ liệu lõi (Data Responder)	Nguồn tạo hồ sơ lâm sàng (Document Source)
Encounter
Slices for extension
extension:referralMode	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
extension:treatmentOutcome	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
Slices for identifier
identifier:maLuotKcb	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
status	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
class	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
type	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
subject	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
period	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
reasonCode	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
diagnosis	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
account	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
hospitalization
dischargeDisposition	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
serviceProvider	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Encounter.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
Encounter.identifier:maLuotKcb.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Encounter.identifier:maLuotKcb.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Encounter.status	Base	required	EncounterStatus	📍4.0.1	FHIR Std.
Encounter.statusHistory.​status	Base	required	EncounterStatus	📍4.0.1	FHIR Std.
Encounter.class	Base	extensible	ActEncounterCode	📦3.0.0	THO v7.2
Encounter.classHistory.​class	Base	extensible	ActEncounterCode	📦3.0.0	THO v7.2
Encounter.type	Base	extensible	Loại khám chữa bệnh — Vietnam Encounter Type ValueSet	📦0.10.0	This IG
Encounter.serviceType	Base	example	Service type	📍4.0.1	FHIR Std.
Encounter.priority	Base	example	ActPriority	📦3.0.0	THO v7.2
Encounter.participant.​type	Base	extensible	Participant type	📍4.0.1	FHIR Std.
Encounter.reasonCode	Base	extensible	Mã chẩn đoán — VN Core Condition Code ValueSet	📦0.10.0	This IG
Encounter.diagnosis.​use	Base	preferred	DiagnosisRole	📍4.0.1	FHIR Std.
Encounter.hospitalization.​admitSource	Base	preferred	Admit source	📍4.0.1	FHIR Std.
Encounter.hospitalization.​reAdmission	Base	example	hl7VS-re-admissionIndicator	📍3.0.0	THO v7.2
Encounter.hospitalization.​dietPreference	Base	example	Diet	📍4.0.1	FHIR Std.
Encounter.hospitalization.​specialCourtesy	Base	preferred	Special courtesy	📍4.0.1	FHIR Std.
Encounter.hospitalization.​specialArrangement	Base	preferred	Special arrangements	📍4.0.1	FHIR Std.
Encounter.hospitalization.​dischargeDisposition	Base	extensible	Tình trạng ra viện — Vietnam Discharge Disposition ValueSet	📦0.10.0	This IG
Encounter.location.status	Base	required	EncounterLocationStatus	📍4.0.1	FHIR Std.
Encounter.location.physicalType	Base	example	Location type	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Encounter	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Encounter	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	Encounter	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	Encounter	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Encounter	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()
vn-encounter-telehealth-two-axes	error	Encounter	Lượt khám từ xa phải mang cả hai trục: `class = VR` (phương thức ảo) và `type` chứa mã 14 (loại hình KCB từ xa theo QĐ 1804/QĐ-BYT). A telehealth encounter SHALL carry both axes: virtual class and the national telemedicine encounter type.	(class.code = 'VR') = type.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-encounter-type-cs' and code = '14').exists()
vn-encounter-visit-code-issuer-scoped	error	Encounter	Mã lượt khám ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/ma-luot-kcb) phải kèm `assigner` chỉ rõ cơ sở cấp mã; khuyến nghị chính là mỗi cơ sở công bố URI riêng. A visit code recorded under the shared national placeholder URI SHALL name its assigning facility; per-facility namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/ma-luot-kcb').all(assigner.exists())

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Kho hồ sơ EMR (Repository)	Bên đáp ứng dữ liệu lõi (Data Responder)	Nguồn tạo hồ sơ lâm sàng (Document Source)
Encounter
Slices for extension
extension:referralMode	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
extension:treatmentOutcome	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
Slices for identifier
identifier:maLuotKcb	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
status	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
class	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
type	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
subject	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
period	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
reasonCode	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
diagnosis	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
account	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
hospitalization
dischargeDisposition	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
serviceProvider	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
Documentation for this format

Summary

Mandatory: 2 elements(3 nested mandatory elements)
Must-Support: 15 elements
Fixed: 1 element

Structures

This structure refers to these other structures:

• Bệnh nhân VN Core — VN Core Patient Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient)
• Nhân viên y tế VN Core — VN Core Practitioner Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner)
• Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role)
• Cuộc hẹn khám bệnh VN Core — VN Core Appointment Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-appointment)
• Chẩn đoán VN Core — VN Core Condition Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition)
• Tài khoản viện phí — VN Core Account (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-account)
• Cơ sở y tế VN Core — VN Core Organization Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization)

Extensions

This structure refers to these extensions:

• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-visit-type
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-referral-mode
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-treatment-outcome
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method

Slices

This structure defines the following Slices:

• The element 1 is sliced based on the values of Encounter.identifier

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

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Encounter	C	0..*	Encounter	An interaction during which services are provided to the patient Constraints: vn-encounter-visit-code-issuer-scoped, vn-encounter-telehealth-two-axes
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:insuranceVisitType		0..1	CodeableConcept	Legacy-only trước 01/07/2024; không dùng cho trao đổi BHXH hiện hành URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-visit-type Binding: Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type ValueSet (required)
extension:referralMode	SO	0..1	CodeableConcept	Hình thức chuyển tuyến — trường HTCHUYEN (tự đến, chuyển lên, chuyển xuống, cùng tuyến, cấp cứu) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-referral-mode Binding: Hình thức chuyển tuyến — VN Referral Mode ValueSet (required) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
extension:treatmentOutcome	SO	0..1	CodeableConcept	Kết quả điều trị — xem VNTreatmentOutcomeVS URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-treatment-outcome Binding: Kết quả điều trị — Vietnam Treatment Outcome ValueSet (required) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
extension:paymentMethod		0..1	CodeableConcept	Phương thức thanh toán BHYT (FFS/Capitation/DRG) — trường MA_PTTT URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method Binding: Phương thức thanh toán BHYT — VN Payment Method ValueSet (extensible)
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	Σ	0..*	Identifier	Định danh lượt khám (gồm slice MA_LUOT_KCB) Slice: Unordered, Open by value:system
identifier:maLuotKcb	SOΣ	0..1	Identifier	Mã lượt KCB (MA_LUOT_KCB) theo convention VN Core; tương thích khoá MA_LK khi trao đổi BHYT Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	1..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: MA_LUOT_KCB
display		1..1	string	Representation defined by the system Fixed Value: Mã lượt khám chữa bệnh
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/ma-luot-kcb
value	Σ	1..1	string	The value that is unique Example General: 123456
status	?!SOΣ	1..1	code	Trạng thái lượt khám Binding: EncounterStatus (required): Current state of the encounter. Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
class	SOΣ	1..1	Coding	Loại hình KCB: AMB (ngoại trú), IMP (nội trú), EMER (cấp cứu), VR (khám từ xa) Binding: ActEncounterCode (extensible): Classification of the encounter. Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
type	SOΣ	0..*	CodeableConcept	Loại hình KCB (MA_LOAI_KCB): 01=khám, 02=ngoại trú, 03=nội trú, 04=điều trị ban ngày, …, 14=từ xa, 15=KSK định kỳ, 16=sàng lọc Binding: Loại khám chữa bệnh — Vietnam Encounter Type ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
subject	SOΣ	1..1	Reference(Bệnh nhân VN Core — VN Core Patient Profile)	Bệnh nhân Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
participant	Σ	0..*	BackboneElement	Bác sĩ/NVYT tham gia
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
individual	Σ	0..1	Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile)	Persons involved in the encounter other than the patient
appointment	Σ	0..*	Reference(Cuộc hẹn khám bệnh VN Core — VN Core Appointment Profile)	Cuộc hẹn đã đặt dẫn tới lượt khám này
period	SO	0..1	Period	Thời gian khám/nhập viện Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
reasonCode	SOΣ	0..*	CodeableConcept	Lý do đến khám/chief complaint Binding: Mã chẩn đoán — VN Core Condition Code ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
text	SΣ	0..1	string	Diễn giải tự do của lý do đến khám
diagnosis	SOΣ	0..*	BackboneElement	Chẩn đoán Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
condition	SΣ	1..1	Reference(Chẩn đoán VN Core — VN Core Condition Profile)	The diagnosis or procedure relevant to the encounter
use		0..1	CodeableConcept	Loại chẩn đoán (chính, phụ, nhập viện, ra viện) Binding: DiagnosisRole (preferred): The type of diagnosis this condition represents.
account	SO	0..*	Reference(Tài khoản viện phí — VN Core Account)	Tài khoản viện phí gom chi phí của đợt điều trị Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
hospitalization		0..1	BackboneElement	Thông tin nhập viện/ra viện
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
dischargeDisposition	SO	0..1	CodeableConcept	Tình trạng ra viện Binding: Tình trạng ra viện — Vietnam Discharge Disposition ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
serviceProvider	SO	1..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile)	Cơ sở KCB Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Kho hồ sơ EMR (Repository)	Bên đáp ứng dữ liệu lõi (Data Responder)	Nguồn tạo hồ sơ lâm sàng (Document Source)
Encounter
Slices for extension
extension:referralMode	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
extension:treatmentOutcome	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
Slices for identifier
identifier:maLuotKcb	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
status	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
class	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
type	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
subject	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
period	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
reasonCode	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
diagnosis	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
account	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
hospitalization
dischargeDisposition	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
serviceProvider	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Encounter.identifier:maLuotKcb.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Encounter.identifier:maLuotKcb.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Encounter.status	Base	required	EncounterStatus	📍4.0.1	FHIR Std.
Encounter.class	Base	extensible	ActEncounterCode	📦3.0.0	THO v7.2
Encounter.type	Base	extensible	Loại khám chữa bệnh — Vietnam Encounter Type ValueSet	📦0.10.0	This IG
Encounter.reasonCode	Base	extensible	Mã chẩn đoán — VN Core Condition Code ValueSet	📦0.10.0	This IG
Encounter.diagnosis.​use	Base	preferred	DiagnosisRole	📍4.0.1	FHIR Std.
Encounter.hospitalization.​dischargeDisposition	Base	extensible	Tình trạng ra viện — Vietnam Discharge Disposition ValueSet	📦0.10.0	This IG

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Encounter	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Encounter	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	Encounter	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	Encounter	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Encounter	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()
vn-encounter-telehealth-two-axes	error	Encounter	Lượt khám từ xa phải mang cả hai trục: `class = VR` (phương thức ảo) và `type` chứa mã 14 (loại hình KCB từ xa theo QĐ 1804/QĐ-BYT). A telehealth encounter SHALL carry both axes: virtual class and the national telemedicine encounter type.	(class.code = 'VR') = type.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-encounter-type-cs' and code = '14').exists()
vn-encounter-visit-code-issuer-scoped	error	Encounter	Mã lượt khám ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/ma-luot-kcb) phải kèm `assigner` chỉ rõ cơ sở cấp mã; khuyến nghị chính là mỗi cơ sở công bố URI riêng. A visit code recorded under the shared national placeholder URI SHALL name its assigning facility; per-facility namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/ma-luot-kcb').all(assigner.exists())

Dạng xem Differential

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Encounter	C	0..*	Encounter	An interaction during which services are provided to the patient Constraints: vn-encounter-visit-code-issuer-scoped, vn-encounter-telehealth-two-axes
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
extension:insuranceVisitType		0..1	CodeableConcept	Legacy-only trước 01/07/2024; không dùng cho trao đổi BHXH hiện hành URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-visit-type Binding: Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type ValueSet (required)
extension:referralMode	SO	0..1	CodeableConcept	Hình thức chuyển tuyến — trường HTCHUYEN (tự đến, chuyển lên, chuyển xuống, cùng tuyến, cấp cứu) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-referral-mode Binding: Hình thức chuyển tuyến — VN Referral Mode ValueSet (required) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
extension:treatmentOutcome	SO	0..1	CodeableConcept	Kết quả điều trị — xem VNTreatmentOutcomeVS URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-treatment-outcome Binding: Kết quả điều trị — Vietnam Treatment Outcome ValueSet (required) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
extension:paymentMethod		0..1	CodeableConcept	Phương thức thanh toán BHYT (FFS/Capitation/DRG) — trường MA_PTTT URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method Binding: Phương thức thanh toán BHYT — VN Payment Method ValueSet (extensible)
Slices for identifier		0..*	Identifier	Định danh lượt khám (gồm slice MA_LUOT_KCB) Slice: Unordered, Open by value:system
identifier:maLuotKcb	SO	0..1	Identifier	Mã lượt KCB (MA_LUOT_KCB) theo convention VN Core; tương thích khoá MA_LK khi trao đổi BHYT Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
type		1..1	CodeableConcept	Description of identifier Required Pattern: At least the following
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
code		1..1	code	Symbol in syntax defined by the system Fixed Value: MA_LUOT_KCB
display		1..1	string	Representation defined by the system Fixed Value: Mã lượt khám chữa bệnh
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/ma-luot-kcb
value		1..1	string	The value that is unique
status	SO	1..1	code	Trạng thái lượt khám Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
class	SO	1..1	Coding	Loại hình KCB: AMB (ngoại trú), IMP (nội trú), EMER (cấp cứu), VR (khám từ xa) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
type	SO	0..*	CodeableConcept	Loại hình KCB (MA_LOAI_KCB): 01=khám, 02=ngoại trú, 03=nội trú, 04=điều trị ban ngày, …, 14=từ xa, 15=KSK định kỳ, 16=sàng lọc Binding: Loại khám chữa bệnh — Vietnam Encounter Type ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
subject	SO	1..1	Reference(Bệnh nhân VN Core — VN Core Patient Profile)	Bệnh nhân Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
participant		0..*	BackboneElement	Bác sĩ/NVYT tham gia
individual		0..1	Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile)	Persons involved in the encounter other than the patient
appointment		0..*	Reference(Cuộc hẹn khám bệnh VN Core — VN Core Appointment Profile)	Cuộc hẹn đã đặt dẫn tới lượt khám này
period	SO	0..1	Period	Thời gian khám/nhập viện Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
reasonCode	SO	0..*	CodeableConcept	Lý do đến khám/chief complaint Binding: Mã chẩn đoán — VN Core Condition Code ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
text	S	0..1	string	Diễn giải tự do của lý do đến khám
diagnosis	SO	0..*	BackboneElement	Chẩn đoán Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
condition	S	1..1	Reference(Chẩn đoán VN Core — VN Core Condition Profile)	The diagnosis or procedure relevant to the encounter
use		0..1	CodeableConcept	Loại chẩn đoán (chính, phụ, nhập viện, ra viện)
account	SO	0..*	Reference(Tài khoản viện phí — VN Core Account)	Tài khoản viện phí gom chi phí của đợt điều trị Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
hospitalization		0..1	BackboneElement	Thông tin nhập viện/ra viện
dischargeDisposition	SO	0..1	CodeableConcept	Tình trạng ra viện Binding: Tình trạng ra viện — Vietnam Discharge Disposition ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
serviceProvider	SO	1..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile)	Cơ sở KCB Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Kho hồ sơ EMR (Repository)	Bên đáp ứng dữ liệu lõi (Data Responder)	Nguồn tạo hồ sơ lâm sàng (Document Source)
Encounter
Slices for extension
extension:referralMode	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
extension:treatmentOutcome	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
Slices for identifier
identifier:maLuotKcb	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
status	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
class	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
type	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
subject	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
period	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
reasonCode	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
diagnosis	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
account	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
hospitalization
dischargeDisposition	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
serviceProvider	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
Encounter.type	Base	extensible	Loại khám chữa bệnh — Vietnam Encounter Type ValueSet	📦0.10.0	This IG
Encounter.reasonCode	Base	extensible	Mã chẩn đoán — VN Core Condition Code ValueSet	📦0.10.0	This IG
Encounter.hospitalization.​dischargeDisposition	Base	extensible	Tình trạng ra viện — Vietnam Discharge Disposition ValueSet	📦0.10.0	This IG

Constraints

Id	Grade	Path(s)	Description	Expression
vn-encounter-telehealth-two-axes	error	Encounter	Lượt khám từ xa phải mang cả hai trục: `class = VR` (phương thức ảo) và `type` chứa mã 14 (loại hình KCB từ xa theo QĐ 1804/QĐ-BYT). A telehealth encounter SHALL carry both axes: virtual class and the national telemedicine encounter type.	(class.code = 'VR') = type.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-encounter-type-cs' and code = '14').exists()
vn-encounter-visit-code-issuer-scoped	error	Encounter	Mã lượt khám ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/ma-luot-kcb) phải kèm `assigner` chỉ rõ cơ sở cấp mã; khuyến nghị chính là mỗi cơ sở công bố URI riêng. A visit code recorded under the shared national placeholder URI SHALL name its assigning facility; per-facility namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/ma-luot-kcb').all(assigner.exists())

Dạng xem SnapshotView

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Encounter	C	0..*	Encounter	An interaction during which services are provided to the patient Constraints: vn-encounter-visit-code-issuer-scoped, vn-encounter-telehealth-two-axes
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
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
extension:insuranceVisitType		0..1	CodeableConcept	Legacy-only trước 01/07/2024; không dùng cho trao đổi BHXH hiện hành URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-visit-type Binding: Loại khám chữa bệnh BHYT — Vietnam Insurance Visit Type ValueSet (required)
extension:referralMode	SO	0..1	CodeableConcept	Hình thức chuyển tuyến — trường HTCHUYEN (tự đến, chuyển lên, chuyển xuống, cùng tuyến, cấp cứu) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-referral-mode Binding: Hình thức chuyển tuyến — VN Referral Mode ValueSet (required) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
extension:treatmentOutcome	SO	0..1	CodeableConcept	Kết quả điều trị — xem VNTreatmentOutcomeVS URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-treatment-outcome Binding: Kết quả điều trị — Vietnam Treatment Outcome ValueSet (required) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
extension:paymentMethod		0..1	CodeableConcept	Phương thức thanh toán BHYT (FFS/Capitation/DRG) — trường MA_PTTT URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method Binding: Phương thức thanh toán BHYT — VN Payment Method ValueSet (extensible)
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	Σ	0..*	Identifier	Định danh lượt khám (gồm slice MA_LUOT_KCB) Slice: Unordered, Open by value:system
identifier:maLuotKcb	SOΣ	0..1	Identifier	Mã lượt KCB (MA_LUOT_KCB) theo convention VN Core; tương thích khoá MA_LK khi trao đổi BHYT Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	1..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: At least the following
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
coding		1..*	Coding	Code defined by a terminology system Fixed Value: (Complex)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
system		1..1	uri	Identity of the terminology system Fixed Value: http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs
version		0..1	string	Version of the system - if relevant
code		1..1	code	Symbol in syntax defined by the system Fixed Value: MA_LUOT_KCB
display		1..1	string	Representation defined by the system Fixed Value: Mã lượt khám chữa bệnh
userSelected		0..1	boolean	If this coding was chosen directly by the user
text		0..1	string	Plain text representation of the concept
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/ma-luot-kcb
value	Σ	1..1	string	The value that is unique Example General: 123456
period	Σ	0..1	Period	Time period when id is/was valid for use
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
status	?!SOΣ	1..1	code	Trạng thái lượt khám Binding: EncounterStatus (required): Current state of the encounter. Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
statusHistory		0..*	BackboneElement	List of past encounter statuses
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
status		1..1	code	planned | arrived | triaged | in-progress | onleave | finished | cancelled + Binding: EncounterStatus (required): Current state of the encounter.
period		1..1	Period	The time that the episode was in the specified status
class	SOΣ	1..1	Coding	Loại hình KCB: AMB (ngoại trú), IMP (nội trú), EMER (cấp cứu), VR (khám từ xa) Binding: ActEncounterCode (extensible): Classification of the encounter. Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
classHistory		0..*	BackboneElement	List of past encounter classes
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
class		1..1	Coding	inpatient | outpatient | ambulatory | emergency + Binding: ActEncounterCode (extensible): Classification of the encounter.
period		1..1	Period	The time that the episode was in the specified class
type	SOΣ	0..*	CodeableConcept	Loại hình KCB (MA_LOAI_KCB): 01=khám, 02=ngoại trú, 03=nội trú, 04=điều trị ban ngày, …, 14=từ xa, 15=KSK định kỳ, 16=sàng lọc Binding: Loại khám chữa bệnh — Vietnam Encounter Type ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
serviceType	Σ	0..1	CodeableConcept	Specific type of service Binding: ServiceType (example): Broad categorization of the service that is to be provided.
priority		0..1	CodeableConcept	Indicates the urgency of the encounter Binding: ActPriority (example): Indicates the urgency of the encounter.
subject	SOΣ	1..1	Reference(Bệnh nhân VN Core — VN Core Patient Profile)	Bệnh nhân Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
episodeOfCare	Σ	0..*	Reference(EpisodeOfCare)	Episode(s) of care that this encounter should be recorded against
basedOn		0..*	Reference(ServiceRequest)	The ServiceRequest that initiated this encounter
participant	Σ	0..*	BackboneElement	Bác sĩ/NVYT tham gia
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
type	Σ	0..*	CodeableConcept	Role of participant in encounter Binding: ParticipantType (extensible): Role of participant in encounter.
period		0..1	Period	Period of time during the encounter that the participant participated
individual	Σ	0..1	Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile)	Persons involved in the encounter other than the patient
appointment	Σ	0..*	Reference(Cuộc hẹn khám bệnh VN Core — VN Core Appointment Profile)	Cuộc hẹn đã đặt dẫn tới lượt khám này
period	SO	0..1	Period	Thời gian khám/nhập viện Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
length		0..1	Duration	Quantity of time the encounter lasted (less time absent)
reasonCode	SOΣ	0..*	CodeableConcept	Lý do đến khám/chief complaint Binding: Mã chẩn đoán — VN Core Condition Code ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
coding	Σ	0..*	Coding	Code defined by a terminology system
text	SΣ	0..1	string	Diễn giải tự do của lý do đến khám
reasonReference	Σ	0..*	Reference(Condition | Procedure | Observation | ImmunizationRecommendation)	Reason the encounter takes place (reference)
diagnosis	SOΣ	0..*	BackboneElement	Chẩn đoán Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
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
condition	SΣ	1..1	Reference(Chẩn đoán VN Core — VN Core Condition Profile)	The diagnosis or procedure relevant to the encounter
use		0..1	CodeableConcept	Loại chẩn đoán (chính, phụ, nhập viện, ra viện) Binding: DiagnosisRole (preferred): The type of diagnosis this condition represents.
rank		0..1	positiveInt	Ranking of the diagnosis (for each role type)
account	SO	0..*	Reference(Tài khoản viện phí — VN Core Account)	Tài khoản viện phí gom chi phí của đợt điều trị Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
hospitalization		0..1	BackboneElement	Thông tin nhập viện/ra viện
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
preAdmissionIdentifier		0..1	Identifier	Pre-admission identifier
origin		0..1	Reference(Location | Organization)	The location/organization from which the patient came before admission
admitSource		0..1	CodeableConcept	From where patient was admitted (physician referral, transfer) Binding: AdmitSource (preferred): From where the patient was admitted.
reAdmission		0..1	CodeableConcept	The type of hospital re-admission that has occurred (if any). If the value is absent, then this is not identified as a readmission Binding: Hl7VSReAdmissionIndicator (3.0.0) (example): The reason for re-admission of this hospitalization encounter.
dietPreference		0..*	CodeableConcept	Diet preferences reported by the patient Binding: Diet (example): Medical, cultural or ethical food preferences to help with catering requirements.
specialCourtesy		0..*	CodeableConcept	Special courtesies (VIP, board member) Binding: SpecialCourtesy (preferred): Special courtesies.
specialArrangement		0..*	CodeableConcept	Wheelchair, translator, stretcher, etc. Binding: SpecialArrangements (preferred): Special arrangements.
destination		0..1	Reference(Location | Organization)	Location/organization to which the patient is discharged
dischargeDisposition	SO	0..1	CodeableConcept	Tình trạng ra viện Binding: Tình trạng ra viện — Vietnam Discharge Disposition ValueSet (extensible) Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
location		0..*	BackboneElement	List of locations where the patient has been
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
location		1..1	Reference(Location)	Location the encounter takes place
status		0..1	code	planned | active | reserved | completed Binding: EncounterLocationStatus (required): The status of the location.
physicalType		0..1	CodeableConcept	The physical type of the location (usually the level in the location hierachy - bed room ward etc.) Binding: LocationType (example): Physical form of the location.
period		0..1	Period	Time period during which the patient was present at the location
serviceProvider	SO	1..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile)	Cơ sở KCB Obligations Actor SHALL:populate-if-known Bên đáp ứng dữ liệu lõi (Data Responder) SHALL:no-error & SHALL:handle Bên yêu cầu dữ liệu lõi (Data Requester) SHALL:populate-if-known Nguồn tạo hồ sơ lâm sàng (Document Source) SHALL:no-error & SHALL:persist Kho hồ sơ EMR (Repository)
partOf		0..1	Reference(Encounter)	Another Encounter this encounter is part of
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Kho hồ sơ EMR (Repository)	Bên đáp ứng dữ liệu lõi (Data Responder)	Nguồn tạo hồ sơ lâm sàng (Document Source)
Encounter
Slices for extension
extension:referralMode	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
extension:treatmentOutcome	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
Slices for identifier
identifier:maLuotKcb	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
status	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
class	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
type	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
subject	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
period	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
reasonCode	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
diagnosis	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
account	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
hospitalization
dischargeDisposition	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
serviceProvider	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Encounter.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
Encounter.identifier:maLuotKcb.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Encounter.identifier:maLuotKcb.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Encounter.status	Base	required	EncounterStatus	📍4.0.1	FHIR Std.
Encounter.statusHistory.​status	Base	required	EncounterStatus	📍4.0.1	FHIR Std.
Encounter.class	Base	extensible	ActEncounterCode	📦3.0.0	THO v7.2
Encounter.classHistory.​class	Base	extensible	ActEncounterCode	📦3.0.0	THO v7.2
Encounter.type	Base	extensible	Loại khám chữa bệnh — Vietnam Encounter Type ValueSet	📦0.10.0	This IG
Encounter.serviceType	Base	example	Service type	📍4.0.1	FHIR Std.
Encounter.priority	Base	example	ActPriority	📦3.0.0	THO v7.2
Encounter.participant.​type	Base	extensible	Participant type	📍4.0.1	FHIR Std.
Encounter.reasonCode	Base	extensible	Mã chẩn đoán — VN Core Condition Code ValueSet	📦0.10.0	This IG
Encounter.diagnosis.​use	Base	preferred	DiagnosisRole	📍4.0.1	FHIR Std.
Encounter.hospitalization.​admitSource	Base	preferred	Admit source	📍4.0.1	FHIR Std.
Encounter.hospitalization.​reAdmission	Base	example	hl7VS-re-admissionIndicator	📍3.0.0	THO v7.2
Encounter.hospitalization.​dietPreference	Base	example	Diet	📍4.0.1	FHIR Std.
Encounter.hospitalization.​specialCourtesy	Base	preferred	Special courtesy	📍4.0.1	FHIR Std.
Encounter.hospitalization.​specialArrangement	Base	preferred	Special arrangements	📍4.0.1	FHIR Std.
Encounter.hospitalization.​dischargeDisposition	Base	extensible	Tình trạng ra viện — Vietnam Discharge Disposition ValueSet	📦0.10.0	This IG
Encounter.location.status	Base	required	EncounterLocationStatus	📍4.0.1	FHIR Std.
Encounter.location.physicalType	Base	example	Location type	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Encounter	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Encounter	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	Encounter	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	Encounter	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Encounter	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()
vn-encounter-telehealth-two-axes	error	Encounter	Lượt khám từ xa phải mang cả hai trục: `class = VR` (phương thức ảo) và `type` chứa mã 14 (loại hình KCB từ xa theo QĐ 1804/QĐ-BYT). A telehealth encounter SHALL carry both axes: virtual class and the national telemedicine encounter type.	(class.code = 'VR') = type.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-encounter-type-cs' and code = '14').exists()
vn-encounter-visit-code-issuer-scoped	error	Encounter	Mã lượt khám ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/ma-luot-kcb) phải kèm `assigner` chỉ rõ cơ sở cấp mã; khuyến nghị chính là mỗi cơ sở công bố URI riêng. A visit code recorded under the shared national placeholder URI SHALL name its assigning facility; per-facility namespace URIs are preferred.	identifier.where(system = 'http://fhir.hl7.org.vn/core/sid/ma-luot-kcb').all(assigner.exists())

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Kho hồ sơ EMR (Repository)	Bên đáp ứng dữ liệu lõi (Data Responder)	Nguồn tạo hồ sơ lâm sàng (Document Source)
Encounter
Slices for extension
extension:referralMode	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
extension:treatmentOutcome	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
Slices for identifier
identifier:maLuotKcb	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
status	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
class	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
type	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
subject	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
period	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
reasonCode	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
diagnosis	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
account	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
hospitalization
dischargeDisposition	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
serviceProvider	SHALL:no-error & SHALL:handle	SHALL:no-error & SHALL:persist	SHALL:populate-if-known	SHALL:populate-if-known
Documentation for this format

Summary

Mandatory: 2 elements(3 nested mandatory elements)
Must-Support: 15 elements
Fixed: 1 element

Structures

This structure refers to these other structures:

• Bệnh nhân VN Core — VN Core Patient Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient)
• Nhân viên y tế VN Core — VN Core Practitioner Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner)
• Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role)
• Cuộc hẹn khám bệnh VN Core — VN Core Appointment Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-appointment)
• Chẩn đoán VN Core — VN Core Condition Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition)
• Tài khoản viện phí — VN Core Account (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-account)
• Cơ sở y tế VN Core — VN Core Organization Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization)

Extensions

This structure refers to these extensions:

• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-visit-type
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-referral-mode
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-treatment-outcome
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method

Slices

This structure defines the following Slices:

• The element 1 is sliced based on the values of Encounter.identifier