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.9.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 - Local Development build (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Hồ sơ tài nguyên: Đối soát và phân bổ khoản thanh toán BHYT — VN Core BHYT Payment Reconciliation

URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-payment-reconciliation Phiên bản: 0.9.0
Computable Name: VNCorePaymentReconciliation
Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.89

Profile PaymentReconciliation cho thông báo chuyển tiền/remittance và phân bổ một khoản thanh toán BHYT tổng hợp về các yêu cầu hoặc giao dịch thành phần theo semantics FHIR R4. Resource này có thể tham chiếu kỳ nghiệp vụ và các Claim liên quan, nhưng không phải carrier chuẩn của Biên bản quyết toán Mẫu 06/BH. Dữ liệu 5 phần A–E và bộ chỉ tiêu quyết toán quý phải dùng LogicalModel VNCoreQuarterlyHealthcareCostSettlement; nếu cần văn bản ký, render LogicalModel rồi đóng gói bằng Composition/DocumentReference. Slice formNumber được giữ để tương thích dữ liệu cũ, không biến PaymentReconciliation thành biểu mẫu 06/BH. Căn cứ: [TT 12/2026/TT-BTC] (ban hành 10/02/2026, hiệu lực 10/02/2026) — Giám định, thanh toán và quyết toán chi phí KCB BHYT; [NĐ 188/2025/NĐ-CP] (ban hành 01/07/2025, hiệu lực 15/08/2025) — Hướng dẫn thi hành Luật BHYT; [NĐ 164/2025/NĐ-CP] (ban hành 29/06/2025, hiệu lực 01/07/2025) — Giao dịch điện tử trong lĩnh vực BHXH; [Luật 51/2024/QH15] (ban hành 27/11/2024, hiệu lực 01/07/2025) — Luật BHYT sửa đổi.

English summary: This profile represents a BHYT remittance or bulk payment and allocates that payment to underlying requests or transactions in accordance with FHIR R4 PaymentReconciliation semantics. It is not the canonical carrier for quarterly Form 06/BH; use VNCoreQuarterlyHealthcareCostSettlement for the five-section quarterly settlement dataset and render/package that model separately when a signed document is required. The formNumber slice remains only for backward compatibility.

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
.. PaymentReconciliation C 0..* PaymentReconciliation PaymentReconciliation resource
Constraints: vn-payment-reconciliation-detail-amount-sum, vn-payment-reconciliation-money-vnd
... 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:formNumber S 0..1 string Tham chiếu biểu mẫu legacy để tương thích — Legacy form reference for compatibility
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-reconciliation-form
.... extension:auditStatus S 0..1 CodeableConcept Trạng thái giám định BHYT (received | under-review | approved | rejected | disputed)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status
Binding: Trạng thái giám định BHYT — VN Claim Audit Status ValueSet (extensible)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... period SΣ 1..1 Period Kỳ đối soát/phân bổ khoản thanh toán — Remittance or payment-allocation period
... created SΣ 1..1 dateTime Ngày tạo thông báo đối soát/remittance — Reconciliation creation date
... paymentIssuer SΣ 0..1 Reference(Organization) Cơ quan BHXH chi trả (BHXH cấp tỉnh/Trung ương)
... request S 0..1 Reference(Task) Hồ sơ/đề nghị thanh toán liên quan (optional)
... outcome S 0..1 code Kết quả tổng quát chuẩn FHIR (queued | complete | error | partial)
Binding: ClaimProcessingCodes (required): The outcome of the processing.
... paymentDate Σ 1..1 date When payment issued
... paymentAmount SΣ 1..1 Money Tổng khoản thanh toán/remittance BHXH — Total BHXH remittance amount
... detail S 1..* BackboneElement Phân bổ khoản thanh toán theo giao dịch/Claim — Payment allocation by transaction or Claim
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... type S 1..1 CodeableConcept Loại giao dịch (payment | adjustment | advance...)
Binding: PaymentTypeCodes (example): The reason for the amount: payment, adjustment, advance.
.... request S 0..1 Reference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile) Claim hoặc yêu cầu được phân bổ khoản thanh toán — Claim/request receiving the allocation
.... amount S 1..1 Money Số tiền được phân bổ cho giao dịch (VND) — Amount allocated to the transaction
..... value Σ 1..1 decimal Numerical value (with implicit precision)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PaymentReconciliation.​status Base required Financial Resource Status Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​outcome Base required Claim Processing Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​detail.type Base example Payment Type Codes 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PaymentReconciliation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PaymentReconciliation 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 PaymentReconciliation 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 PaymentReconciliation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PaymentReconciliation 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-payment-reconciliation-detail-amount-sum error PaymentReconciliation Tổng khoản thanh toán phải bằng tổng số tiền được phân bổ ở các detail. The payment amount SHALL equal the sum of amounts allocated across all details. paymentAmount.value = detail.amount.value.aggregate($this + $total, 0)
vn-payment-reconciliation-money-vnd error PaymentReconciliation Mọi khoản phân bổ chi tiết và tổng khoản thanh toán phải dùng VND. Every detail allocation and the total payment amount SHALL use VND. detail.amount.all(currency.count() = 1 and currency = 'VND') and paymentAmount.currency.count() = 1 and paymentAmount.currency = 'VND'

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PaymentReconciliation C 0..* PaymentReconciliation PaymentReconciliation resource
Constraints: vn-payment-reconciliation-detail-amount-sum, vn-payment-reconciliation-money-vnd
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:formNumber S 0..1 string Tham chiếu biểu mẫu legacy để tương thích — Legacy form reference for compatibility
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-reconciliation-form
.... extension:auditStatus S 0..1 CodeableConcept Trạng thái giám định BHYT (received | under-review | approved | rejected | disputed)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status
Binding: Trạng thái giám định BHYT — VN Claim Audit Status ValueSet (extensible)
... status S 1..1 code Trạng thái resource (active | cancelled | draft | entered-in-error)
... period S 1..1 Period Kỳ đối soát/phân bổ khoản thanh toán — Remittance or payment-allocation period
... paymentIssuer S 0..1 Reference(Organization) Cơ quan BHXH chi trả (BHXH cấp tỉnh/Trung ương)
... request S 0..1 Reference(Task) Hồ sơ/đề nghị thanh toán liên quan (optional)
... outcome S 0..1 code Kết quả tổng quát chuẩn FHIR (queued | complete | error | partial)
... paymentAmount S 1..1 Money Tổng khoản thanh toán/remittance BHXH — Total BHXH remittance amount
... detail S 1..* BackboneElement Phân bổ khoản thanh toán theo giao dịch/Claim — Payment allocation by transaction or Claim
.... type S 1..1 CodeableConcept Loại giao dịch (payment | adjustment | advance...)
.... request S 0..1 Reference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile) Claim hoặc yêu cầu được phân bổ khoản thanh toán — Claim/request receiving the allocation
.... amount S 1..1 Money Số tiền được phân bổ cho giao dịch (VND) — Amount allocated to the transaction
..... value 1..1 decimal Numerical value (with implicit precision)

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
vn-payment-reconciliation-detail-amount-sum error PaymentReconciliation Tổng khoản thanh toán phải bằng tổng số tiền được phân bổ ở các detail. The payment amount SHALL equal the sum of amounts allocated across all details. paymentAmount.value = detail.amount.value.aggregate($this + $total, 0)
vn-payment-reconciliation-money-vnd error PaymentReconciliation Mọi khoản phân bổ chi tiết và tổng khoản thanh toán phải dùng VND. Every detail allocation and the total payment amount SHALL use VND. detail.amount.all(currency.count() = 1 and currency = 'VND') and paymentAmount.currency.count() = 1 and paymentAmount.currency = 'VND'
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PaymentReconciliation C 0..* PaymentReconciliation PaymentReconciliation resource
Constraints: vn-payment-reconciliation-detail-amount-sum, vn-payment-reconciliation-money-vnd
... 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
... 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:formNumber S 0..1 string Tham chiếu biểu mẫu legacy để tương thích — Legacy form reference for compatibility
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-reconciliation-form
.... extension:auditStatus S 0..1 CodeableConcept Trạng thái giám định BHYT (received | under-review | approved | rejected | disputed)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status
Binding: Trạng thái giám định BHYT — VN Claim Audit Status ValueSet (extensible)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier 0..* Identifier Business Identifier for a payment reconciliation
... status ?!SΣ 1..1 code Trạng thái resource (active | cancelled | draft | entered-in-error)
Binding: FinancialResourceStatusCodes (required): A code specifying the state of the resource instance.
... period SΣ 1..1 Period Kỳ đối soát/phân bổ khoản thanh toán — Remittance or payment-allocation period
... created SΣ 1..1 dateTime Ngày tạo thông báo đối soát/remittance — Reconciliation creation date
... paymentIssuer SΣ 0..1 Reference(Organization) Cơ quan BHXH chi trả (BHXH cấp tỉnh/Trung ương)
... request S 0..1 Reference(Task) Hồ sơ/đề nghị thanh toán liên quan (optional)
... requestor 0..1 Reference(Practitioner | PractitionerRole | Organization) Responsible practitioner
... outcome S 0..1 code Kết quả tổng quát chuẩn FHIR (queued | complete | error | partial)
Binding: ClaimProcessingCodes (required): The outcome of the processing.
... disposition 0..1 string Disposition message
... paymentDate Σ 1..1 date When payment issued
... paymentAmount SΣ 1..1 Money Tổng khoản thanh toán/remittance BHXH — Total BHXH remittance amount
... paymentIdentifier 0..1 Identifier Business identifier for the payment
... detail S 1..* BackboneElement Phân bổ khoản thanh toán theo giao dịch/Claim — Payment allocation by transaction or Claim
.... 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
.... identifier 0..1 Identifier Business identifier of the payment detail
.... predecessor 0..1 Identifier Business identifier of the prior payment detail
.... type S 1..1 CodeableConcept Loại giao dịch (payment | adjustment | advance...)
Binding: PaymentTypeCodes (example): The reason for the amount: payment, adjustment, advance.
.... request S 0..1 Reference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile) Claim hoặc yêu cầu được phân bổ khoản thanh toán — Claim/request receiving the allocation
.... submitter 0..1 Reference(Practitioner | PractitionerRole | Organization) Submitter of the request
.... response 0..1 Reference(Resource) Response committing to a payment
.... date 0..1 date Date of commitment to pay
.... responsible 0..1 Reference(PractitionerRole) Contact for the response
.... payee 0..1 Reference(Practitioner | PractitionerRole | Organization) Recipient of the payment
.... amount S 1..1 Money Số tiền được phân bổ cho giao dịch (VND) — Amount allocated to the transaction
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... value Σ 1..1 decimal Numerical value (with implicit precision)
..... currency Σ 0..1 code ISO 4217 Currency Code
Binding: Currencies (required): A code indicating the currency, taken from ISO 4217.
... formCode 0..1 CodeableConcept Printed form identifier
Binding: Form Codes (example): The forms codes.
... processNote 0..* BackboneElement Note concerning processing
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... type 0..1 code display | print | printoper
Binding: NoteType (required): The presentation types of notes.
.... text 0..1 string Note explanatory text

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PaymentReconciliation.​language Base preferred Common Languages 📍4.0.1 FHIR Std.
PaymentReconciliation.​status Base required Financial Resource Status Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​outcome Base required Claim Processing Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​detail.type Base example Payment Type Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​detail.amount.currency Base required CurrencyCode 📍4.0.1 FHIR Std.
PaymentReconciliation.​formCode Base example Forms 📍4.0.1 FHIR Std.
PaymentReconciliation.​processNote.type Base required NoteType 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PaymentReconciliation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PaymentReconciliation 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 PaymentReconciliation 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 PaymentReconciliation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PaymentReconciliation 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-payment-reconciliation-detail-amount-sum error PaymentReconciliation Tổng khoản thanh toán phải bằng tổng số tiền được phân bổ ở các detail. The payment amount SHALL equal the sum of amounts allocated across all details. paymentAmount.value = detail.amount.value.aggregate($this + $total, 0)
vn-payment-reconciliation-money-vnd error PaymentReconciliation Mọi khoản phân bổ chi tiết và tổng khoản thanh toán phải dùng VND. Every detail allocation and the total payment amount SHALL use VND. detail.amount.all(currency.count() = 1 and currency = 'VND') and paymentAmount.currency.count() = 1 and paymentAmount.currency = 'VND'

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

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PaymentReconciliation C 0..* PaymentReconciliation PaymentReconciliation resource
Constraints: vn-payment-reconciliation-detail-amount-sum, vn-payment-reconciliation-money-vnd
... 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:formNumber S 0..1 string Tham chiếu biểu mẫu legacy để tương thích — Legacy form reference for compatibility
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-reconciliation-form
.... extension:auditStatus S 0..1 CodeableConcept Trạng thái giám định BHYT (received | under-review | approved | rejected | disputed)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status
Binding: Trạng thái giám định BHYT — VN Claim Audit Status ValueSet (extensible)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... period SΣ 1..1 Period Kỳ đối soát/phân bổ khoản thanh toán — Remittance or payment-allocation period
... created SΣ 1..1 dateTime Ngày tạo thông báo đối soát/remittance — Reconciliation creation date
... paymentIssuer SΣ 0..1 Reference(Organization) Cơ quan BHXH chi trả (BHXH cấp tỉnh/Trung ương)
... request S 0..1 Reference(Task) Hồ sơ/đề nghị thanh toán liên quan (optional)
... outcome S 0..1 code Kết quả tổng quát chuẩn FHIR (queued | complete | error | partial)
Binding: ClaimProcessingCodes (required): The outcome of the processing.
... paymentDate Σ 1..1 date When payment issued
... paymentAmount SΣ 1..1 Money Tổng khoản thanh toán/remittance BHXH — Total BHXH remittance amount
... detail S 1..* BackboneElement Phân bổ khoản thanh toán theo giao dịch/Claim — Payment allocation by transaction or Claim
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... type S 1..1 CodeableConcept Loại giao dịch (payment | adjustment | advance...)
Binding: PaymentTypeCodes (example): The reason for the amount: payment, adjustment, advance.
.... request S 0..1 Reference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile) Claim hoặc yêu cầu được phân bổ khoản thanh toán — Claim/request receiving the allocation
.... amount S 1..1 Money Số tiền được phân bổ cho giao dịch (VND) — Amount allocated to the transaction
..... value Σ 1..1 decimal Numerical value (with implicit precision)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PaymentReconciliation.​status Base required Financial Resource Status Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​outcome Base required Claim Processing Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​detail.type Base example Payment Type Codes 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PaymentReconciliation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PaymentReconciliation 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 PaymentReconciliation 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 PaymentReconciliation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PaymentReconciliation 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-payment-reconciliation-detail-amount-sum error PaymentReconciliation Tổng khoản thanh toán phải bằng tổng số tiền được phân bổ ở các detail. The payment amount SHALL equal the sum of amounts allocated across all details. paymentAmount.value = detail.amount.value.aggregate($this + $total, 0)
vn-payment-reconciliation-money-vnd error PaymentReconciliation Mọi khoản phân bổ chi tiết và tổng khoản thanh toán phải dùng VND. Every detail allocation and the total payment amount SHALL use VND. detail.amount.all(currency.count() = 1 and currency = 'VND') and paymentAmount.currency.count() = 1 and paymentAmount.currency = 'VND'

Dạng xem Differential

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PaymentReconciliation C 0..* PaymentReconciliation PaymentReconciliation resource
Constraints: vn-payment-reconciliation-detail-amount-sum, vn-payment-reconciliation-money-vnd
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:formNumber S 0..1 string Tham chiếu biểu mẫu legacy để tương thích — Legacy form reference for compatibility
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-reconciliation-form
.... extension:auditStatus S 0..1 CodeableConcept Trạng thái giám định BHYT (received | under-review | approved | rejected | disputed)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status
Binding: Trạng thái giám định BHYT — VN Claim Audit Status ValueSet (extensible)
... status S 1..1 code Trạng thái resource (active | cancelled | draft | entered-in-error)
... period S 1..1 Period Kỳ đối soát/phân bổ khoản thanh toán — Remittance or payment-allocation period
... paymentIssuer S 0..1 Reference(Organization) Cơ quan BHXH chi trả (BHXH cấp tỉnh/Trung ương)
... request S 0..1 Reference(Task) Hồ sơ/đề nghị thanh toán liên quan (optional)
... outcome S 0..1 code Kết quả tổng quát chuẩn FHIR (queued | complete | error | partial)
... paymentAmount S 1..1 Money Tổng khoản thanh toán/remittance BHXH — Total BHXH remittance amount
... detail S 1..* BackboneElement Phân bổ khoản thanh toán theo giao dịch/Claim — Payment allocation by transaction or Claim
.... type S 1..1 CodeableConcept Loại giao dịch (payment | adjustment | advance...)
.... request S 0..1 Reference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile) Claim hoặc yêu cầu được phân bổ khoản thanh toán — Claim/request receiving the allocation
.... amount S 1..1 Money Số tiền được phân bổ cho giao dịch (VND) — Amount allocated to the transaction
..... value 1..1 decimal Numerical value (with implicit precision)

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
vn-payment-reconciliation-detail-amount-sum error PaymentReconciliation Tổng khoản thanh toán phải bằng tổng số tiền được phân bổ ở các detail. The payment amount SHALL equal the sum of amounts allocated across all details. paymentAmount.value = detail.amount.value.aggregate($this + $total, 0)
vn-payment-reconciliation-money-vnd error PaymentReconciliation Mọi khoản phân bổ chi tiết và tổng khoản thanh toán phải dùng VND. Every detail allocation and the total payment amount SHALL use VND. detail.amount.all(currency.count() = 1 and currency = 'VND') and paymentAmount.currency.count() = 1 and paymentAmount.currency = 'VND'

Dạng xem SnapshotView

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PaymentReconciliation C 0..* PaymentReconciliation PaymentReconciliation resource
Constraints: vn-payment-reconciliation-detail-amount-sum, vn-payment-reconciliation-money-vnd
... 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
... 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:formNumber S 0..1 string Tham chiếu biểu mẫu legacy để tương thích — Legacy form reference for compatibility
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-reconciliation-form
.... extension:auditStatus S 0..1 CodeableConcept Trạng thái giám định BHYT (received | under-review | approved | rejected | disputed)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status
Binding: Trạng thái giám định BHYT — VN Claim Audit Status ValueSet (extensible)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier 0..* Identifier Business Identifier for a payment reconciliation
... status ?!SΣ 1..1 code Trạng thái resource (active | cancelled | draft | entered-in-error)
Binding: FinancialResourceStatusCodes (required): A code specifying the state of the resource instance.
... period SΣ 1..1 Period Kỳ đối soát/phân bổ khoản thanh toán — Remittance or payment-allocation period
... created SΣ 1..1 dateTime Ngày tạo thông báo đối soát/remittance — Reconciliation creation date
... paymentIssuer SΣ 0..1 Reference(Organization) Cơ quan BHXH chi trả (BHXH cấp tỉnh/Trung ương)
... request S 0..1 Reference(Task) Hồ sơ/đề nghị thanh toán liên quan (optional)
... requestor 0..1 Reference(Practitioner | PractitionerRole | Organization) Responsible practitioner
... outcome S 0..1 code Kết quả tổng quát chuẩn FHIR (queued | complete | error | partial)
Binding: ClaimProcessingCodes (required): The outcome of the processing.
... disposition 0..1 string Disposition message
... paymentDate Σ 1..1 date When payment issued
... paymentAmount SΣ 1..1 Money Tổng khoản thanh toán/remittance BHXH — Total BHXH remittance amount
... paymentIdentifier 0..1 Identifier Business identifier for the payment
... detail S 1..* BackboneElement Phân bổ khoản thanh toán theo giao dịch/Claim — Payment allocation by transaction or Claim
.... 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
.... identifier 0..1 Identifier Business identifier of the payment detail
.... predecessor 0..1 Identifier Business identifier of the prior payment detail
.... type S 1..1 CodeableConcept Loại giao dịch (payment | adjustment | advance...)
Binding: PaymentTypeCodes (example): The reason for the amount: payment, adjustment, advance.
.... request S 0..1 Reference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile) Claim hoặc yêu cầu được phân bổ khoản thanh toán — Claim/request receiving the allocation
.... submitter 0..1 Reference(Practitioner | PractitionerRole | Organization) Submitter of the request
.... response 0..1 Reference(Resource) Response committing to a payment
.... date 0..1 date Date of commitment to pay
.... responsible 0..1 Reference(PractitionerRole) Contact for the response
.... payee 0..1 Reference(Practitioner | PractitionerRole | Organization) Recipient of the payment
.... amount S 1..1 Money Số tiền được phân bổ cho giao dịch (VND) — Amount allocated to the transaction
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... value Σ 1..1 decimal Numerical value (with implicit precision)
..... currency Σ 0..1 code ISO 4217 Currency Code
Binding: Currencies (required): A code indicating the currency, taken from ISO 4217.
... formCode 0..1 CodeableConcept Printed form identifier
Binding: Form Codes (example): The forms codes.
... processNote 0..* BackboneElement Note concerning processing
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... type 0..1 code display | print | printoper
Binding: NoteType (required): The presentation types of notes.
.... text 0..1 string Note explanatory text

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PaymentReconciliation.​language Base preferred Common Languages 📍4.0.1 FHIR Std.
PaymentReconciliation.​status Base required Financial Resource Status Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​outcome Base required Claim Processing Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​detail.type Base example Payment Type Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​detail.amount.currency Base required CurrencyCode 📍4.0.1 FHIR Std.
PaymentReconciliation.​formCode Base example Forms 📍4.0.1 FHIR Std.
PaymentReconciliation.​processNote.type Base required NoteType 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PaymentReconciliation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PaymentReconciliation 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 PaymentReconciliation 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 PaymentReconciliation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PaymentReconciliation 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-payment-reconciliation-detail-amount-sum error PaymentReconciliation Tổng khoản thanh toán phải bằng tổng số tiền được phân bổ ở các detail. The payment amount SHALL equal the sum of amounts allocated across all details. paymentAmount.value = detail.amount.value.aggregate($this + $total, 0)
vn-payment-reconciliation-money-vnd error PaymentReconciliation Mọi khoản phân bổ chi tiết và tổng khoản thanh toán phải dùng VND. Every detail allocation and the total payment amount SHALL use VND. detail.amount.all(currency.count() = 1 and currency = 'VND') and paymentAmount.currency.count() = 1 and paymentAmount.currency = 'VND'

 

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