HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review Viet Nam cờ

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

Hồ sơ tài nguyên: Bảng giá dịch vụ khám bệnh, chữa bệnh — VN Core ChargeItemDefinition

URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-charge-item-definition Phiên bản: 0.10.0
Computable Name: VNCoreChargeItemDefinition
Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.32

Mức giá của một dịch vụ khám bệnh, chữa bệnh tại một cơ sở, kèm mốc hiệu lực và đường tra ngược về quyết định phê duyệt.

Vì sao tách khỏi ChargeItem. VNCoreChargeItem chỉ truy vết chi phí này thuộc đợt khám nào, do dịch vụ nào sinh ra. Giá là chuyện khác: cùng một dịch vụ có mức giá khác nhau giữa các cơ sở và thay đổi theo từng đợt phê duyệt. Gộp giá vào ChargeItem sẽ buộc mỗi dòng chi phí tự mang mức giá — không tra ngược được về quyết định, và hồ sơ đã quyết toán mất khả năng đối chiếu mức giá tại thời điểm phát sinh.

Không còn bảng giá quốc gia thống nhất theo hạng bệnh viện. Điều này quan trọng với bên đang triển khai: TT 21/2023/TT-BYT — thông tư từng ban hành khung giá của Nhà nước phân theo hạng bệnh viện — đã hết hiệu lực từ 01/01/2025 theo Điều 11 khoản 2 điểm b TT 21/2024/TT-BYT (cùng đợt với TT 13/2023/TT-BYT và TT 22/2023/TT-BYT). TT 21/2024/TT-BYT thay bằng phương pháp định giá: giá cụ thể do cấp có thẩm quyền phê duyệt cho từng cơ sở, cấu thành từ chi phí trực tiếp, tiền lương, chi phí quản lý và khấu hao. Vì vậy profile này không mô hình hoá trục 'hạng bệnh viện'; thứ phải lưu là cơ sở nào, mức nào, hiệu lực từ bao giờ, theo quyết định nào.

Phạm vi. Chuẩn hoá cách công bố một mức giá và điều kiện áp dụng. Bộ hướng dẫn không nạp bảng giá của bất kỳ cơ sở nào — mức giá do từng cơ sở được phê duyệt riêng và thay đổi theo đợt, nạp vào đây là sai chỗ và chắc chắn lạc hậu. Mỗi cơ sở tự công bố ChargeItemDefinition của mình.

Ranh giới pháp lý. Luật Giá 16/2023/QH15 (được sửa bởi Luật 140/2025/QH15, hợp nhất tại VBHN 25/VBHN-VPQH năm 2026) và NĐ 85/2024/NĐ-CP (được sửa bởi NĐ 128/2026/NĐ-CP) là khung quản trị, thẩm quyền và trình tự về giá. Chuỗi văn bản này không trực tiếp bắt buộc các cardinality FHIR derivedFromUri, effectivePeriod hay propertyGroup; các ràng buộc đó là lựa chọn thiết kế truy vết của VN Core. TT 21/2024/TT-BYT mới là nguồn chuyên ngành trực tiếp cho phương pháp định giá dịch vụ khám bệnh, chữa bệnh.

Cách dùng. ChargeItem.definitionCanonical trỏ tới bảng giá đã áp, nhờ đó từ một dòng chi phí tra ngược được đúng mức giá và đúng quyết định phê duyệt. / The price of a healthcare service at a given facility, with its effective period and a traceable link to the approving decision.

Important for implementers: Circular 21/2023/TT-BYT — which set a national price framework by hospital rank — was repealed effective 01 January 2025 by Article 11(2)(b) of Circular 21/2024/TT-BYT. There is no longer a single national price table by rank; prices are approved per facility using the costing method of Circular 21/2024/TT-BYT. This profile therefore models facility, amount, effective period and approving decision — not hospital rank. The guide ships no facility price list.

Usages:

You can also check for usages in the FHIR IG Statistics

Các dạng xem hình thức của nội dung hồ sơ

Mô tả profile, differential, snapshot và các biểu diễn liên quan.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. ChargeItemDefinition C 0..* ChargeItemDefinition Definition of properties and rules about how the price and the applicability of a ChargeItem can be determined
Constraints: cid-0, vn-charge-item-definition-money-vnd, vn-charge-item-definition-approval-traceable, vn-charge-item-definition-base-price-required
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:facility S 1..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở khám bệnh, chữa bệnh áp dụng bảng giá
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-price-list-facility
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... version SΣ 0..1 string Phiên bản bảng giá của cơ sở
... derivedFromUri SΣ 0..* uri Quyết định phê duyệt giá của cấp có thẩm quyền
... status ?!SΣ 1..1 code draft | active | retired — `active` là bảng giá đang áp dụng
Binding: PublicationStatus (required): The lifecycle status of an artifact.
... publisher SΣ 0..1 string Cơ sở khám bệnh, chữa bệnh công bố bảng giá
... useContext SΣ 0..* UsageContext Bối cảnh áp dụng — cơ sở, loại người bệnh, phạm vi thanh toán
... approvalDate S 0..1 date Ngày phê duyệt mức giá
... effectivePeriod SΣ 1..1 Period Khoảng thời gian bảng giá có hiệu lực
.... start SΣC 1..1 dateTime Starting time with inclusive boundary
... code SΣ 1..1 CodeableConcept Mã dịch vụ áp giá — cùng danh mục với ChargeItem.code
Binding: Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet (extensible)
... applicability S 0..* BackboneElement Điều kiện áp giá diễn đạt bằng lời và bằng biểu thức
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... description S 0..1 string Diễn đạt bằng lời — ví dụ: dịch vụ thuộc phạm vi thanh toán của quỹ bảo hiểm y tế
.... expression 0..1 string Biểu thức kiểm được bằng máy, nếu có
... propertyGroup S 1..* BackboneElement Nhóm thành phần giá
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... Slices for priceComponent S 1..* BackboneElement Thành phần giá — dùng `base` cho mức giá công bố
Slice: Unordered, Open by value:type
..... priceComponent:All Slices Content/Rules for all slices
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... type S 1..1 code base | surcharge | deduction | discount | tax | informational
Binding: InvoicePriceComponentType (required): Codes indicating the kind of the price component.
...... amount S 1..1 Money Mức giá (VND, đơn vị đồng)
..... priceComponent:base S 0..1 BackboneElement Components of total line item price
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... type S 1..1 code base | surcharge | deduction | discount | tax | informational
Binding: InvoicePriceComponentType (required): Codes indicating the kind of the price component.
Fixed Value: base
...... amount S 1..1 Money Mức giá (VND, đơn vị đồng)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
ChargeItemDefinition.​status Base required PublicationStatus 📍4.0.1 FHIR Std.
ChargeItemDefinition.​code Base extensible Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet 📦0.10.0 This IG
ChargeItemDefinition.​propertyGroup.priceComponent.​type Base required InvoicePriceComponentType 📍4.0.1 FHIR Std.
ChargeItemDefinition.​propertyGroup.priceComponent:base.​type Base required InvoicePriceComponentType 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
cid-0 warning ChargeItemDefinition Name should be usable as an identifier for the module by machine processing applications such as code generation name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
dom-2 error ChargeItemDefinition If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error ChargeItemDefinition 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 ChargeItemDefinition 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 ChargeItemDefinition If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice ChargeItemDefinition A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
vn-charge-item-definition-approval-traceable error ChargeItemDefinition Bảng giá phải tra ngược được về quyết định phê duyệt: có `derivedFromUri` trỏ văn bản phê duyệt, hoặc `approvalDate` kèm `publisher`. A price definition SHALL be traceable to its approving decision. derivedFromUri.exists() or (approvalDate.exists() and publisher.exists())
vn-charge-item-definition-base-price-required error ChargeItemDefinition Bảng giá phải có đúng một thành phần `base`; phụ thu, giảm trừ, chiết khấu, thuế và thành phần thông tin chỉ bổ sung quanh mức giá gốc. A price definition SHALL contain exactly one base price component. propertyGroup.priceComponent.where(type = 'base').count() = 1
vn-charge-item-definition-money-vnd error ChargeItemDefinition Mọi mức giá phải dùng VND. Every price component SHALL use VND. descendants().ofType(Money).all(currency = 'VND')

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. ChargeItemDefinition C 0..* ChargeItemDefinition Definition of properties and rules about how the price and the applicability of a ChargeItem can be determined
Constraints: vn-charge-item-definition-money-vnd, vn-charge-item-definition-approval-traceable, vn-charge-item-definition-base-price-required
... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:facility S 1..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở khám bệnh, chữa bệnh áp dụng bảng giá
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-price-list-facility
... url S 1..1 uri Canonical identifier for this charge item definition, represented as a URI (globally unique)
... version S 0..1 string Phiên bản bảng giá của cơ sở
... status S 1..1 code draft | active | retired — `active` là bảng giá đang áp dụng
... publisher S 0..1 string Cơ sở khám bệnh, chữa bệnh công bố bảng giá
... useContext S 0..* UsageContext Bối cảnh áp dụng — cơ sở, loại người bệnh, phạm vi thanh toán
... approvalDate S 0..1 date Ngày phê duyệt mức giá
... effectivePeriod S 1..1 Period Khoảng thời gian bảng giá có hiệu lực
.... start S 1..1 dateTime Starting time with inclusive boundary
... code S 1..1 CodeableConcept Mã dịch vụ áp giá — cùng danh mục với ChargeItem.code
Binding: Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet (extensible)
... applicability S 0..* BackboneElement Điều kiện áp giá diễn đạt bằng lời và bằng biểu thức
.... description S 0..1 string Diễn đạt bằng lời — ví dụ: dịch vụ thuộc phạm vi thanh toán của quỹ bảo hiểm y tế
.... expression 0..1 string Biểu thức kiểm được bằng máy, nếu có
... propertyGroup S 1..* BackboneElement Nhóm thành phần giá
.... Slices for priceComponent S 1..* BackboneElement Thành phần giá — dùng `base` cho mức giá công bố
Slice: Unordered, Open by value:type
..... priceComponent:All Slices Content/Rules for all slices
...... type S 1..1 code base | surcharge | deduction | discount | tax | informational
...... amount S 1..1 Money Mức giá (VND, đơn vị đồng)
..... priceComponent:base S 0..1 BackboneElement Components of total line item price
...... type S 1..1 code base | surcharge | deduction | discount | tax | informational
Fixed Value: base
...... amount S 1..1 Money Mức giá (VND, đơn vị đồng)

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
ChargeItemDefinition.​code Base extensible Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet 📦0.10.0 This IG

Constraints

Id Grade Path(s) Description Expression
vn-charge-item-definition-approval-traceable error ChargeItemDefinition Bảng giá phải tra ngược được về quyết định phê duyệt: có `derivedFromUri` trỏ văn bản phê duyệt, hoặc `approvalDate` kèm `publisher`. A price definition SHALL be traceable to its approving decision. derivedFromUri.exists() or (approvalDate.exists() and publisher.exists())
vn-charge-item-definition-base-price-required error ChargeItemDefinition Bảng giá phải có đúng một thành phần `base`; phụ thu, giảm trừ, chiết khấu, thuế và thành phần thông tin chỉ bổ sung quanh mức giá gốc. A price definition SHALL contain exactly one base price component. propertyGroup.priceComponent.where(type = 'base').count() = 1
vn-charge-item-definition-money-vnd error ChargeItemDefinition Mọi mức giá phải dùng VND. Every price component SHALL use VND. descendants().ofType(Money).all(currency = 'VND')
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. ChargeItemDefinition C 0..* ChargeItemDefinition Definition of properties and rules about how the price and the applicability of a ChargeItem can be determined
Constraints: cid-0, vn-charge-item-definition-money-vnd, vn-charge-item-definition-approval-traceable, vn-charge-item-definition-base-price-required
... 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 BindingsPurpose
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 1..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:facility S 1..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở khám bệnh, chữa bệnh áp dụng bảng giá
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-price-list-facility
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... url SΣ 1..1 uri Canonical identifier for this charge item definition, represented as a URI (globally unique)
... identifier Σ 0..* Identifier Additional identifier for the charge item definition
... version SΣ 0..1 string Phiên bản bảng giá của cơ sở
... title Σ 0..1 string Name for this charge item definition (human friendly)
... derivedFromUri SΣ 0..* uri Quyết định phê duyệt giá của cấp có thẩm quyền
... partOf Σ 0..* canonical(ChargeItemDefinition) A larger definition of which this particular definition is a component or step
... replaces Σ 0..* canonical(ChargeItemDefinition) Completed or terminated request(s) whose function is taken by this new request
... status ?!SΣ 1..1 code draft | active | retired — `active` là bảng giá đang áp dụng
Binding: PublicationStatus (required): The lifecycle status of an artifact.
... experimental Σ 0..1 boolean For testing purposes, not real usage
... date Σ 0..1 dateTime Date last changed
... publisher SΣ 0..1 string Cơ sở khám bệnh, chữa bệnh công bố bảng giá
... contact Σ 0..* ContactDetail Contact details for the publisher
... description Σ 0..1 markdown Natural language description of the charge item definition
... useContext SΣ 0..* UsageContext Bối cảnh áp dụng — cơ sở, loại người bệnh, phạm vi thanh toán
... jurisdiction Σ 0..* CodeableConcept Intended jurisdiction for charge item definition (if applicable)
Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.
... copyright 0..1 markdown Use and/or publishing restrictions
... approvalDate S 0..1 date Ngày phê duyệt mức giá
... lastReviewDate 0..1 date When the charge item definition was last reviewed
... effectivePeriod SΣ 1..1 Period Khoảng thời gian bảng giá có hiệu lực
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... start SΣC 1..1 dateTime Starting time with inclusive boundary
.... end ΣC 0..1 dateTime End time with inclusive boundary, if not ongoing
... code SΣ 1..1 CodeableConcept Mã dịch vụ áp giá — cùng danh mục với ChargeItem.code
Binding: Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet (extensible)
... instance 0..* Reference(Medication | Substance | Device) Instances this definition applies to
... applicability S 0..* BackboneElement Điều kiện áp giá diễn đạt bằng lời và bằng biểu thức
.... 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
.... description S 0..1 string Diễn đạt bằng lời — ví dụ: dịch vụ thuộc phạm vi thanh toán của quỹ bảo hiểm y tế
.... language 0..1 string Language of the expression
.... expression 0..1 string Biểu thức kiểm được bằng máy, nếu có
... propertyGroup S 1..* BackboneElement Nhóm thành phần giá
.... 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
.... applicability 0..* See applicability (ChargeItemDefinition) Conditions under which the priceComponent is applicable
.... Slices for priceComponent S 1..* BackboneElement Thành phần giá — dùng `base` cho mức giá công bố
Slice: Unordered, Open by value:type
..... priceComponent: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
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... type S 1..1 code base | surcharge | deduction | discount | tax | informational
Binding: InvoicePriceComponentType (required): Codes indicating the kind of the price component.
...... code 0..1 CodeableConcept Code identifying the specific component
...... factor 0..1 decimal Factor used for calculating this component
...... amount S 1..1 Money Mức giá (VND, đơn vị đồng)
..... priceComponent:base S 0..1 BackboneElement Components of total line item price
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... type S 1..1 code base | surcharge | deduction | discount | tax | informational
Binding: InvoicePriceComponentType (required): Codes indicating the kind of the price component.
Fixed Value: base
...... code 0..1 CodeableConcept Code identifying the specific component
...... factor 0..1 decimal Factor used for calculating this component
...... amount S 1..1 Money Mức giá (VND, đơn vị đồng)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
ChargeItemDefinition.​language Base preferred Common Languages 📍4.0.1 FHIR Std.
ChargeItemDefinition.​status Base required PublicationStatus 📍4.0.1 FHIR Std.
ChargeItemDefinition.​jurisdiction Base extensible Jurisdiction 📍4.0.1 FHIR Std.
ChargeItemDefinition.​code Base extensible Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet 📦0.10.0 This IG
ChargeItemDefinition.​propertyGroup.priceComponent.​type Base required InvoicePriceComponentType 📍4.0.1 FHIR Std.
ChargeItemDefinition.​propertyGroup.priceComponent:base.​type Base required InvoicePriceComponentType 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
cid-0 warning ChargeItemDefinition Name should be usable as an identifier for the module by machine processing applications such as code generation name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
dom-2 error ChargeItemDefinition If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error ChargeItemDefinition 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 ChargeItemDefinition 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 ChargeItemDefinition If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice ChargeItemDefinition A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
vn-charge-item-definition-approval-traceable error ChargeItemDefinition Bảng giá phải tra ngược được về quyết định phê duyệt: có `derivedFromUri` trỏ văn bản phê duyệt, hoặc `approvalDate` kèm `publisher`. A price definition SHALL be traceable to its approving decision. derivedFromUri.exists() or (approvalDate.exists() and publisher.exists())
vn-charge-item-definition-base-price-required error ChargeItemDefinition Bảng giá phải có đúng một thành phần `base`; phụ thu, giảm trừ, chiết khấu, thuế và thành phần thông tin chỉ bổ sung quanh mức giá gốc. A price definition SHALL contain exactly one base price component. propertyGroup.priceComponent.where(type = 'base').count() = 1
vn-charge-item-definition-money-vnd error ChargeItemDefinition Mọi mức giá phải dùng VND. Every price component SHALL use VND. descendants().ofType(Money).all(currency = 'VND')

Summary

Mandatory: 8 elements(1 nested mandatory element)
Must-Support: 20 elements
Fixed: 1 element

Extensions

This structure refers to these extensions:

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the values of ChargeItemDefinition.propertyGroup.priceComponent

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

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. ChargeItemDefinition C 0..* ChargeItemDefinition Definition of properties and rules about how the price and the applicability of a ChargeItem can be determined
Constraints: cid-0, vn-charge-item-definition-money-vnd, vn-charge-item-definition-approval-traceable, vn-charge-item-definition-base-price-required
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:facility S 1..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở khám bệnh, chữa bệnh áp dụng bảng giá
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-price-list-facility
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... version SΣ 0..1 string Phiên bản bảng giá của cơ sở
... derivedFromUri SΣ 0..* uri Quyết định phê duyệt giá của cấp có thẩm quyền
... status ?!SΣ 1..1 code draft | active | retired — `active` là bảng giá đang áp dụng
Binding: PublicationStatus (required): The lifecycle status of an artifact.
... publisher SΣ 0..1 string Cơ sở khám bệnh, chữa bệnh công bố bảng giá
... useContext SΣ 0..* UsageContext Bối cảnh áp dụng — cơ sở, loại người bệnh, phạm vi thanh toán
... approvalDate S 0..1 date Ngày phê duyệt mức giá
... effectivePeriod SΣ 1..1 Period Khoảng thời gian bảng giá có hiệu lực
.... start SΣC 1..1 dateTime Starting time with inclusive boundary
... code SΣ 1..1 CodeableConcept Mã dịch vụ áp giá — cùng danh mục với ChargeItem.code
Binding: Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet (extensible)
... applicability S 0..* BackboneElement Điều kiện áp giá diễn đạt bằng lời và bằng biểu thức
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... description S 0..1 string Diễn đạt bằng lời — ví dụ: dịch vụ thuộc phạm vi thanh toán của quỹ bảo hiểm y tế
.... expression 0..1 string Biểu thức kiểm được bằng máy, nếu có
... propertyGroup S 1..* BackboneElement Nhóm thành phần giá
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... Slices for priceComponent S 1..* BackboneElement Thành phần giá — dùng `base` cho mức giá công bố
Slice: Unordered, Open by value:type
..... priceComponent:All Slices Content/Rules for all slices
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... type S 1..1 code base | surcharge | deduction | discount | tax | informational
Binding: InvoicePriceComponentType (required): Codes indicating the kind of the price component.
...... amount S 1..1 Money Mức giá (VND, đơn vị đồng)
..... priceComponent:base S 0..1 BackboneElement Components of total line item price
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... type S 1..1 code base | surcharge | deduction | discount | tax | informational
Binding: InvoicePriceComponentType (required): Codes indicating the kind of the price component.
Fixed Value: base
...... amount S 1..1 Money Mức giá (VND, đơn vị đồng)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
ChargeItemDefinition.​status Base required PublicationStatus 📍4.0.1 FHIR Std.
ChargeItemDefinition.​code Base extensible Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet 📦0.10.0 This IG
ChargeItemDefinition.​propertyGroup.priceComponent.​type Base required InvoicePriceComponentType 📍4.0.1 FHIR Std.
ChargeItemDefinition.​propertyGroup.priceComponent:base.​type Base required InvoicePriceComponentType 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
cid-0 warning ChargeItemDefinition Name should be usable as an identifier for the module by machine processing applications such as code generation name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
dom-2 error ChargeItemDefinition If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error ChargeItemDefinition 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 ChargeItemDefinition 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 ChargeItemDefinition If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice ChargeItemDefinition A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
vn-charge-item-definition-approval-traceable error ChargeItemDefinition Bảng giá phải tra ngược được về quyết định phê duyệt: có `derivedFromUri` trỏ văn bản phê duyệt, hoặc `approvalDate` kèm `publisher`. A price definition SHALL be traceable to its approving decision. derivedFromUri.exists() or (approvalDate.exists() and publisher.exists())
vn-charge-item-definition-base-price-required error ChargeItemDefinition Bảng giá phải có đúng một thành phần `base`; phụ thu, giảm trừ, chiết khấu, thuế và thành phần thông tin chỉ bổ sung quanh mức giá gốc. A price definition SHALL contain exactly one base price component. propertyGroup.priceComponent.where(type = 'base').count() = 1
vn-charge-item-definition-money-vnd error ChargeItemDefinition Mọi mức giá phải dùng VND. Every price component SHALL use VND. descendants().ofType(Money).all(currency = 'VND')

Dạng xem Differential

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. ChargeItemDefinition C 0..* ChargeItemDefinition Definition of properties and rules about how the price and the applicability of a ChargeItem can be determined
Constraints: vn-charge-item-definition-money-vnd, vn-charge-item-definition-approval-traceable, vn-charge-item-definition-base-price-required
... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:facility S 1..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở khám bệnh, chữa bệnh áp dụng bảng giá
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-price-list-facility
... url S 1..1 uri Canonical identifier for this charge item definition, represented as a URI (globally unique)
... version S 0..1 string Phiên bản bảng giá của cơ sở
... status S 1..1 code draft | active | retired — `active` là bảng giá đang áp dụng
... publisher S 0..1 string Cơ sở khám bệnh, chữa bệnh công bố bảng giá
... useContext S 0..* UsageContext Bối cảnh áp dụng — cơ sở, loại người bệnh, phạm vi thanh toán
... approvalDate S 0..1 date Ngày phê duyệt mức giá
... effectivePeriod S 1..1 Period Khoảng thời gian bảng giá có hiệu lực
.... start S 1..1 dateTime Starting time with inclusive boundary
... code S 1..1 CodeableConcept Mã dịch vụ áp giá — cùng danh mục với ChargeItem.code
Binding: Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet (extensible)
... applicability S 0..* BackboneElement Điều kiện áp giá diễn đạt bằng lời và bằng biểu thức
.... description S 0..1 string Diễn đạt bằng lời — ví dụ: dịch vụ thuộc phạm vi thanh toán của quỹ bảo hiểm y tế
.... expression 0..1 string Biểu thức kiểm được bằng máy, nếu có
... propertyGroup S 1..* BackboneElement Nhóm thành phần giá
.... Slices for priceComponent S 1..* BackboneElement Thành phần giá — dùng `base` cho mức giá công bố
Slice: Unordered, Open by value:type
..... priceComponent:All Slices Content/Rules for all slices
...... type S 1..1 code base | surcharge | deduction | discount | tax | informational
...... amount S 1..1 Money Mức giá (VND, đơn vị đồng)
..... priceComponent:base S 0..1 BackboneElement Components of total line item price
...... type S 1..1 code base | surcharge | deduction | discount | tax | informational
Fixed Value: base
...... amount S 1..1 Money Mức giá (VND, đơn vị đồng)

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
ChargeItemDefinition.​code Base extensible Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet 📦0.10.0 This IG

Constraints

Id Grade Path(s) Description Expression
vn-charge-item-definition-approval-traceable error ChargeItemDefinition Bảng giá phải tra ngược được về quyết định phê duyệt: có `derivedFromUri` trỏ văn bản phê duyệt, hoặc `approvalDate` kèm `publisher`. A price definition SHALL be traceable to its approving decision. derivedFromUri.exists() or (approvalDate.exists() and publisher.exists())
vn-charge-item-definition-base-price-required error ChargeItemDefinition Bảng giá phải có đúng một thành phần `base`; phụ thu, giảm trừ, chiết khấu, thuế và thành phần thông tin chỉ bổ sung quanh mức giá gốc. A price definition SHALL contain exactly one base price component. propertyGroup.priceComponent.where(type = 'base').count() = 1
vn-charge-item-definition-money-vnd error ChargeItemDefinition Mọi mức giá phải dùng VND. Every price component SHALL use VND. descendants().ofType(Money).all(currency = 'VND')

Dạng xem SnapshotView

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. ChargeItemDefinition C 0..* ChargeItemDefinition Definition of properties and rules about how the price and the applicability of a ChargeItem can be determined
Constraints: cid-0, vn-charge-item-definition-money-vnd, vn-charge-item-definition-approval-traceable, vn-charge-item-definition-base-price-required
... 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 BindingsPurpose
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 1..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:facility S 1..1 Reference(Cơ sở y tế VN Core — VN Core Organization Profile) Cơ sở khám bệnh, chữa bệnh áp dụng bảng giá
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-price-list-facility
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... url SΣ 1..1 uri Canonical identifier for this charge item definition, represented as a URI (globally unique)
... identifier Σ 0..* Identifier Additional identifier for the charge item definition
... version SΣ 0..1 string Phiên bản bảng giá của cơ sở
... title Σ 0..1 string Name for this charge item definition (human friendly)
... derivedFromUri SΣ 0..* uri Quyết định phê duyệt giá của cấp có thẩm quyền
... partOf Σ 0..* canonical(ChargeItemDefinition) A larger definition of which this particular definition is a component or step
... replaces Σ 0..* canonical(ChargeItemDefinition) Completed or terminated request(s) whose function is taken by this new request
... status ?!SΣ 1..1 code draft | active | retired — `active` là bảng giá đang áp dụng
Binding: PublicationStatus (required): The lifecycle status of an artifact.
... experimental Σ 0..1 boolean For testing purposes, not real usage
... date Σ 0..1 dateTime Date last changed
... publisher SΣ 0..1 string Cơ sở khám bệnh, chữa bệnh công bố bảng giá
... contact Σ 0..* ContactDetail Contact details for the publisher
... description Σ 0..1 markdown Natural language description of the charge item definition
... useContext SΣ 0..* UsageContext Bối cảnh áp dụng — cơ sở, loại người bệnh, phạm vi thanh toán
... jurisdiction Σ 0..* CodeableConcept Intended jurisdiction for charge item definition (if applicable)
Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.
... copyright 0..1 markdown Use and/or publishing restrictions
... approvalDate S 0..1 date Ngày phê duyệt mức giá
... lastReviewDate 0..1 date When the charge item definition was last reviewed
... effectivePeriod SΣ 1..1 Period Khoảng thời gian bảng giá có hiệu lực
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... start SΣC 1..1 dateTime Starting time with inclusive boundary
.... end ΣC 0..1 dateTime End time with inclusive boundary, if not ongoing
... code SΣ 1..1 CodeableConcept Mã dịch vụ áp giá — cùng danh mục với ChargeItem.code
Binding: Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet (extensible)
... instance 0..* Reference(Medication | Substance | Device) Instances this definition applies to
... applicability S 0..* BackboneElement Điều kiện áp giá diễn đạt bằng lời và bằng biểu thức
.... 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
.... description S 0..1 string Diễn đạt bằng lời — ví dụ: dịch vụ thuộc phạm vi thanh toán của quỹ bảo hiểm y tế
.... language 0..1 string Language of the expression
.... expression 0..1 string Biểu thức kiểm được bằng máy, nếu có
... propertyGroup S 1..* BackboneElement Nhóm thành phần giá
.... 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
.... applicability 0..* See applicability (ChargeItemDefinition) Conditions under which the priceComponent is applicable
.... Slices for priceComponent S 1..* BackboneElement Thành phần giá — dùng `base` cho mức giá công bố
Slice: Unordered, Open by value:type
..... priceComponent: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
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... type S 1..1 code base | surcharge | deduction | discount | tax | informational
Binding: InvoicePriceComponentType (required): Codes indicating the kind of the price component.
...... code 0..1 CodeableConcept Code identifying the specific component
...... factor 0..1 decimal Factor used for calculating this component
...... amount S 1..1 Money Mức giá (VND, đơn vị đồng)
..... priceComponent:base S 0..1 BackboneElement Components of total line item price
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... type S 1..1 code base | surcharge | deduction | discount | tax | informational
Binding: InvoicePriceComponentType (required): Codes indicating the kind of the price component.
Fixed Value: base
...... code 0..1 CodeableConcept Code identifying the specific component
...... factor 0..1 decimal Factor used for calculating this component
...... amount S 1..1 Money Mức giá (VND, đơn vị đồng)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
ChargeItemDefinition.​language Base preferred Common Languages 📍4.0.1 FHIR Std.
ChargeItemDefinition.​status Base required PublicationStatus 📍4.0.1 FHIR Std.
ChargeItemDefinition.​jurisdiction Base extensible Jurisdiction 📍4.0.1 FHIR Std.
ChargeItemDefinition.​code Base extensible Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet 📦0.10.0 This IG
ChargeItemDefinition.​propertyGroup.priceComponent.​type Base required InvoicePriceComponentType 📍4.0.1 FHIR Std.
ChargeItemDefinition.​propertyGroup.priceComponent:base.​type Base required InvoicePriceComponentType 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
cid-0 warning ChargeItemDefinition Name should be usable as an identifier for the module by machine processing applications such as code generation name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
dom-2 error ChargeItemDefinition If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error ChargeItemDefinition 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 ChargeItemDefinition 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 ChargeItemDefinition If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice ChargeItemDefinition A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
vn-charge-item-definition-approval-traceable error ChargeItemDefinition Bảng giá phải tra ngược được về quyết định phê duyệt: có `derivedFromUri` trỏ văn bản phê duyệt, hoặc `approvalDate` kèm `publisher`. A price definition SHALL be traceable to its approving decision. derivedFromUri.exists() or (approvalDate.exists() and publisher.exists())
vn-charge-item-definition-base-price-required error ChargeItemDefinition Bảng giá phải có đúng một thành phần `base`; phụ thu, giảm trừ, chiết khấu, thuế và thành phần thông tin chỉ bổ sung quanh mức giá gốc. A price definition SHALL contain exactly one base price component. propertyGroup.priceComponent.where(type = 'base').count() = 1
vn-charge-item-definition-money-vnd error ChargeItemDefinition Mọi mức giá phải dùng VND. Every price component SHALL use VND. descendants().ofType(Money).all(currency = 'VND')

Summary

Mandatory: 8 elements(1 nested mandatory element)
Must-Support: 20 elements
Fixed: 1 element

Extensions

This structure refers to these extensions:

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the values of ChargeItemDefinition.propertyGroup.priceComponent

 

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