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: Cơ sở y tế VN Core — VN Core Organization Profile

Profile Organization cho cơ sở y tế Việt Nam. Bao gồm identifier mã CSKCB, extensions loại hình/cấp quản lý/phân hạng/cấp KCB hiện hành, và địa chỉ theo VNCoreAddress. Đây là profile CƠ SỞ CHUNG cho mọi tổ chức trong dữ liệu y tế. Cơ sở khám bệnh, chữa bệnh thuộc phạm vi Luật 15/2023/QH15 Điều 48-56 phải conform thêm profile con VNCoreKCBOrganization để mang số giấy phép hoạt động và trạng thái của giấy phép. Vòng đời mã cơ sở (identifier.period + extension orgLifecycleRelation) hỗ trợ biểu diễn sáp nhập/chia tách/đổi mã cơ sở y tế — generic cho mọi cơ sở, đặc biệt khi sắp xếp đơn vị hành chính. Căn cứ:

• Luật KCB 2023 — Điều 47-48 — hình thức tổ chức cơ sở KCB
• NĐ 96/2023/NĐ-CP — 30/12/2023 — hướng dẫn Luật KCB
• NĐ 102/2025/NĐ-CP — 13/5/2025 — CSDL quốc gia về y tế, dữ liệu cơ sở y tế, vòng đời dữ liệu
• NQ 202/2025/QH15 — sắp xếp ĐVHC cấp tỉnh → cơ sở y tế sáp nhập/chia tách (driver vòng đời mã)
• QĐ 11/2026/QĐ-TTg — 28/3/2026 — danh mục CSDL quốc gia, bao gồm CSDL quốc gia về y tế
• TT 06/2024/TT-BYT — 16/5/2024 — phân hạng cơ sở KCB
• TT 35/2024/TT-BYT — 16/11/2024 — tiêu chuẩn chất lượng cơ bản đối với bệnh viện.

Usages:

• Derived from this Profile: Cơ sở khám bệnh, chữa bệnh VN Core — VN Core KCB Organization Profile
• Use this Profile: Bundle hồ sơ thanh toán BHYT — VN Core BHYT Submission Bundle
• Refer to this Profile: Tài khoản viện phí — VN Core Account, Quyết định xử lý dựa trên căn cứ pháp lý — VN Core Legal-Basis Decision AuditEvent, Nhóm chăm sóc VN Core — VN Core CareTeam Profile, Dòng chi phí phát sinh — VN Core ChargeItem... Show 40 more, Kiến nghị xem xét lại chi phí BHYT — VN Core BHYT Cost Appeal Task, Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile, Giấy chứng sinh — VN Core Birth Certificate Composition, Thông báo vi phạm DLCN (Mẫu 08) — VN Core Breach Notification Composition 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, Giấy chứng sinh mang thai hộ — VN Core Surrogacy Birth Certificate Composition, Bệnh án điện tử VN Core — VN Core Composition Profile, Đồng ý xử lý dữ liệu VN Core — VN Core Consent Profile, Bản ghi attestation bảng kê chi phí khám bệnh, chữa bệnh — VN Core Cost Statement Composition, Bảng kê chi phí khám bệnh, chữa bệnh — VN Core Cost Statement Invoice, Yêu cầu tra cứu quyền lợi BHYT VN Core — VN Core Coverage Eligibility Request Profile, Báo cáo Chẩn đoán hình ảnh VN Core — VN Core Imaging DiagnosticReport, Báo cáo cận lâm sàng VN Core — VN Core DiagnosticReport Profile, Bản Giấy chứng sinh đã ký — VN Core Birth Certificate DocumentReference, Tài liệu y tế VN Core — VN Core DocumentReference Profile, Lượt khám/nhập viện VN Core — VN Core Encounter Profile, Đợt chăm sóc VN Core — VN Core EpisodeOfCare Profile, Giải trình quyền lợi BHYT VN Core — VN Core ExplanationOfBenefit Profile, Nhóm đối tượng VN Core — VN Core Group Profile, Dịch vụ y tế VN Core — VN Core HealthcareService Profile, Tiêm chủng — VN Core Immunization, Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile, Kết quả đo chỉ tiêu VN Core — VN Core MeasureReport Profile, Cấp phát thuốc VN Core — VN Core Medication Dispense Profile, Phân loại sức khoẻ VN Core — VN Core Observation Health Classification Profile, Xét nghiệm VN Core — VN Core Observation Laboratory Profile, Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile, Khoa/Phòng VN Core — VN Core Organization Department Profile, Vai trò nhân viên y tế VN Core — VN Core PractitionerRole 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, Công việc điều phối VN Core — VN Core Task Profile, Nội dung đã thông báo khi xin đồng ý — Consent Disclosure Evidence Extension, Quan hệ vòng đời mã cơ sở y tế — Organization Facility-Code Lifecycle Relation Extension, Bằng chứng chuyển đổi giấy ↔ điện tử — Paper/Electronic Conversion Evidence Extension, Cơ sở áp dụng bảng giá — Price List Facility Extension, Nơi đăng ký KCB ban đầu — Vietnam Primary Care Facility Extension, Cơ quan hướng dẫn chuyên môn — Supervising Clinical Authority Extension and Quyết toán chi phí KCB BHYT theo quý — VN Core Quarterly Healthcare Cost Settlement
• Examples for this Profile: Trung tâm Y tế khu vực Cầu Giấy, Bệnh viện Đa khoa Gia Lâm, Nhà thuốc Bệnh viện Chợ Rẫy, Trung tâm Y tế khu vực Cầu Giấy... Show 5 more, Trạm Y tế xã Phú Mỹ, Trung tâm Kiểm soát bệnh tật thành phố Quảng Ninh, Nhà thuốc Bệnh viện Chợ Rẫy, Trạm Y tế xã Phú Mỹ and Bệnh viện Bạch Mai
• CapabilityStatements using this Profile: VN Core BHYT Gateway Client CapabilityStatement, VN Core BHYT Gateway Server CapabilityStatement, VN Core Data Requester CapabilityStatement, VN Core Data Responder 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
Organization	C	0..*	Organization	A grouping of people or organizations with a common purpose Constraints: org-1, vn-organization-local-id-issuer-scoped
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:organizationType	SO	0..1	CodeableConcept	Loại hình CSYT (BV, PK, TYT...) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-type Binding: Loại hình cơ sở y tế — Vietnam Organization Type 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:organizationLevel	SO	0..1	CodeableConcept	Cấp quản lý hành chính (TW, Tỉnh, Xã) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-level Binding: Cấp quản lý hành chính y tế — Vietnam Administrative Health Level 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:organizationRank		0..1	CodeableConcept	Hạng pháp lý của cơ sở KCB (Đặc biệt, I, II, III) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank Binding: Hạng cơ sở khám chữa bệnh — Vietnam Healthcare Facility Rank ValueSet (required)
extension:healthUnitRank		0..1	CodeableConcept	Hạng pháp lý của đơn vị y tế không phải cơ sở KCB (I-IV) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-health-unit-rank Binding: Hạng đơn vị sự nghiệp y tế không phải cơ sở KCB — Vietnam Non-KCB Health Unit Rank ValueSet (required)
extension:organizationRankStatus		0..1	CodeableConcept	Tình trạng xếp hạng (đã xếp, chưa xếp, không áp dụng) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank-status Binding: Tình trạng xếp hạng của cơ sở y tế — Vietnam Organization Rank Status ValueSet (required)
extension:facilityCareLevel	SO	0..1	CodeableConcept	Cấp KCB hiện hành (ban đầu, cơ bản, chuyên sâu) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level Binding: Cấp năng lực cơ sở KCB — Vietnam Facility Care Level ValueSet (required) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:legacyTechnicalLine		0..1	CodeableConcept	Tuyến chuyên môn kỹ thuật lịch sử theo TT 43/2013/TT-BYT (legacy) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legacy-technical-line Binding: Tuyến chuyên môn kỹ thuật lịch sử — Vietnam Legacy Technical Line ValueSet (required)
extension:qualityScoreBand		0..1	CodeableConcept	Dải điểm chất lượng phục vụ xác định quyền lợi BHYT URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band Binding: Dải điểm chất lượng cơ sở KCB — Vietnam Quality Score Band ValueSet (required)
extension:supervisingAuthority		0..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile | Organization)	Cơ quan hướng dẫn chuyên môn (vd: Sở Y tế đối với TYT cấp xã) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-supervising-authority
extension:orgLifecycleRelation		0..*	(Complex)	Quan hệ vòng đời mã cơ sở (tiền nhiệm/kế nhiệm/sáp nhập/tách) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	SOΣC	1..*	Identifier	Định danh CSYT (mã CSKCB hoặc mã quản lý hợp lệ khác) Slice: Unordered, Open by value:system 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
identifier:All Slices				Content/Rules for all slices
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
period	SΣ	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
identifier:CSKCB	SOΣC	0..1	Identifier	Mã CSKCB (5 chữ số) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..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: CSKCB
display		0..1	string	Representation defined by the system
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-cskcb
value	SΣ	1..1	string	The value that is unique Example General: 123456
period	SΣ	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
identifier:MaGtin	SOΣC	0..1	Identifier	Mã định danh cơ sở KCB 13 ký tự (MA_GTIN_CSKCB) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..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: CSKCB13
display		0..1	string	Representation defined by the system
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-gtin-cskcb
value	SΣC	1..1	string	The value that is unique Constraints: vn-org-ma-gtin-13-digit Example General: 123456
period	SΣ	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
identifier:Local	SOΣC	0..*	Identifier	Mã quản lý cục bộ của đơn vị 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/organization-local-id
value	Σ	1..1	string	The value that is unique Example General: 123456
period	SΣ	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
active	?!SOΣ	0..1	boolean	Đang hoạt động 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type	Σ	0..*	CodeableConcept	Loại tổ chức (FHIR base) Binding: OrganizationType (example): Used to categorize the organization.
name	SOΣC	1..1	string	Tên cơ sở y tế 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
telecom	C	0..*	ContactPoint	SĐT, email, website Constraints: org-3
address	SOC	0..*	VNCoreAddress	Địa chỉ CSYT Constraints: org-2 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
endpoint	SO	0..*	Reference(Endpoint)	Endpoint điện tử (vd: gdbhyt portal cho CSKCB ký hợp đồng BHXH) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Bên đáp ứng dữ liệu lõi (Data Responder)	Bên giám định BHYT (Adjudicator)	Bên gửi hồ sơ BHYT (Submitter)
Organization
Slices for extension
extension:organizationType	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
extension:organizationLevel	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
extension:facilityCareLevel	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:All Slices
identifier:CSKCB	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:MaGtin	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:Local	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
active	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
name	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
address	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
endpoint	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Organization.identifier.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.identifier:CSKCB.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.identifier:CSKCB.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Organization.identifier:MaGtin.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.identifier:MaGtin.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Organization.identifier:Local.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.type	Base	example	Organization type	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Organization	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Organization	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	Organization	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	Organization	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Organization	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()
org-1	error	Organization	The organization SHALL at least have a name or an identifier, and possibly more than one	(identifier.count() + name.count()) > 0
org-2	error	Organization.address	An address of an organization can never be of use 'home'	where(use = 'home').empty()
org-3	error	Organization.telecom	The telecom of an organization can never be of use 'home'	where(use = 'home').empty()
vn-org-ma-gtin-13-digit	error	Organization.identifier:MaGtin.value	Mã định danh cơ sở KCB (MA_GTIN_CSKCB) phải đúng 13 ký tự số theo QĐ 1551/QĐ-BYT đã được QĐ 2062/QĐ-BYT thay Phụ lục 01-03	$this.empty() or $this.matches('^[0-9]{13}$')
vn-organization-local-id-issuer-scoped	error	Organization	Mã tổ chức nội bộ ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/organization-local-id) 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 local organization identifier 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/organization-local-id').all(assigner.reference.exists())

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Organization	C	0..*	Organization	A grouping of people or organizations with a common purpose Constraints: vn-organization-local-id-issuer-scoped
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
extension:organizationType	SO	0..1	CodeableConcept	Loại hình CSYT (BV, PK, TYT...) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-type Binding: Loại hình cơ sở y tế — Vietnam Organization Type 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:organizationLevel	SO	0..1	CodeableConcept	Cấp quản lý hành chính (TW, Tỉnh, Xã) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-level Binding: Cấp quản lý hành chính y tế — Vietnam Administrative Health Level 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:organizationRank		0..1	CodeableConcept	Hạng pháp lý của cơ sở KCB (Đặc biệt, I, II, III) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank Binding: Hạng cơ sở khám chữa bệnh — Vietnam Healthcare Facility Rank ValueSet (required)
extension:healthUnitRank		0..1	CodeableConcept	Hạng pháp lý của đơn vị y tế không phải cơ sở KCB (I-IV) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-health-unit-rank Binding: Hạng đơn vị sự nghiệp y tế không phải cơ sở KCB — Vietnam Non-KCB Health Unit Rank ValueSet (required)
extension:organizationRankStatus		0..1	CodeableConcept	Tình trạng xếp hạng (đã xếp, chưa xếp, không áp dụng) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank-status Binding: Tình trạng xếp hạng của cơ sở y tế — Vietnam Organization Rank Status ValueSet (required)
extension:facilityCareLevel	SO	0..1	CodeableConcept	Cấp KCB hiện hành (ban đầu, cơ bản, chuyên sâu) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level Binding: Cấp năng lực cơ sở KCB — Vietnam Facility Care Level ValueSet (required) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:legacyTechnicalLine		0..1	CodeableConcept	Tuyến chuyên môn kỹ thuật lịch sử theo TT 43/2013/TT-BYT (legacy) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legacy-technical-line Binding: Tuyến chuyên môn kỹ thuật lịch sử — Vietnam Legacy Technical Line ValueSet (required)
extension:qualityScoreBand		0..1	CodeableConcept	Dải điểm chất lượng phục vụ xác định quyền lợi BHYT URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band Binding: Dải điểm chất lượng cơ sở KCB — Vietnam Quality Score Band ValueSet (required)
extension:supervisingAuthority		0..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile | Organization)	Cơ quan hướng dẫn chuyên môn (vd: Sở Y tế đối với TYT cấp xã) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-supervising-authority
extension:orgLifecycleRelation		0..*	(Complex)	Quan hệ vòng đời mã cơ sở (tiền nhiệm/kế nhiệm/sáp nhập/tách) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation
Slices for identifier	SO	1..*	Identifier	Định danh CSYT (mã CSKCB hoặc mã quản lý hợp lệ khác) Slice: Unordered, Open by value:system 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
identifier:All Slices				Content/Rules for all slices
period	S	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
identifier:CSKCB	SO	0..1	Identifier	Mã CSKCB (5 chữ số) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		0..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: CSKCB
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/ma-cskcb
value	S	1..1	string	The value that is unique
period	S	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
identifier:MaGtin	SO	0..1	Identifier	Mã định danh cơ sở KCB 13 ký tự (MA_GTIN_CSKCB) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		0..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: CSKCB13
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/ma-gtin-cskcb
value	SC	1..1	string	The value that is unique Constraints: vn-org-ma-gtin-13-digit
period	S	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
identifier:Local	SO	0..*	Identifier	Mã quản lý cục bộ của đơn vị 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/organization-local-id
value		1..1	string	The value that is unique
period	S	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
active	SO	0..1	boolean	Đang hoạt động 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		0..*	CodeableConcept	Loại tổ chức (FHIR base)
name	SO	1..1	string	Tên cơ sở y tế 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
telecom		0..*	ContactPoint	SĐT, email, website
address	SO	0..*	VNCoreAddress	Địa chỉ CSYT 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
endpoint	SO	0..*	Reference(Endpoint)	Endpoint điện tử (vd: gdbhyt portal cho CSKCB ký hợp đồng BHXH) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Bên đáp ứng dữ liệu lõi (Data Responder)	Bên giám định BHYT (Adjudicator)	Bên gửi hồ sơ BHYT (Submitter)
Organization
Slices for extension
extension:organizationType	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
extension:organizationLevel	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
extension:facilityCareLevel	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:All Slices
identifier:CSKCB	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:MaGtin	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:Local	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
active	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
name	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
address	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
endpoint	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
Documentation for this format

Constraints

Id	Grade	Path(s)	Description	Expression
vn-org-ma-gtin-13-digit	error	Organization.identifier:MaGtin.value	Mã định danh cơ sở KCB (MA_GTIN_CSKCB) phải đúng 13 ký tự số theo QĐ 1551/QĐ-BYT đã được QĐ 2062/QĐ-BYT thay Phụ lục 01-03	$this.empty() or $this.matches('^[0-9]{13}$')
vn-organization-local-id-issuer-scoped	error	Organization	Mã tổ chức nội bộ ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/organization-local-id) 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 local organization identifier 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/organization-local-id').all(assigner.reference.exists())

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Organization	C	0..*	Organization	A grouping of people or organizations with a common purpose Constraints: org-1, vn-organization-local-id-issuer-scoped
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:organizationType	SO	0..1	CodeableConcept	Loại hình CSYT (BV, PK, TYT...) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-type Binding: Loại hình cơ sở y tế — Vietnam Organization Type 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:organizationLevel	SO	0..1	CodeableConcept	Cấp quản lý hành chính (TW, Tỉnh, Xã) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-level Binding: Cấp quản lý hành chính y tế — Vietnam Administrative Health Level 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:organizationRank		0..1	CodeableConcept	Hạng pháp lý của cơ sở KCB (Đặc biệt, I, II, III) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank Binding: Hạng cơ sở khám chữa bệnh — Vietnam Healthcare Facility Rank ValueSet (required)
extension:healthUnitRank		0..1	CodeableConcept	Hạng pháp lý của đơn vị y tế không phải cơ sở KCB (I-IV) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-health-unit-rank Binding: Hạng đơn vị sự nghiệp y tế không phải cơ sở KCB — Vietnam Non-KCB Health Unit Rank ValueSet (required)
extension:organizationRankStatus		0..1	CodeableConcept	Tình trạng xếp hạng (đã xếp, chưa xếp, không áp dụng) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank-status Binding: Tình trạng xếp hạng của cơ sở y tế — Vietnam Organization Rank Status ValueSet (required)
extension:facilityCareLevel	SO	0..1	CodeableConcept	Cấp KCB hiện hành (ban đầu, cơ bản, chuyên sâu) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level Binding: Cấp năng lực cơ sở KCB — Vietnam Facility Care Level ValueSet (required) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:legacyTechnicalLine		0..1	CodeableConcept	Tuyến chuyên môn kỹ thuật lịch sử theo TT 43/2013/TT-BYT (legacy) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legacy-technical-line Binding: Tuyến chuyên môn kỹ thuật lịch sử — Vietnam Legacy Technical Line ValueSet (required)
extension:qualityScoreBand		0..1	CodeableConcept	Dải điểm chất lượng phục vụ xác định quyền lợi BHYT URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band Binding: Dải điểm chất lượng cơ sở KCB — Vietnam Quality Score Band ValueSet (required)
extension:supervisingAuthority		0..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile | Organization)	Cơ quan hướng dẫn chuyên môn (vd: Sở Y tế đối với TYT cấp xã) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-supervising-authority
extension:orgLifecycleRelation		0..*	(Complex)	Quan hệ vòng đời mã cơ sở (tiền nhiệm/kế nhiệm/sáp nhập/tách) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	SOΣC	1..*	Identifier	Định danh CSYT (mã CSKCB hoặc mã quản lý hợp lệ khác) Slice: Unordered, Open by value:system 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
identifier:All Slices				Content/Rules for all slices
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	Σ	0..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.
system	Σ	0..1	uri	The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value	Σ	0..1	string	The value that is unique Example General: 123456
period	SΣ	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
identifier:CSKCB	SOΣC	0..1	Identifier	Mã CSKCB (5 chữ số) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	0..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: CSKCB
display		0..1	string	Representation defined by the system
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-cskcb
value	SΣ	1..1	string	The value that is unique Example General: 123456
period	SΣ	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
identifier:MaGtin	SOΣC	0..1	Identifier	Mã định danh cơ sở KCB 13 ký tự (MA_GTIN_CSKCB) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	0..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: CSKCB13
display		0..1	string	Representation defined by the system
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-gtin-cskcb
value	SΣC	1..1	string	The value that is unique Constraints: vn-org-ma-gtin-13-digit Example General: 123456
period	SΣ	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
identifier:Local	SOΣC	0..*	Identifier	Mã quản lý cục bộ của đơn vị 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	0..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.
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/organization-local-id
value	Σ	1..1	string	The value that is unique Example General: 123456
period	SΣ	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
active	?!SOΣ	0..1	boolean	Đang hoạt động 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type	Σ	0..*	CodeableConcept	Loại tổ chức (FHIR base) Binding: OrganizationType (example): Used to categorize the organization.
name	SOΣC	1..1	string	Tên cơ sở y tế 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
alias		0..*	string	A list of alternate names that the organization is known as, or was known as in the past
telecom	C	0..*	ContactPoint	SĐT, email, website Constraints: org-3
address	SOC	0..*	VNCoreAddress	Địa chỉ CSYT Constraints: org-2 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
partOf	Σ	0..1	Reference(Organization)	The organization of which this organization forms a part
contact		0..*	BackboneElement	Contact for the organization for a certain purpose
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
purpose		0..1	CodeableConcept	The type of contact Binding: ContactEntityType (extensible): The purpose for which you would contact a contact party.
name		0..1	HumanName	A name associated with the contact
telecom		0..*	ContactPoint	Contact details (telephone, email, etc.) for a contact
address		0..1	Address	Visiting or postal addresses for the contact
endpoint	SO	0..*	Reference(Endpoint)	Endpoint điện tử (vd: gdbhyt portal cho CSKCB ký hợp đồng BHXH) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Bên đáp ứng dữ liệu lõi (Data Responder)	Bên giám định BHYT (Adjudicator)	Bên gửi hồ sơ BHYT (Submitter)
Organization
Slices for extension
extension:organizationType	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
extension:organizationLevel	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
extension:facilityCareLevel	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:All Slices
identifier:CSKCB	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:MaGtin	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:Local	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
active	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
name	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
address	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
endpoint	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Organization.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
Organization.identifier.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.identifier.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Organization.identifier:CSKCB.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.identifier:CSKCB.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Organization.identifier:MaGtin.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.identifier:MaGtin.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Organization.identifier:Local.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.identifier:Local.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Organization.type	Base	example	Organization type	📍4.0.1	FHIR Std.
Organization.contact.​purpose	Base	extensible	Contact entity type	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Organization	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Organization	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	Organization	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	Organization	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Organization	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()
org-1	error	Organization	The organization SHALL at least have a name or an identifier, and possibly more than one	(identifier.count() + name.count()) > 0
org-2	error	Organization.address	An address of an organization can never be of use 'home'	where(use = 'home').empty()
org-3	error	Organization.telecom	The telecom of an organization can never be of use 'home'	where(use = 'home').empty()
vn-org-ma-gtin-13-digit	error	Organization.identifier:MaGtin.value	Mã định danh cơ sở KCB (MA_GTIN_CSKCB) phải đúng 13 ký tự số theo QĐ 1551/QĐ-BYT đã được QĐ 2062/QĐ-BYT thay Phụ lục 01-03	$this.empty() or $this.matches('^[0-9]{13}$')
vn-organization-local-id-issuer-scoped	error	Organization	Mã tổ chức nội bộ ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/organization-local-id) 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 local organization identifier 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/organization-local-id').all(assigner.reference.exists())

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Bên đáp ứng dữ liệu lõi (Data Responder)	Bên giám định BHYT (Adjudicator)	Bên gửi hồ sơ BHYT (Submitter)
Organization
Slices for extension
extension:organizationType	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
extension:organizationLevel	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
extension:facilityCareLevel	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:All Slices
identifier:CSKCB	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:MaGtin	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:Local	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
active	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
name	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
address	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
endpoint	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
Documentation for this format

Summary

Mandatory: 2 elements(6 nested mandatory elements)
Must-Support: 17 elements
Fixed: 3 elements

Structures

This structure refers to these other structures:

• Địa chỉ VN Core — VN Core Address Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-address)

Extensions

This structure refers to these extensions:

• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-type
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-level
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-health-unit-rank
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank-status
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legacy-technical-line
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-supervising-authority
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation

Slices

This structure defines the following Slices:

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

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

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Organization	C	0..*	Organization	A grouping of people or organizations with a common purpose Constraints: org-1, vn-organization-local-id-issuer-scoped
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:organizationType	SO	0..1	CodeableConcept	Loại hình CSYT (BV, PK, TYT...) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-type Binding: Loại hình cơ sở y tế — Vietnam Organization Type 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:organizationLevel	SO	0..1	CodeableConcept	Cấp quản lý hành chính (TW, Tỉnh, Xã) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-level Binding: Cấp quản lý hành chính y tế — Vietnam Administrative Health Level 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:organizationRank		0..1	CodeableConcept	Hạng pháp lý của cơ sở KCB (Đặc biệt, I, II, III) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank Binding: Hạng cơ sở khám chữa bệnh — Vietnam Healthcare Facility Rank ValueSet (required)
extension:healthUnitRank		0..1	CodeableConcept	Hạng pháp lý của đơn vị y tế không phải cơ sở KCB (I-IV) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-health-unit-rank Binding: Hạng đơn vị sự nghiệp y tế không phải cơ sở KCB — Vietnam Non-KCB Health Unit Rank ValueSet (required)
extension:organizationRankStatus		0..1	CodeableConcept	Tình trạng xếp hạng (đã xếp, chưa xếp, không áp dụng) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank-status Binding: Tình trạng xếp hạng của cơ sở y tế — Vietnam Organization Rank Status ValueSet (required)
extension:facilityCareLevel	SO	0..1	CodeableConcept	Cấp KCB hiện hành (ban đầu, cơ bản, chuyên sâu) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level Binding: Cấp năng lực cơ sở KCB — Vietnam Facility Care Level ValueSet (required) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:legacyTechnicalLine		0..1	CodeableConcept	Tuyến chuyên môn kỹ thuật lịch sử theo TT 43/2013/TT-BYT (legacy) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legacy-technical-line Binding: Tuyến chuyên môn kỹ thuật lịch sử — Vietnam Legacy Technical Line ValueSet (required)
extension:qualityScoreBand		0..1	CodeableConcept	Dải điểm chất lượng phục vụ xác định quyền lợi BHYT URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band Binding: Dải điểm chất lượng cơ sở KCB — Vietnam Quality Score Band ValueSet (required)
extension:supervisingAuthority		0..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile | Organization)	Cơ quan hướng dẫn chuyên môn (vd: Sở Y tế đối với TYT cấp xã) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-supervising-authority
extension:orgLifecycleRelation		0..*	(Complex)	Quan hệ vòng đời mã cơ sở (tiền nhiệm/kế nhiệm/sáp nhập/tách) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	SOΣC	1..*	Identifier	Định danh CSYT (mã CSKCB hoặc mã quản lý hợp lệ khác) Slice: Unordered, Open by value:system 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
identifier:All Slices				Content/Rules for all slices
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
period	SΣ	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
identifier:CSKCB	SOΣC	0..1	Identifier	Mã CSKCB (5 chữ số) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..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: CSKCB
display		0..1	string	Representation defined by the system
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-cskcb
value	SΣ	1..1	string	The value that is unique Example General: 123456
period	SΣ	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
identifier:MaGtin	SOΣC	0..1	Identifier	Mã định danh cơ sở KCB 13 ký tự (MA_GTIN_CSKCB) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type	Σ	0..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: CSKCB13
display		0..1	string	Representation defined by the system
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-gtin-cskcb
value	SΣC	1..1	string	The value that is unique Constraints: vn-org-ma-gtin-13-digit Example General: 123456
period	SΣ	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
identifier:Local	SOΣC	0..*	Identifier	Mã quản lý cục bộ của đơn vị 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
use	?!Σ	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/organization-local-id
value	Σ	1..1	string	The value that is unique Example General: 123456
period	SΣ	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
active	?!SOΣ	0..1	boolean	Đang hoạt động 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type	Σ	0..*	CodeableConcept	Loại tổ chức (FHIR base) Binding: OrganizationType (example): Used to categorize the organization.
name	SOΣC	1..1	string	Tên cơ sở y tế 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
telecom	C	0..*	ContactPoint	SĐT, email, website Constraints: org-3
address	SOC	0..*	VNCoreAddress	Địa chỉ CSYT Constraints: org-2 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
endpoint	SO	0..*	Reference(Endpoint)	Endpoint điện tử (vd: gdbhyt portal cho CSKCB ký hợp đồng BHXH) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Bên đáp ứng dữ liệu lõi (Data Responder)	Bên giám định BHYT (Adjudicator)	Bên gửi hồ sơ BHYT (Submitter)
Organization
Slices for extension
extension:organizationType	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
extension:organizationLevel	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
extension:facilityCareLevel	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:All Slices
identifier:CSKCB	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:MaGtin	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:Local	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
active	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
name	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
address	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
endpoint	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Organization.identifier.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.identifier:CSKCB.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.identifier:CSKCB.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Organization.identifier:MaGtin.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.identifier:MaGtin.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Organization.identifier:Local.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.type	Base	example	Organization type	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Organization	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Organization	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	Organization	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	Organization	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Organization	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()
org-1	error	Organization	The organization SHALL at least have a name or an identifier, and possibly more than one	(identifier.count() + name.count()) > 0
org-2	error	Organization.address	An address of an organization can never be of use 'home'	where(use = 'home').empty()
org-3	error	Organization.telecom	The telecom of an organization can never be of use 'home'	where(use = 'home').empty()
vn-org-ma-gtin-13-digit	error	Organization.identifier:MaGtin.value	Mã định danh cơ sở KCB (MA_GTIN_CSKCB) phải đúng 13 ký tự số theo QĐ 1551/QĐ-BYT đã được QĐ 2062/QĐ-BYT thay Phụ lục 01-03	$this.empty() or $this.matches('^[0-9]{13}$')
vn-organization-local-id-issuer-scoped	error	Organization	Mã tổ chức nội bộ ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/organization-local-id) 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 local organization identifier 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/organization-local-id').all(assigner.reference.exists())

Dạng xem Differential

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Organization	C	0..*	Organization	A grouping of people or organizations with a common purpose Constraints: vn-organization-local-id-issuer-scoped
Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
extension:organizationType	SO	0..1	CodeableConcept	Loại hình CSYT (BV, PK, TYT...) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-type Binding: Loại hình cơ sở y tế — Vietnam Organization Type 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:organizationLevel	SO	0..1	CodeableConcept	Cấp quản lý hành chính (TW, Tỉnh, Xã) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-level Binding: Cấp quản lý hành chính y tế — Vietnam Administrative Health Level 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:organizationRank		0..1	CodeableConcept	Hạng pháp lý của cơ sở KCB (Đặc biệt, I, II, III) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank Binding: Hạng cơ sở khám chữa bệnh — Vietnam Healthcare Facility Rank ValueSet (required)
extension:healthUnitRank		0..1	CodeableConcept	Hạng pháp lý của đơn vị y tế không phải cơ sở KCB (I-IV) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-health-unit-rank Binding: Hạng đơn vị sự nghiệp y tế không phải cơ sở KCB — Vietnam Non-KCB Health Unit Rank ValueSet (required)
extension:organizationRankStatus		0..1	CodeableConcept	Tình trạng xếp hạng (đã xếp, chưa xếp, không áp dụng) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank-status Binding: Tình trạng xếp hạng của cơ sở y tế — Vietnam Organization Rank Status ValueSet (required)
extension:facilityCareLevel	SO	0..1	CodeableConcept	Cấp KCB hiện hành (ban đầu, cơ bản, chuyên sâu) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level Binding: Cấp năng lực cơ sở KCB — Vietnam Facility Care Level ValueSet (required) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:legacyTechnicalLine		0..1	CodeableConcept	Tuyến chuyên môn kỹ thuật lịch sử theo TT 43/2013/TT-BYT (legacy) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legacy-technical-line Binding: Tuyến chuyên môn kỹ thuật lịch sử — Vietnam Legacy Technical Line ValueSet (required)
extension:qualityScoreBand		0..1	CodeableConcept	Dải điểm chất lượng phục vụ xác định quyền lợi BHYT URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band Binding: Dải điểm chất lượng cơ sở KCB — Vietnam Quality Score Band ValueSet (required)
extension:supervisingAuthority		0..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile | Organization)	Cơ quan hướng dẫn chuyên môn (vd: Sở Y tế đối với TYT cấp xã) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-supervising-authority
extension:orgLifecycleRelation		0..*	(Complex)	Quan hệ vòng đời mã cơ sở (tiền nhiệm/kế nhiệm/sáp nhập/tách) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation
Slices for identifier	SO	1..*	Identifier	Định danh CSYT (mã CSKCB hoặc mã quản lý hợp lệ khác) Slice: Unordered, Open by value:system 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
identifier:All Slices				Content/Rules for all slices
period	S	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
identifier:CSKCB	SO	0..1	Identifier	Mã CSKCB (5 chữ số) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		0..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: CSKCB
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/ma-cskcb
value	S	1..1	string	The value that is unique
period	S	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
identifier:MaGtin	SO	0..1	Identifier	Mã định danh cơ sở KCB 13 ký tự (MA_GTIN_CSKCB) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		0..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: CSKCB13
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/ma-gtin-cskcb
value	SC	1..1	string	The value that is unique Constraints: vn-org-ma-gtin-13-digit
period	S	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
identifier:Local	SO	0..*	Identifier	Mã quản lý cục bộ của đơn vị 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
system		1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/organization-local-id
value		1..1	string	The value that is unique
period	S	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
active	SO	0..1	boolean	Đang hoạt động 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type		0..*	CodeableConcept	Loại tổ chức (FHIR base)
name	SO	1..1	string	Tên cơ sở y tế 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
telecom		0..*	ContactPoint	SĐT, email, website
address	SO	0..*	VNCoreAddress	Địa chỉ CSYT 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
endpoint	SO	0..*	Reference(Endpoint)	Endpoint điện tử (vd: gdbhyt portal cho CSKCB ký hợp đồng BHXH) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Bên đáp ứng dữ liệu lõi (Data Responder)	Bên giám định BHYT (Adjudicator)	Bên gửi hồ sơ BHYT (Submitter)
Organization
Slices for extension
extension:organizationType	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
extension:organizationLevel	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
extension:facilityCareLevel	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:All Slices
identifier:CSKCB	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:MaGtin	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:Local	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
active	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
name	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
address	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
endpoint	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
Documentation for this format

Constraints

Id	Grade	Path(s)	Description	Expression
vn-org-ma-gtin-13-digit	error	Organization.identifier:MaGtin.value	Mã định danh cơ sở KCB (MA_GTIN_CSKCB) phải đúng 13 ký tự số theo QĐ 1551/QĐ-BYT đã được QĐ 2062/QĐ-BYT thay Phụ lục 01-03	$this.empty() or $this.matches('^[0-9]{13}$')
vn-organization-local-id-issuer-scoped	error	Organization	Mã tổ chức nội bộ ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/organization-local-id) 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 local organization identifier 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/organization-local-id').all(assigner.reference.exists())

Dạng xem SnapshotView

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Organization	C	0..*	Organization	A grouping of people or organizations with a common purpose Constraints: org-1, vn-organization-local-id-issuer-scoped
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:organizationType	SO	0..1	CodeableConcept	Loại hình CSYT (BV, PK, TYT...) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-type Binding: Loại hình cơ sở y tế — Vietnam Organization Type 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:organizationLevel	SO	0..1	CodeableConcept	Cấp quản lý hành chính (TW, Tỉnh, Xã) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-level Binding: Cấp quản lý hành chính y tế — Vietnam Administrative Health Level 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:organizationRank		0..1	CodeableConcept	Hạng pháp lý của cơ sở KCB (Đặc biệt, I, II, III) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank Binding: Hạng cơ sở khám chữa bệnh — Vietnam Healthcare Facility Rank ValueSet (required)
extension:healthUnitRank		0..1	CodeableConcept	Hạng pháp lý của đơn vị y tế không phải cơ sở KCB (I-IV) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-health-unit-rank Binding: Hạng đơn vị sự nghiệp y tế không phải cơ sở KCB — Vietnam Non-KCB Health Unit Rank ValueSet (required)
extension:organizationRankStatus		0..1	CodeableConcept	Tình trạng xếp hạng (đã xếp, chưa xếp, không áp dụng) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank-status Binding: Tình trạng xếp hạng của cơ sở y tế — Vietnam Organization Rank Status ValueSet (required)
extension:facilityCareLevel	SO	0..1	CodeableConcept	Cấp KCB hiện hành (ban đầu, cơ bản, chuyên sâu) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level Binding: Cấp năng lực cơ sở KCB — Vietnam Facility Care Level ValueSet (required) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
extension:legacyTechnicalLine		0..1	CodeableConcept	Tuyến chuyên môn kỹ thuật lịch sử theo TT 43/2013/TT-BYT (legacy) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legacy-technical-line Binding: Tuyến chuyên môn kỹ thuật lịch sử — Vietnam Legacy Technical Line ValueSet (required)
extension:qualityScoreBand		0..1	CodeableConcept	Dải điểm chất lượng phục vụ xác định quyền lợi BHYT URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band Binding: Dải điểm chất lượng cơ sở KCB — Vietnam Quality Score Band ValueSet (required)
extension:supervisingAuthority		0..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile | Organization)	Cơ quan hướng dẫn chuyên môn (vd: Sở Y tế đối với TYT cấp xã) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-supervising-authority
extension:orgLifecycleRelation		0..*	(Complex)	Quan hệ vòng đời mã cơ sở (tiền nhiệm/kế nhiệm/sáp nhập/tách) URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	SOΣC	1..*	Identifier	Định danh CSYT (mã CSKCB hoặc mã quản lý hợp lệ khác) Slice: Unordered, Open by value:system 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
identifier:All Slices				Content/Rules for all slices
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	Σ	0..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.
system	Σ	0..1	uri	The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value	Σ	0..1	string	The value that is unique Example General: 123456
period	SΣ	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
identifier:CSKCB	SOΣC	0..1	Identifier	Mã CSKCB (5 chữ số) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	0..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: CSKCB
display		0..1	string	Representation defined by the system
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-cskcb
value	SΣ	1..1	string	The value that is unique Example General: 123456
period	SΣ	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
identifier:MaGtin	SOΣC	0..1	Identifier	Mã định danh cơ sở KCB 13 ký tự (MA_GTIN_CSKCB) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	0..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: CSKCB13
display		0..1	string	Representation defined by the system
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-gtin-cskcb
value	SΣC	1..1	string	The value that is unique Constraints: vn-org-ma-gtin-13-digit Example General: 123456
period	SΣ	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
identifier:Local	SOΣC	0..*	Identifier	Mã quản lý cục bộ của đơn vị 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
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	Σ	0..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.
system	Σ	1..1	uri	The namespace for the identifier value Fixed Value: http://fhir.hl7.org.vn/core/sid/organization-local-id
value	Σ	1..1	string	The value that is unique Example General: 123456
period	SΣ	0..1	Period	Khoảng thời gian mã định danh có hiệu lực (hỗ trợ vòng đời mã khi sáp nhập/đổi mã)
assigner	Σ	0..1	Reference(Organization)	Organization that issued id (may be just text)
active	?!SOΣ	0..1	boolean	Đang hoạt động 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
type	Σ	0..*	CodeableConcept	Loại tổ chức (FHIR base) Binding: OrganizationType (example): Used to categorize the organization.
name	SOΣC	1..1	string	Tên cơ sở y tế 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
alias		0..*	string	A list of alternate names that the organization is known as, or was known as in the past
telecom	C	0..*	ContactPoint	SĐT, email, website Constraints: org-3
address	SOC	0..*	VNCoreAddress	Địa chỉ CSYT Constraints: org-2 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
partOf	Σ	0..1	Reference(Organization)	The organization of which this organization forms a part
contact		0..*	BackboneElement	Contact for the organization for a certain purpose
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
purpose		0..1	CodeableConcept	The type of contact Binding: ContactEntityType (extensible): The purpose for which you would contact a contact party.
name		0..1	HumanName	A name associated with the contact
telecom		0..*	ContactPoint	Contact details (telephone, email, etc.) for a contact
address		0..1	Address	Visiting or postal addresses for the contact
endpoint	SO	0..*	Reference(Endpoint)	Endpoint điện tử (vd: gdbhyt portal cho CSKCB ký hợp đồng BHXH) 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 Bên gửi hồ sơ BHYT (Submitter) SHALL:no-error & SHALL:persist Bên giám định BHYT (Adjudicator)
Documentation for this format

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Bên đáp ứng dữ liệu lõi (Data Responder)	Bên giám định BHYT (Adjudicator)	Bên gửi hồ sơ BHYT (Submitter)
Organization
Slices for extension
extension:organizationType	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
extension:organizationLevel	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
extension:facilityCareLevel	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:All Slices
identifier:CSKCB	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:MaGtin	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:Local	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
active	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
name	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
address	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
endpoint	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Organization.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
Organization.identifier.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.identifier.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Organization.identifier:CSKCB.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.identifier:CSKCB.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Organization.identifier:MaGtin.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.identifier:MaGtin.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Organization.identifier:Local.​use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.identifier:Local.​type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Organization.type	Base	example	Organization type	📍4.0.1	FHIR Std.
Organization.contact.​purpose	Base	extensible	Contact entity type	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	Organization	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	Organization	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	Organization	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	Organization	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	Organization	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()
org-1	error	Organization	The organization SHALL at least have a name or an identifier, and possibly more than one	(identifier.count() + name.count()) > 0
org-2	error	Organization.address	An address of an organization can never be of use 'home'	where(use = 'home').empty()
org-3	error	Organization.telecom	The telecom of an organization can never be of use 'home'	where(use = 'home').empty()
vn-org-ma-gtin-13-digit	error	Organization.identifier:MaGtin.value	Mã định danh cơ sở KCB (MA_GTIN_CSKCB) phải đúng 13 ký tự số theo QĐ 1551/QĐ-BYT đã được QĐ 2062/QĐ-BYT thay Phụ lục 01-03	$this.empty() or $this.matches('^[0-9]{13}$')
vn-organization-local-id-issuer-scoped	error	Organization	Mã tổ chức nội bộ ghi dưới URI dùng tạm cấp quốc gia (http://fhir.hl7.org.vn/core/sid/organization-local-id) 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 local organization identifier 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/organization-local-id').all(assigner.reference.exists())

Name	Bên yêu cầu dữ liệu lõi (Data Requester)	Bên đáp ứng dữ liệu lõi (Data Responder)	Bên giám định BHYT (Adjudicator)	Bên gửi hồ sơ BHYT (Submitter)
Organization
Slices for extension
extension:organizationType	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
extension:organizationLevel	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
extension:facilityCareLevel	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
Slices for identifier	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:All Slices
identifier:CSKCB	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:MaGtin	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
identifier:Local	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
active	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
name	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
address	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
endpoint	SHALL:no-error & SHALL:handle	SHALL:populate-if-known	SHALL:no-error & SHALL:persist	SHALL:populate-if-known
Documentation for this format

Summary

Mandatory: 2 elements(6 nested mandatory elements)
Must-Support: 17 elements
Fixed: 3 elements

Structures

This structure refers to these other structures:

• Địa chỉ VN Core — VN Core Address Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-address)

Extensions

This structure refers to these extensions:

• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-type
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-level
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-health-unit-rank
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-rank-status
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-facility-care-level
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legacy-technical-line
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-quality-score-band
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-supervising-authority
• http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-org-lifecycle-relation

Slices

This structure defines the following Slices:

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