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
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
| URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-charge-item | Phiên bản: 0.10.0 | ||||
| Computable Name: VNCoreChargeItem | |||||
| Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.33 | |||||
Một khoản chi phí phát sinh trong đợt khám bệnh, chữa bệnh, gắn với sự kiện lâm sàng sinh ra nó.
Vì sao cần. Invoice trong FHIR R4 không có phần tử nào trỏ về Encounter — bảng kê chi phí
(VNCoreCostStatementInvoice) vì thế chỉ nối
được với đợt khám bằng quy ước trùng MA_LK. Quy ước chuỗi không kiểm được bằng máy và mỗi hệ thống
tự diễn giải một kiểu. ChargeItem.context là đường liên kết chính thức của FHIR từ dòng chi phí về
sự kiện lâm sàng, còn ChargeItem.service trỏ thẳng tới y lệnh hoặc thủ thuật đã sinh ra khoản đó.
Vị trí trong vòng đời (ADR-0021, sửa đổi 13/09/2026): Encounter → ChargeItem → Invoice
(bảng kê cho người bệnh) → Claim (đề nghị thanh toán; có thể mang nhiều insurance nối tiếp hoặc
đồng thời, đúng một focal) → ClaimResponse (kết quả giám định) → PaymentReconciliation.
Trước 0.10.0 mắt xích đầu tiên bỏ trống.
Phạm vi cố ý hẹp. Profile này chỉ chuẩn hoá phần truy vết: chi phí này thuộc đợt khám nào, do dịch vụ nào sinh ra, số lượng bao nhiêu. Việc định giá nằm ở VNCoreChargeItemDefinition: theo TT 21/2024/TT-BYT, giá cụ thể do cấp có thẩm quyền phê duyệt cho từng cơ sở — không còn khung giá quốc gia thống nhất theo hạng bệnh viện kể từ 01/01/2025.
ChargeItem là bước trung gian, không thay thế bảng kê: con số đối soát với cơ quan bảo hiểm xã
hội vẫn nằm ở Invoice và Claim. /
A charge arising during an episode of care, linked to the clinical event that produced it.
FHIR R4 Invoice has no element referencing an Encounter, so the cost statement can only be tied to
the episode by a shared MA_LK string — a convention no validator can check. ChargeItem.context
and .service provide the formal link. Scope is deliberately narrow: traceability only. Pricing lives
on VNCoreChargeItemDefinition, following the per-facility costing method of Circular 21/2024/TT-BYT.
Usages:
You can also check for usages in the FHIR IG Statistics
Mô tả profile, differential, snapshot và các biểu diễn liên quan.
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
C | 0..* | ChargeItem | Item containing charge code(s) associated with the provision of healthcare provider products Constraints: vn-charge-item-money-vnd, vn-charge-item-price-traceable |
![]() ![]() |
?!Σ | 0..1 | uri | A set of rules under which this content was created |
![]() ![]() |
?! | 0..* | Extension | Extensions that cannot be ignored |
![]() ![]() |
S | 0..* | uri | Bảng giá dạng URI khi cơ sở chưa publish ChargeItemDefinition |
![]() ![]() |
S | 0..* | canonical(Bảng giá dịch vụ khám bệnh, chữa bệnh — VN Core ChargeItemDefinition) | Bảng giá đã áp cho khoản chi phí này |
![]() ![]() |
?!SΣ | 1..1 | code | planned | billable | not-billable | aborted | billed | entered-in-error Binding: ChargeItemStatus (required): Codes identifying the lifecycle stage of a ChargeItem. |
![]() ![]() |
SΣ | 1..1 | CodeableConcept | Mã dịch vụ, thuốc hoặc vật tư sinh ra khoản chi phí Binding: Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet (extensible) |
![]() ![]() |
SΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Người bệnh |
![]() ![]() |
SΣ | 1..1 | Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) | Đợt khám bệnh, chữa bệnh sinh ra khoản chi phí |
![]() ![]() |
SΣ | 0..1 | Thời điểm hoặc khoảng phát sinh chi phí | |
![]() ![]() ![]() |
dateTime | |||
![]() ![]() ![]() |
Period | |||
![]() ![]() ![]() |
Timing | |||
![]() ![]() |
S | 0..* | BackboneElement | Who performed charged service |
![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
![]() ![]() ![]() |
1..1 | Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile | Cơ sở y tế VN Core — VN Core Organization Profile) | Người hoặc đơn vị thực hiện | |
![]() ![]() |
S | 0..1 | Reference(Cơ sở y tế VN Core — VN Core Organization Profile) | Cơ sở thực hiện dịch vụ |
![]() ![]() |
SΣ | 0..1 | Quantity | Số lượng — cột (3) của mẫu bảng kê QĐ 697/QĐ-BYT |
![]() ![]() |
0..1 | Money | Giá áp dụng khi khác giá niêm yết | |
![]() ![]() |
0..1 | string | Lý do áp giá khác | |
![]() ![]() |
S | 0..* | Reference(DiagnosticReport | ImagingStudy | Immunization | MedicationAdministration | MedicationDispense | Observation | Procedure | SupplyDelivery) | Y lệnh hoặc thủ thuật đã sinh ra khoản chi phí |
![]() ![]() |
SΣ | 1..1 | Reference(Tài khoản viện phí — VN Core Account) | Tài khoản viện phí mà khoản chi phí này thuộc về |
![]() ![]() |
0..* | Annotation | Ghi chú | |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| ChargeItem.status | Base | required | ChargeItemStatus | 📍4.0.1 | FHIR Std. |
| ChargeItem.code | Base | extensible | Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet | 📦0.10.0 | This IG |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | ChargeItem | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | ChargeItem | 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 | ChargeItem | 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 | ChargeItem | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | ChargeItem | 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-money-vnd | error | ChargeItem | Mọi khoản tiền của dòng chi phí phải dùng VND. Every monetary amount on the charge item SHALL use VND. |
descendants().ofType(Money).all(currency = 'VND')
|
| vn-charge-item-price-traceable | error | ChargeItem | Khoản chi phí phải có `definitionCanonical`, `definitionUri`, hoặc cặp `priceOverride` + `overrideReason`. A charge SHALL be traceable to an approved price or declare an explicit override with a reason. |
(definitionCanonical.exists() or definitionUri.exists() or priceOverride.value.exists()) and (priceOverride.value.exists() implies overrideReason.exists())
|
| Path | Status | Usage | ValueSet | Version | Source |
| ChargeItem.code | Base | extensible | Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet | 📦0.10.0 | This IG |
| Id | Grade | Path(s) | Description | Expression |
| vn-charge-item-money-vnd | error | ChargeItem | Mọi khoản tiền của dòng chi phí phải dùng VND. Every monetary amount on the charge item SHALL use VND. |
descendants().ofType(Money).all(currency = 'VND')
|
| vn-charge-item-price-traceable | error | ChargeItem | Khoản chi phí phải có `definitionCanonical`, `definitionUri`, hoặc cặp `priceOverride` + `overrideReason`. A charge SHALL be traceable to an approved price or declare an explicit override with a reason. |
(definitionCanonical.exists() or definitionUri.exists() or priceOverride.value.exists()) and (priceOverride.value.exists() implies overrideReason.exists())
|
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() | ||||
|---|---|---|---|---|---|---|---|---|
![]() |
C | 0..* | ChargeItem | Item containing charge code(s) associated with the provision of healthcare provider products Constraints: vn-charge-item-money-vnd, vn-charge-item-price-traceable | ||||
![]() ![]() |
Σ | 0..1 | id | Logical id of this artifact | ||||
![]() ![]() |
Σ | 0..1 | Meta | Metadata about the resource | ||||
![]() ![]() |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||
![]() ![]() |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
![]() ![]() |
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 | |||||
![]() ![]() |
0..* | Resource | Contained, inline Resources | |||||
![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||
![]() ![]() |
Σ | 0..* | Identifier | Business Identifier for item | ||||
![]() ![]() |
S | 0..* | uri | Bảng giá dạng URI khi cơ sở chưa publish ChargeItemDefinition | ||||
![]() ![]() |
S | 0..* | canonical(Bảng giá dịch vụ khám bệnh, chữa bệnh — VN Core ChargeItemDefinition) | Bảng giá đã áp cho khoản chi phí này | ||||
![]() ![]() |
?!SΣ | 1..1 | code | planned | billable | not-billable | aborted | billed | entered-in-error Binding: ChargeItemStatus (required): Codes identifying the lifecycle stage of a ChargeItem. | ||||
![]() ![]() |
0..* | Reference(ChargeItem) | Part of referenced ChargeItem | |||||
![]() ![]() |
SΣ | 1..1 | CodeableConcept | Mã dịch vụ, thuốc hoặc vật tư sinh ra khoản chi phí Binding: Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet (extensible) | ||||
![]() ![]() |
SΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Người bệnh | ||||
![]() ![]() |
SΣ | 1..1 | Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) | Đợt khám bệnh, chữa bệnh sinh ra khoản chi phí | ||||
![]() ![]() |
SΣ | 0..1 | Thời điểm hoặc khoảng phát sinh chi phí | |||||
![]() ![]() ![]() |
dateTime | |||||||
![]() ![]() ![]() |
Period | |||||||
![]() ![]() ![]() |
Timing | |||||||
![]() ![]() |
S | 0..* | BackboneElement | Who performed charged service | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
![]() ![]() ![]() |
0..1 | CodeableConcept | What type of performance was done Binding: ProcedurePerformerRoleCodes (example): Codes describing the types of functional roles performers can take on when performing events. | |||||
![]() ![]() ![]() |
1..1 | Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile | Cơ sở y tế VN Core — VN Core Organization Profile) | Người hoặc đơn vị thực hiện | |||||
![]() ![]() |
S | 0..1 | Reference(Cơ sở y tế VN Core — VN Core Organization Profile) | Cơ sở thực hiện dịch vụ | ||||
![]() ![]() |
0..1 | Reference(Organization) | Organization requesting the charged service | |||||
![]() ![]() |
0..1 | Reference(Organization) | Organization that has ownership of the (potential, future) revenue | |||||
![]() ![]() |
SΣ | 0..1 | Quantity | Số lượng — cột (3) của mẫu bảng kê QĐ 697/QĐ-BYT | ||||
![]() ![]() |
Σ | 0..* | CodeableConcept | Anatomical location, if relevant Binding: SNOMEDCTBodyStructures (example): Codes describing anatomical locations. May include laterality. | ||||
![]() ![]() |
0..1 | decimal | Factor overriding the associated rules | |||||
![]() ![]() |
0..1 | Money | Giá áp dụng khi khác giá niêm yết | |||||
![]() ![]() |
0..1 | string | Lý do áp giá khác | |||||
![]() ![]() |
Σ | 0..1 | Reference(Practitioner | PractitionerRole | Organization | Patient | Device | RelatedPerson) | Individual who was entering | ||||
![]() ![]() |
Σ | 0..1 | dateTime | Date the charge item was entered | ||||
![]() ![]() |
0..* | CodeableConcept | Why was the charged service rendered? Binding: ICD-10Codes (example): Example binding for reason. | |||||
![]() ![]() |
S | 0..* | Reference(DiagnosticReport | ImagingStudy | Immunization | MedicationAdministration | MedicationDispense | Observation | Procedure | SupplyDelivery) | Y lệnh hoặc thủ thuật đã sinh ra khoản chi phí | ||||
![]() ![]() |
0..1 | Product charged Binding: FHIRDeviceTypes (example): Example binding for product type. | ||||||
![]() ![]() ![]() |
Reference(Device | Medication | Substance) | |||||||
![]() ![]() ![]() |
CodeableConcept | |||||||
![]() ![]() |
SΣ | 1..1 | Reference(Tài khoản viện phí — VN Core Account) | Tài khoản viện phí mà khoản chi phí này thuộc về | ||||
![]() ![]() |
0..* | Annotation | Ghi chú | |||||
![]() ![]() |
0..* | Reference(Resource) | Further information supporting this charge | |||||
Documentation for this format | ||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| ChargeItem.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| ChargeItem.status | Base | required | ChargeItemStatus | 📍4.0.1 | FHIR Std. |
| ChargeItem.code | Base | extensible | Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet | 📦0.10.0 | This IG |
| ChargeItem.performer.function | Base | example | Procedure Performer Role Codes | 📍4.0.1 | FHIR Std. |
| ChargeItem.bodysite | Base | example | SNOMED CT Body Structures | 📍4.0.1 | FHIR Std. |
| ChargeItem.reason | Base | example | ICD-10 Codes | 📍4.0.1 | FHIR Std. |
| ChargeItem.product[x] | Base | example | FHIR Device Types | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | ChargeItem | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | ChargeItem | 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 | ChargeItem | 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 | ChargeItem | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | ChargeItem | 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-money-vnd | error | ChargeItem | Mọi khoản tiền của dòng chi phí phải dùng VND. Every monetary amount on the charge item SHALL use VND. |
descendants().ofType(Money).all(currency = 'VND')
|
| vn-charge-item-price-traceable | error | ChargeItem | Khoản chi phí phải có `definitionCanonical`, `definitionUri`, hoặc cặp `priceOverride` + `overrideReason`. A charge SHALL be traceable to an approved price or declare an explicit override with a reason. |
(definitionCanonical.exists() or definitionUri.exists() or priceOverride.value.exists()) and (priceOverride.value.exists() implies overrideReason.exists())
|
Summary
Mandatory: 2 elements
Must-Support: 12 elements
Structures
This structure refers to these other structures:
Dạng xem phần tử chính
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
|---|---|---|---|---|
![]() |
C | 0..* | ChargeItem | Item containing charge code(s) associated with the provision of healthcare provider products Constraints: vn-charge-item-money-vnd, vn-charge-item-price-traceable |
![]() ![]() |
?!Σ | 0..1 | uri | A set of rules under which this content was created |
![]() ![]() |
?! | 0..* | Extension | Extensions that cannot be ignored |
![]() ![]() |
S | 0..* | uri | Bảng giá dạng URI khi cơ sở chưa publish ChargeItemDefinition |
![]() ![]() |
S | 0..* | canonical(Bảng giá dịch vụ khám bệnh, chữa bệnh — VN Core ChargeItemDefinition) | Bảng giá đã áp cho khoản chi phí này |
![]() ![]() |
?!SΣ | 1..1 | code | planned | billable | not-billable | aborted | billed | entered-in-error Binding: ChargeItemStatus (required): Codes identifying the lifecycle stage of a ChargeItem. |
![]() ![]() |
SΣ | 1..1 | CodeableConcept | Mã dịch vụ, thuốc hoặc vật tư sinh ra khoản chi phí Binding: Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet (extensible) |
![]() ![]() |
SΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Người bệnh |
![]() ![]() |
SΣ | 1..1 | Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) | Đợt khám bệnh, chữa bệnh sinh ra khoản chi phí |
![]() ![]() |
SΣ | 0..1 | Thời điểm hoặc khoảng phát sinh chi phí | |
![]() ![]() ![]() |
dateTime | |||
![]() ![]() ![]() |
Period | |||
![]() ![]() ![]() |
Timing | |||
![]() ![]() |
S | 0..* | BackboneElement | Who performed charged service |
![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
![]() ![]() ![]() |
1..1 | Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile | Cơ sở y tế VN Core — VN Core Organization Profile) | Người hoặc đơn vị thực hiện | |
![]() ![]() |
S | 0..1 | Reference(Cơ sở y tế VN Core — VN Core Organization Profile) | Cơ sở thực hiện dịch vụ |
![]() ![]() |
SΣ | 0..1 | Quantity | Số lượng — cột (3) của mẫu bảng kê QĐ 697/QĐ-BYT |
![]() ![]() |
0..1 | Money | Giá áp dụng khi khác giá niêm yết | |
![]() ![]() |
0..1 | string | Lý do áp giá khác | |
![]() ![]() |
S | 0..* | Reference(DiagnosticReport | ImagingStudy | Immunization | MedicationAdministration | MedicationDispense | Observation | Procedure | SupplyDelivery) | Y lệnh hoặc thủ thuật đã sinh ra khoản chi phí |
![]() ![]() |
SΣ | 1..1 | Reference(Tài khoản viện phí — VN Core Account) | Tài khoản viện phí mà khoản chi phí này thuộc về |
![]() ![]() |
0..* | Annotation | Ghi chú | |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| ChargeItem.status | Base | required | ChargeItemStatus | 📍4.0.1 | FHIR Std. |
| ChargeItem.code | Base | extensible | Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet | 📦0.10.0 | This IG |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | ChargeItem | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | ChargeItem | 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 | ChargeItem | 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 | ChargeItem | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | ChargeItem | 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-money-vnd | error | ChargeItem | Mọi khoản tiền của dòng chi phí phải dùng VND. Every monetary amount on the charge item SHALL use VND. |
descendants().ofType(Money).all(currency = 'VND')
|
| vn-charge-item-price-traceable | error | ChargeItem | Khoản chi phí phải có `definitionCanonical`, `definitionUri`, hoặc cặp `priceOverride` + `overrideReason`. A charge SHALL be traceable to an approved price or declare an explicit override with a reason. |
(definitionCanonical.exists() or definitionUri.exists() or priceOverride.value.exists()) and (priceOverride.value.exists() implies overrideReason.exists())
|
Dạng xem Differential
| Path | Status | Usage | ValueSet | Version | Source |
| ChargeItem.code | Base | extensible | Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet | 📦0.10.0 | This IG |
| Id | Grade | Path(s) | Description | Expression |
| vn-charge-item-money-vnd | error | ChargeItem | Mọi khoản tiền của dòng chi phí phải dùng VND. Every monetary amount on the charge item SHALL use VND. |
descendants().ofType(Money).all(currency = 'VND')
|
| vn-charge-item-price-traceable | error | ChargeItem | Khoản chi phí phải có `definitionCanonical`, `definitionUri`, hoặc cặp `priceOverride` + `overrideReason`. A charge SHALL be traceable to an approved price or declare an explicit override with a reason. |
(definitionCanonical.exists() or definitionUri.exists() or priceOverride.value.exists()) and (priceOverride.value.exists() implies overrideReason.exists())
|
Dạng xem SnapshotView
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() | ||||
|---|---|---|---|---|---|---|---|---|
![]() |
C | 0..* | ChargeItem | Item containing charge code(s) associated with the provision of healthcare provider products Constraints: vn-charge-item-money-vnd, vn-charge-item-price-traceable | ||||
![]() ![]() |
Σ | 0..1 | id | Logical id of this artifact | ||||
![]() ![]() |
Σ | 0..1 | Meta | Metadata about the resource | ||||
![]() ![]() |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||
![]() ![]() |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
![]() ![]() |
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 | |||||
![]() ![]() |
0..* | Resource | Contained, inline Resources | |||||
![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||
![]() ![]() |
Σ | 0..* | Identifier | Business Identifier for item | ||||
![]() ![]() |
S | 0..* | uri | Bảng giá dạng URI khi cơ sở chưa publish ChargeItemDefinition | ||||
![]() ![]() |
S | 0..* | canonical(Bảng giá dịch vụ khám bệnh, chữa bệnh — VN Core ChargeItemDefinition) | Bảng giá đã áp cho khoản chi phí này | ||||
![]() ![]() |
?!SΣ | 1..1 | code | planned | billable | not-billable | aborted | billed | entered-in-error Binding: ChargeItemStatus (required): Codes identifying the lifecycle stage of a ChargeItem. | ||||
![]() ![]() |
0..* | Reference(ChargeItem) | Part of referenced ChargeItem | |||||
![]() ![]() |
SΣ | 1..1 | CodeableConcept | Mã dịch vụ, thuốc hoặc vật tư sinh ra khoản chi phí Binding: Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet (extensible) | ||||
![]() ![]() |
SΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Người bệnh | ||||
![]() ![]() |
SΣ | 1..1 | Reference(Lượt khám/nhập viện VN Core — VN Core Encounter Profile) | Đợt khám bệnh, chữa bệnh sinh ra khoản chi phí | ||||
![]() ![]() |
SΣ | 0..1 | Thời điểm hoặc khoảng phát sinh chi phí | |||||
![]() ![]() ![]() |
dateTime | |||||||
![]() ![]() ![]() |
Period | |||||||
![]() ![]() ![]() |
Timing | |||||||
![]() ![]() |
S | 0..* | BackboneElement | Who performed charged service | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||
![]() ![]() ![]() |
0..1 | CodeableConcept | What type of performance was done Binding: ProcedurePerformerRoleCodes (example): Codes describing the types of functional roles performers can take on when performing events. | |||||
![]() ![]() ![]() |
1..1 | Reference(Nhân viên y tế VN Core — VN Core Practitioner Profile | Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile | Cơ sở y tế VN Core — VN Core Organization Profile) | Người hoặc đơn vị thực hiện | |||||
![]() ![]() |
S | 0..1 | Reference(Cơ sở y tế VN Core — VN Core Organization Profile) | Cơ sở thực hiện dịch vụ | ||||
![]() ![]() |
0..1 | Reference(Organization) | Organization requesting the charged service | |||||
![]() ![]() |
0..1 | Reference(Organization) | Organization that has ownership of the (potential, future) revenue | |||||
![]() ![]() |
SΣ | 0..1 | Quantity | Số lượng — cột (3) của mẫu bảng kê QĐ 697/QĐ-BYT | ||||
![]() ![]() |
Σ | 0..* | CodeableConcept | Anatomical location, if relevant Binding: SNOMEDCTBodyStructures (example): Codes describing anatomical locations. May include laterality. | ||||
![]() ![]() |
0..1 | decimal | Factor overriding the associated rules | |||||
![]() ![]() |
0..1 | Money | Giá áp dụng khi khác giá niêm yết | |||||
![]() ![]() |
0..1 | string | Lý do áp giá khác | |||||
![]() ![]() |
Σ | 0..1 | Reference(Practitioner | PractitionerRole | Organization | Patient | Device | RelatedPerson) | Individual who was entering | ||||
![]() ![]() |
Σ | 0..1 | dateTime | Date the charge item was entered | ||||
![]() ![]() |
0..* | CodeableConcept | Why was the charged service rendered? Binding: ICD-10Codes (example): Example binding for reason. | |||||
![]() ![]() |
S | 0..* | Reference(DiagnosticReport | ImagingStudy | Immunization | MedicationAdministration | MedicationDispense | Observation | Procedure | SupplyDelivery) | Y lệnh hoặc thủ thuật đã sinh ra khoản chi phí | ||||
![]() ![]() |
0..1 | Product charged Binding: FHIRDeviceTypes (example): Example binding for product type. | ||||||
![]() ![]() ![]() |
Reference(Device | Medication | Substance) | |||||||
![]() ![]() ![]() |
CodeableConcept | |||||||
![]() ![]() |
SΣ | 1..1 | Reference(Tài khoản viện phí — VN Core Account) | Tài khoản viện phí mà khoản chi phí này thuộc về | ||||
![]() ![]() |
0..* | Annotation | Ghi chú | |||||
![]() ![]() |
0..* | Reference(Resource) | Further information supporting this charge | |||||
Documentation for this format | ||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| ChargeItem.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| ChargeItem.status | Base | required | ChargeItemStatus | 📍4.0.1 | FHIR Std. |
| ChargeItem.code | Base | extensible | Mã khoản chi phí trên bảng kê — VN Cost Item Code ValueSet | 📦0.10.0 | This IG |
| ChargeItem.performer.function | Base | example | Procedure Performer Role Codes | 📍4.0.1 | FHIR Std. |
| ChargeItem.bodysite | Base | example | SNOMED CT Body Structures | 📍4.0.1 | FHIR Std. |
| ChargeItem.reason | Base | example | ICD-10 Codes | 📍4.0.1 | FHIR Std. |
| ChargeItem.product[x] | Base | example | FHIR Device Types | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| dom-2 | error | ChargeItem | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | ChargeItem | 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 | ChargeItem | 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 | ChargeItem | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | ChargeItem | 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-money-vnd | error | ChargeItem | Mọi khoản tiền của dòng chi phí phải dùng VND. Every monetary amount on the charge item SHALL use VND. |
descendants().ofType(Money).all(currency = 'VND')
|
| vn-charge-item-price-traceable | error | ChargeItem | Khoản chi phí phải có `definitionCanonical`, `definitionUri`, hoặc cặp `priceOverride` + `overrideReason`. A charge SHALL be traceable to an approved price or declare an explicit override with a reason. |
(definitionCanonical.exists() or definitionUri.exists() or priceOverride.value.exists()) and (priceOverride.value.exists() implies overrideReason.exists())
|
Summary
Mandatory: 2 elements
Must-Support: 12 elements
Structures
This structure refers to these other structures:
Biểu diễn khác của hồ sơ: CSV, Excel, Schematron